@unterberg/nivel 0.0.3 → 0.0.4

package/dist/chunk-67GE3PJ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/runtime/node/codegen.ts","../src/runtime/node/loadDocsConfig.ts","../src/runtime/node/scaffold.ts"],"sourcesContent":["import fs from 'node:fs'\nimport path from 'node:path'\nimport type { DocPageData, DocPageLinkData, DocsConfig, DocsGlobalContextData } from '../../docs/types.js'\nimport { extractDocHeadings } from '../../docs/docHeadings.js'\nimport { getResolvedPageById, resolveDocsConfig } from '../../docs/resolveDocsConfig.js'\n\nconst GENERATED_DIRNAME = '(nivel-generated)'\n\nconst writeFileIfChanged = (filePath: string, source: string) => {\n  const current = fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf8') : null\n  if (current === source) {\n    return\n  }\n\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, source)\n}\n\nconst toPosix = (value: string) => value.split(path.sep).join(path.posix.sep)\n\nconst getRelativeImportPath = (fromDirectory: string, toFile: string) => {\n  const relativePath = toPosix(path.relative(fromDirectory, toFile))\n  if (relativePath.startsWith('.')) {\n    return relativePath\n  }\n  return `./${relativePath}`\n}\n\nconst serializeData = (data: DocPageData | DocsGlobalContextData) => JSON.stringify(data, null, 2)\n\nconst collectFiles = (directoryPath: string): string[] => {\n  if (!fs.existsSync(directoryPath)) {\n    return []\n  }\n\n  const entries = fs.readdirSync(directoryPath, { withFileTypes: true })\n\n  return entries.flatMap((entry) => {\n    const entryPath = path.join(directoryPath, entry.name)\n    return entry.isDirectory() ? collectFiles(entryPath) : [entryPath]\n  })\n}\n\nconst removeEmptyDirectories = (directoryPath: string, rootPath: string) => {\n  if (!fs.existsSync(directoryPath)) {\n    return\n  }\n\n  for (const entry of fs.readdirSync(directoryPath, { withFileTypes: true })) {\n    if (!entry.isDirectory()) {\n      continue\n    }\n\n    removeEmptyDirectories(path.join(directoryPath, entry.name), rootPath)\n  }\n\n  if (directoryPath === rootPath) {\n    return\n  }\n\n  if (fs.readdirSync(directoryPath).length === 0) {\n    fs.rmdirSync(directoryPath)\n  }\n}\n\nconst getGeneratedPageSource = (contentImportPath: string) => {\n  return [\n    \"import { DocsPage } from '@unterberg/nivel/client'\",\n    `import Content from ${JSON.stringify(contentImportPath)}`,\n    '',\n    'const Page = () => {',\n    '  return <DocsPage Content={Content} />',\n    '}',\n    '',\n    'export default Page',\n    '',\n  ].join('\\n')\n}\n\nconst getGeneratedDataSource = (data: DocPageData) => {\n  return [\n    \"import type { DocPageData } from '@unterberg/nivel'\",\n    '',\n    `const data: DocPageData = ${serializeData(data)}`,\n    '',\n    'const pageData = () => {',\n    '  return data',\n    '}',\n    '',\n    'export default pageData',\n    '',\n  ].join('\\n')\n}\n\nconst getGeneratedGlobalContextSource = (data: DocsGlobalContextData) => {\n  return [\n    \"import type { DocsGlobalContextData } from '@unterberg/nivel'\",\n    '',\n    `const docsGlobalContextData: DocsGlobalContextData = ${serializeData(data)}`,\n    '',\n    'export { docsGlobalContextData }',\n    '',\n  ].join('\\n')\n}\n\nconst getRouteString = (href: string) => {\n  if (href === '/') {\n    return href\n  }\n\n  return href.replace(/\\/+$/g, '')\n}\n\nconst getGeneratedRouteSource = (href: string) => {\n  return [`export default ${JSON.stringify(getRouteString(href))}`, ''].join('\\n')\n}\n\nconst getGeneratedTextExport = (value: string) => {\n  return [`export default ${JSON.stringify(value)}`, ''].join('\\n')\n}\n\nconst toDocPageLinkData = (\n  page:\n    | {\n        id: string\n        title: string\n        href: string\n        documentTitle: string\n      }\n    | undefined,\n): DocPageLinkData | null => {\n  if (!page) {\n    return null\n  }\n\n  return {\n    id: page.id,\n    title: page.title,\n    href: page.href,\n    documentTitle: page.documentTitle,\n  }\n}\n\nexport const getGeneratedPagesRoot = (rootDir: string) => path.join(rootDir, 'pages', GENERATED_DIRNAME)\n\nexport const syncGeneratedDocsPages = (options: { rootDir: string; docsConfig: DocsConfig }) => {\n  const { rootDir, docsConfig } = options\n  const resolved = resolveDocsConfig(docsConfig)\n  const generatedPagesRoot = getGeneratedPagesRoot(rootDir)\n  const docsRoot = path.join(rootDir, 'docs')\n  const expectedFiles = new Set<string>()\n  const globalContextFilePath = path.join(generatedPagesRoot, '_docsGlobalContext.ts')\n\n  fs.mkdirSync(generatedPagesRoot, { recursive: true })\n\n  const globalContextData: DocsGlobalContextData = {\n    siteTitle: resolved.siteTitle,\n    basePath: resolved.basePath,\n    theme: resolved.theme,\n    footer: resolved.footer,\n    brand: resolved.brand,\n    head: resolved.head,\n    partners: resolved.partners,\n    algolia: resolved.algolia,\n    pages: resolved.pages,\n    navbarItems: resolved.navbarItems,\n    sidebarSections: resolved.sections,\n  }\n\n  writeFileIfChanged(globalContextFilePath, getGeneratedGlobalContextSource(globalContextData))\n  expectedFiles.add(globalContextFilePath)\n\n  for (const [pageIndex, page] of resolved.pages.entries()) {\n    const contentFilePath = path.join(docsRoot, page.source)\n\n    if (!fs.existsSync(contentFilePath)) {\n      throw new Error(`Docs page \"${page.id}\" points to missing source file: ${contentFilePath}`)\n    }\n\n    const pageSource = fs.readFileSync(contentFilePath, 'utf8')\n    const data: DocPageData = {\n      page: getResolvedPageById(resolved, page.id),\n      headings: extractDocHeadings(pageSource),\n      previousPage: toDocPageLinkData(resolved.pages[pageIndex - 1]),\n      nextPage: toDocPageLinkData(resolved.pages[pageIndex + 1]),\n    }\n\n    for (const routeHref of [page.href, ...page.aliasHrefs]) {\n      const routeSlug = routeHref.replace(/^\\/docs\\//, '').replace(/\\/+$/g, '')\n      const pageDir = path.join(generatedPagesRoot, ...routeSlug.split('/'))\n      const contentImportPath = getRelativeImportPath(pageDir, contentFilePath)\n\n      const pageFilePath = path.join(pageDir, '+Page.tsx')\n      const dataFilePath = path.join(pageDir, '+data.ts')\n      const routeFilePath = path.join(pageDir, '+route.ts')\n      const titleFilePath = path.join(pageDir, '+title.ts')\n\n      writeFileIfChanged(pageFilePath, getGeneratedPageSource(contentImportPath))\n      writeFileIfChanged(dataFilePath, getGeneratedDataSource(data))\n      writeFileIfChanged(routeFilePath, getGeneratedRouteSource(routeHref))\n      writeFileIfChanged(titleFilePath, getGeneratedTextExport(page.documentTitle))\n\n      expectedFiles.add(pageFilePath)\n      expectedFiles.add(dataFilePath)\n      expectedFiles.add(routeFilePath)\n      expectedFiles.add(titleFilePath)\n\n      if (page.description) {\n        const descriptionFilePath = path.join(pageDir, '+description.ts')\n        writeFileIfChanged(descriptionFilePath, getGeneratedTextExport(page.description))\n        expectedFiles.add(descriptionFilePath)\n      }\n    }\n  }\n\n  for (const filePath of collectFiles(generatedPagesRoot)) {\n    if (expectedFiles.has(filePath)) {\n      continue\n    }\n\n    fs.rmSync(filePath, { force: true })\n  }\n\n  removeEmptyDirectories(generatedPagesRoot, generatedPagesRoot)\n}\n\nexport const isDocsSourcePath = (filePath: string, rootDir: string) => {\n  const normalized = toPosix(filePath)\n  const docsRoot = toPosix(path.join(rootDir, 'docs'))\n  const docsConfigPath = toPosix(path.join(rootDir, 'pages', '+docs.ts'))\n  const generatedRoot = toPosix(getGeneratedPagesRoot(rootDir))\n\n  if (normalized.startsWith(generatedRoot)) {\n    return false\n  }\n\n  return normalized === docsConfigPath || normalized.startsWith(`${docsRoot}/`)\n}\n","import path from 'node:path'\nimport type { DocsConfig } from '../../docs/types.js'\n\nconst getDocsConfigModulePath = (rootDir: string) => {\n  return path.join(rootDir, 'pages', '+docs.ts')\n}\n\nconst getDocsConfigFromLoadedModule = (loaded: unknown, modulePath: string) => {\n  const docsConfig = (loaded as { default?: DocsConfig }).default\n\n  if (!docsConfig) {\n    throw new Error(`Expected default export from ${modulePath}`)\n  }\n\n  return docsConfig\n}\n\nexport const loadDocsConfig = async (options: {\n  rootDir: string\n  loadModule: (modulePath: string) => Promise<unknown>\n}) => {\n  const modulePath = getDocsConfigModulePath(options.rootDir)\n  const loaded = await options.loadModule(modulePath)\n  return getDocsConfigFromLoadedModule(loaded, modulePath)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\nconst MANAGED_SCRIPT_NAMES = ['generate:docs', 'predev', 'prebuild', 'pretypecheck'] as const\n\nconst REQUIRED_DEPENDENCIES = ['@unterberg/nivel', 'react', 'react-dom', 'vike', 'vike-react'] as const\nconst REQUIRED_DEV_DEPENDENCIES = ['vite', 'typescript', '@types/react', '@types/react-dom'] as const\n\ntype InitConsumerOptions = { force: boolean; rootDir: string }\n\ntype InitConsumerResult = {\n  allDependenciesPresent: boolean\n  createdFiles: string[]\n  missingDependencies: string[]\n  overwrittenFiles: string[]\n  skippedFiles: string[]\n  updatedScripts: string[]\n}\n\ntype PackageJsonShape = {\n  dependencies?: Record<string, string>\n  devDependencies?: Record<string, string>\n  packageManager?: string\n  scripts?: Record<string, string>\n}\n\nconst getDocsConfigTemplate = () => {\n  return [\n    \"import { defineDocsConfig } from '@unterberg/nivel/config'\",\n    \"import { docsGraph } from '../docs/docs.graph'\",\n    '',\n    'const docsConfig = defineDocsConfig({',\n    '  graph: docsGraph,',\n    \"  siteTitle: 'My Docs',\",\n    \"  siteDescription: 'Documentation site powered by @unterberg/nivel.',\",\n    \"  basePath: '/docs',\",\n    '})',\n    '',\n    'export default docsConfig',\n    '',\n  ].join('\\n')\n}\n\nconst getDocsGraphTemplate = () => {\n  return [\n    \"import { defineDocsGraph } from '@unterberg/nivel/config'\",\n    '',\n    'export const docsGraph = defineDocsGraph({',\n    '  items: [',\n    '    {',\n    \"      kind: 'section',\",\n    \"      id: 'docs',\",\n    \"      title: 'Docs',\",\n    '      items: [',\n    '        {',\n    \"          kind: 'page',\",\n    \"          id: 'gettingStarted',\",\n    \"          title: 'Getting Started',\",\n    \"          slug: 'getting-started',\",\n    \"          source: 'content/getting-started/content.mdx',\",\n    \"          description: 'Getting started with @unterberg/nivel.',\",\n    '        },',\n    '      ],',\n    '    },',\n    '  ],',\n    '})',\n    '',\n  ].join('\\n')\n}\n\nconst getConfigTemplate = () => {\n  return [\n    \"import { createNivelVikeConfig } from '@unterberg/nivel/vike'\",\n    \"import docsConfig from './+docs'\",\n    '',\n    'export { config }',\n    '',\n    'const config = createNivelVikeConfig(docsConfig)',\n    '',\n  ].join('\\n')\n}\n\nconst getHeadTemplate = () => {\n  return [\n    \"import { MetaHead } from '@unterberg/nivel/client'\",\n    '',\n    'export const Head = () => {',\n    '  return <MetaHead />',\n    '}',\n    '',\n  ].join('\\n')\n}\n\nconst getLayoutTemplate = () => {\n  return [\n    \"import { AppLayout } from '@unterberg/nivel/client'\",\n    \"import type { ReactNode } from 'react'\",\n    '',\n    'const Layout = ({ children }: { children: ReactNode }) => {',\n    '  return <AppLayout>{children}</AppLayout>',\n    '}',\n    '',\n    'export default Layout',\n    '',\n  ].join('\\n')\n}\n\nconst getGlobalContextTemplate = () => {\n  return [\n    \"import { docsGlobalContextData } from './(nivel-generated)/_docsGlobalContext'\",\n    '',\n    'export const onCreateGlobalContext = (globalContext: { docs?: typeof docsGlobalContextData }) => {',\n    '  globalContext.docs = docsGlobalContextData',\n    '}',\n    '',\n  ].join('\\n')\n}\n\nconst getWrapperTemplate = () => {\n  return [\n    \"import type { ReactNode } from 'react'\",\n    '',\n    'const Wrapper = ({ children }: { children: ReactNode }) => {',\n    '  return <>{children}</>',\n    '}',\n    '',\n    'export default Wrapper',\n    '',\n  ].join('\\n')\n}\n\nconst getGlobalTypesTemplate = () => {\n  return [\n    \"declare module '*.mdx' {\",\n    \"  import type { ComponentType } from 'react'\",\n    '',\n    '  const MdxComponent: ComponentType',\n    '  export default MdxComponent',\n    '}',\n    '',\n    \"declare module '*.css'\",\n    '',\n    'declare global {',\n    '  namespace Vike {',\n    '    interface GlobalContext {',\n    \"      docs: import('@unterberg/nivel').DocsGlobalContextData\",\n    '    }',\n    '  }',\n    '}',\n    '',\n  ].join('\\n')\n}\n\nconst getManagedFileEntries = () => {\n  return [\n    ['pages/+docs.ts', getDocsConfigTemplate()],\n    ['docs/docs.graph.ts', getDocsGraphTemplate()],\n    ['pages/+config.ts', getConfigTemplate()],\n    ['pages/+Head.tsx', getHeadTemplate()],\n    ['pages/+Layout.tsx', getLayoutTemplate()],\n    ['pages/+onCreateGlobalContext.ts', getGlobalContextTemplate()],\n    ['pages/+Wrapper.tsx', getWrapperTemplate()],\n    ['global.d.ts', getGlobalTypesTemplate()],\n  ] as const\n}\n\nconst getGenerateDocsRunner = (packageJson: PackageJsonShape) => {\n  const packageManager = packageJson.packageManager?.trim() ?? ''\n\n  if (packageManager.startsWith('pnpm@')) {\n    return 'pnpm generate:docs'\n  }\n\n  if (packageManager.startsWith('npm@')) {\n    return 'npm run generate:docs'\n  }\n\n  return 'npm run generate:docs'\n}\n\nconst getManagedScripts = (packageJson: PackageJsonShape) => {\n  const generateDocsRunner = getGenerateDocsRunner(packageJson)\n\n  return {\n    'generate:docs': 'nivel prepare',\n    predev: generateDocsRunner,\n    prebuild: generateDocsRunner,\n    pretypecheck: generateDocsRunner,\n  } satisfies Record<(typeof MANAGED_SCRIPT_NAMES)[number], string>\n}\n\nconst writeFile = (filePath: string, source: string) => {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, source)\n}\n\nconst writeManagedFile = (\n  rootDir: string,\n  relativeFilePath: string,\n  source: string,\n  force: boolean,\n  result: InitConsumerResult,\n) => {\n  const filePath = path.join(rootDir, relativeFilePath)\n  const exists = fs.existsSync(filePath)\n\n  if (exists && !force) {\n    result.skippedFiles.push(relativeFilePath)\n    return\n  }\n\n  writeFile(filePath, source)\n\n  if (exists) {\n    result.overwrittenFiles.push(relativeFilePath)\n    return\n  }\n\n  result.createdFiles.push(relativeFilePath)\n}\n\nconst readPackageJson = (rootDir: string) => {\n  const packageJsonPath = path.join(rootDir, 'package.json')\n\n  if (!fs.existsSync(packageJsonPath)) {\n    throw new Error(`Expected package.json in ${rootDir}`)\n  }\n\n  return {\n    packageJson: JSON.parse(fs.readFileSync(packageJsonPath, 'utf8')) as PackageJsonShape,\n    packageJsonPath,\n  }\n}\n\nconst patchPackageScripts = (packageJson: PackageJsonShape, packageJsonPath: string, result: InitConsumerResult) => {\n  const scripts = { ...(packageJson.scripts ?? {}) }\n  const managedScripts = getManagedScripts(packageJson)\n\n  for (const scriptName of MANAGED_SCRIPT_NAMES) {\n    if (scripts[scriptName] === managedScripts[scriptName]) {\n      continue\n    }\n\n    scripts[scriptName] = managedScripts[scriptName]\n    result.updatedScripts.push(scriptName)\n  }\n\n  const nextPackageJson = {\n    ...packageJson,\n    scripts,\n  }\n\n  fs.writeFileSync(packageJsonPath, `${JSON.stringify(nextPackageJson, null, 2)}\\n`)\n}\n\nconst getMissingDependencies = (packageJson: PackageJsonShape) => {\n  const installed = new Set<string>([\n    ...Object.keys(packageJson.dependencies ?? {}),\n    ...Object.keys(packageJson.devDependencies ?? {}),\n  ])\n\n  return [...REQUIRED_DEPENDENCIES, ...REQUIRED_DEV_DEPENDENCIES].filter((packageName) => !installed.has(packageName))\n}\n\nexport const getInitSummary = (result: InitConsumerResult) => {\n  const lines = ['Initialized nivel consumer scaffolding.']\n\n  if (result.createdFiles.length > 0) {\n    lines.push(`Created files: ${result.createdFiles.join(', ')}`)\n  }\n\n  if (result.overwrittenFiles.length > 0) {\n    lines.push(`Overwritten files: ${result.overwrittenFiles.join(', ')}`)\n  }\n\n  if (result.skippedFiles.length > 0) {\n    lines.push(`Skipped existing files: ${result.skippedFiles.join(', ')}`)\n  }\n\n  if (result.updatedScripts.length > 0) {\n    lines.push(`Updated package.json scripts: ${result.updatedScripts.join(', ')}`)\n  }\n\n  if (result.missingDependencies.length > 0) {\n    lines.push(`Missing dependencies: ${result.missingDependencies.join(', ')}`)\n    lines.push(\n      'Consumer CSS stays hand-authored. Add your stylesheet import manually, for example in pages/+Wrapper.tsx.',\n    )\n  } else if (!result.allDependenciesPresent) {\n    lines.push('Dependency validation completed with warnings.')\n  } else {\n    lines.push('All required dependencies are already present.')\n  }\n\n  return `${lines.join('\\n')}\\n`\n}\n\nexport const initConsumer = (options: InitConsumerOptions): InitConsumerResult => {\n  const result: InitConsumerResult = {\n    allDependenciesPresent: true,\n    createdFiles: [],\n    missingDependencies: [],\n    overwrittenFiles: [],\n    skippedFiles: [],\n    updatedScripts: [],\n  }\n\n  const { packageJson, packageJsonPath } = readPackageJson(options.rootDir)\n\n  for (const [relativeFilePath, source] of getManagedFileEntries()) {\n    writeManagedFile(options.rootDir, relativeFilePath, source, options.force, result)\n  }\n\n  patchPackageScripts(packageJson, packageJsonPath, result)\n\n  result.missingDependencies = getMissingDependencies(packageJson)\n  result.allDependenciesPresent = result.missingDependencies.length === 0\n\n  return result\n}\n"],"mappings":"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","names":["path","fs","path"]}

package/dist/{chunk-K5ZYRA3G.js → chunk-AURANIZE.js}

@@ -2,7 +2,7 @@ import {
   isDocsSourcePath,
   loadDocsConfig,
   syncGeneratedDocsPages
-} from "./chunk-DNCQR5NH.js";
+} from "./chunk-67GE3PJ6.js";
 import {
   nivelPublicRoute
 } from "./chunk-PYYPYIBD.js";
@@ -195,4 +195,4 @@ var nivelPagesPlugin = () => {
 export {
   nivelPagesPlugin
 };
-//# sourceMappingURL=chunk-K5ZYRA3G.js.map
+//# sourceMappingURL=chunk-AURANIZE.js.map

package/dist/{chunk-FARXFRHG.js → chunk-GHQDRDZL.js}

@@ -648,4 +648,4 @@ export {
   RepoLink,
   Table
 };
-//# sourceMappingURL=chunk-FARXFRHG.js.map
+//# sourceMappingURL=chunk-GHQDRDZL.js.map

package/dist/chunk-JSZZPQEP.js

@@ -0,0 +1,9 @@
+// src/docs/defineDocs.ts
+var defineDocsConfig = (config) => config;
+var defineDocsGraph = (graph) => graph;
+
+export {
+  defineDocsConfig,
+  defineDocsGraph
+};
+//# sourceMappingURL=chunk-JSZZPQEP.js.map

package/dist/chunk-JSZZPQEP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/docs/defineDocs.ts"],"sourcesContent":["import type { DocsConfig, DocsGraph } from './types.js'\n\nexport const defineDocsConfig = (config: DocsConfig) => config\n\nexport const defineDocsGraph = (graph: DocsGraph) => graph\n"],"mappings":";AAEO,IAAM,mBAAmB,CAAC,WAAuB;AAEjD,IAAM,kBAAkB,CAAC,UAAqB;","names":[]}

package/dist/cli.js

@@ -1,27 +1,50 @@
 import {
-  loadDocsConfigWithVite,
+  getInitSummary,
+  initConsumer,
+  loadDocsConfig,
   syncGeneratedDocsPages
-} from "./chunk-DNCQR5NH.js";
+} from "./chunk-67GE3PJ6.js";
 import "./chunk-D7IAGT53.js";
 import "./chunk-PYYPYIBD.js";
 
 // src/cli.ts
 import path from "path";
+
+// src/runtime/node/loadDocsConfigWithTsx.ts
+import { pathToFileURL } from "url";
+import { register } from "tsx/esm/api";
+var loadDocsConfigWithTsx = async (rootDir) => {
+  const unregister = register();
+  try {
+    return await loadDocsConfig({
+      rootDir,
+      loadModule: async (modulePath) => import(pathToFileURL(modulePath).href)
+    });
+  } finally {
+    await unregister();
+  }
+};
+
+// src/cli.ts
 var usage = [
   "Usage:",
   "  nivel prepare [--root <path>]",
+  "  nivel init [--root <path>] [--force]",
   "",
   "Commands:",
-  "  prepare    Generate docs pages from pages/+docs.ts"
+  "  prepare    Generate docs pages from pages/+docs.ts",
+  "  init       Scaffold visible consumer files and standard docs scripts"
 ].join("\n");
 var parseCliArgs = (args) => {
   let command = null;
+  let force = false;
   let rootDir = process.cwd();
   for (let index = 0; index < args.length; index += 1) {
     const value = args[index];
     if (value === "--help" || value === "-h") {
       return {
         command: "help",
+        force,
         rootDir
       };
     }
@@ -34,6 +57,10 @@ var parseCliArgs = (args) => {
       index += 1;
       continue;
     }
+    if (value === "--force") {
+      force = true;
+      continue;
+    }
     if (value.startsWith("--")) {
       throw new Error(`Unknown option ${value}`);
     }
@@ -44,16 +71,24 @@ var parseCliArgs = (args) => {
   }
   return {
     command,
+    force,
     rootDir
   };
 };
 var runPrepare = async (rootDir) => {
-  const docsConfig = await loadDocsConfigWithVite(rootDir);
+  const docsConfig = await loadDocsConfigWithTsx(rootDir);
   syncGeneratedDocsPages({
     rootDir,
     docsConfig
   });
 };
+var runInit = (rootDir, force) => {
+  const result = initConsumer({
+    force,
+    rootDir
+  });
+  process.stdout.write(getInitSummary(result));
+};
 var runCli = async (args) => {
   const parsed = parseCliArgs(args);
   if (!parsed.command || parsed.command === "help") {
@@ -62,7 +97,11 @@ var runCli = async (args) => {
     return;
   }
   if (parsed.command !== "prepare") {
-    throw new Error(`Unknown command ${parsed.command}`);
+    if (parsed.command !== "init") {
+      throw new Error(`Unknown command ${parsed.command}`);
+    }
+    runInit(parsed.rootDir, parsed.force);
+    return;
   }
   await runPrepare(parsed.rootDir);
 };

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli.ts"],"sourcesContent":["import path from 'node:path'\nimport { syncGeneratedDocsPages } from './runtime/node/codegen.js'\nimport { loadDocsConfigWithVite } from './runtime/node/loadDocsConfig.js'\n\nconst usage = [\n  'Usage:',\n  '  nivel prepare [--root <path>]',\n  '',\n  'Commands:',\n  '  prepare    Generate docs pages from pages/+docs.ts',\n].join('\\n')\n\nconst parseCliArgs = (args: string[]) => {\n  let command: string | null = null\n  let rootDir = process.cwd()\n\n  for (let index = 0; index < args.length; index += 1) {\n    const value = args[index]\n\n    if (value === '--help' || value === '-h') {\n      return {\n        command: 'help',\n        rootDir,\n      }\n    }\n\n    if (value === '--root') {\n      const nextValue = args[index + 1]\n\n      if (!nextValue) {\n        throw new Error('Missing value for --root.')\n      }\n\n      rootDir = path.resolve(nextValue)\n      index += 1\n      continue\n    }\n\n    if (value.startsWith('--')) {\n      throw new Error(`Unknown option ${value}`)\n    }\n\n    if (command) {\n      throw new Error(`Unexpected argument ${value}`)\n    }\n\n    command = value\n  }\n\n  return {\n    command,\n    rootDir,\n  }\n}\n\nconst runPrepare = async (rootDir: string) => {\n  const docsConfig = await loadDocsConfigWithVite(rootDir)\n\n  syncGeneratedDocsPages({\n    rootDir,\n    docsConfig,\n  })\n}\n\nexport const runCli = async (args: string[]) => {\n  const parsed = parseCliArgs(args)\n\n  if (!parsed.command || parsed.command === 'help') {\n    process.stdout.write(`${usage}\\n`)\n    return\n  }\n\n  if (parsed.command !== 'prepare') {\n    throw new Error(`Unknown command ${parsed.command}`)\n  }\n\n  await runPrepare(parsed.rootDir)\n}\n\nvoid runCli(process.argv.slice(2)).catch((error: unknown) => {\n  const message = error instanceof Error ? (error.stack ?? error.message) : String(error)\n  process.stderr.write(`${message}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;;;;;;AAAA,OAAO,UAAU;AAIjB,IAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,eAAe,CAAC,SAAmB;AACvC,MAAI,UAAyB;AAC7B,MAAI,UAAU,QAAQ,IAAI;AAE1B,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,QAAQ,KAAK,KAAK;AAExB,QAAI,UAAU,YAAY,UAAU,MAAM;AACxC,aAAO;AAAA,QACL,SAAS;AAAA,QACT;AAAA,MACF;AAAA,IACF;AAEA,QAAI,UAAU,UAAU;AACtB,YAAM,YAAY,KAAK,QAAQ,CAAC;AAEhC,UAAI,CAAC,WAAW;AACd,cAAM,IAAI,MAAM,2BAA2B;AAAA,MAC7C;AAEA,gBAAU,KAAK,QAAQ,SAAS;AAChC,eAAS;AACT;AAAA,IACF;AAEA,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,YAAM,IAAI,MAAM,kBAAkB,KAAK,EAAE;AAAA,IAC3C;AAEA,QAAI,SAAS;AACX,YAAM,IAAI,MAAM,uBAAuB,KAAK,EAAE;AAAA,IAChD;AAEA,cAAU;AAAA,EACZ;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,EACF;AACF;AAEA,IAAM,aAAa,OAAO,YAAoB;AAC5C,QAAM,aAAa,MAAM,uBAAuB,OAAO;AAEvD,yBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEO,IAAM,SAAS,OAAO,SAAmB;AAC9C,QAAM,SAAS,aAAa,IAAI;AAEhC,MAAI,CAAC,OAAO,WAAW,OAAO,YAAY,QAAQ;AAChD,YAAQ,OAAO,MAAM,GAAG,KAAK;AAAA,CAAI;AACjC;AAAA,EACF;AAEA,MAAI,OAAO,YAAY,WAAW;AAChC,UAAM,IAAI,MAAM,mBAAmB,OAAO,OAAO,EAAE;AAAA,EACrD;AAEA,QAAM,WAAW,OAAO,OAAO;AACjC;AAEA,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,UAAmB;AAC3D,QAAM,UAAU,iBAAiB,QAAS,MAAM,SAAS,MAAM,UAAW,OAAO,KAAK;AACtF,UAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,UAAQ,WAAW;AACrB,CAAC;","names":[]}
+{"version":3,"sources":["../src/cli.ts","../src/runtime/node/loadDocsConfigWithTsx.ts"],"sourcesContent":["import path from 'node:path'\nimport { syncGeneratedDocsPages } from './runtime/node/codegen.js'\nimport { loadDocsConfigWithTsx } from './runtime/node/loadDocsConfigWithTsx.js'\nimport { getInitSummary, initConsumer } from './runtime/node/scaffold.js'\n\nconst usage = [\n  'Usage:',\n  '  nivel prepare [--root <path>]',\n  '  nivel init [--root <path>] [--force]',\n  '',\n  'Commands:',\n  '  prepare    Generate docs pages from pages/+docs.ts',\n  '  init       Scaffold visible consumer files and standard docs scripts',\n].join('\\n')\n\nconst parseCliArgs = (args: string[]) => {\n  let command: string | null = null\n  let force = false\n  let rootDir = process.cwd()\n\n  for (let index = 0; index < args.length; index += 1) {\n    const value = args[index]\n\n    if (value === '--help' || value === '-h') {\n      return {\n        command: 'help',\n        force,\n        rootDir,\n      }\n    }\n\n    if (value === '--root') {\n      const nextValue = args[index + 1]\n\n      if (!nextValue) {\n        throw new Error('Missing value for --root.')\n      }\n\n      rootDir = path.resolve(nextValue)\n      index += 1\n      continue\n    }\n\n    if (value === '--force') {\n      force = true\n      continue\n    }\n\n    if (value.startsWith('--')) {\n      throw new Error(`Unknown option ${value}`)\n    }\n\n    if (command) {\n      throw new Error(`Unexpected argument ${value}`)\n    }\n\n    command = value\n  }\n\n  return {\n    command,\n    force,\n    rootDir,\n  }\n}\n\nconst runPrepare = async (rootDir: string) => {\n  const docsConfig = await loadDocsConfigWithTsx(rootDir)\n\n  syncGeneratedDocsPages({\n    rootDir,\n    docsConfig,\n  })\n}\n\nconst runInit = (rootDir: string, force: boolean) => {\n  const result = initConsumer({\n    force,\n    rootDir,\n  })\n\n  process.stdout.write(getInitSummary(result))\n}\n\nexport const runCli = async (args: string[]) => {\n  const parsed = parseCliArgs(args)\n\n  if (!parsed.command || parsed.command === 'help') {\n    process.stdout.write(`${usage}\\n`)\n    return\n  }\n\n  if (parsed.command !== 'prepare') {\n    if (parsed.command !== 'init') {\n      throw new Error(`Unknown command ${parsed.command}`)\n    }\n\n    runInit(parsed.rootDir, parsed.force)\n    return\n  }\n\n  await runPrepare(parsed.rootDir)\n}\n\nvoid runCli(process.argv.slice(2)).catch((error: unknown) => {\n  const message = error instanceof Error ? (error.stack ?? error.message) : String(error)\n  process.stderr.write(`${message}\\n`)\n  process.exitCode = 1\n})\n","import { pathToFileURL } from 'node:url'\nimport { register } from 'tsx/esm/api'\nimport { loadDocsConfig } from './loadDocsConfig.js'\n\nexport const loadDocsConfigWithTsx = async (rootDir: string) => {\n  const unregister = register()\n\n  try {\n    return await loadDocsConfig({\n      rootDir,\n      loadModule: async (modulePath) => import(pathToFileURL(modulePath).href),\n    })\n  } finally {\n    await unregister()\n  }\n}\n"],"mappings":";;;;;;;;;;AAAA,OAAO,UAAU;;;ACAjB,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AAGlB,IAAM,wBAAwB,OAAO,YAAoB;AAC9D,QAAM,aAAa,SAAS;AAE5B,MAAI;AACF,WAAO,MAAM,eAAe;AAAA,MAC1B;AAAA,MACA,YAAY,OAAO,eAAe,OAAO,cAAc,UAAU,EAAE;AAAA,IACrE,CAAC;AAAA,EACH,UAAE;AACA,UAAM,WAAW;AAAA,EACnB;AACF;;;ADVA,IAAM,QAAQ;AAAA,EACZ;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,EAAE,KAAK,IAAI;AAEX,IAAM,eAAe,CAAC,SAAmB;AACvC,MAAI,UAAyB;AAC7B,MAAI,QAAQ;AACZ,MAAI,UAAU,QAAQ,IAAI;AAE1B,WAAS,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;AACnD,UAAM,QAAQ,KAAK,KAAK;AAExB,QAAI,UAAU,YAAY,UAAU,MAAM;AACxC,aAAO;AAAA,QACL,SAAS;AAAA,QACT;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,QAAI,UAAU,UAAU;AACtB,YAAM,YAAY,KAAK,QAAQ,CAAC;AAEhC,UAAI,CAAC,WAAW;AACd,cAAM,IAAI,MAAM,2BAA2B;AAAA,MAC7C;AAEA,gBAAU,KAAK,QAAQ,SAAS;AAChC,eAAS;AACT;AAAA,IACF;AAEA,QAAI,UAAU,WAAW;AACvB,cAAQ;AACR;AAAA,IACF;AAEA,QAAI,MAAM,WAAW,IAAI,GAAG;AAC1B,YAAM,IAAI,MAAM,kBAAkB,KAAK,EAAE;AAAA,IAC3C;AAEA,QAAI,SAAS;AACX,YAAM,IAAI,MAAM,uBAAuB,KAAK,EAAE;AAAA,IAChD;AAEA,cAAU;AAAA,EACZ;AAEA,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,IAAM,aAAa,OAAO,YAAoB;AAC5C,QAAM,aAAa,MAAM,sBAAsB,OAAO;AAEtD,yBAAuB;AAAA,IACrB;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,IAAM,UAAU,CAAC,SAAiB,UAAmB;AACnD,QAAM,SAAS,aAAa;AAAA,IAC1B;AAAA,IACA;AAAA,EACF,CAAC;AAED,UAAQ,OAAO,MAAM,eAAe,MAAM,CAAC;AAC7C;AAEO,IAAM,SAAS,OAAO,SAAmB;AAC9C,QAAM,SAAS,aAAa,IAAI;AAEhC,MAAI,CAAC,OAAO,WAAW,OAAO,YAAY,QAAQ;AAChD,YAAQ,OAAO,MAAM,GAAG,KAAK;AAAA,CAAI;AACjC;AAAA,EACF;AAEA,MAAI,OAAO,YAAY,WAAW;AAChC,QAAI,OAAO,YAAY,QAAQ;AAC7B,YAAM,IAAI,MAAM,mBAAmB,OAAO,OAAO,EAAE;AAAA,IACrD;AAEA,YAAQ,OAAO,SAAS,OAAO,KAAK;AACpC;AAAA,EACF;AAEA,QAAM,WAAW,OAAO,OAAO;AACjC;AAEA,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,UAAmB;AAC3D,QAAM,UAAU,iBAAiB,QAAS,MAAM,SAAS,MAAM,UAAW,OAAO,KAAK;AACtF,UAAQ,OAAO,MAAM,GAAG,OAAO;AAAA,CAAI;AACnC,UAAQ,WAAW;AACrB,CAAC;","names":[]}

package/dist/client.js

@@ -8,9 +8,9 @@ import {
   UserSettingsSync,
   applyThemePreference,
   useDocsUserSettingsStore
-} from "./chunk-UDOIFPCZ.js";
-import "./chunk-L6ZVB6XH.js";
+} from "./chunk-2EDJWL3U.js";
 import "./chunk-D7IAGT53.js";
+import "./chunk-L6ZVB6XH.js";
 import "./chunk-PYYPYIBD.js";
 export {
   AppLayout,

package/dist/config.d.ts

@@ -0,0 +1,6 @@
+import { g as DocsConfig, j as DocsGraph } from './types-j0kEkMA4.js';
+
+declare const defineDocsConfig: (config: DocsConfig) => DocsConfig;
+declare const defineDocsGraph: (graph: DocsGraph) => DocsGraph;
+
+export { defineDocsConfig, defineDocsGraph };

package/dist/config.js

@@ -0,0 +1,9 @@
+import {
+  defineDocsConfig,
+  defineDocsGraph
+} from "./chunk-JSZZPQEP.js";
+export {
+  defineDocsConfig,
+  defineDocsGraph
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentPropsWithoutRef, PropsWithChildren } from 'react';
+export { defineDocsConfig, defineDocsGraph } from './config.js';
 export { D as DocHeading, a as DocPageData, b as DocPageLinkData, c as DocsAlgoliaConfig, d as DocsAlgoliaFieldsConfig, e as DocsBrandConfig, f as DocsCollapsible, g as DocsConfig, h as DocsFooterConfig, i as DocsGlobalContextData, j as DocsGraph, k as DocsGroupNode, l as DocsHeadConfig, m as DocsPageNode, n as DocsPartnerConfig, o as DocsPartnersConfig, p as DocsSectionNode, q as DocsSidebarNode, r as DocsThemeConfig, J as JsonPrimitive, s as JsonValue, R as ResolvedDocsAlgoliaConfig, t as ResolvedDocsAlgoliaFieldsConfig, u as ResolvedDocsBrandConfig, v as ResolvedDocsConfig, w as ResolvedDocsPartnerConfig, x as ResolvedDocsPartnersConfig, y as ResolvedDocsSection, T as ThemePreference } from './types-j0kEkMA4.js';
 
 type AlertVariant = 'info' | 'warning' | 'error' | 'success';

package/dist/index.js

@@ -9,7 +9,11 @@ import {
   Pre,
   RepoLink,
   Table
-} from "./chunk-FARXFRHG.js";
+} from "./chunk-GHQDRDZL.js";
+import {
+  defineDocsConfig,
+  defineDocsGraph
+} from "./chunk-JSZZPQEP.js";
 import {
   UniversalMdxProvider,
   renderInlineMarkdown,
@@ -33,6 +37,8 @@ export {
   Table,
   UniversalMdxProvider,
   baseAssets,
+  defineDocsConfig,
+  defineDocsGraph,
   nivelAssetUrl,
   nivelPublicRoute,
   renderInlineMarkdown,

package/dist/mdx.js

@@ -9,7 +9,8 @@ import {
   Pre,
   RepoLink,
   Table
-} from "./chunk-FARXFRHG.js";
+} from "./chunk-GHQDRDZL.js";
+import "./chunk-JSZZPQEP.js";
 import "./chunk-L6ZVB6XH.js";
 import "./chunk-PYYPYIBD.js";
 

package/dist/mdx.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/mdx/index.ts"],"sourcesContent":["import type { ComponentType } from 'react'\nimport {\n  Alert,\n  ChoiceGroup,\n  CodeBlockTransformer,\n  FileAdded,\n  FileRemoved,\n  Link,\n  Overview,\n  Pre,\n  RepoLink,\n  Table,\n} from '../index.js'\n\ntype MdxComponents = Record<string, ComponentType<any> | string>\n\nexport const useMDXComponents = (components?: MdxComponents): MdxComponents => {\n  return {\n    Alert,\n    Link,\n    RepoLink,\n    Table,\n    Overview,\n    ChoiceGroup,\n    CodeBlockTransformer,\n    FileAdded,\n    FileRemoved,\n    pre: Pre,\n    ...components,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBO,IAAM,mBAAmB,CAAC,eAA8C;AAC7E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL;AACF;","names":[]}
+{"version":3,"sources":["../src/mdx/index.ts"],"sourcesContent":["import type { ComponentType } from 'react'\nimport {\n  Alert,\n  ChoiceGroup,\n  CodeBlockTransformer,\n  FileAdded,\n  FileRemoved,\n  Link,\n  Overview,\n  Pre,\n  RepoLink,\n  Table,\n} from '../index.js'\n\ntype MdxComponents = Record<string, ComponentType<any> | string>\n\nexport const useMDXComponents = (components?: MdxComponents): MdxComponents => {\n  return {\n    Alert,\n    Link,\n    RepoLink,\n    Table,\n    Overview,\n    ChoiceGroup,\n    CodeBlockTransformer,\n    FileAdded,\n    FileRemoved,\n    pre: Pre,\n    ...components,\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAgBO,IAAM,mBAAmB,CAAC,eAA8C;AAC7E,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL;AACF;","names":[]}

package/dist/runtime/client.js

@@ -8,9 +8,9 @@ import {
   UserSettingsSync,
   applyThemePreference,
   useDocsUserSettingsStore
-} from "../chunk-UDOIFPCZ.js";
-import "../chunk-L6ZVB6XH.js";
+} from "../chunk-2EDJWL3U.js";
 import "../chunk-D7IAGT53.js";
+import "../chunk-L6ZVB6XH.js";
 import "../chunk-PYYPYIBD.js";
 export {
   AppLayout,

package/dist/runtime/node.d.ts

@@ -1,6 +1,21 @@
 import { g as DocsConfig, z as ResolvedDocsPage, v as ResolvedDocsConfig } from '../types-j0kEkMA4.js';
 import { Plugin } from 'vite';
 
+type InitConsumerOptions = {
+    force: boolean;
+    rootDir: string;
+};
+type InitConsumerResult = {
+    allDependenciesPresent: boolean;
+    createdFiles: string[];
+    missingDependencies: string[];
+    overwrittenFiles: string[];
+    skippedFiles: string[];
+    updatedScripts: string[];
+};
+declare const getInitSummary: (result: InitConsumerResult) => string;
+declare const initConsumer: (options: InitConsumerOptions) => InitConsumerResult;
+
 declare const getGeneratedPagesRoot: (rootDir: string) => string;
 declare const syncGeneratedDocsPages: (options: {
     rootDir: string;
@@ -11,7 +26,6 @@ declare const loadDocsConfig: (options: {
     rootDir: string;
     loadModule: (modulePath: string) => Promise<unknown>;
 }) => Promise<DocsConfig>;
-declare const loadDocsConfigWithVite: (rootDir: string) => Promise<DocsConfig>;
 
 declare const nivelPagesPlugin: () => Plugin;
 
@@ -20,4 +34,4 @@ declare const getResolvedPageById: (config: {
     pages: ResolvedDocsPage[];
 }, pageId: string) => ResolvedDocsPage;
 
-export { getGeneratedPagesRoot, getResolvedPageById, loadDocsConfig, loadDocsConfigWithVite, nivelPagesPlugin, resolveDocsConfig, syncGeneratedDocsPages };
+export { getGeneratedPagesRoot, getInitSummary, getResolvedPageById, initConsumer, loadDocsConfig, nivelPagesPlugin, resolveDocsConfig, syncGeneratedDocsPages };

package/dist/runtime/node.js

@@ -1,12 +1,13 @@
 import {
   nivelPagesPlugin
-} from "../chunk-K5ZYRA3G.js";
+} from "../chunk-AURANIZE.js";
 import {
   getGeneratedPagesRoot,
+  getInitSummary,
+  initConsumer,
   loadDocsConfig,
-  loadDocsConfigWithVite,
   syncGeneratedDocsPages
-} from "../chunk-DNCQR5NH.js";
+} from "../chunk-67GE3PJ6.js";
 import {
   getResolvedPageById,
   resolveDocsConfig
@@ -14,9 +15,10 @@ import {
 import "../chunk-PYYPYIBD.js";
 export {
   getGeneratedPagesRoot,
+  getInitSummary,
   getResolvedPageById,
+  initConsumer,
   loadDocsConfig,
-  loadDocsConfigWithVite,
   nivelPagesPlugin,
   resolveDocsConfig,
   syncGeneratedDocsPages

package/dist/vike.d.ts

@@ -1,3 +1,6 @@
+import { Config } from 'vike/types';
+import { g as DocsConfig } from './types-j0kEkMA4.js';
+
 declare const nivelConfig: {
     meta: {
         docs: {
@@ -12,5 +15,6 @@ declare const nivelConfig: {
     trailingSlash: true;
     vite: Record<string, unknown>;
 };
+declare const createNivelVikeConfig: (docsConfig: DocsConfig) => Config;
 
-export { nivelConfig as default };
+export { createNivelVikeConfig, nivelConfig as default };

package/dist/vike.js

@@ -1,10 +1,10 @@
+import {
+  nivelPagesPlugin
+} from "./chunk-AURANIZE.js";
+import "./chunk-67GE3PJ6.js";
 import {
   getCodeBlockMdxPlugins
 } from "./chunk-Q7JU4J6A.js";
-import {
-  nivelPagesPlugin
-} from "./chunk-K5ZYRA3G.js";
-import "./chunk-DNCQR5NH.js";
 import {
   createHeadingSlugger,
   normalizeHeadingTitle
@@ -82,6 +82,13 @@ var viteConfig = {
     noExternal: ["@unterberg/nivel"]
   }
 };
+var getDefaultConsumerDataTheme = (docsConfig) => {
+  const defaultPreference = docsConfig.theme?.defaultPreference ?? "light";
+  const lightThemeName = docsConfig.theme?.light ?? "consumer-light";
+  const darkThemeName = docsConfig.theme?.dark ?? "consumer-dark";
+  return defaultPreference === "dark" ? darkThemeName : lightThemeName;
+};
+var vikeReactConfigImport = "import:vike-react/config:default";
 var nivelConfig = {
   meta: {
     docs: {
@@ -96,7 +103,21 @@ var nivelConfig = {
   trailingSlash: true,
   vite: viteConfig
 };
+var createNivelVikeConfig = (docsConfig) => {
+  return {
+    ...nivelConfig,
+    title: docsConfig.siteTitle,
+    description: docsConfig.siteDescription ?? `${docsConfig.siteTitle} documentation`,
+    extends: [vikeReactConfigImport],
+    htmlAttributes: {
+      "data-theme": getDefaultConsumerDataTheme(docsConfig)
+    },
+    passToClient: ["docs"],
+    prerender: true
+  };
+};
 export {
+  createNivelVikeConfig,
   nivelConfig as default
 };
 //# sourceMappingURL=vike.js.map

package/dist/vike.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/vike/index.ts","../src/mdx/plugins/rehypeDocsHeadings.ts"],"sourcesContent":["export { nivelConfig as default }\n\nimport mdx from '@mdx-js/rollup'\nimport remarkGfm from 'remark-gfm'\nimport type { Config } from 'vike/types'\nimport type { PluginOption, UserConfig } from 'vite'\nimport { getCodeBlockMdxPlugins } from '../mdx/code-blocks/index.js'\nimport { rehypeDocsHeadings } from '../mdx/plugins/rehypeDocsHeadings.js'\nimport { nivelPagesPlugin } from '../runtime/node/index.js'\n\nprocess.env.VIKE_CRAWL ??= JSON.stringify({ git: false })\n\nconst codeBlockMdxPlugins = getCodeBlockMdxPlugins()\n\nconst viteConfig: UserConfig = {\n  plugins: [\n    {\n      ...mdx({\n        providerImportSource: '@unterberg/nivel/mdx',\n        ...codeBlockMdxPlugins,\n        rehypePlugins: [...codeBlockMdxPlugins.rehypePlugins, rehypeDocsHeadings],\n        remarkPlugins: [remarkGfm, ...codeBlockMdxPlugins.remarkPlugins],\n      }),\n      enforce: 'pre',\n    } as PluginOption,\n    nivelPagesPlugin(),\n  ],\n  ssr: {\n    noExternal: ['@unterberg/nivel'],\n  },\n}\n\nconst nivelConfig = {\n  meta: {\n    docs: {\n      env: {\n        server: true,\n        client: true,\n      },\n      global: true,\n    },\n  },\n  prerender: true,\n  trailingSlash: true,\n  vite: viteConfig as Record<string, unknown>,\n} satisfies Config\n","import { visit } from 'unist-util-visit'\nimport { createHeadingSlugger, normalizeHeadingTitle } from '../../docs/docHeadings.js'\n\nconst headingTags = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6'])\n\nconst getNodeText = (node: any): string => {\n  if (!node || typeof node !== 'object') {\n    return ''\n  }\n\n  if (node.type === 'text') {\n    return typeof node.value === 'string' ? node.value : ''\n  }\n\n  if (Array.isArray(node.children)) {\n    return node.children.map((child: any) => getNodeText(child)).join('')\n  }\n\n  return ''\n}\n\nconst getClassNames = (value: unknown): string[] => {\n  if (Array.isArray(value)) {\n    return value.flatMap((entry) => getClassNames(entry))\n  }\n\n  if (typeof value === 'string') {\n    return value.split(/\\s+/).filter(Boolean)\n  }\n\n  return []\n}\n\nexport const rehypeDocsHeadings = () => {\n  return (tree: any) => {\n    const slugify = createHeadingSlugger()\n\n    visit(tree as any, 'element', (node: any) => {\n      if (!headingTags.has(node?.tagName)) {\n        return\n      }\n\n      const title = normalizeHeadingTitle(getNodeText(node))\n      if (!title) {\n        return\n      }\n\n      node.properties ??= {}\n\n      if (typeof node.properties.id !== 'string' || node.properties.id === '') {\n        node.properties.id = slugify(title)\n      }\n\n      const classNames = getClassNames(node.properties.className)\n      if (!classNames.includes('scroll-mt-24')) {\n        node.properties.className = [...classNames, 'scroll-mt-24']\n      }\n    })\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;AAEA,OAAO,SAAS;AAChB,OAAO,eAAe;;;ACHtB,SAAS,aAAa;AAGtB,IAAM,cAAc,oBAAI,IAAI,CAAC,MAAM,MAAM,MAAM,MAAM,MAAM,IAAI,CAAC;AAEhE,IAAM,cAAc,CAAC,SAAsB;AACzC,MAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AACrC,WAAO;AAAA,EACT;AAEA,MAAI,KAAK,SAAS,QAAQ;AACxB,WAAO,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ;AAAA,EACvD;AAEA,MAAI,MAAM,QAAQ,KAAK,QAAQ,GAAG;AAChC,WAAO,KAAK,SAAS,IAAI,CAAC,UAAe,YAAY,KAAK,CAAC,EAAE,KAAK,EAAE;AAAA,EACtE;AAEA,SAAO;AACT;AAEA,IAAM,gBAAgB,CAAC,UAA6B;AAClD,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,QAAQ,CAAC,UAAU,cAAc,KAAK,CAAC;AAAA,EACtD;AAEA,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,MAAM,MAAM,KAAK,EAAE,OAAO,OAAO;AAAA,EAC1C;AAEA,SAAO,CAAC;AACV;AAEO,IAAM,qBAAqB,MAAM;AACtC,SAAO,CAAC,SAAc;AACpB,UAAM,UAAU,qBAAqB;AAErC,UAAM,MAAa,WAAW,CAAC,SAAc;AAC3C,UAAI,CAAC,YAAY,IAAI,MAAM,OAAO,GAAG;AACnC;AAAA,MACF;AAEA,YAAM,QAAQ,sBAAsB,YAAY,IAAI,CAAC;AACrD,UAAI,CAAC,OAAO;AACV;AAAA,MACF;AAEA,WAAK,eAAe,CAAC;AAErB,UAAI,OAAO,KAAK,WAAW,OAAO,YAAY,KAAK,WAAW,OAAO,IAAI;AACvE,aAAK,WAAW,KAAK,QAAQ,KAAK;AAAA,MACpC;AAEA,YAAM,aAAa,cAAc,KAAK,WAAW,SAAS;AAC1D,UAAI,CAAC,WAAW,SAAS,cAAc,GAAG;AACxC,aAAK,WAAW,YAAY,CAAC,GAAG,YAAY,cAAc;AAAA,MAC5D;AAAA,IACF,CAAC;AAAA,EACH;AACF;;;ADjDA,QAAQ,IAAI,eAAe,KAAK,UAAU,EAAE,KAAK,MAAM,CAAC;AAExD,IAAM,sBAAsB,uBAAuB;AAEnD,IAAM,aAAyB;AAAA,EAC7B,SAAS;AAAA,IACP;AAAA,MACE,GAAG,IAAI;AAAA,QACL,sBAAsB;AAAA,QACtB,GAAG;AAAA,QACH,eAAe,CAAC,GAAG,oBAAoB,eAAe,kBAAkB;AAAA,QACxE,eAAe,CAAC,WAAW,GAAG,oBAAoB,aAAa;AAAA,MACjE,CAAC;AAAA,MACD,SAAS;AAAA,IACX;AAAA,IACA,iBAAiB;AAAA,EACnB;AAAA,EACA,KAAK;AAAA,IACH,YAAY,CAAC,kBAAkB;AAAA,EACjC;AACF;AAEA,IAAM,cAAc;AAAA,EAClB,MAAM;AAAA,IACJ,MAAM;AAAA,MACJ,KAAK;AAAA,QACH,QAAQ;AAAA,QACR,QAAQ;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,WAAW;AAAA,EACX,eAAe;AAAA,EACf,MAAM;AACR;","names":[]}
+{"version":3,"sources":["../src/vike/index.ts","../src/mdx/plugins/rehypeDocsHeadings.ts"],"sourcesContent":["export { nivelConfig as default }\n\nimport mdx from '@mdx-js/rollup'\nimport remarkGfm from 'remark-gfm'\nimport type { Config } from 'vike/types'\nimport type { PluginOption, UserConfig } from 'vite'\nimport type { DocsConfig } from '../docs/types.js'\nimport { getCodeBlockMdxPlugins } from '../mdx/code-blocks/index.js'\nimport { rehypeDocsHeadings } from '../mdx/plugins/rehypeDocsHeadings.js'\nimport { nivelPagesPlugin } from '../runtime/node/index.js'\n\nprocess.env.VIKE_CRAWL ??= JSON.stringify({ git: false })\n\nconst codeBlockMdxPlugins = getCodeBlockMdxPlugins()\n\nconst viteConfig: UserConfig = {\n  plugins: [\n    {\n      ...mdx({\n        providerImportSource: '@unterberg/nivel/mdx',\n        ...codeBlockMdxPlugins,\n        rehypePlugins: [...codeBlockMdxPlugins.rehypePlugins, rehypeDocsHeadings],\n        remarkPlugins: [remarkGfm, ...codeBlockMdxPlugins.remarkPlugins],\n      }),\n      enforce: 'pre',\n    } as PluginOption,\n    nivelPagesPlugin(),\n  ],\n  ssr: {\n    noExternal: ['@unterberg/nivel'],\n  },\n}\n\nconst getDefaultConsumerDataTheme = (docsConfig: DocsConfig) => {\n  const defaultPreference = docsConfig.theme?.defaultPreference ?? 'light'\n  const lightThemeName = docsConfig.theme?.light ?? 'consumer-light'\n  const darkThemeName = docsConfig.theme?.dark ?? 'consumer-dark'\n\n  return defaultPreference === 'dark' ? darkThemeName : lightThemeName\n}\n\nconst vikeReactConfigImport = 'import:vike-react/config:default'\n\nconst nivelConfig = {\n  meta: {\n    docs: {\n      env: {\n        server: true,\n        client: true,\n      },\n      global: true,\n    },\n  },\n  prerender: true,\n  trailingSlash: true,\n  vite: viteConfig as Record<string, unknown>,\n} satisfies Config\n\nexport const createNivelVikeConfig = (docsConfig: DocsConfig) => {\n  return {\n    ...nivelConfig,\n    title: docsConfig.siteTitle,\n    description: docsConfig.siteDescription ?? `${docsConfig.siteTitle} documentation`,\n    extends: [vikeReactConfigImport] as unknown as Config['extends'],\n    htmlAttributes: {\n      'data-theme': getDefaultConsumerDataTheme(docsConfig),\n    },\n    passToClient: ['docs'],\n    prerender: true,\n  } as Config\n}\n","import { visit } from 'unist-util-visit'\nimport { createHeadingSlugger, normalizeHeadingTitle } from '../../docs/docHeadings.js'\n\nconst headingTags = new Set(['h1', 'h2', 'h3', 'h4', 'h5', 'h6'])\n\nconst getNodeText = (node: any): string => {\n  if (!node || typeof node !== 'object') {\n    return ''\n  }\n\n  if (node.type === 'text') {\n    return typeof node.value === 'string' ? node.value : ''\n  }\n\n  if (Array.isArray(node.children)) {\n    return node.children.map((child: any) => getNodeText(child)).join('')\n  }\n\n  return ''\n}\n\nconst getClassNames = (value: unknown): string[] => {\n  if (Array.isArray(value)) {\n    return value.flatMap((entry) => getClassNames(entry))\n  }\n\n  if (typeof value === 'string') {\n    return value.split(/\\s+/).filter(Boolean)\n  }\n\n  return []\n}\n\nexport const rehypeDocsHeadings = () => {\n  return (tree: any) => {\n    const slugify = createHeadingSlugger()\n\n    visit(tree as any, 'element', (node: any) => {\n      if (!headingTags.has(node?.tagName)) {\n        return\n      }\n\n      const title = normalizeHeadingTitle(getNodeText(node))\n      if (!title) {\n        return\n      }\n\n      node.properties ??= {}\n\n      if (typeof node.properties.id !== 'string' || node.properties.id === '') {\n        node.properties.id = slugify(title)\n      }\n\n      const classNames = getClassNames(node.properties.className)\n      if (!classNames.includes('scroll-mt-24')) {\n        node.properties.className = [...classNames, 'scroll-mt-24']\n      }\n    })\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unterberg/nivel",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "type": "module",
   "sideEffects": false,
   "repository": {
@@ -31,6 +31,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./config": {
+      "types": "./dist/config.d.ts",
+      "import": "./dist/config.js"
+    },
     "./vike": {
       "types": "./dist/vike.d.ts",
       "import": "./dist/vike.js"
@@ -60,7 +64,7 @@
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
-    "test": "pnpm build && node --test tests/meta.test.mjs",
+    "test": "pnpm build && node --test tests/*.test.mjs",
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "dependencies": {
@@ -94,6 +98,6 @@
     "@types/react": "^19.1.12",
     "@types/react-dom": "^19.1.9",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.3"
+    "typescript": "^6.0.2"
   }
 }