svedocs 0.1.0-beta.2 → 0.1.0-beta.4

package/README.md

@@ -7,7 +7,9 @@ Integrated SvelteKit documentation framework package.
 - `svedocs/config`: config schema and `defineConfig`.
 - `svedocs/core`: content manifest, scoped navigation, checks, search records, and shared types.
 - `svedocs/vite`: virtual modules and content refresh Vite plugin.
-- `svedocs/theme`: default Svelte theme components and Tailwind CSS v4 styles.
+- `svedocs/theme`: default Svelte theme components, replaceable theme component map, and Tailwind CSS v4 styles.
+- `svedocs/theme/headless`: unstyled theme behavior controllers for custom themes.
+- `svedocs/theme/types`: public theme component prop and component-map types.
 - `svedocs/svelte`: `mdsvex`-based Svelte-compatible authoring helpers.
 - `svedocs/search`: weighted local search, scope filters, Cloudflare AI Search provider, and indexing sync.
 - `svedocs/ai`: Ask AI providers, SSE responses, and rate limiting helpers.
@@ -16,6 +18,44 @@ Integrated SvelteKit documentation framework package.
 
 All rendering, theme, search, AI, SEO, OG, and Cloudflare capabilities are intentionally kept inside this package.
 
+## Theme Development
+
+The default theme is optional and replaceable. Import the full bundled CSS when you want the standard look:
+
+```svelte
+<script lang="ts">
+  import 'svedocs/theme/styles.css';
+</script>
+```
+
+Custom themes can import only `svedocs/theme/base.css` for reset, accessibility, prose, and code structure, or skip theme CSS entirely and own every style.
+
+Register replacement components in the Vite plugin, not `svedocs.config.ts`, because Svelte component paths are build-time imports:
+
+```ts
+import { svedocs } from 'svedocs/vite';
+import svedocsConfig from './svedocs.config';
+
+svedocs({
+  config: svedocsConfig,
+  theme: {
+    components: {
+      Navbar: '$lib/theme/Navbar.svelte',
+      Article: '$lib/theme/Article.svelte',
+      Search: '$lib/theme/Search.svelte',
+      AskAi: '$lib/theme/AskAi.svelte',
+      Error: '$lib/theme/Error.svelte'
+    }
+  }
+});
+```
+
+Generated routes import `virtual:svedocs/theme-components` and pass the map to `DocsApp`. You can replace broad page layouts such as `Root`, `Layout`, `Docs`, `Page`, `Home`, and `Error`, or smaller pieces such as `Navbar`, `Sidebar`, `Article`, `Toc`, `Search`, `AskAi`, `Footer`, `ThemeToggle`, `PageTools`, and `RenderError`.
+
+Use `svedocs/theme/types` for stable props and `svedocs/theme/headless` for unstyled behavior controllers such as search, Ask AI, ToC tracking, theme mode, mobile nav, page tools, and code-copy behavior. Replacement page layouts should keep passing `pages`, `tree`, `search`, `config`, `loadSearch`, and `themeComponents` into nested default components so navigation highlighting, mobile menus, and runtime panels stay connected.
+
+Generated templates include `src/routes/+error.svelte`. Register `theme.components.Error` to customize full-route error pages and `theme.components.RenderError` to customize local render-boundary failures inside layouts, articles, and tools.
+
 ## MDX/SVX Components
 
 The Vite plugin loads `svedocs.config.ts` by default. You can also pass a config object explicitly and register shared authoring components or layouts:
@@ -31,8 +71,15 @@ svedocs({
   },
   layouts: {
     feature: '$lib/FeatureLayout.svelte'
+  },
+  theme: {
+    components: {
+      Navbar: '$lib/theme/Navbar.svelte',
+      Article: '$lib/theme/Article.svelte'
+    }
   }
 })
 ```
 
 `.svx` and `.mdx` files can then use `<Callout />` without local imports.
+Registered theme components are exposed through `virtual:svedocs/theme-components` and can replace default navigation, article, search, Ask AI, ToC, and footer rendering.

package/dist/ai/providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/ai/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,WAAW,EAGX,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,IAAI,UAAU,CAajD;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,UAAU,CAsFb;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,EAAE,EAAE,0BAA0B,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,UAAU,CA2Bb;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAI,GACR,WAAW,EAAE,CAMf;AAED,eAAO,MAAM,cAAc,YAAyB,CAAC"}
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../../src/ai/providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAItD,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,WAAW,EAGX,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAEpB,wBAAgB,oBAAoB,IAAI,UAAU,CAajD;AAED,wBAAgB,kCAAkC,CAAC,KAAK,EAAE;IACxD,OAAO,EAAE,eAAe,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,UAAU,CAuDb;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,EAAE,EAAE,0BAA0B,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GAAG,UAAU,CA2Bb;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,mBAAmB,EAAE,EAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAI,GACR,WAAW,EAAE,CAMf;AAED,eAAO,MAAM,cAAc,YAAyB,CAAC"}

package/dist/ai/providers.js

@@ -1,5 +1,5 @@
-import { normalizeCloudflareAiSearchResults } from '../search/cloudflare.js';
-import { searchRecords } from '../search.js';
+import { createCloudflareAiSearchScopeFilters, normalizeCloudflareAiSearchResults } from '../search/cloudflare.js';
+import { matchesSearchScope, searchRecords } from '../search.js';
 export function createMockAiProvider() {
     return {
         name: 'mock',
@@ -24,44 +24,24 @@ export function createCloudflareAiSearchAiProvider(input) {
             const result = await instance.search({
                 messages: conversation,
                 ai_search_options: {
-                    retrieval: {
-                        retrieval_type: 'hybrid',
-                        max_num_results: maxResults
-                    }
+                    retrieval: createCloudflareAiSearchRetrieval(maxResults, question.scope)
                 }
             });
             return {
                 answer: result.response ?? result.answer ?? 'No answer was returned.',
-                citations: normalizeCloudflareAiSearchResults(result, question.question)
-                    .slice(0, maxResults)
-                    .map((result) => ({
-                    title: result.title,
-                    url: result.url,
-                    ...(result.section ? { section: result.section } : {})
-                }))
+                citations: createCloudflareAiSearchCitations(result, question, maxResults)
             };
         }
         const result = await instance.chatCompletions({
             messages: conversation,
             ...(input.model ? { model: input.model } : {}),
             ai_search_options: {
-                retrieval: {
-                    retrieval_type: 'hybrid',
-                    max_num_results: maxResults
-                }
+                retrieval: createCloudflareAiSearchRetrieval(maxResults, question.scope)
             }
         });
         return {
             answer: readAiSearchAnswer(result),
-            citations: normalizeCitations(result.citations).length > 0
-                ? normalizeCitations(result.citations)
-                : normalizeCloudflareAiSearchResults(result, question.question)
-                    .slice(0, maxResults)
-                    .map((result) => ({
-                    title: result.title,
-                    url: result.url,
-                    ...(result.section ? { section: result.section } : {})
-                }))
+            citations: readCloudflareAiSearchCitations(result, question, maxResults)
         };
     }
     return {
@@ -77,25 +57,14 @@ export function createCloudflareAiSearchAiProvider(input) {
                 ...(input.model ? { model: input.model } : {}),
                 stream: true,
                 ai_search_options: {
-                    retrieval: {
-                        retrieval_type: 'hybrid',
-                        max_num_results: maxResults
-                    }
+                    retrieval: createCloudflareAiSearchRetrieval(maxResults, question.scope)
                 }
             });
             if (result instanceof Response || result instanceof ReadableStream)
                 return result;
             return createSvedocsAnswerStream({
                 answer: readAiSearchAnswer(result),
-                citations: normalizeCitations(result.citations).length > 0
-                    ? normalizeCitations(result.citations)
-                    : normalizeCloudflareAiSearchResults(result, question.question)
-                        .slice(0, maxResults)
-                        .map((result) => ({
-                        title: result.title,
-                        url: result.url,
-                        ...(result.section ? { section: result.section } : {})
-                    }))
+                citations: readCloudflareAiSearchCitations(result, question, maxResults)
             });
         }
     };
@@ -157,6 +126,35 @@ function normalizeCitations(citations) {
         ...(citation.section ? { section: citation.section } : {})
     }));
 }
+function createCloudflareAiSearchRetrieval(maxResults, scope) {
+    const filters = createCloudflareAiSearchScopeFilters(scope);
+    return {
+        retrieval_type: 'hybrid',
+        max_num_results: maxResults,
+        ...(filters ? { filters } : {})
+    };
+}
+function readCloudflareAiSearchCitations(result, input, maxResults) {
+    const scopedCitations = createCloudflareAiSearchCitations(result, input, maxResults);
+    const citations = normalizeCitations(result.citations);
+    if (hasSearchScope(input.scope)) {
+        return scopedCitations.length > 0 ? scopedCitations : citations.slice(0, maxResults);
+    }
+    return citations.length > 0 ? citations.slice(0, maxResults) : scopedCitations;
+}
+function createCloudflareAiSearchCitations(result, input, maxResults) {
+    return normalizeCloudflareAiSearchResults(result, input.question)
+        .filter((searchResult) => matchesSearchScope({ metadata: searchResult.metadata }, input.scope))
+        .slice(0, maxResults)
+        .map((searchResult) => ({
+        title: searchResult.title,
+        url: searchResult.url,
+        ...(searchResult.section ? { section: searchResult.section } : {})
+    }));
+}
+function hasSearchScope(scope) {
+    return Boolean(scope?.locale || scope?.kind);
+}
 function readAiSearchAnswer(result) {
     return (result.response ??
         result.answer ??

package/dist/ai/runtime.d.ts

@@ -18,6 +18,8 @@ export interface CreateConfiguredAiProviderOptions {
     config: Pick<SvedocsResolvedConfig, 'ai' | 'cloudflare'>;
     env?: SvedocsAiRuntimeEnv;
     provider?: string;
+    systemPrompt?: string;
+    maxResults?: number;
     fetch?: typeof fetch;
 }
 export interface CreateConfiguredAskResponseOptions extends Omit<CreateAskResponseOptions, 'records'> {

package/dist/ai/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/ai/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAG5F,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,EAAE,0BAA0B,GAAG,2BAA2B,GAAG,SAAS,CAAC;IACzF,EAAE,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAC5C,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,6BAA6B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,iCAAiC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,kCAAkC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxD,+BAA+B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,qCAAqC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC;IACzD,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kCAAmC,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC;IACnG,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,UAAU,CA4CjG;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,EACxD,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,QAAQ,CAAC,CAcnB"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/ai/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAG5F,OAAO,KAAK,EAAE,UAAU,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAGnG,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,CAAC,EAAE,0BAA0B,GAAG,2BAA2B,GAAG,SAAS,CAAC;IACzF,EAAE,CAAC,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAC5C,yBAAyB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/C,0BAA0B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,uBAAuB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,6BAA6B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnD,iCAAiC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACvD,kCAAkC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxD,+BAA+B,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrD,qCAAqC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,CAAC;IACzD,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,kCAAmC,SAAQ,IAAI,CAAC,wBAAwB,EAAE,SAAS,CAAC;IACnG,GAAG,CAAC,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,iCAAiC,GAAG,UAAU,CA6CjG;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,YAAY,CAAC,EACxD,OAAO,EAAE,mBAAmB,EAAE,EAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kCAAuC,GAC/C,OAAO,CAAC,QAAQ,CAAC,CAkBnB"}

package/dist/ai/runtime.js

@@ -5,8 +5,8 @@ export function createConfiguredAiProvider(options) {
     const provider = normalizeProviderName(options.provider ?? options.config.ai.provider);
     if (!options.config.ai.enabled)
         return createMockAiProvider();
-    const systemPrompt = options.config.ai.systemPrompt;
-    const maxResults = options.config.ai.maxResults;
+    const systemPrompt = options.systemPrompt ?? options.config.ai.systemPrompt;
+    const maxResults = options.maxResults ?? options.config.ai.maxResults;
     if (provider === 'cloudflare-workers-ai') {
         const ai = readWorkersAiBinding(options.env);
         if (ai)
@@ -41,6 +41,7 @@ export function createConfiguredAiProvider(options) {
                 ...(baseUrl ? { baseUrl } : {}),
                 ...(typeof temperature === 'number' ? { temperature } : {}),
                 ...(systemPrompt ? { systemPrompt } : {}),
+                ...(typeof maxResults === 'number' ? { citationLimit: maxResults } : {}),
                 ...(options.fetch ? { fetch: options.fetch } : {})
             });
         }
@@ -52,6 +53,8 @@ export function createConfiguredAskResponse(config, records, request, options =
     const provider = createConfiguredAiProvider({
         config,
         ...(options.provider ? { provider: options.provider } : {}),
+        ...(options.systemPrompt ? { systemPrompt: options.systemPrompt } : {}),
+        ...(typeof options.maxResults === 'number' ? { maxResults: options.maxResults } : {}),
         ...(options.env ? { env: options.env } : {}),
         ...(options.fetch ? { fetch: options.fetch } : {})
     });
@@ -60,7 +63,9 @@ export function createConfiguredAskResponse(config, records, request, options =
         ...(typeof options.stream === 'boolean' ? { stream: options.stream } : {}),
         ...(options.scope ? { scope: options.scope } : {}),
         ...(options.rateLimiter ? { rateLimiter: options.rateLimiter } : {}),
-        ...(options.rateLimitKey ? { rateLimitKey: options.rateLimitKey } : {})
+        ...(options.rateLimitKey ? { rateLimitKey: options.rateLimitKey } : {}),
+        ...(options.systemPrompt ? { systemPrompt: options.systemPrompt } : {}),
+        ...(typeof options.maxResults === 'number' ? { maxResults: options.maxResults } : {})
     });
 }
 function readCloudflareAiSearchBinding(env, config) {

package/dist/cloudflare.d.ts

@@ -1,6 +1,7 @@
 import type { SvedocsResolvedConfig } from './core.js';
 export type SvedocsBuildMode = 'edge' | 'static' | 'spa';
 export type SvedocsPagePrerenderOption = true | false | 'auto';
+export type SvedocsTrailingSlashOption = 'always' | 'never' | 'ignore';
 export interface CloudflareBindingShape {
     AI?: unknown;
     SVEDOCS_AI_SEARCH?: unknown;
@@ -18,6 +19,7 @@ export declare function createCloudflarePreset(mode?: SvedocsBuildMode): Cloudfl
 export declare function readSvedocsBuildMode(value?: string | undefined): SvedocsBuildMode;
 export declare function svedocsSsr(mode?: SvedocsBuildMode): boolean;
 export declare function svedocsPagePrerender(mode?: SvedocsBuildMode): SvedocsPagePrerenderOption;
+export declare function svedocsTrailingSlash(mode?: SvedocsBuildMode): SvedocsTrailingSlashOption;
 export declare function createWranglerJson(config: SvedocsResolvedConfig): Record<string, unknown>;
 export declare function createWranglerJsonc(config: SvedocsResolvedConfig): string;
 export declare function createWranglerToml(config: SvedocsResolvedConfig): string;

package/dist/cloudflare.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,0BAA0B,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,8BAA8B,GAAG,0BAA0B,CAAC;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,gBAAyB,GAAG,qBAAqB,CAwB7F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,qBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,UAAU,CAAC,IAAI,mBAAyB,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,mBAAyB,GAAG,0BAA0B,CAG9F;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgCxE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAe5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE9E"}
+{"version":3,"file":"cloudflare.d.ts","sourceRoot":"","sources":["../src/cloudflare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,0BAA0B,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,0BAA0B,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEvE,MAAM,WAAW,sBAAsB;IACrC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,8BAA8B,GAAG,0BAA0B,CAAC;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,GAAE,gBAAyB,GAAG,qBAAqB,CAwB7F;AAED,wBAAgB,oBAAoB,CAAC,KAAK,qBAA4B,GAAG,gBAAgB,CAExF;AAED,wBAAgB,UAAU,CAAC,IAAI,mBAAyB,GAAG,OAAO,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,mBAAyB,GAAG,0BAA0B,CAG9F;AAED,wBAAgB,oBAAoB,CAAC,IAAI,mBAAyB,GAAG,0BAA0B,CAE9F;AAMD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkCzF;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAEzE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAgCxE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAe5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAG7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE9E"}

package/dist/cloudflare.js

@@ -34,6 +34,9 @@ export function svedocsPagePrerender(mode = readSvedocsBuildMode()) {
         return true;
     return 'auto';
 }
+export function svedocsTrailingSlash(mode = readSvedocsBuildMode()) {
+    return mode === 'static' || mode === 'spa' ? 'always' : 'never';
+}
 function readSvedocsBuildModeEnv() {
     return typeof process !== 'undefined' ? process.env.SVEDOCS_BUILD_MODE : undefined;
 }

package/dist/config.d.ts

@@ -1,13 +1,16 @@
 import { z } from 'zod';
 import type { SvedocsResolvedConfig } from './core.js';
+import type { SvedocsMessages, SvedocsSeoHead } from './core/types.js';
 import type { OgTemplate } from './og/types.js';
 export interface SvedocsNavItem {
     label: string;
+    labelKey?: string;
     href: string;
     external?: boolean;
 }
 export interface SvedocsThemeBrand {
     label?: string;
+    labelKey?: string;
     href?: string;
     logo?: string;
     mark?: 'pixel' | false;
@@ -28,21 +31,25 @@ export interface SvedocsThemeCodeTheme {
 export interface SvedocsThemeCode {
     lineNumbers?: boolean;
     wrap?: boolean;
+    copyButton?: boolean;
 }
 export interface SvedocsShikiOptions {
     transformers?: unknown[];
 }
 export interface SvedocsThemeHomeAction {
     label: string;
+    labelKey?: string;
     href: string;
 }
 export interface SvedocsThemeHomeVisual {
     type?: 'pixel' | 'image';
     src?: string;
     alt?: string;
+    altKey?: string;
 }
 export interface SvedocsThemeHome {
     kicker?: string;
+    kickerKey?: string;
     primaryAction?: SvedocsThemeHomeAction;
     secondaryAction?: SvedocsThemeHomeAction;
     visual?: SvedocsThemeHomeVisual;
@@ -107,6 +114,7 @@ export interface SvedocsConfig {
         sitemap?: boolean;
         robots?: boolean;
         defaultAuthor?: string;
+        head?: SvedocsSeoHead;
         ogImage?: false | {
             template?: 'default' | string | OgTemplate;
             format?: 'svg' | 'png';
@@ -137,8 +145,11 @@ export interface SvedocsConfig {
             code: string;
             label?: string;
             path?: string;
+            hreflang?: string;
+            dir?: 'ltr' | 'rtl';
         }>;
         prefixDefaultLocale?: boolean;
+        messages?: Record<string, Partial<SvedocsMessages>>;
     };
 }
 export type { SvedocsResolvedConfig };
@@ -186,20 +197,24 @@ export declare const svedocsConfigSchema: z.ZodObject<{
         code: z.ZodOptional<z.ZodObject<{
             lineNumbers: z.ZodOptional<z.ZodBoolean>;
             wrap: z.ZodOptional<z.ZodBoolean>;
+            copyButton: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>;
         brand: z.ZodOptional<z.ZodObject<{
             label: z.ZodOptional<z.ZodString>;
+            labelKey: z.ZodOptional<z.ZodString>;
             href: z.ZodOptional<z.ZodString>;
             logo: z.ZodOptional<z.ZodString>;
             mark: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"pixel">, z.ZodLiteral<false>]>>;
         }, z.core.$strip>>;
         nav: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
+            labelKey: z.ZodOptional<z.ZodString>;
             href: z.ZodString;
             external: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
         social: z.ZodOptional<z.ZodArray<z.ZodObject<{
             label: z.ZodString;
+            labelKey: z.ZodOptional<z.ZodString>;
             href: z.ZodString;
             external: z.ZodOptional<z.ZodBoolean>;
         }, z.core.$strip>>>;
@@ -207,18 +222,22 @@ export declare const svedocsConfigSchema: z.ZodObject<{
             text: z.ZodOptional<z.ZodString>;
             links: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 label: z.ZodString;
+                labelKey: z.ZodOptional<z.ZodString>;
                 href: z.ZodString;
                 external: z.ZodOptional<z.ZodBoolean>;
             }, z.core.$strip>>>;
         }, z.core.$strip>]>>;
         home: z.ZodOptional<z.ZodObject<{
             kicker: z.ZodOptional<z.ZodString>;
+            kickerKey: z.ZodOptional<z.ZodString>;
             primaryAction: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
+                labelKey: z.ZodOptional<z.ZodString>;
                 href: z.ZodString;
             }, z.core.$strip>>;
             secondaryAction: z.ZodOptional<z.ZodObject<{
                 label: z.ZodString;
+                labelKey: z.ZodOptional<z.ZodString>;
                 href: z.ZodString;
             }, z.core.$strip>>;
             visual: z.ZodOptional<z.ZodObject<{
@@ -228,6 +247,7 @@ export declare const svedocsConfigSchema: z.ZodObject<{
                 }>>;
                 src: z.ZodOptional<z.ZodString>;
                 alt: z.ZodOptional<z.ZodString>;
+                altKey: z.ZodOptional<z.ZodString>;
             }, z.core.$strip>>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
@@ -264,6 +284,29 @@ export declare const svedocsConfigSchema: z.ZodObject<{
         sitemap: z.ZodOptional<z.ZodBoolean>;
         robots: z.ZodOptional<z.ZodBoolean>;
         defaultAuthor: z.ZodOptional<z.ZodString>;
+        head: z.ZodOptional<z.ZodObject<{
+            meta: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodOptional<z.ZodString>;
+                property: z.ZodOptional<z.ZodString>;
+                httpEquiv: z.ZodOptional<z.ZodString>;
+                itemprop: z.ZodOptional<z.ZodString>;
+                content: z.ZodString;
+            }, z.core.$strip>>>;
+            links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                rel: z.ZodString;
+                href: z.ZodString;
+                hreflang: z.ZodOptional<z.ZodString>;
+                type: z.ZodOptional<z.ZodString>;
+                media: z.ZodOptional<z.ZodString>;
+                title: z.ZodOptional<z.ZodString>;
+                sizes: z.ZodOptional<z.ZodString>;
+                as: z.ZodOptional<z.ZodString>;
+                crossorigin: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            jsonLd: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            jsonld: z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+            'json-ld': z.ZodOptional<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        }, z.core.$strip>>;
         ogImage: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
             template: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodCustom<OgTemplate, OgTemplate>]>>;
             format: z.ZodOptional<z.ZodEnum<{
@@ -300,8 +343,14 @@ export declare const svedocsConfigSchema: z.ZodObject<{
             code: z.ZodString;
             label: z.ZodOptional<z.ZodString>;
             path: z.ZodOptional<z.ZodString>;
+            hreflang: z.ZodOptional<z.ZodString>;
+            dir: z.ZodOptional<z.ZodEnum<{
+                ltr: "ltr";
+                rtl: "rtl";
+            }>>;
         }, z.core.$strip>]>>>;
         prefixDefaultLocale: z.ZodOptional<z.ZodBoolean>;
+        messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>;
     }, z.core.$strip>]>>;
 }, z.core.$strip>;
 export declare function defineConfig(config: SvedocsConfig): SvedocsConfig;

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/config.js

@@ -1,3 +1,4 @@
+import { access } from 'node:fs/promises';
 import { pathToFileURL } from 'node:url';
 import { z } from 'zod';
 import { resolveSvedocsConfig } from './core.js';
@@ -53,12 +54,14 @@ export const svedocsConfigSchema = z.object({
         code: z
             .object({
             lineNumbers: z.boolean().optional(),
-            wrap: z.boolean().optional()
+            wrap: z.boolean().optional(),
+            copyButton: z.boolean().optional()
         })
             .optional(),
         brand: z
             .object({
             label: z.string().optional(),
+            labelKey: z.string().optional(),
             href: z.string().optional(),
             logo: z.string().optional(),
             mark: z.union([z.literal('pixel'), z.literal(false)]).optional()
@@ -67,6 +70,7 @@ export const svedocsConfigSchema = z.object({
         nav: z
             .array(z.object({
             label: z.string(),
+            labelKey: z.string().optional(),
             href: z.string(),
             external: z.boolean().optional()
         }))
@@ -74,6 +78,7 @@ export const svedocsConfigSchema = z.object({
         social: z
             .array(z.object({
             label: z.string(),
+            labelKey: z.string().optional(),
             href: z.string(),
             external: z.boolean().optional()
         }))
@@ -86,6 +91,7 @@ export const svedocsConfigSchema = z.object({
                 links: z
                     .array(z.object({
                     label: z.string(),
+                    labelKey: z.string().optional(),
                     href: z.string(),
                     external: z.boolean().optional()
                 }))
@@ -96,15 +102,18 @@ export const svedocsConfigSchema = z.object({
         home: z
             .object({
             kicker: z.string().optional(),
+            kickerKey: z.string().optional(),
             primaryAction: z
                 .object({
                 label: z.string(),
+                labelKey: z.string().optional(),
                 href: z.string()
             })
                 .optional(),
             secondaryAction: z
                 .object({
                 label: z.string(),
+                labelKey: z.string().optional(),
                 href: z.string()
             })
                 .optional(),
@@ -112,7 +121,8 @@ export const svedocsConfigSchema = z.object({
                 .object({
                 type: z.enum(['pixel', 'image']).optional(),
                 src: z.string().optional(),
-                alt: z.string().optional()
+                alt: z.string().optional(),
+                altKey: z.string().optional()
             })
                 .optional()
         })
@@ -161,6 +171,35 @@ export const svedocsConfigSchema = z.object({
         sitemap: z.boolean().optional(),
         robots: z.boolean().optional(),
         defaultAuthor: z.string().optional(),
+        head: z
+            .object({
+            meta: z
+                .array(z.object({
+                name: z.string().optional(),
+                property: z.string().optional(),
+                httpEquiv: z.string().optional(),
+                itemprop: z.string().optional(),
+                content: z.string()
+            }))
+                .optional(),
+            links: z
+                .array(z.object({
+                rel: z.string(),
+                href: z.string(),
+                hreflang: z.string().optional(),
+                type: z.string().optional(),
+                media: z.string().optional(),
+                title: z.string().optional(),
+                sizes: z.string().optional(),
+                as: z.string().optional(),
+                crossorigin: z.string().optional()
+            }))
+                .optional(),
+            jsonLd: z.array(z.record(z.string(), z.unknown())).optional(),
+            jsonld: z.array(z.record(z.string(), z.unknown())).optional(),
+            'json-ld': z.array(z.record(z.string(), z.unknown())).optional()
+        })
+            .optional(),
         ogImage: z
             .union([
             z.literal(false),
@@ -210,11 +249,14 @@ export const svedocsConfigSchema = z.object({
                 z.object({
                     code: z.string(),
                     label: z.string().optional(),
-                    path: z.string().optional()
+                    path: z.string().optional(),
+                    hreflang: z.string().optional(),
+                    dir: z.enum(['ltr', 'rtl']).optional()
                 })
             ]))
                 .optional(),
-            prefixDefaultLocale: z.boolean().optional()
+            prefixDefaultLocale: z.boolean().optional(),
+            messages: z.record(z.string(), z.record(z.string(), z.string())).optional()
         })
     ])
         .optional()
@@ -226,18 +268,21 @@ export function loadSvedocsConfig(config = {}) {
     return resolveSvedocsConfig(validateSvedocsConfig(config));
 }
 export function validateSvedocsConfig(config) {
-    return svedocsConfigSchema.parse(config);
+    const validated = svedocsConfigSchema.parse(config);
+    resolveSvedocsConfig(validated);
+    return validated;
 }
 export async function loadSvedocsConfigFile(configFile, fallback = {}) {
     try {
-        const module = await import(pathToFileURL(configFile).href);
-        return loadSvedocsConfig((module.default ?? module.config ?? fallback));
+        await access(configFile);
     }
     catch (error) {
         const code = typeof error === 'object' && error && 'code' in error ? error.code : undefined;
-        if (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND') {
+        if (code === 'ENOENT' || code === 'ENOTDIR') {
             return loadSvedocsConfig(fallback);
         }
         throw error;
     }
+    const module = await import(pathToFileURL(configFile).href);
+    return loadSvedocsConfig((module.default ?? module.config ?? fallback));
 }

package/dist/core/checks.js

@@ -68,9 +68,9 @@ function createMissingTranslationIssues(manifest) {
         return [];
     const groups = new Map();
     for (const page of manifest.pages) {
-        if (page.hidden || page.kind !== 'doc')
+        if (page.hidden)
             continue;
-        const key = page.scopePath;
+        const key = `${page.kind}:${page.scopePath}`;
         const group = groups.get(key) ?? [];
         group.push(page);
         groups.set(key, group);

package/dist/core/config.d.ts

@@ -1,5 +1,6 @@
 import type { SvedocsConfig } from '../config.js';
 import type { SvedocsResolvedConfig } from './types.js';
+export { defaultSvedocsMessages } from './i18n.js';
 export declare function resolveSvedocsConfig(config?: SvedocsConfig): SvedocsResolvedConfig;
 export declare function isResolvedConfig(config: SvedocsConfig | SvedocsResolvedConfig | undefined): config is SvedocsResolvedConfig;
 //# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAiB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEvE,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,aAAkB,GAAG,qBAAqB,CAmItF;AAeD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,qBAAqB,GAAG,SAAS,GAAG,MAAM,IAAI,qBAAqB,CAY3H"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,aAAkB,GAAG,qBAAqB,CA4ItF;AAeD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,qBAAqB,GAAG,SAAS,GAAG,MAAM,IAAI,qBAAqB,CAY3H"}