svedocs-cli 0.1.0-beta.1 → 0.1.0-beta.2

package/dist/create-svedocs.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runCreateSvedocsCli
-} from "./chunk-QD6TB2KV.js";
+} from "./chunk-VMZTD7VT.js";
 
 // src/create-svedocs.ts
 var result = await runCreateSvedocsCli(process.argv.slice(2));

package/dist/index.d.ts

@@ -9,12 +9,15 @@ type PackageManagerName = 'pnpm' | 'npm' | 'yarn' | 'bun';
 
 interface CreateSvedocsRuntime {
     env?: NodeJS.ProcessEnv;
+    fetch?: typeof fetch;
     readPackageManagerVersion?: (name: PackageManagerName) => Promise<string | undefined>;
 }
 declare function renderCreateSvedocsHelp(): string;
 declare function runCreateSvedocsCli(args: string[], runtime?: CreateSvedocsRuntime): Promise<CliResult>;
 
+declare function renderUpgradeHelp(): string;
+
 declare function renderSvedocsHelp(): string;
 declare function runSvedocsCli(args: string[]): Promise<CliResult>;
 
-export { type CliResult, type CreateSvedocsRuntime, renderCreateSvedocsHelp, renderSvedocsHelp, runCreateSvedocsCli, runSvedocsCli };
+export { type CliResult, type CreateSvedocsRuntime, renderCreateSvedocsHelp, renderSvedocsHelp, renderUpgradeHelp, runCreateSvedocsCli, runSvedocsCli };

package/dist/index.js

@@ -1,12 +1,14 @@
 import {
   renderCreateSvedocsHelp,
   renderSvedocsHelp,
+  renderUpgradeHelp,
   runCreateSvedocsCli,
   runSvedocsCli
-} from "./chunk-QD6TB2KV.js";
+} from "./chunk-VMZTD7VT.js";
 export {
   renderCreateSvedocsHelp,
   renderSvedocsHelp,
+  renderUpgradeHelp,
   runCreateSvedocsCli,
   runSvedocsCli
 };

package/dist/svedocs.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   runSvedocsCli
-} from "./chunk-QD6TB2KV.js";
+} from "./chunk-VMZTD7VT.js";
 
 // src/svedocs.ts
 var result = await runSvedocsCli(process.argv.slice(2));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "svedocs-cli",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.2",
   "description": "CLI for the svedocs documentation framework.",
   "license": "MIT",
   "repository": {

package/templates/cloudflare/src/app.d.ts

@@ -10,6 +10,18 @@ declare module 'virtual:svedocs/pages' {
   export default pages;
 }
 
+declare module 'virtual:svedocs/page-index' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const pages: SvedocsPage[];
+  export default pages;
+}
+
+declare module 'virtual:svedocs/page-loaders' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const loaders: Record<string, () => Promise<{ default: SvedocsPage | undefined }>>;
+  export default loaders;
+}
+
 declare module 'virtual:svedocs/tree' {
   import type { SvedocsTreeItem } from 'svedocs/core';
   const tree: SvedocsTreeItem[];
@@ -22,6 +34,12 @@ declare module 'virtual:svedocs/search' {
   export default records;
 }
 
+declare module 'virtual:svedocs/search-loader' {
+  import type { SvedocsSearchRecord } from 'svedocs/core';
+  const loadSearch: () => Promise<SvedocsSearchRecord[]>;
+  export default loadSearch;
+}
+
 declare module 'virtual:svedocs/components' {
   import type { Component } from 'svelte';
   const components: Record<string, Component>;

package/templates/cloudflare/src/routes/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/cloudflare/src/routes/+page.ts

@@ -1,12 +1,24 @@
 import config from 'virtual:svedocs/config';
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
 
-export const load: PageLoad = () => {
-  return { page: pages.find((page) => page.routePath === '/'), pages, search, tree, config };
+export const load: PageLoad = async () => {
+  const pageIndex = pages.find((page) => page.routePath === '/');
+  const page = pageIndex ? await loadFullPage(pageIndex) : undefined;
+  return { page, pages: page ? mergeCurrentPage(pages, page) : pages, search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/cloudflare/src/routes/[...path]/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/cloudflare/src/routes/[...path]/+page.ts

@@ -1,9 +1,10 @@
 import { error } from '@sveltejs/kit';
 import config from 'virtual:svedocs/config';
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
@@ -14,9 +15,19 @@ export function entries() {
     .map((page) => ({ path: page.routePath.replace(/^\//, '') }));
 }
 
-export const load: PageLoad = ({ params }) => {
+export const load: PageLoad = async ({ params }) => {
   const routePath = `/${params.path ?? ''}`.replace(/\/$/, '') || '/';
-  const page = pages.find((item) => item.routePath === routePath);
-  if (!page) error(404, `No page found for ${routePath}`);
-  return { page, pages, search, tree, config };
+  const pageIndex = pages.find((item) => item.routePath === routePath);
+  if (!pageIndex) error(404, `No page found for ${routePath}`);
+  const page = await loadFullPage(pageIndex);
+  return { page, pages: mergeCurrentPage(pages, page), search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/cloudflare/svedocs.config.ts

@@ -6,6 +6,12 @@ export default defineConfig({
     title: 'svedocs cloudflare',
     description: 'Edge-first documentation powered by svedocs and Cloudflare Pages.'
   },
+  theme: {
+    palette: {
+      // Try "sky", "indigo", "rose", "amber", or any CSS color.
+      accent: 'emerald'
+    }
+  },
   search: {
     enabled: true,
     provider: 'cloudflare-ai-search'

package/templates/docs/src/app.d.ts

@@ -10,6 +10,18 @@ declare module 'virtual:svedocs/pages' {
   export default pages;
 }
 
+declare module 'virtual:svedocs/page-index' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const pages: SvedocsPage[];
+  export default pages;
+}
+
+declare module 'virtual:svedocs/page-loaders' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const loaders: Record<string, () => Promise<{ default: SvedocsPage | undefined }>>;
+  export default loaders;
+}
+
 declare module 'virtual:svedocs/tree' {
   import type { SvedocsTreeItem } from 'svedocs/core';
   const tree: SvedocsTreeItem[];
@@ -22,6 +34,12 @@ declare module 'virtual:svedocs/search' {
   export default records;
 }
 
+declare module 'virtual:svedocs/search-loader' {
+  import type { SvedocsSearchRecord } from 'svedocs/core';
+  const loadSearch: () => Promise<SvedocsSearchRecord[]>;
+  export default loadSearch;
+}
+
 declare module 'virtual:svedocs/components' {
   import type { Component } from 'svelte';
   const components: Record<string, Component>;

package/templates/docs/src/routes/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/docs/src/routes/+page.ts

@@ -1,12 +1,24 @@
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import config from 'virtual:svedocs/config';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
 
-export const load: PageLoad = () => {
-  return { page: pages.find((page) => page.routePath === '/'), pages, search, tree, config };
+export const load: PageLoad = async () => {
+  const pageIndex = pages.find((page) => page.routePath === '/');
+  const page = pageIndex ? await loadFullPage(pageIndex) : undefined;
+  return { page, pages: page ? mergeCurrentPage(pages, page) : pages, search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/docs/src/routes/[...path]/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/docs/src/routes/[...path]/+page.ts

@@ -1,9 +1,10 @@
 import { error } from '@sveltejs/kit';
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import config from 'virtual:svedocs/config';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
@@ -14,9 +15,19 @@ export function entries() {
     .map((page) => ({ path: page.routePath.replace(/^\//, '') }));
 }
 
-export const load: PageLoad = ({ params }) => {
+export const load: PageLoad = async ({ params }) => {
   const routePath = `/${params.path ?? ''}`.replace(/\/$/, '') || '/';
-  const page = pages.find((item) => item.routePath === routePath);
-  if (!page) error(404, `No page found for ${routePath}`);
-  return { page, pages, search, tree, config };
+  const pageIndex = pages.find((item) => item.routePath === routePath);
+  if (!pageIndex) error(404, `No page found for ${routePath}`);
+  const page = await loadFullPage(pageIndex);
+  return { page, pages: mergeCurrentPage(pages, page), search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/docs/svedocs.config.ts

@@ -6,6 +6,12 @@ export default defineConfig({
     title: 'My docs',
     description: 'Documentation built with svedocs'
   },
+  theme: {
+    palette: {
+      // Try "sky", "indigo", "rose", "amber", or any CSS color.
+      accent: 'emerald'
+    }
+  },
   source: {
     editBaseUrl: 'https://github.com/acme/my-docs/edit/main'
   }

package/templates/minimal/src/app.d.ts

@@ -10,6 +10,18 @@ declare module 'virtual:svedocs/pages' {
   export default pages;
 }
 
+declare module 'virtual:svedocs/page-index' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const pages: SvedocsPage[];
+  export default pages;
+}
+
+declare module 'virtual:svedocs/page-loaders' {
+  import type { SvedocsPage } from 'svedocs/core';
+  const loaders: Record<string, () => Promise<{ default: SvedocsPage | undefined }>>;
+  export default loaders;
+}
+
 declare module 'virtual:svedocs/tree' {
   import type { SvedocsTreeItem } from 'svedocs/core';
   const tree: SvedocsTreeItem[];
@@ -22,6 +34,12 @@ declare module 'virtual:svedocs/search' {
   export default records;
 }
 
+declare module 'virtual:svedocs/search-loader' {
+  import type { SvedocsSearchRecord } from 'svedocs/core';
+  const loadSearch: () => Promise<SvedocsSearchRecord[]>;
+  export default loadSearch;
+}
+
 declare module 'virtual:svedocs/components' {
   import type { Component } from 'svelte';
   const components: Record<string, Component>;

package/templates/minimal/src/routes/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/minimal/src/routes/+page.ts

@@ -1,12 +1,24 @@
 import config from 'virtual:svedocs/config';
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
 
-export const load: PageLoad = () => {
-  return { page: pages.find((page) => page.routePath === '/'), pages, search, tree, config };
+export const load: PageLoad = async () => {
+  const pageIndex = pages.find((page) => page.routePath === '/');
+  const page = pageIndex ? await loadFullPage(pageIndex) : undefined;
+  return { page, pages: page ? mergeCurrentPage(pages, page) : pages, search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/minimal/src/routes/[...path]/+page.svelte

@@ -2,7 +2,8 @@
   import { DocsApp } from 'svedocs/theme';
   import components from 'virtual:svedocs/components';
   import layouts from 'virtual:svedocs/layouts';
+  import loadSearch from 'virtual:svedocs/search-loader';
   export let data;
 </script>
 
-<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} />
+<DocsApp page={data.page} pages={data.pages} tree={data.tree} search={data.search} config={data.config} {components} {layouts} {loadSearch} />

package/templates/minimal/src/routes/[...path]/+page.ts

@@ -1,9 +1,10 @@
 import { error } from '@sveltejs/kit';
 import config from 'virtual:svedocs/config';
-import pages from 'virtual:svedocs/pages';
-import search from 'virtual:svedocs/search';
+import pageLoaders from 'virtual:svedocs/page-loaders';
+import pages from 'virtual:svedocs/page-index';
 import tree from 'virtual:svedocs/tree';
 import { svedocsPagePrerender } from 'svedocs/cloudflare';
+import type { SvedocsPage } from 'svedocs/core';
 import type { PageLoad } from './$types';
 
 export const prerender = svedocsPagePrerender();
@@ -14,9 +15,19 @@ export function entries() {
     .map((page) => ({ path: page.routePath.replace(/^\//, '') }));
 }
 
-export const load: PageLoad = ({ params }) => {
+export const load: PageLoad = async ({ params }) => {
   const routePath = `/${params.path ?? ''}`.replace(/\/$/, '') || '/';
-  const page = pages.find((item) => item.routePath === routePath);
-  if (!page) error(404, `No page found for ${routePath}`);
-  return { page, pages, search, tree, config };
+  const pageIndex = pages.find((item) => item.routePath === routePath);
+  if (!pageIndex) error(404, `No page found for ${routePath}`);
+  const page = await loadFullPage(pageIndex);
+  return { page, pages: mergeCurrentPage(pages, page), search: [], tree, config };
 };
+
+async function loadFullPage(page: SvedocsPage): Promise<SvedocsPage> {
+  const loaded = await pageLoaders[page.id]?.();
+  return loaded?.default ?? page;
+}
+
+function mergeCurrentPage(pages: SvedocsPage[], current: SvedocsPage): SvedocsPage[] {
+  return pages.map((page) => page.id === current.id ? current : page);
+}

package/templates/minimal/svedocs.config.ts

@@ -6,5 +6,11 @@ export default defineConfig({
     title: 'svedocs minimal',
     description: 'A minimal documentation site powered by svedocs.'
   },
+  theme: {
+    palette: {
+      // Try "sky", "indigo", "rose", "amber", or any CSS color.
+      accent: 'emerald'
+    }
+  },
   ai: false
 });