@dreamlake/dockit 0.1.1

package/dist/vite.js

@@ -0,0 +1,80 @@
+import { readFile } from "node:fs/promises";
+import react from "@vitejs/plugin-react";
+import vike from "vike/plugin";
+import tailwindcss from "@tailwindcss/vite";
+import mdx from "@mdx-js/rollup";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkMdxFrontmatter from "remark-mdx-frontmatter";
+import remarkGfm from "remark-gfm";
+import rehypeSlug from "rehype-slug";
+import rehypeShiki from "@shikijs/rehype";
+function mdxRawLoader() {
+  const PREFIX = "\0mdx-raw:";
+  return {
+    name: "mdx-raw-loader",
+    enforce: "pre",
+    async resolveId(id, importer) {
+      if (!id.endsWith(".mdx?raw")) return null;
+      const base = id.slice(0, -"?raw".length);
+      const resolved = await this.resolve(base, importer, { skipSelf: true });
+      if (!resolved) return null;
+      return PREFIX + resolved.id;
+    },
+    async load(id) {
+      if (!id.startsWith(PREFIX)) return null;
+      const text = await readFile(id.slice(PREFIX.length), "utf-8");
+      return `export default ${JSON.stringify(text)};`;
+    }
+  };
+}
+function dockit() {
+  return [
+    tailwindcss(),
+    mdxRawLoader(),
+    {
+      enforce: "pre",
+      ...mdx({
+        remarkPlugins: [remarkFrontmatter, remarkMdxFrontmatter, remarkGfm],
+        rehypePlugins: [
+          rehypeSlug,
+          [
+            rehypeShiki,
+            {
+              themes: { light: "github-light", dark: "github-dark" },
+              defaultColor: false,
+              // Extract `file="…"` from the fenced-block meta string
+              // (e.g. ```bash file="terminal"). Returned keys become
+              // attributes on the <pre>; PreWrapper strips it off.
+              parseMetaString(meta) {
+                const m = meta.match(/\bfile="([^"]+)"/);
+                return m ? { file: m[1] } : null;
+              },
+              transformers: [
+                // Shiki drops the original `language-…` class from <code>,
+                // so the language is otherwise inaccessible to MDX
+                // components. Mirror it onto <pre language="…"> so
+                // PreWrapper can hand it to CodeBlock as the lang chip.
+                {
+                  name: "forward-language",
+                  pre(node) {
+                    const lang = this.options?.lang;
+                    if (typeof lang === "string" && lang && lang !== "text" && lang !== "plaintext") {
+                      node.properties = node.properties || {};
+                      node.properties.language = lang;
+                    }
+                  }
+                }
+              ]
+            }
+          ]
+        ],
+        providerImportSource: "@mdx-js/react"
+      })
+    },
+    react(),
+    vike()
+  ];
+}
+export {
+  dockit
+};

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@dreamlake/dockit",
+  "version": "0.1.1",
+  "description": "The DreamLake documentation shell — Vike + React + Tailwind v4 + MDX docs framework with sidebar, TOC, search, and theming",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/renderer/onRenderHtml.d.ts",
+      "default": "./dist/renderer/onRenderHtml.js"
+    },
+    "./client": {
+      "types": "./dist/renderer/onRenderClient.d.ts",
+      "default": "./dist/renderer/onRenderClient.js"
+    },
+    "./vike": {
+      "types": "./dist/vike.d.ts",
+      "default": "./dist/vike.js"
+    },
+    "./vite": {
+      "types": "./dist/vite.d.ts",
+      "default": "./dist/vite.js"
+    },
+    "./styles.css": "./dist/styles.css"
+  },
+  "peerDependencies": {
+    "@mdx-js/react": ">=3.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "vike": "^0.4.210",
+    "vike-react": "^0.5.0",
+    "vite": ">=6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@mdx-js/rollup": "^3.1.1",
+    "@shikijs/rehype": "^1.24.0",
+    "@tailwindcss/vite": "^4.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "rehype-slug": "^6.0.0",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.0",
+    "remark-mdx-frontmatter": "^5.2.0",
+    "shiki": "^1.24.0",
+    "tailwindcss": "^4.0.0"
+  },
+  "devDependencies": {
+    "@mdx-js/react": "^3.1.0",
+    "@types/node": "^22.20.1",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.7.0",
+    "vike": "^0.4.210",
+    "vike-react": "^0.5.0",
+    "vite": "^7.0.0",
+    "vite-plugin-dts": "^4.3.0"
+  },
+  "scripts": {
+    "build": "vite build",
+    "typecheck": "tsc --noEmit"
+  }
+}

package/templates/netlify.example.toml

@@ -0,0 +1,33 @@
+# Netlify config for a dockit docs site in a pnpm monorepo.
+# Copy to your repo root as netlify.toml and adjust the publish path if your
+# docs package is not at docs/.
+
+[build]
+command = "pnpm install --frozen-lockfile && pnpm build"
+publish = "docs/dist/client"
+
+[build.environment]
+# Vite 7 requires node ^20.19 || >=22 — Netlify's "20" image can sit below
+# that floor.
+NODE_VERSION = "22"
+PNPM_VERSION = "10.33.0"
+# Netlify installs pnpm via corepack (honoring package.json's packageManager
+# field). Corepack's baked-in npm registry keys rotate out from under old
+# corepack builds and the signature check then kills the install — the
+# documented workaround is to disable the integrity check.
+COREPACK_INTEGRITY_KEYS = "0"
+
+# ─── Branch + PR deploys ─────────────────────────────────────────────
+# Every PR gets a deploy preview at deploy-preview-<n>--<site>.netlify.app.
+# Every push to a non-production branch gets a branch deploy at
+# <branch>--<site>.netlify.app — which is what powers versioned docs URLs.
+# Empty blocks suffice — they tell Netlify "use the [build] defaults for
+# these contexts." Branch deploys must also be enabled in the Netlify UI:
+# Site settings → Build & deploy → Continuous deployment → Branches and
+# deploy contexts → "Deploy all branches" (or whitelist specific branches).
+
+[context.deploy-preview]
+  # Applies to every PR — uses [build] command + publish settings.
+
+[context.branch-deploy]
+  # Applies to every non-production branch push.

package/templates/set-version.mjs

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+/**
+ * Usage: node scripts/set-version.mjs <version>
+ *
+ * Updates the docs-deploy version in two places:
+ *   - package.json at the workspace root (the canonical version used by
+ *     version-branch.sh)
+ *   - docs/public/versions.json (the version manifest served at /versions.json,
+ *     consumed by the in-site version switcher)
+ *
+ * versions.json schema:
+ *   {
+ *     "current": "<latest>",
+ *     "stable": "<stable>",
+ *     "aliases": { "latest": "<url>", "stable": "<url>" },
+ *     "versions": [{ "version", "url", "date" }, ...]   // newest first
+ *   }
+ *
+ * Idempotent: if the version already exists, its url/date are refreshed.
+ *
+ * Run from the workspace root. Paths resolve from the invocation cwd and
+ * assume the root-package.json + docs/public/versions.json layout; adjust
+ * below if your docs package lives elsewhere.
+ */
+import { readFileSync, writeFileSync } from 'fs';
+import { resolve } from 'path';
+
+// ── EDIT ME ──────────────────────────────────────────────────────────
+// Your Netlify site name. Per-version URLs are the site's branch-deploy
+// addresses for branch v<x.y.z> — they always resolve once branch deploys
+// are enabled, with no DNS setup. (Pretty subdomains like
+// v0-2-0.your-domain.com require a manual Netlify domain-management step
+// per release; most sites should skip them.)
+const NETLIFY_SITE = 'YOUR-SITE';
+const versionUrl = (version) =>
+  `https://v${version.replace(/\./g, '-')}--${NETLIFY_SITE}.netlify.app`;
+// ─────────────────────────────────────────────────────────────────────
+
+const version = process.argv[2];
+
+if (!version || !/^\d+\.\d+\.\d+/.test(version)) {
+  console.error('Usage: node scripts/set-version.mjs <x.y.z>');
+  process.exit(1);
+}
+
+const pkgPath = resolve(process.cwd(), 'package.json');
+const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+pkg.version = version;
+writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n');
+
+const manifestPath = resolve(process.cwd(), 'docs', 'public', 'versions.json');
+const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+
+const url = versionUrl(version);
+const date = new Date().toISOString().slice(0, 10);
+
+const existing = manifest.versions.find((v) => v.version === version);
+if (existing) {
+  existing.url = url;
+  existing.date = date;
+} else {
+  manifest.versions.unshift({ version, url, date });
+}
+manifest.current = version;
+
+writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+
+console.log(`Updated docs version to ${version}`);
+console.log(`  package.json  → version: "${version}"`);
+console.log(`  versions.json → current: "${version}", entry: ${url}`);

package/templates/version-branch.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+# Push current HEAD to a v<version> branch for Netlify branch deploy.
+# Netlify serves branch "vx.y.z" at v<x-y-z>--<site>.netlify.app.
+set -euo pipefail
+
+# ── EDIT ME ──────────────────────────────────────────────────────────
+# Your Netlify site name (matches NETLIFY_SITE in set-version.mjs).
+SITE="YOUR-SITE"
+# ─────────────────────────────────────────────────────────────────────
+
+VERSION=$(node -e "console.log(require('./package.json').version)")
+BRANCH="v${VERSION}"
+
+echo "Pushing to branch: ${BRANCH}"
+git push origin "HEAD:refs/heads/${BRANCH}" --force
+echo "Branch deploy will be available at: https://${BRANCH//./-}--${SITE}.netlify.app"

package/templates/versions.example.json

@@ -0,0 +1,15 @@
+{
+  "current": "0.1.0",
+  "stable": "0.1.0",
+  "aliases": {
+    "latest": "https://docs.example.com",
+    "stable": "https://docs.example.com"
+  },
+  "versions": [
+    {
+      "version": "0.1.0",
+      "url": "https://v0-1-0--YOUR-SITE.netlify.app",
+      "date": "2026-01-01"
+    }
+  ]
+}