@vezham/start 0.3.3 → 26.0.0-alpha.6

package/dist/lib/runtime/docs/i18n.js

@@ -0,0 +1,41 @@
+import { defineI18n } from "@vezham/docs-core/i18n";
+//#region src/lib/runtime/docs/i18n.ts
+var createDocsI18n = (config) => {
+	const { hideLocale = "default-locale", languages, ...i18nConfig } = config;
+	return defineI18n({
+		...i18nConfig,
+		hideLocale,
+		languages: [...languages]
+	});
+};
+var normalizeLocale = (i18n, lang) => {
+	return i18n.languages.includes(lang) ? lang : i18n.defaultLanguage;
+};
+var isOptionalLocaleParam = (i18n, lang) => {
+	return !lang || i18n.languages.includes(lang);
+};
+var isDefaultLocaleParam = (i18n, lang) => {
+	return lang === i18n.defaultLanguage;
+};
+var escapeRegExp = (value) => {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+};
+var getDefaultLocaleRedirectHref = (i18n, href) => {
+	const defaultLocalePattern = escapeRegExp(i18n.defaultLanguage);
+	const defaultLocalePrefix = new RegExp(`^/${defaultLocalePattern}(?=/|\\?|#|$)`);
+	if (!defaultLocalePrefix.test(href)) return;
+	return href.replace(defaultLocalePrefix, "") || "/";
+};
+var localizedUrl = (i18n, locale, path) => {
+	const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+	return locale === i18n.defaultLanguage ? normalizedPath : `/${locale}${normalizedPath}`;
+};
+var localizedRouteParam = (i18n, locale) => {
+	return locale && locale !== i18n.defaultLanguage ? locale : void 0;
+};
+var localizeRouteBase = ({ defaultLanguage, lang, languages, routeBase }) => {
+	const locale = languages.find((language) => language === lang);
+	return locale && locale !== defaultLanguage ? `/${locale}${routeBase}` : routeBase;
+};
+//#endregion
+export { createDocsI18n, getDefaultLocaleRedirectHref, isDefaultLocaleParam, isOptionalLocaleParam, localizeRouteBase, localizedRouteParam, localizedUrl, normalizeLocale };

package/dist/lib/runtime/docs/icons.d.ts

@@ -0,0 +1,26 @@
+import { CSSProperties, ReactNode } from 'react';
+import { LoaderPlugin } from '@vezham/docs-core/source';
+import { metaSchema, pageSchema } from '@vezham/docs-core/source/schema';
+export declare const defaultDocsIconAssetBaseUrl = "https://cdn.jsdelivr.net/npm/@vezham/icons@1.0.7/dist/cdn/icons";
+export type DocsIconName = string;
+export type DocsIconWeight = 'outline' | 'filled' | 'duotone';
+export type DocsIconAlt = string | ((iconName: DocsIconName) => string);
+export type DocsIconFrontmatter = {
+    iconAlt?: string;
+    iconColor?: CSSProperties['color'];
+    iconWeight?: DocsIconWeight;
+};
+export type DocsIconResolverOptions = {
+    alt?: DocsIconAlt;
+    assetBaseUrl?: string;
+    color?: CSSProperties['color'];
+    defaultIcon?: DocsIconName;
+    size?: number | string;
+    weight?: DocsIconWeight;
+};
+export declare const docsPageSchema: typeof pageSchema;
+export declare const docsMetaSchema: typeof metaSchema;
+export declare const toDocsIconName: (value: string) => string;
+export declare const createDocsIconResolver: ({ alt, assetBaseUrl, color, defaultIcon, size, weight }?: DocsIconResolverOptions) => (icon?: string) => ReactNode;
+export declare const docsIconsPlugin: (options?: DocsIconResolverOptions) => LoaderPlugin;
+//# sourceMappingURL=icons.d.ts.map

package/dist/lib/runtime/docs/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/icons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAiB,MAAM,OAAO,CAAA;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAA;AAExE,eAAO,MAAM,2BAA2B,oEAC2B,CAAA;AAEnE,MAAM,MAAM,YAAY,GAAG,MAAM,CAAA;AAEjC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,YAAY,KAAK,MAAM,CAAC,CAAA;AAEvE,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAClC,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAC9B,WAAW,CAAC,EAAE,YAAY,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,MAAM,CAAC,EAAE,cAAc,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,cAAc,EAIV,OAAO,UAAU,CAAA;AAElC,eAAO,MAAM,cAAc,EAIV,OAAO,UAAU,CAAA;AAUlC,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,WAE3C,CAAA;AAuBD,eAAO,MAAM,sBAAsB,GAAI,0DAOpC,uBAA4B,MACrB,OAAO,MAAM,KAAG,SAoCzB,CAAA;AAgDD,eAAO,MAAM,eAAe,GAC1B,UAAS,uBAA4B,KACpC,YAuBD,CAAA"}

package/dist/lib/runtime/docs/icons.js

@@ -0,0 +1,103 @@
+import { createElement } from "react";
+import { metaSchema, pageSchema } from "@vezham/docs-core/source/schema";
+//#region src/lib/runtime/docs/icons.ts
+var defaultDocsIconAssetBaseUrl = "https://cdn.jsdelivr.net/npm/@vezham/icons@1.0.7/dist/cdn/icons";
+var docsPageSchema = pageSchema.extend({
+	iconAlt: pageSchema.shape.description,
+	iconColor: pageSchema.shape.description,
+	iconWeight: pageSchema.shape.description
+});
+var docsMetaSchema = metaSchema.extend({
+	iconAlt: metaSchema.shape.description,
+	iconColor: metaSchema.shape.description,
+	iconWeight: metaSchema.shape.description
+});
+var toKebabIconName = (value) => {
+	return value.replace(/_/g, "-").replace(/([a-z0-9])([A-Z])/g, "$1-$2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1-$2").toLowerCase();
+};
+var toDocsIconName = (value) => {
+	return toKebabIconName(value);
+};
+var isDocsIconWeight = (value) => {
+	return value === "outline" || value === "filled" || value === "duotone";
+};
+var getDocsIconAlt = (alt, iconName) => {
+	return typeof alt === "function" ? alt(iconName) : alt;
+};
+var getDocsIconAssetUrl = (iconName, weight, assetBaseUrl) => {
+	const suffix = weight === "filled" || weight === "duotone" ? `-${weight}` : "";
+	return `${assetBaseUrl.replace(/\/$/, "")}/${iconName}${suffix}.svg`;
+};
+var createDocsIconResolver = ({ alt, assetBaseUrl = defaultDocsIconAssetBaseUrl, color, defaultIcon, size = 16, weight } = {}) => {
+	return (icon) => {
+		const iconName = icon ?? defaultIcon;
+		if (iconName === void 0) return;
+		const normalizedIconName = toDocsIconName(iconName);
+		const iconSize = typeof size === "number" ? `${size}px` : size;
+		const iconUrl = getDocsIconAssetUrl(normalizedIconName, weight, assetBaseUrl);
+		const altText = getDocsIconAlt(alt, normalizedIconName);
+		const style = {
+			WebkitMask: `url("${iconUrl}") center / contain no-repeat`,
+			backgroundColor: "currentColor",
+			color,
+			display: "inline-block",
+			flexShrink: 0,
+			height: iconSize,
+			mask: `url("${iconUrl}") center / contain no-repeat`,
+			verticalAlign: "middle",
+			width: iconSize
+		};
+		return createElement("span", {
+			...altText ? {
+				"aria-label": altText,
+				role: "img"
+			} : { "aria-hidden": true },
+			"data-vx-icon": normalizedIconName,
+			"data-vx-icon-weight": weight,
+			style
+		});
+	};
+};
+var getString = (value) => {
+	return typeof value === "string" ? value : void 0;
+};
+var getDocsIconFrontmatter = (data) => {
+	if (!data || typeof data !== "object") return {};
+	const frontmatter = data;
+	const iconWeight = frontmatter.iconWeight;
+	return {
+		iconAlt: getString(frontmatter.iconAlt),
+		iconColor: getString(frontmatter.iconColor),
+		iconWeight: isDocsIconWeight(iconWeight) ? iconWeight : void 0
+	};
+};
+var createFrontmatterDocsIconResolver = (frontmatter, options) => {
+	return createDocsIconResolver({
+		...options,
+		alt: frontmatter.iconAlt ?? options.alt,
+		color: frontmatter.iconColor ?? options.color,
+		weight: frontmatter.iconWeight ?? options.weight
+	});
+};
+var resolveDocsNodeIcon = (node, options, frontmatter = {}) => {
+	if (node.icon === void 0 || typeof node.icon === "string") node.icon = createFrontmatterDocsIconResolver(frontmatter, options)(node.icon);
+	return node;
+};
+var docsIconsPlugin = (options = {}) => ({
+	name: "vezham:docs-icons",
+	transformPageTree: {
+		file(node, filePath) {
+			const file = filePath ? this.storage.read(filePath) : void 0;
+			return resolveDocsNodeIcon(node, options, file?.format === "page" ? getDocsIconFrontmatter(file.data) : void 0);
+		},
+		folder(node, _folderPath, metaPath) {
+			const file = metaPath ? this.storage.read(metaPath) : void 0;
+			return resolveDocsNodeIcon(node, options, file?.format === "meta" ? getDocsIconFrontmatter(file.data) : void 0);
+		},
+		separator(node) {
+			return resolveDocsNodeIcon(node, options);
+		}
+	}
+});
+//#endregion
+export { createDocsIconResolver, defaultDocsIconAssetBaseUrl, docsIconsPlugin, docsMetaSchema, docsPageSchema, toDocsIconName };

package/dist/lib/runtime/docs/index.d.ts

@@ -0,0 +1,9 @@
+export * from './runtime';
+export * from './icons';
+export * from './i18n';
+export * from './routes';
+export * from './head';
+export * from './openapi';
+export * from './pages';
+export * from './static';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/runtime/docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,WAAW,CAAA;AACzB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/lib/runtime/docs/index.js

@@ -0,0 +1,9 @@
+import { createDocsI18n, getDefaultLocaleRedirectHref, isDefaultLocaleParam, isOptionalLocaleParam, localizeRouteBase, localizedRouteParam, localizedUrl, normalizeLocale } from "./i18n.js";
+import { createDocsIconResolver, defaultDocsIconAssetBaseUrl, docsIconsPlugin, docsMetaSchema, docsPageSchema, toDocsIconName } from "./icons.js";
+import { createOpenAPIFromSources, getDocsLLMText, getOpenAPIDocumentId, openAPIDocumentIdFromPath, parseOpenAPIDocument, preloadDocsOpenAPIPage } from "./openapi.js";
+import { decodeMarkdownUrl, defaultDocsImageRoute, defaultDocsRoute, encodeMarkdownUrl, getDocsImageRoute, normalizeDocsRoutePath, replaceDocsRouteBase } from "./routes.js";
+import { createDocsRuntime, createDocsSource, createSearchServer, createStaticDocsRuntimeBase, createStaticDocsSource, getDocsLLMSIndex } from "./runtime.js";
+import { getDocsOgImagePath, getDocsRouteHead } from "./head.js";
+import { createDocsPageRuntime } from "./pages.js";
+import { createStaticDocsRuntime } from "./static.js";
+export { createDocsI18n, createDocsIconResolver, createDocsPageRuntime, createDocsRuntime, createDocsSource, createOpenAPIFromSources, createSearchServer, createStaticDocsRuntime, createStaticDocsRuntimeBase, createStaticDocsSource, decodeMarkdownUrl, defaultDocsIconAssetBaseUrl, defaultDocsImageRoute, defaultDocsRoute, docsIconsPlugin, docsMetaSchema, docsPageSchema, encodeMarkdownUrl, getDefaultLocaleRedirectHref, getDocsImageRoute, getDocsLLMSIndex, getDocsLLMText, getDocsOgImagePath, getDocsRouteHead, getOpenAPIDocumentId, isDefaultLocaleParam, isOptionalLocaleParam, localizeRouteBase, localizedRouteParam, localizedUrl, normalizeDocsRoutePath, normalizeLocale, openAPIDocumentIdFromPath, parseOpenAPIDocument, preloadDocsOpenAPIPage, replaceDocsRouteBase, toDocsIconName };

package/dist/lib/runtime/docs/openapi.d.ts

@@ -0,0 +1,41 @@
+import { OpenAPIOptions, createOpenAPI } from '@vezham/docs-openapi/server';
+type OpenAPIDocument = Exclude<NonNullable<OpenAPIOptions['input']>, string[]>[string];
+export type DocsOpenAPIPlugin = {
+    loaderPlugin: () => ReturnType<ReturnType<typeof createOpenAPI>['loaderPlugin']>;
+};
+export type DocsOpenAPIRuntime = {
+    getSchema: (documentId: string) => Promise<unknown>;
+};
+export type DocsOpenAPIPreloader = {
+    preloadOpenAPIPage: (page: never) => Promise<unknown>;
+};
+export type OpenAPISourceFiles = Record<string, string>;
+export type CreateOpenAPIFromSourcesOptions = {
+    files?: OpenAPISourceFiles;
+    openapiDir?: string;
+    rootDocument?: string;
+    rootDocumentId?: string;
+};
+export type DocsPageLike = {
+    data: {
+        _openapi?: {
+            preload?: unknown;
+        };
+        description?: string;
+        getText?: (mode: 'processed' | 'raw') => Promise<string>;
+        title?: string;
+    };
+    locale?: string;
+    slugs?: string[];
+    url: string;
+};
+export declare const parseOpenAPIDocument: (filePath: string, source: string) => OpenAPIDocument;
+export declare const openAPIDocumentIdFromPath: (filePath: string, openapiDir?: string) => string;
+export declare const createOpenAPIFromSources: ({ files, openapiDir, rootDocument, rootDocumentId }: CreateOpenAPIFromSourcesOptions) => import('@vezham/docs-openapi/server').OpenAPIServer;
+export declare const getOpenAPIDocumentId: (page: DocsPageLike) => string | undefined;
+export declare const preloadDocsOpenAPIPage: <Page extends DocsPageLike>(page: Page, openapi: {
+    preloadOpenAPIPage: (page: Page) => Promise<unknown>;
+}) => Promise<unknown>;
+export declare const getDocsLLMText: (page: DocsPageLike, openapi?: Pick<DocsOpenAPIRuntime, "getSchema">) => Promise<string>;
+export {};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/lib/runtime/docs/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/openapi.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhF,KAAK,eAAe,GAAG,OAAO,CAC5B,WAAW,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EACpC,MAAM,EAAE,CACT,CAAC,MAAM,CAAC,CAAA;AAET,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,MAAM,UAAU,CAC5B,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC,cAAc,CAAC,CACjD,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACpD,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,kBAAkB,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACtD,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;AAEvD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE;QACJ,QAAQ,CAAC,EAAE;YACT,OAAO,CAAC,EAAE,OAAO,CAAA;SAClB,CAAA;QACD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;QACxD,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAMD,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,QAAQ,MAAM,KACb,eAIF,CAAA;AAED,eAAO,MAAM,yBAAyB,GACpC,UAAU,MAAM,EAChB,mBAAsB,WAgBvB,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,qDAKtC,+BAA+B,wDAmBjC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,MAAM,YAAY,uBAMtD,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAU,IAAI,SAAS,YAAY,EACpE,MAAM,IAAI,EACV,SAAS;IACP,kBAAkB,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACrD,qBAKF,CAAA;AAED,eAAO,MAAM,cAAc,GACzB,MAAM,YAAY,EAClB,UAAU,IAAI,CAAC,kBAAkB,EAAE,WAAW,CAAC,oBAiBhD,CAAA"}

package/dist/lib/runtime/docs/openapi.js

@@ -0,0 +1,40 @@
+import { parse } from "yaml";
+import { createOpenAPI } from "@vezham/docs-openapi/server";
+//#region src/lib/runtime/docs/openapi.ts
+var slash = (value) => {
+	return value.split("\\").join("/");
+};
+var parseOpenAPIDocument = (filePath, source) => {
+	return filePath.endsWith(".json") ? JSON.parse(source) : parse(source);
+};
+var openAPIDocumentIdFromPath = (filePath, openapiDir = "openapi") => {
+	const segments = slash(filePath).split("/");
+	const openapiDirIndex = segments.lastIndexOf(openapiDir);
+	const idSegments = (openapiDirIndex === -1 ? slash(filePath) : segments.slice(openapiDirIndex + 1).join("/")).replace(/\.(?:json|yaml|yml)$/, "").split("/");
+	if (idSegments[idSegments.length - 1] === "index") idSegments.pop();
+	return idSegments.length === 0 ? "openapi" : idSegments.join("/");
+};
+var createOpenAPIFromSources = ({ files = {}, openapiDir, rootDocument, rootDocumentId = "openapi" }) => {
+	return createOpenAPI({ input: {
+		...rootDocument ? { [rootDocumentId]: parseOpenAPIDocument("openapi/index.yaml", rootDocument) } : {},
+		...Object.fromEntries(Object.entries(files).map(([filePath, source]) => [openAPIDocumentIdFromPath(filePath, openapiDir), parseOpenAPIDocument(filePath, source)]))
+	} });
+};
+var getOpenAPIDocumentId = (page) => {
+	const preload = page.data._openapi?.preload;
+	return Array.isArray(preload) && typeof preload[0] === "string" ? preload[0] : void 0;
+};
+var preloadDocsOpenAPIPage = async (page, openapi) => {
+	return getOpenAPIDocumentId(page) ? openapi.preloadOpenAPIPage(page) : void 0;
+};
+var getDocsLLMText = async (page, openapi) => {
+	const documentId = getOpenAPIDocumentId(page);
+	if (documentId && openapi) return JSON.stringify(await openapi.getSchema(documentId), null, 2);
+	if (!page.data.getText) throw new Error(`Cannot render LLM text for ${page.url}`);
+	const processed = await page.data.getText("processed");
+	return `# ${page.data.title ?? "Untitled"} (${page.url})
+
+${processed}`;
+};
+//#endregion
+export { createOpenAPIFromSources, getDocsLLMText, getOpenAPIDocumentId, openAPIDocumentIdFromPath, parseOpenAPIDocument, preloadDocsOpenAPIPage };

package/dist/lib/runtime/docs/pages.d.ts

@@ -0,0 +1,98 @@
+import { StaticSource } from '@vezham/docs-core/source';
+import { DocsRouteHeadOptions } from './head';
+import { createStaticDocsRuntimeBase } from './runtime';
+export type DocsPageInput = {
+    lang?: string;
+    pathFormat?: 'slug' | 'markdown-url';
+    slugs: string[];
+};
+export declare const createDocsPageRuntime: <Docs extends StaticSource, const Languages extends readonly string[]>({ docs, runtime, head }: {
+    docs: {
+        getPage: (path: string) => {
+            preload: () => unknown;
+        } | undefined;
+    };
+    runtime: ReturnType<typeof createStaticDocsRuntimeBase<Docs, Languages>>;
+    head: Omit<DocsRouteHeadOptions, "defaultLanguage" | "languages">;
+}) => {
+    getDocsPage: ({ lang, pathFormat, slugs }: DocsPageInput) => {
+        locale: Languages[number];
+        page: {
+            docs: Docs;
+        } extends infer T ? T extends {
+            docs: Docs;
+        } ? T extends Record<infer K extends string, import('@vezham/docs-core/source').SourceUnion<{
+            pageData: import('@vezham/docs-core/source').PageData;
+            metaData: import('@vezham/docs-core/source').MetaData;
+        }>> ? { [k in K]: T[k] extends import('@vezham/docs-core/source').SourceUnion<infer D extends {
+            pageData: import('@vezham/docs-core/source').PageData;
+            metaData: import('@vezham/docs-core/source').MetaData;
+        }> ? import('@vezham/docs-core/source').Page<k, D["pageData"]> : never; }[K] : T extends import('@vezham/docs-core/source').SourceUnion<infer D extends {
+            pageData: import('@vezham/docs-core/source').PageData;
+            metaData: import('@vezham/docs-core/source').MetaData;
+        }> ? import('@vezham/docs-core/source').Page<undefined, D["pageData"]> : never : never : never;
+    };
+    loadDocsPage: ({ slugs, lang, routeBase }: {
+        slugs: string[];
+        lang?: string;
+        routeBase?: string;
+    }) => Promise<{
+        locale: Languages[number];
+        title: string | undefined;
+        description: string | undefined;
+        routePath: string;
+        path: string;
+        markdownUrl: string;
+        pageTree: import('@vezham/docs-core/source/client').SerializedPageTree;
+        openapiData: unknown;
+    }>;
+    getDocsRouteHead: (data?: Awaited<ReturnType<({ slugs, lang, routeBase }: {
+        slugs: string[];
+        lang?: string;
+        routeBase?: string;
+    }) => Promise<{
+        locale: Languages[number];
+        title: string | undefined;
+        description: string | undefined;
+        routePath: string;
+        path: string;
+        markdownUrl: string;
+        pageTree: import('@vezham/docs-core/source/client').SerializedPageTree;
+        openapiData: unknown;
+    }>>>) => {
+        meta?: undefined;
+    } | {
+        meta: ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+            property?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+            property?: undefined;
+        } | {
+            property: string;
+            content: string;
+            title?: undefined;
+            name?: undefined;
+        })[];
+    };
+    createDocsLoader: (routeBase?: string) => ({ params }: {
+        params: {
+            lang?: string;
+            _splat?: string;
+        };
+    }) => Promise<{
+        locale: Languages[number];
+        title: string | undefined;
+        description: string | undefined;
+        routePath: string;
+        path: string;
+        markdownUrl: string;
+        pageTree: import('@vezham/docs-core/source/client').SerializedPageTree;
+        openapiData: unknown;
+    }>;
+};
+//# sourceMappingURL=pages.d.ts.map

package/dist/lib/runtime/docs/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/pages.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAE5D,OAAO,EAAE,KAAK,oBAAoB,EAAoB,MAAM,QAAQ,CAAA;AAYpE,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,WAAW,CAAA;AAE5D,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,cAAc,CAAA;IACpC,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,IAAI,SAAS,YAAY,EACzB,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EACzC,yBAIC;IACD,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;YAAE,OAAO,EAAE,MAAM,OAAO,CAAA;SAAE,GAAG,SAAS,CAAA;KAAE,CAAA;IAC3E,OAAO,EAAE,UAAU,CAAC,OAAO,2BAA2B,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAA;IACxE,IAAI,EAAE,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,GAAG,WAAW,CAAC,CAAA;CAClE;+CAImD,aAAa;;;;;;;;;;;;;;;;;+CAqB5D;QACD,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB;;;;;;;;;;8BAgE2B,OAAO,CAAC,UAAU,8BApE3C;QACD,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB;;;;;;;;;OAgEkE,CAAC;;;;;;;;;;;;;;;;;;;;+CAQ/D,YAAY;QAAE,MAAM,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;;;;;;;;;;CAOhE,CAAA"}

package/dist/lib/runtime/docs/pages.js

@@ -0,0 +1,89 @@
+import { isOptionalLocaleParam, localizeRouteBase, normalizeLocale } from "./i18n.js";
+import { decodeMarkdownUrl, encodeMarkdownUrl, replaceDocsRouteBase } from "./routes.js";
+import { getDocsRouteHead } from "./head.js";
+import { notFound } from "@tanstack/react-router";
+//#region src/lib/runtime/docs/pages.ts
+var createDocsPageRuntime = ({ docs, runtime, head }) => {
+	const { i18n, source, preloadOpenAPIPage } = runtime;
+	const docsRoute = head.docsRoute ?? "/docs";
+	const getDocsPage = ({ lang, pathFormat, slugs }) => {
+		if (!isOptionalLocaleParam(i18n, lang)) throw notFound();
+		const locale = normalizeLocale(i18n, lang);
+		const resolvedSlugs = pathFormat === "markdown-url" ? decodeMarkdownUrl(slugs) : slugs;
+		const page = source.getPage(resolvedSlugs, locale);
+		if (!page) throw notFound();
+		return {
+			locale,
+			page
+		};
+	};
+	const loadDocsPage = async ({ slugs, lang, routeBase = docsRoute }) => {
+		const { locale, page } = getDocsPage({
+			slugs,
+			lang
+		});
+		const resolvedRouteBase = localizeRouteBase({
+			defaultLanguage: i18n.defaultLanguage,
+			lang,
+			languages: i18n.languages,
+			routeBase
+		});
+		const remapPage = (item) => ({
+			...item,
+			url: replaceDocsRouteBase({
+				docsRoute,
+				languages: i18n.languages,
+				pagePath: item.url,
+				routeBase: resolvedRouteBase
+			})
+		});
+		const remapNode = (node) => {
+			if (node.type === "page") return remapPage(node);
+			if (node.type !== "folder") return node;
+			return {
+				...node,
+				index: node.index ? remapPage(node.index) : void 0,
+				children: node.children.map(remapNode)
+			};
+		};
+		const remapTree = (tree) => ({
+			...tree,
+			$id: `${tree.$id ?? locale}:${resolvedRouteBase}`,
+			children: tree.children.map(remapNode),
+			fallback: tree.fallback ? remapTree(tree.fallback) : void 0
+		});
+		const data = {
+			locale,
+			title: page.data.title,
+			description: page.data.description,
+			routePath: replaceDocsRouteBase({
+				docsRoute,
+				languages: i18n.languages,
+				pagePath: page.url,
+				routeBase: resolvedRouteBase
+			}),
+			path: page.path,
+			markdownUrl: encodeMarkdownUrl(page.slugs, page.locale, docsRoute, i18n.defaultLanguage),
+			pageTree: await source.serializePageTree(routeBase === docsRoute ? source.getPageTree(locale) : remapTree(source.getPageTree(locale))),
+			openapiData: await preloadOpenAPIPage(page)
+		};
+		await docs.getPage(data.path)?.preload();
+		return data;
+	};
+	return {
+		getDocsPage,
+		loadDocsPage,
+		getDocsRouteHead: (data) => getDocsRouteHead(data, {
+			...head,
+			defaultLanguage: i18n.defaultLanguage,
+			languages: i18n.languages
+		}),
+		createDocsLoader: (routeBase = docsRoute) => ({ params }) => loadDocsPage({
+			slugs: params._splat?.split("/") ?? [],
+			lang: params.lang,
+			routeBase
+		})
+	};
+};
+//#endregion
+export { createDocsPageRuntime };

package/dist/lib/runtime/docs/routes.d.ts

@@ -0,0 +1,17 @@
+export declare const defaultDocsRoute = "/docs";
+export declare const getDocsImageRoute: (docsRoute?: string) => string;
+export declare const defaultDocsImageRoute: string;
+export declare const encodeMarkdownUrl: (slugs: string[], locale?: string, docsRoute?: string, defaultLocale?: string) => string;
+export declare const decodeMarkdownUrl: (segments: string[]) => string[];
+export declare const replaceDocsRouteBase: ({ docsRoute, languages, pagePath, routeBase }: {
+    docsRoute?: string;
+    languages: readonly string[];
+    pagePath: string;
+    routeBase: string;
+}) => string;
+export declare const normalizeDocsRoutePath: ({ docsRoute, languages, routePath }: {
+    docsRoute?: string;
+    languages: readonly string[];
+    routePath: string;
+}) => string;
+//# sourceMappingURL=routes.d.ts.map

package/dist/lib/runtime/docs/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/routes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC,eAAO,MAAM,iBAAiB,GAAI,kBAA4B,WAE7D,CAAA;AAED,eAAO,MAAM,qBAAqB,QAAsB,CAAA;AAExD,eAAO,MAAM,iBAAiB,GAC5B,OAAO,MAAM,EAAE,EACf,SAAS,MAAM,EACf,kBAA4B,EAC5B,gBAAgB,MAAM,WAiBvB,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,EAAE,aAanD,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,+CAKlC;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB,WA0BA,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,qCAIpC;IACD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB,WAcA,CAAA"}

package/dist/lib/runtime/docs/routes.js

@@ -0,0 +1,45 @@
+//#region src/lib/runtime/docs/routes.ts
+var defaultDocsRoute = "/docs";
+var getDocsImageRoute = (docsRoute = defaultDocsRoute) => {
+	return `/og${docsRoute}`;
+};
+var defaultDocsImageRoute = getDocsImageRoute();
+var encodeMarkdownUrl = (slugs, locale, docsRoute = defaultDocsRoute, defaultLocale) => {
+	const segments = [...slugs];
+	const localePrefix = locale && locale !== defaultLocale ? locale : void 0;
+	if (segments.length === 0) segments.push("index.md");
+	else segments[segments.length - 1] += ".md";
+	return "/" + [
+		localePrefix,
+		...docsRoute.split("/"),
+		...segments
+	].filter(Boolean).join("/");
+};
+var decodeMarkdownUrl = (segments) => {
+	if (segments.length === 0) return [];
+	const out = [...segments];
+	out[out.length - 1] = out[out.length - 1].replace(/\.md$/, "");
+	if (out.length === 1 && out[0] === "index") out.pop();
+	return out;
+};
+var replaceDocsRouteBase = ({ docsRoute = defaultDocsRoute, languages, pagePath, routeBase }) => {
+	if (routeBase === docsRoute) return pagePath;
+	if (pagePath === docsRoute) return routeBase;
+	if (pagePath.startsWith(`${docsRoute}/`)) return `${routeBase}${pagePath.slice(docsRoute.length)}`;
+	for (const lang of languages) {
+		const localizedDocsRoute = `/${lang}${docsRoute}`;
+		if (pagePath === localizedDocsRoute) return routeBase;
+		if (pagePath.startsWith(`${localizedDocsRoute}/`)) return `${routeBase}${pagePath.slice(localizedDocsRoute.length)}`;
+	}
+	return pagePath;
+};
+var normalizeDocsRoutePath = ({ docsRoute = defaultDocsRoute, languages, routePath }) => {
+	for (const lang of languages) {
+		const localizedDocsRoute = `/${lang}${docsRoute}`;
+		if (routePath === localizedDocsRoute) return docsRoute;
+		if (routePath.startsWith(`${localizedDocsRoute}/`)) return routePath.slice(`/${lang}`.length);
+	}
+	return routePath;
+};
+//#endregion
+export { decodeMarkdownUrl, defaultDocsImageRoute, defaultDocsRoute, encodeMarkdownUrl, getDocsImageRoute, normalizeDocsRoutePath, replaceDocsRouteBase };