@dominikcz/greg 0.9.34 → 0.9.36

package/README.md

@@ -16,7 +16,7 @@ For unattended/default setup (no prompts):
 npx @dominikcz/greg init --defaults
 ```
 
-The interactive wizard will ask for docs path, site title, TypeScript preference, and the type of initial documentation (empty, sample, or generated fake docs). It can also install all required dependencies for you.
+The interactive wizard asks for docs path, site title, TypeScript preference, config mode (minimal or full), and starter docs type (empty, sample, or generated fake docs). It also creates a sensible `.gitignore`, copies default `public/` assets, and can install all required dependencies for you.
 
 At the end you only need:
 
@@ -299,6 +299,33 @@ export default {
 
 To override those labels per locale, use `versioning.locales`:
 
+### Cache SHA length (branch mode)
+
+In `branches` strategy, Greg stores build cache under `.greg/version-cache/builds/...` using a short commit SHA prefix.
+
+- default prefix length: `7`
+- configurable in `greg.config.* > versioning.cacheShaLength`
+- can be overridden per run via env `GREG_CACHE_SHA_LENGTH`
+- allowed range: `7..40`
+- cache folder key format: `<shortSha>-<workspaceBuildFingerprint>`
+- the suffix avoids stale cache reuse when local build inputs/config changed but branch commit SHA stayed the same
+
+Example: if `main` still points to the same commit, but you changed `vite.config.js` or Markdown build plugins locally, Greg uses a different cache folder because the workspace fingerprint changes.
+
+Example:
+
+```js [greg.config.js]
+export default {
+    versioning: {
+        cacheShaLength: 12,
+    },
+}
+```
+
+```sh
+GREG_CACHE_SHA_LENGTH=16 greg build
+```
+
 ```js [greg.config.js]
 export default {
     versioning: {

package/bin/init.js

@@ -18,6 +18,7 @@ import { fork, spawnSync } from 'node:child_process';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const cliArgs = new Set(process.argv.slice(2));
 const useDefaultsMode = cliArgs.has('--defaults') || cliArgs.has('--yes');
+const forceLocalDependency = cliArgs.has('--local-dependency') || process.env.GREG_INIT_LOCAL_DEP === '1';
 
 // ── ANSI helpers (used for file-creation log lines) ───────────────────────────
 const g = (s) => `\x1b[32m${s}\x1b[0m`;  // green
@@ -120,12 +121,7 @@ function isTransientCacheSpec(spec) {
 
 function resolveGregDependencySpec(version) {
     const packageRoot = join(__dirname, '..');
-    const npmView = spawnSync('npm', ['view', `@dominikcz/greg@${version}`, 'version'], {
-        stdio: 'pipe',
-        shell: true,
-    });
-
-    if (npmView.status === 0) {
+    if (!forceLocalDependency) {
         return { spec: `^${version}`, source: 'registry' };
     }
 
@@ -158,6 +154,7 @@ async function main() {
     let desc = 'Documentation';
     let useTS = true;
     let addScripts = true;
+    let fullConfig = false;
     let docsType = '1';
 
     if (!useDefaultsMode) {
@@ -166,6 +163,7 @@ async function main() {
         desc         = orCancel(await p.text({ message: 'Site description', initialValue: 'Documentation' }));
         useTS        = orCancel(await p.confirm({ message: 'Use TypeScript for configuration?', initialValue: true }));
         addScripts   = orCancel(await p.confirm({ message: 'Add greg scripts to package.json?', initialValue: true }));
+        fullConfig   = orCancel(await p.confirm({ message: 'Generate full greg.config template?', initialValue: false }));
         docsType     = orCancel(await p.select({
             message: 'Documentation contents',
             options: [
@@ -189,6 +187,9 @@ async function main() {
     const rootPath = '';
     const ext      = useTS ? 'ts' : 'js';
     const vars     = { TITLE: title, DESCRIPTION: desc, DOCS_DIR: docsDir, ROOT_PATH: rootPath, EXT: ext };
+    const gregConfigTemplate = useTS
+        ? (fullConfig ? 'greg.config.full.ts' : 'greg.config.ts')
+        : (fullConfig ? 'greg.config.full.js' : 'greg.config.js');
 
     p.log.step('Creating files…');
 
@@ -199,7 +200,14 @@ async function main() {
     ensure('src/app.css',          tpl('src/app.css'));
     ensure(`vite.config.${ext}`,   tpl('vite.config.js', vars)); // same content for .js and .ts
     ensure('svelte.config.js',     tpl('svelte.config.js'));     // always .js — vite-plugin-svelte requires it
-    ensure(`greg.config.${ext}`,   tpl(useTS ? 'greg.config.ts' : 'greg.config.js', vars));
+    ensure(`greg.config.${ext}`,   tpl(gregConfigTemplate, vars));
+    ensure('.gitignore',           tpl('.gitignore'));
+    const packagePublicDir = join(__dirname, '..', 'public');
+    if (existsSync(packagePublicDir)) {
+        copyRawDir(packagePublicDir, 'public');
+    } else {
+        p.log.warn('public assets not found in package; skipping public/ scaffold');
+    }
 
     if (useTS) {
         ensure('tsconfig.json', tpl('tsconfig.json'));
@@ -244,7 +252,7 @@ async function main() {
                 let changed = false;
                 if (addScripts) {
                     pkg.scripts ??= {};
-                    for (const [k, v] of [['dev', 'greg dev'], ['build', 'greg build'], ['preview', 'greg preview']]) {
+                    for (const [k, v] of [['greg', 'greg'], ['dev', 'greg dev'], ['build', 'greg build'], ['preview', 'greg preview']]) {
                         if (!pkg.scripts[k]) { pkg.scripts[k] = v; changed = true; }
                     }
                 }
@@ -259,6 +267,18 @@ async function main() {
                     pkg.devDependencies['@dominikcz/greg'] = gregDependencySpec;
                     changed = true;
                 }
+                const peerDepsMap = {
+                    '@sveltejs/vite-plugin-svelte': gregDevDeps['@sveltejs/vite-plugin-svelte'] ?? '^6',
+                    svelte: gregDevDeps.svelte ?? '^5',
+                    vite: gregDevDeps.vite ?? '^7',
+                    ...(useTS ? { typescript: '^5' } : {}),
+                };
+                for (const [depName, depVersion] of Object.entries(peerDepsMap)) {
+                    if (!pkg.devDependencies[depName]) {
+                        pkg.devDependencies[depName] = depVersion;
+                        changed = true;
+                    }
+                }
                 if (changed) {
                     writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
                     p.log.success('package.json  ' + d('(updated)'));
@@ -273,8 +293,14 @@ async function main() {
                 name: 'my-docs',
                 version: '0.0.1',
                 type: 'module',
-                ...(addScripts ? { scripts: { dev: 'greg dev', build: 'greg build', preview: 'greg preview' } } : {}),
-                devDependencies: { '@dominikcz/greg': gregDependencySpec },
+                ...(addScripts ? { scripts: { greg: 'greg', dev: 'greg dev', build: 'greg build', preview: 'greg preview' } } : {}),
+                devDependencies: {
+                    '@dominikcz/greg': gregDependencySpec,
+                    '@sveltejs/vite-plugin-svelte': gregDevDeps['@sveltejs/vite-plugin-svelte'] ?? '^6',
+                    svelte: gregDevDeps.svelte ?? '^5',
+                    vite: gregDevDeps.vite ?? '^7',
+                    ...(useTS ? { typescript: '^5' } : {}),
+                },
             };
             writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
             console.log(`  ${g('+')} package.json`);
@@ -283,16 +309,8 @@ async function main() {
 
     // ── Install dependencies ──────────────────────────────────────────────────
     // @dominikcz/greg is already in package.json devDependencies — install only peer deps.
-    const peerDepsArr = [
-        `@sveltejs/vite-plugin-svelte@${gregDevDeps['@sveltejs/vite-plugin-svelte'] ?? '^6'}`,
-        `svelte@${gregDevDeps.svelte ?? '^5'}`,
-        `vite@${gregDevDeps.vite ?? '^7'}`,
-        ...(useTS ? ['typescript'] : []),
-    ];
     const pm = detectPm();
-    const installArgs = pm === 'npm'
-        ? ['install', '--save-dev', ...peerDepsArr]
-        : ['add', '-D', ...peerDepsArr];
+    const installArgs = ['install'];
 
     const installNow = useDefaultsMode
         ? true
@@ -325,8 +343,8 @@ async function main() {
 
     p.outro(
         installNow
-            ? `${b(g('Done!'))}  Start your project:\n\n  ${c('npm run dev')}`
-            : `${b(g('Done!'))}  Next steps:\n\n  ${c(`${pm} ${installArgs.join(' ')}`)}\n  ${c('npm run dev')}`
+            ? `${b(g('Done!'))}  Start your project:\n\n  ${c('npm run dev')}\n  ${c('npx greg --help')}`
+            : `${b(g('Done!'))}  Next steps:\n\n  ${c(`${pm} ${installArgs.join(' ')}`)}\n  ${c('npm run dev')}\n  ${c('npx greg --help')}`
     );
 }
 
@@ -346,6 +364,26 @@ function copyTemplateDir(srcDir, destRel, vars) {
     }
 }
 
+function copyRawDir(srcDir, destRel) {
+    for (const entry of readdirSync(srcDir)) {
+        const srcPath = join(srcDir, entry);
+        const destPath = join(destRel, entry);
+        if (statSync(srcPath).isDirectory()) {
+            copyRawDir(srcPath, destPath);
+        } else {
+            const full = join(cwd, destPath);
+            if (existsSync(full)) {
+                console.log(`  ${y('~')} ${destPath}  ${d('(skipped – already exists)')}`);
+                continue;
+            }
+            const dir = dirname(full);
+            if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+            writeFileSync(full, readFileSync(srcPath));
+            console.log(`  ${g('+')} ${destPath}`);
+        }
+    }
+}
+
 main().catch((err) => {
     console.error(err);
     process.exit(1);

package/bin/templates/greg.config.full.js

@@ -0,0 +1,32 @@
+/**
+ * @type {import('@dominikcz/greg').GregConfig}
+ */
+export default {
+    base: '/',
+    outDir: 'dist',
+    srcDir: '{{DOCS_DIR}}',
+    docsBase: '',
+    mainTitle: '{{TITLE}}',
+    useDynamicPageTitle: true,
+    sidebar: 'auto',
+    outline: [2, 3],
+    nav: [
+        { text: 'Guide', link: '/guide' },
+        { text: 'Reference', link: '/reference' },
+    ],
+    search: {
+        provider: 'local',
+        fuzzy: {
+            threshold: 0.35,
+            minMatchCharLength: 2,
+        },
+    },
+    // versioning: {
+    //     strategy: 'branches',
+    //     default: 'latest',
+    //     aliases: { latest: '1.0' },
+    //     branches: [
+    //         { version: '1.0', branch: 'main', title: '1.0' },
+    //     ],
+    // },
+}

package/bin/templates/greg.config.full.ts

@@ -0,0 +1,31 @@
+import type { GregConfig } from '@dominikcz/greg'
+
+export default {
+    base: '/',
+    outDir: 'dist',
+    srcDir: '{{DOCS_DIR}}',
+    docsBase: '',
+    mainTitle: '{{TITLE}}',
+    useDynamicPageTitle: true,
+    sidebar: 'auto',
+    outline: [2, 3],
+    nav: [
+        { text: 'Guide', link: '/guide' },
+        { text: 'Reference', link: '/reference' },
+    ],
+    search: {
+        provider: 'local',
+        fuzzy: {
+            threshold: 0.35,
+            minMatchCharLength: 2,
+        },
+    },
+    // versioning: {
+    //     strategy: 'branches',
+    //     default: 'latest',
+    //     aliases: { latest: '1.0' },
+    //     branches: [
+    //         { version: '1.0', branch: 'main', title: '1.0' },
+    //     ],
+    // },
+} satisfies GregConfig

package/bin/templates/greg.config.js

@@ -2,38 +2,14 @@
  * @type {import('@dominikcz/greg').GregConfig}
  */
 export default {
-    // VitePress-compatible build options:
-    // base: '/',
-    // outDir: 'dist',
-    srcDir: '',
-    docsBase: '',
+    base: '/',
+    outDir: 'dist',
+    srcDir: '{{DOCS_DIR}}',
     mainTitle: '{{TITLE}}',
+    // useDynamicPageTitle: true,
     sidebar: 'auto',
-    // versioning: {
-    //     strategy: 'branches', // default
-    //     default: 'latest',
-    //     aliases: {
-    //         latest: '2.1',
-    //         stable: '2.0',
-    //     },
-    //     ui: {
-    //         versionMenuLabel: 'Version',
-    //         manifestUnavailableText: 'Version selector unavailable',
-    //         showManifestUnavailableStatus: false,
-    //         outdatedVersionMessage: 'You are viewing an older version ({current}). Recommended: {default}.',
-    //         outdatedVersionActionLabel: 'Go to latest',
-    //     },
-    //     locales: {
-    //         '/': {
-    //             ui: { versionMenuLabel: 'Version' },
-    //         },
-    //         '/pl/': {
-    //             ui: { versionMenuLabel: 'Wersja' },
-    //         },
-    //     },
-    //     branches: [
-    //         { version: '2.1', branch: 'main', title: '2.1' },
-    //         { version: '2.0', branch: 'release/2.0', title: '2.0' },
-    //     ],
+    // search: {
+    //     provider: 'local',
+    //     // fuzzy: { threshold: 0.35, minMatchCharLength: 2 },
     // },
 }

package/bin/templates/greg.config.ts

@@ -1,38 +1,14 @@
 import type { GregConfig } from '@dominikcz/greg'
 
 export default {
-    // VitePress-compatible build options:
-    // base: '/',
-    // outDir: 'dist',
-    srcDir: '',
-    docsBase: '',
+    base: '/',
+    outDir: 'dist',
+    srcDir: '{{DOCS_DIR}}',
     mainTitle: '{{TITLE}}',
+    // useDynamicPageTitle: true,
     sidebar: 'auto',
-    // versioning: {
-    //     strategy: 'branches', // default
-    //     default: 'latest',
-    //     aliases: {
-    //         latest: '2.1',
-    //         stable: '2.0',
-    //     },
-    //     ui: {
-    //         versionMenuLabel: 'Version',
-    //         manifestUnavailableText: 'Version selector unavailable',
-    //         showManifestUnavailableStatus: false,
-    //         outdatedVersionMessage: 'You are viewing an older version ({current}). Recommended: {default}.',
-    //         outdatedVersionActionLabel: 'Go to latest',
-    //     },
-    //     locales: {
-    //         '/': {
-    //             ui: { versionMenuLabel: 'Version' },
-    //         },
-    //         '/pl/': {
-    //             ui: { versionMenuLabel: 'Wersja' },
-    //         },
-    //     },
-    //     branches: [
-    //         { version: '2.1', branch: 'main', title: '2.1' },
-    //         { version: '2.0', branch: 'release/2.0', title: '2.0' },
-    //     ],
+    // search: {
+    //     provider: 'local',
+    //     // fuzzy: { threshold: 0.35, minMatchCharLength: 2 },
     // },
 } satisfies GregConfig

package/docs/guide/getting-started.md

@@ -55,11 +55,13 @@ The wizard asks a handful of questions:
 | **Site title** | Shown in the browser tab and the site header |
 | **Description** | Used in the HTML `<meta>` tag |
 | **TypeScript** | Creates `.ts` config files instead of `.js` |
-| **Add npm scripts** | Adds `dev`, `build` and `preview` to `package.json` |
+| **Config mode** | Choose **minimal** (default) or **full** `greg.config` template |
+| **Add npm scripts** | Adds `greg`, `dev`, `build` and `preview` to `package.json` |
 | **Starter content** | _Empty_ — bare minimum; _Sample_ — example pages; _Generated_ — large fake docs set |
 | **Install now** | Runs `npm install` (or your package manager) right away |
 
 When it finishes, you will see a summary of created files.
+The scaffold also includes a default `.gitignore` and copies baseline assets into `public/`.
 
 ### 3. Start the development server
 

package/docs/guide/versioning.md

@@ -190,6 +190,17 @@ Optional maintenance flags:
 - `--clean-versions`: removes the versioned output directory before building
 - `--rebuild-all`: rebuilds every configured version and skips branch build cache reuse for this run
 
+Cache SHA prefix length in branch build cache:
+
+- default: `7`
+- config: `versioning.cacheShaLength`
+- env override: `GREG_CACHE_SHA_LENGTH`
+- valid range: `7..40`
+- cache key format: `<shortSha>-<workspaceBuildFingerprint>`
+- the suffix prevents stale cache hits when build inputs/config changed but commit SHA did not
+
+Example: if branch `main` still resolves to the same commit, but you changed local build inputs (for example `vite.config.js` or Markdown build plugins), Greg writes to a different cache folder because the workspace fingerprint changes.
+
 ## UI Components
 
 Greg renders two visual versioning components automatically when a valid manifest is available:

package/docs/reference/markdowndocs.md

@@ -133,6 +133,23 @@ Name of the project shown in the top-left header.
 <MarkdownDocs srcDir="/" version="1.0.0" mainTitle="My Project" />
 ```
 
+### `useDynamicPageTitle`
+
+- **Type:** `boolean`
+- **Default:** `true`
+
+Controls browser tab title behavior:
+
+- `true` (default): tab title follows active page title (for example `Getting Started | My Project`)
+- `false`: tab title stays fixed to `mainTitle`
+
+```js
+export default {
+  mainTitle: 'My Project',
+  useDynamicPageTitle: false,
+}
+```
+
 ### `outline`
 
 - **Type:** `false | number | [number, number] | 'deep' | { level?: …, label?: string }`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dominikcz/greg",
-  "version": "0.9.34",
+  "version": "0.9.36",
   "type": "module",
   "types": "./types/index.d.ts",
   "bin": {

package/scripts/build-versions.js

@@ -166,7 +166,6 @@ function computeWorkspaceBuildFingerprint() {
         'vite.config.ts',
         'greg.config.js',
         'greg.config.ts',
-        'prv/greg.config.js',
         'package.json',
         'src/main.js',
         'src/App.svelte',
@@ -201,6 +200,28 @@ function getBranchSha(refName) {
     return String(out.stdout || '').trim();
 }
 
+function toShortSha(sha, length = 7) {
+    return String(sha || '').slice(0, length);
+}
+
+function resolveCacheShaLength(versioning) {
+    const DEFAULT_LENGTH = 7;
+    const MIN_LENGTH = 7;
+    const MAX_LENGTH = 40;
+    const raw = process.env.GREG_CACHE_SHA_LENGTH ?? versioning.cacheShaLength;
+
+    if (raw == null || String(raw).trim() === '') {
+        return DEFAULT_LENGTH;
+    }
+
+    const parsed = Number.parseInt(String(raw), 10);
+    if (!Number.isInteger(parsed) || parsed < MIN_LENGTH || parsed > MAX_LENGTH) {
+        throw new Error(`Invalid cache SHA length '${raw}'. Use an integer between ${MIN_LENGTH} and ${MAX_LENGTH}.`);
+    }
+
+    return parsed;
+}
+
 function ensureBranchDocsSnapshot(args) {
     const { branch, sha, docsDir, branchCacheDir } = args;
     const docsRel = String(docsDir || 'docs').replace(/^\/+|\/+$/g, '') || 'docs';
@@ -252,6 +273,7 @@ function runViteBuild(args) {
         GREG_DOCS_DIR: docsDir,
         GREG_DOCS_BASE: srcDir,
         GREG_ROOT_PATH: srcDir,
+        GREG_OUT_DIR: outDir,
         PATH:
             path.resolve(PROJECT_ROOT, 'node_modules/.bin') +
             (process.platform === 'win32' ? ';' : ':') +
@@ -259,7 +281,7 @@ function runViteBuild(args) {
     };
 
     console.log(`[greg] versions: vite build -> ${path.relative(PROJECT_ROOT, outDir)}`);
-    runCommand('vite', ['build', '--outDir', outDir, ...passthrough], {
+    runCommand('vite', ['build', ...passthrough], {
         stdio: 'inherit',
         shell: true,
         env,
@@ -443,6 +465,7 @@ async function main() {
     const args = parseArgs(process.argv.slice(2));
     const config = await loadGregConfig();
     const versioning = config.versioning ?? {};
+    const cacheShaLength = resolveCacheShaLength(versioning);
 
     const strategy = args.strategy || versioning.strategy || 'branches';
     validateVersioningConfig(versioning, strategy);
@@ -527,6 +550,7 @@ async function main() {
 
         for (const entry of entries) {
             const sha = getBranchSha(entry.branch);
+            const shortSha = toShortSha(sha, cacheShaLength);
             const snapshot = ensureBranchDocsSnapshot({
                 branch: entry.branch,
                 sha,
@@ -538,7 +562,7 @@ async function main() {
                 branchCacheDir,
                 'builds',
                 sanitizeSegment(entry.version),
-                `${sha}-${workspaceBuildFingerprint}`,
+                `${shortSha}-${workspaceBuildFingerprint}`,
             );
             const hasBuildCache = !args.rebuildAll && fs.existsSync(path.join(buildCache, 'index.html'));
 

package/scripts/generate-static.js

@@ -27,6 +27,12 @@ const DIST = path.resolve(distDir);
 const DOCS = path.resolve(docsDir);
 const ROOT_PATH = srcDir;
 
+function normalizeRouteForLog(route) {
+    const cleaned = String(route || '').trim().replace(/\\/g, '/').replace(/\/+/g, '/');
+    if (!cleaned || cleaned === '/') return '/';
+    return '/' + cleaned.replace(/^\/+|\/+$/g, '');
+}
+
 // ── Collect routes from the docs/ folder ────────────────────────────────────
 
 function collectRoutes(dir, base) {
@@ -58,7 +64,7 @@ const routes = [...new Set([
 
 const src = path.join(DIST, 'index.html');
 if (!fs.existsSync(src)) {
-    console.error('dist/index.html not found – run npm run build first.');
+    console.error(`${src} not found - run npm run build first.`);
     process.exit(1);
 }
 
@@ -73,7 +79,8 @@ for (const route of routes) {
     fs.mkdirSync(outDir, { recursive: true });
     fs.copyFileSync(src, outFile);
     count++;
-    console.log(`  ✓  ${route}/index.html`);
+    const routeLog = normalizeRouteForLog(route);
+    console.log(`  ✓  ${routeLog === '/' ? '/index.html' : `${routeLog}/index.html`}`);
 }
 
 console.log(`\nStatic export: ${count} routes written to dist/`);

package/src/lib/MarkdownDocs/MarkdownDocs.svelte

@@ -87,6 +87,8 @@
         children?: Snippet;
         version?: string;
         mainTitle?: string;
+        /** Keep browser tab title in sync with active page title. Default: true. */
+        useDynamicPageTitle?: boolean;
         carbonAds?: CarbonAdsOptions;
         /** VitePress-compatible outline option. false = disabled, [2,3] = default. */
         outline?: OutlineOption | boolean;
@@ -206,6 +208,7 @@
         ),
         version: globalVersion = (gregConfig as any).version ?? "",
         mainTitle: globalMainTitle = (gregConfig as any).mainTitle ?? "Greg",
+        useDynamicPageTitle = (gregConfig as any).useDynamicPageTitle ?? true,
         carbonAds = (gregConfig as any).carbonAds,
         outline: globalOutline =
             (gregConfig as any).outline ?? ([2, 3] as [number, number]),
@@ -1345,6 +1348,28 @@
     }
 
     const title = $derived(router.title(flat));
+    const browserTitle = $derived.by(() => {
+        if (!useDynamicPageTitle) {
+            const fixedTitle = String(mainTitle ?? "").trim();
+            return fixedTitle || "Greg";
+        }
+        const brand =
+            siteTitle === false
+                ? String(mainTitle || "").trim()
+                : String(siteTitle ?? mainTitle ?? "").trim();
+        const pageTitle = String(title ?? "").trim();
+        if (!brand) return pageTitle || "Greg";
+        if (!pageTitle || pageTitle === brand) return brand;
+        return `${pageTitle} | ${brand}`;
+    });
+
+    $effect(() => {
+        if (typeof document === "undefined") return;
+        if (!browserTitle) return;
+        if (document.title !== browserTitle) {
+            document.title = browserTitle;
+        }
+    });
 
     // -- Content fetch -----------------------------------------------------------
     async function fetchMarkdown(mdPath: string): Promise<string> {

package/src/lib/MarkdownDocs/loadGregConfig.js

@@ -6,24 +6,6 @@ function isPlainObject(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
 
-function deepMerge(baseValue, overrideValue) {
-    if (!isPlainObject(baseValue) || !isPlainObject(overrideValue)) {
-        return overrideValue;
-    }
-
-    const result = { ...baseValue };
-    for (const [key, overrideEntry] of Object.entries(overrideValue)) {
-        const baseEntry = result[key];
-        if (isPlainObject(baseEntry) && isPlainObject(overrideEntry)) {
-            result[key] = deepMerge(baseEntry, overrideEntry);
-            continue;
-        }
-        result[key] = overrideEntry;
-    }
-
-    return result;
-}
-
 function normalizeConfig(value) {
     return isPlainObject(value) ? value : {};
 }
@@ -37,17 +19,6 @@ export function resolveMainGregConfigPath(rootDir = process.cwd()) {
     return null;
 }
 
-export function resolvePrvGregConfigPath(rootDir = process.cwd()) {
-    const prvPath = path.join(rootDir, 'prv', 'greg.config.js');
-    return fs.existsSync(prvPath) ? prvPath : null;
-}
-
-export function resolveGregConfigPaths(rootDir = process.cwd()) {
-    const mainConfigPath = resolveMainGregConfigPath(rootDir);
-    const prvConfigPath = resolvePrvGregConfigPath(rootDir);
-    return { mainConfigPath, prvConfigPath };
-}
-
 export async function loadGregConfigFile(configPath) {
     if (!configPath || !fs.existsSync(configPath)) return {};
 
@@ -70,13 +41,5 @@ export async function loadGregConfigFile(configPath) {
 }
 
 export async function loadGregConfig(rootDir = process.cwd()) {
-    const { mainConfigPath, prvConfigPath } = resolveGregConfigPaths(rootDir);
-    const mainConfig = await loadGregConfigFile(mainConfigPath);
-
-    if (!prvConfigPath) {
-        return mainConfig;
-    }
-
-    const prvConfig = await loadGregConfigFile(prvConfigPath);
-    return deepMerge(mainConfig, prvConfig);
+    return loadGregConfigFile(resolveMainGregConfigPath(rootDir));
 }

package/src/lib/MarkdownDocs/vitePluginGregConfig.js

@@ -10,7 +10,6 @@
  *   srcDir       string           – physical docs source directory, relative to project root (default: 'docs')
  *   srcExclude   string[]         – glob patterns to exclude from docs source (VitePress-compatible, default: [])
  *   docsBase     string           – URL prefix for the docs section, e.g. 'docs' → URLs like /docs/guide (default: 'docs')
- *   srcDir     string           – @deprecated, use docsBase instead
  *   version      string           – version badge text
  *   mainTitle    string           – site title shown in the header
  *   outline      OutlineOption    – global outline setting (VitePress-compatible)
@@ -22,12 +21,12 @@
  *   locales      Record<string, LocaleConfig> – VitePress-style locale map
  *   sidebar      'auto' | SidebarItem[]
  *
- * HMR: changing greg.config.* or prv/greg.config.js triggers a full page reload.
+ * HMR: changing greg.config.* triggers a full page reload.
  */
 
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { loadGregConfig, resolveGregConfigPaths } from './loadGregConfig.js';
+import { loadGregConfig, resolveMainGregConfigPath } from './loadGregConfig.js';
 import {
     DEFAULT_OUTPUT_BASE_DIR,
     DEFAULT_SITE_BASE,
@@ -43,10 +42,10 @@ const RESOLVED_ID = '\0' + VIRTUAL_ID;
 
 export function vitePluginGregConfig() {
     let root = process.cwd();
-    let { mainConfigPath, prvConfigPath } = resolveGregConfigPaths(root);
+    let mainConfigPath = resolveMainGregConfigPath(root);
 
     function isWatchedConfig(file) {
-        return file === mainConfigPath || file === prvConfigPath;
+        return file === mainConfigPath;
     }
 
     return {
@@ -84,7 +83,10 @@ export function vitePluginGregConfig() {
                 if (hasBase) {
                     viteConfig.base = normalizeBasePath(resolved.base, DEFAULT_SITE_BASE);
                 }
-                if (hasOutDir) {
+                const outDirOverride = process.env.GREG_OUT_DIR;
+                if (outDirOverride) {
+                    viteConfig.build = { outDir: outDirOverride };
+                } else if (hasOutDir) {
                     const outDir = String(resolved.outDir || DEFAULT_OUTPUT_BASE_DIR).trim() || DEFAULT_OUTPUT_BASE_DIR;
                     viteConfig.build = { outDir };
                 }
@@ -97,7 +99,7 @@ export function vitePluginGregConfig() {
 
         configResolved(config) {
             root = config.root;
-            ({ mainConfigPath, prvConfigPath } = resolveGregConfigPaths(root));
+            mainConfigPath = resolveMainGregConfigPath(root);
         },
 
         resolveId(id) {
@@ -106,7 +108,7 @@ export function vitePluginGregConfig() {
 
         async load(id) {
             if (id !== RESOLVED_ID) return;
-            if (!mainConfigPath && !prvConfigPath) return `export default {};`;
+            if (!mainConfigPath) return `export default {};`;
             try {
                 const config = await loadGregConfig(root);
                 return `export default ${JSON.stringify(config)};`;
@@ -117,7 +119,7 @@ export function vitePluginGregConfig() {
         },
 
         handleHotUpdate({ file, server }) {
-            ({ mainConfigPath, prvConfigPath } = resolveGregConfigPaths(root));
+            mainConfigPath = resolveMainGregConfigPath(root);
             if (isWatchedConfig(file)) {
                 const mod = server.moduleGraph.getModuleById(RESOLVED_ID);
                 if (mod) {