@vezham/start 26.0.0-alpha.5 → 26.0.0-alpha.7

package/dist/lib/provider/tanstack-docs/i18n.js

@@ -0,0 +1,30 @@
+//#region src/lib/provider/tanstack-docs/i18n.ts
+var displayNameLanguageCode = (language) => {
+	return language === "cn" ? "zh" : language;
+};
+var displayNames = /* @__PURE__ */ new Map();
+var getDisplayNames = (languageCode) => {
+	const cached = displayNames.get(languageCode);
+	if (cached) return cached;
+	const formatter = new Intl.DisplayNames([languageCode], { type: "language" });
+	displayNames.set(languageCode, formatter);
+	return formatter;
+};
+var getLanguageDisplayName = (language) => {
+	const languageCode = displayNameLanguageCode(language);
+	try {
+		return getDisplayNames(languageCode).of(languageCode) ?? language;
+	} catch {
+		return language;
+	}
+};
+var createDocsTranslations = (i18n, overrides) => {
+	const translations = {};
+	for (const language of i18n.languages) translations[language] = {
+		displayName: getLanguageDisplayName(language),
+		...overrides?.[language]
+	};
+	return translations;
+};
+//#endregion
+export { createDocsTranslations, getLanguageDisplayName };

package/dist/lib/provider/tanstack-docs/index.d.ts

@@ -0,0 +1,5 @@
+export { createRootComponent, defineConfig } from './config';
+export { getLanguageDisplayName } from './i18n';
+export { assertRouteLocale, parseRouteLocale, redirectDefaultLocale } from './routes';
+export { DocsSearchDialog } from './search';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/provider/tanstack-docs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/tanstack-docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}

package/dist/lib/provider/tanstack-docs/index.js

@@ -0,0 +1,5 @@
+import { getLanguageDisplayName } from "./i18n.js";
+import { DocsSearchDialog } from "./search.js";
+import { createRootComponent, defineConfig } from "./config.js";
+import { assertRouteLocale, parseRouteLocale, redirectDefaultLocale } from "./routes.js";
+export { DocsSearchDialog, assertRouteLocale, createRootComponent, defineConfig, getLanguageDisplayName, parseRouteLocale, redirectDefaultLocale };

package/dist/lib/provider/tanstack-docs/routes.d.ts

@@ -0,0 +1,13 @@
+import { I18nAPI } from '@vezham/docs-core/i18n';
+export declare const parseRouteLocale: <Language extends string, Params extends {
+    lang?: string;
+}>(i18n: I18nAPI<Language>, params: Params) => false | Params;
+export declare const assertRouteLocale: <Language extends string, Params extends {
+    lang?: string;
+}>(i18n: I18nAPI<Language>, params: Params, location: {
+    href: string;
+}) => void;
+export declare const redirectDefaultLocale: <Language extends string>(i18n: I18nAPI<Language>, location: {
+    href: string;
+}) => void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/lib/provider/tanstack-docs/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/tanstack-docs/routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAOrD,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,SAAS,MAAM,EACvB,MAAM,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAEhC,MAAM,OAAO,CAAC,QAAQ,CAAC,EACvB,QAAQ,MAAM,mBAGf,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,SAAS,MAAM,EACvB,MAAM,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAEhC,MAAM,OAAO,CAAC,QAAQ,CAAC,EACvB,QAAQ,MAAM,EACd,UAAU;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,SAc3B,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,QAAQ,SAAS,MAAM,EAC3D,MAAM,OAAO,CAAC,QAAQ,CAAC,EACvB,UAAU;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,SAU3B,CAAA"}

package/dist/lib/provider/tanstack-docs/routes.js

@@ -0,0 +1,23 @@
+import { getDefaultLocaleRedirectHref, isOptionalLocaleParam } from "../../runtime/docs/i18n.js";
+import { notFound, redirect } from "@tanstack/react-router";
+//#region src/lib/provider/tanstack-docs/routes.ts
+var parseRouteLocale = (i18n, params) => {
+	return isOptionalLocaleParam(i18n, params.lang) ? params : false;
+};
+var assertRouteLocale = (i18n, params, location) => {
+	if (!isOptionalLocaleParam(i18n, params.lang)) throw notFound();
+	const redirectHref = getDefaultLocaleRedirectHref(i18n, location.href);
+	if (redirectHref) throw redirect({
+		href: redirectHref,
+		statusCode: 301
+	});
+};
+var redirectDefaultLocale = (i18n, location) => {
+	const redirectHref = getDefaultLocaleRedirectHref(i18n, location.href);
+	if (redirectHref) throw redirect({
+		href: redirectHref,
+		statusCode: 301
+	});
+};
+//#endregion
+export { assertRouteLocale, parseRouteLocale, redirectDefaultLocale };

package/dist/lib/provider/tanstack-docs/search.d.ts

@@ -0,0 +1,4 @@
+import { SharedProps } from '@vezham/docs-react/components/dialog/search';
+declare const DocsSearchDialog: (props: SharedProps) => import("react").JSX.Element;
+export { DocsSearchDialog };
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/provider/tanstack-docs/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/tanstack-docs/search.tsx"],"names":[],"mappings":"AAIA,OAAO,EASL,KAAK,WAAW,EACjB,MAAM,6CAA6C,CAAA;AAGpD,QAAA,MAAM,gBAAgB,GAAI,OAAO,WAAW,gCAyB3C,CAAA;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/lib/provider/tanstack-docs/search.js

@@ -0,0 +1,24 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useDocsSearch } from "@vezham/docs-core/search/client";
+import { staticClient } from "@vezham/docs-core/search/client/orama-static";
+import { SearchDialog, SearchDialogClose, SearchDialogContent, SearchDialogHeader, SearchDialogIcon, SearchDialogInput, SearchDialogList, SearchDialogOverlay } from "@vezham/docs-react/components/dialog/search";
+import { useI18n } from "@vezham/docs-react/contexts/i18n";
+//#region src/lib/provider/tanstack-docs/search.tsx
+var DocsSearchDialog = (props) => {
+	const { locale } = useI18n();
+	const { search, setSearch, query } = useDocsSearch({ client: staticClient({ locale }) });
+	return /* @__PURE__ */ jsxs(SearchDialog, {
+		search,
+		onSearchChange: setSearch,
+		isLoading: query.isLoading,
+		...props,
+		children: [/* @__PURE__ */ jsx(SearchDialogOverlay, {}), /* @__PURE__ */ jsxs(SearchDialogContent, { children: [/* @__PURE__ */ jsxs(SearchDialogHeader, { children: [
+			/* @__PURE__ */ jsx(SearchDialogIcon, {}),
+			/* @__PURE__ */ jsx(SearchDialogInput, {}),
+			/* @__PURE__ */ jsx(SearchDialogClose, {})
+		] }), /* @__PURE__ */ jsx(SearchDialogList, { items: query.data !== "empty" ? query.data : null })] })]
+	});
+};
+//#endregion
+export { DocsSearchDialog };

package/dist/lib/provider/vite/config.d.ts

@@ -0,0 +1,3 @@
+import { Props } from '../shared/types';
+export declare const defineConfig: (props: Props) => void;
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/provider/vite/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/vite/config.tsx"],"names":[],"mappings":"AAMA,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAA;AAGvD,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,SAqBxC,CAAA"}

package/dist/lib/provider/vite/config.js

@@ -0,0 +1,29 @@
+import { config, preConfig } from "../shared/config.js";
+import { NAMESPACE } from "../shared/types.js";
+import { Provider } from "./provider.js";
+import { jsx } from "react/jsx-runtime";
+import ReactDOM from "react-dom/client";
+import { APP_ID, APP_NAME, APP_VER } from "@vezham/env/vite";
+import { useLogger } from "@vezham/use-logger";
+//#region src/lib/provider/vite/config.tsx
+var defineConfig = (props) => {
+	const options = {
+		...props,
+		id: props.id || APP_ID,
+		name: props.name || APP_NAME,
+		version: props.version || APP_VER
+	};
+	const el = document.getElementById("root");
+	if (el && !el.getAttribute("data-vx-app")) {
+		document.documentElement.lang = options.lang ?? "en";
+		preConfig(options);
+		ReactDOM.createRoot(el).render(/* @__PURE__ */ jsx(Provider, {
+			...options,
+			runtime: "vite"
+		}));
+		el.setAttribute("data-vx-app", options.name || "");
+		config(options);
+	} else useLogger.log(NAMESPACE, "[provider] | root el is missing");
+};
+//#endregion
+export { defineConfig };

package/dist/lib/provider/vite/index.d.ts

@@ -0,0 +1,4 @@
+export { ClientDevtools } from '../shared/devtools';
+export { defineConfig } from './config';
+export { Provider } from './provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/provider/vite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/vite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA"}

package/dist/lib/provider/vite/index.js

@@ -0,0 +1,4 @@
+import { ClientDevtools } from "../shared/devtools.js";
+import { Provider } from "./provider.js";
+import { defineConfig } from "./config.js";
+export { ClientDevtools, Provider, defineConfig };

package/dist/lib/provider/vite/provider.d.ts

@@ -0,0 +1,3 @@
+declare const Provider: import('react').FC<import('../shared/types').Props>;
+export { Provider };
+//# sourceMappingURL=provider.d.ts.map

package/dist/lib/provider/vite/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/lib/provider/vite/provider.tsx"],"names":[],"mappings":"AAWA,QAAA,MAAM,QAAQ,qDAEZ,CAAA;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/lib/provider/vite/provider.js

@@ -0,0 +1,13 @@
+import { createProvider } from "../shared/provider.js";
+import { APP_ENV, APP_ID, APP_NAME, APP_VER, __DEBUG__, __DEV__ } from "@vezham/env/vite";
+//#region src/lib/provider/vite/provider.tsx
+var Provider = createProvider({ env: {
+	APP_ID,
+	APP_NAME,
+	APP_VER,
+	APP_ENV,
+	__DEBUG__,
+	__DEV__
+} });
+//#endregion
+export { Provider };

package/dist/lib/router/tanstack/index.d.ts

@@ -0,0 +1,3 @@
+export { RouterRoot } from './root';
+export { createRouter } from './router';
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/router/tanstack/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/router/tanstack/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/lib/router/tanstack/index.js

@@ -0,0 +1,3 @@
+import { RouterRoot } from "./root.js";
+import { createRouter } from "./router.js";
+export { RouterRoot, createRouter };

package/dist/lib/router/tanstack/root.d.ts

@@ -0,0 +1,3 @@
+export declare const RouterRoot: () => import("react").JSX.Element;
+export declare const DefaultNotFound: () => import("react").JSX.Element;
+//# sourceMappingURL=root.d.ts.map

package/dist/lib/router/tanstack/root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root.d.ts","sourceRoot":"","sources":["../../../../src/lib/router/tanstack/root.tsx"],"names":[],"mappings":"AAOA,eAAO,MAAM,UAAU,mCActB,CAAA;AAED,eAAO,MAAM,eAAe,mCAE3B,CAAA"}

package/dist/lib/router/tanstack/root.js

@@ -0,0 +1,22 @@
+import { ClientDevtools } from "../../provider/shared/devtools.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { APP_ENV, APP_ID, APP_NAME, APP_VER, __DEV__ } from "@vezham/env/vite";
+import { Outlet } from "@tanstack/react-router";
+import { NotFound } from "@vezham/template/components";
+//#region src/lib/router/tanstack/root.tsx
+var RouterRoot = () => /* @__PURE__ */ jsxs(Fragment, { children: [/* @__PURE__ */ jsx(Outlet, {}), /* @__PURE__ */ jsx(ClientDevtools, {
+	app: {
+		id: APP_ID,
+		name: APP_NAME,
+		version: APP_VER,
+		environment: APP_ENV,
+		runtime: "vite"
+	},
+	env: __DEV__
+})] });
+var DefaultNotFound = () => /* @__PURE__ */ jsx(NotFound, {
+	app: APP_NAME,
+	version: APP_VER
+});
+//#endregion
+export { DefaultNotFound, RouterRoot };

package/dist/lib/router/tanstack/router.d.ts

@@ -0,0 +1,3 @@
+import { createRouter as createTanstackRouter } from '@tanstack/react-router';
+export declare const createRouter: typeof createTanstackRouter;
+//# sourceMappingURL=router.d.ts.map

package/dist/lib/router/tanstack/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../../src/lib/router/tanstack/router.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,IAAI,oBAAoB,EACrC,MAAM,wBAAwB,CAAA;AAM/B,eAAO,MAAM,YAAY,EAAE,OAAO,oBAkBjC,CAAA"}

package/dist/lib/router/tanstack/router.js

@@ -0,0 +1,22 @@
+import { DefaultNotFound } from "./root.js";
+import { createRouter } from "@tanstack/react-router";
+import { ErrorPage, Loading } from "@vezham/template/components";
+//#region src/lib/router/tanstack/router.ts
+var createRouter$1 = (options) => {
+	const notFoundComponent = options.defaultNotFoundComponent ?? DefaultNotFound;
+	const configureRoute = (route) => {
+		if (route !== options.routeTree && !route.options.notFoundComponent) route.update({ notFoundComponent });
+		route.children?.forEach(configureRoute);
+	};
+	if (options.routeTree) configureRoute(options.routeTree);
+	return createRouter({
+		scrollRestoration: true,
+		defaultPreload: "intent",
+		defaultPendingComponent: Loading,
+		defaultErrorComponent: ErrorPage,
+		defaultNotFoundComponent: notFoundComponent,
+		...options
+	});
+};
+//#endregion
+export { createRouter$1 as createRouter };

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

@@ -0,0 +1,46 @@
+export type DocsRouteHeadData = {
+    description?: string;
+    locale: string;
+    routePath: string;
+    title?: string;
+};
+export type DocsRouteHeadOptions = {
+    appName: string;
+    defaultLanguage: string;
+    docsImageRoute?: string;
+    docsRoute?: string;
+    languages: readonly string[];
+    openGraphImage: string;
+    openGraphImageSource?: string;
+    siteDescription: string;
+    siteUrl: string;
+};
+export declare const getDocsOgImagePath: ({ docsImageRoute, docsRoute, languages, openGraphImage, openGraphImageSource, routePath }: {
+    docsImageRoute?: string;
+    docsRoute?: string;
+    languages: readonly string[];
+    openGraphImage: string;
+    openGraphImageSource?: string;
+    routePath: string;
+}) => string;
+export declare const getDocsRouteHead: (data: DocsRouteHeadData | undefined, { appName, defaultLanguage, docsImageRoute, docsRoute, languages, openGraphImage, openGraphImageSource, siteDescription, siteUrl }: DocsRouteHeadOptions) => {
+    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;
+    })[];
+};
+//# sourceMappingURL=head.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/head.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,eAAe,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,2FAOhC;IACD,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,SAAS,EAAE,MAAM,CAAA;CAClB,WAkBA,CAAA;AAMD,eAAO,MAAM,gBAAgB,GAC3B,MAAM,iBAAiB,GAAG,SAAS,EACnC,oIAUG,oBAAoB;;;;;;;;;;;;;;;;;;;CAsCxB,CAAA"}

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

@@ -0,0 +1,80 @@
+import { defaultDocsImageRoute, defaultDocsRoute, normalizeDocsRoutePath } from "./routes.js";
+//#region src/lib/runtime/docs/head.ts
+var getDocsOgImagePath = ({ docsImageRoute = defaultDocsImageRoute, docsRoute = defaultDocsRoute, languages, openGraphImage, openGraphImageSource, routePath }) => {
+	if (!(openGraphImageSource === "default" || openGraphImage === "/og/image.png")) return openGraphImage;
+	const docsPath = normalizeDocsRoutePath({
+		docsRoute,
+		languages,
+		routePath
+	});
+	const docsImageRouteRoot = docsImageRoute.split("/").slice(0, -1).join("/");
+	if (docsPath !== docsRoute && !docsPath.startsWith(`${docsRoute}/`)) return `${docsImageRouteRoot}${docsPath}/image.png`;
+	return `${docsImageRoute}${docsPath === docsRoute ? "" : docsPath.slice(docsRoute.length)}/image.png`;
+};
+var absoluteSiteUrl = (pathname, siteUrl) => {
+	return new URL(pathname, `${siteUrl}/`).toString();
+};
+var getDocsRouteHead = (data, { appName, defaultLanguage, docsImageRoute, docsRoute = defaultDocsRoute, languages, openGraphImage, openGraphImageSource, siteDescription, siteUrl }) => {
+	if (!data) return {};
+	const title = data.title ? `${data.title} | ${appName}` : appName;
+	const description = data.description ?? siteDescription;
+	const docsPath = normalizeDocsRoutePath({
+		docsRoute,
+		languages,
+		routePath: data.routePath
+	});
+	const pageUrl = data.locale === defaultLanguage ? docsPath : `/${data.locale}${docsPath}`;
+	const imageUrl = getDocsOgImagePath({
+		docsImageRoute,
+		docsRoute,
+		languages,
+		openGraphImage,
+		openGraphImageSource,
+		routePath: docsPath
+	});
+	return { meta: [
+		{ title },
+		{
+			name: "description",
+			content: description
+		},
+		{
+			property: "og:title",
+			content: title
+		},
+		{
+			property: "og:description",
+			content: description
+		},
+		{
+			property: "og:image",
+			content: imageUrl
+		},
+		{
+			property: "og:url",
+			content: absoluteSiteUrl(pageUrl, siteUrl)
+		},
+		{
+			name: "twitter:title",
+			content: title
+		},
+		{
+			name: "twitter:description",
+			content: description
+		},
+		{
+			name: "twitter:image",
+			content: imageUrl
+		},
+		{
+			name: "twitter:url",
+			content: absoluteSiteUrl(pageUrl, siteUrl)
+		},
+		{
+			name: "twitter:card",
+			content: "summary_large_image"
+		}
+	] };
+};
+//#endregion
+export { getDocsOgImagePath, getDocsRouteHead };

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

@@ -0,0 +1,33 @@
+import { I18nConfig } from '@vezham/docs-core/i18n';
+export type DocsI18nInput<Languages extends readonly string[]> = {
+    defaultLanguage: Languages[number];
+    hideLocale?: I18nConfig<Languages[number]>['hideLocale'];
+    languages: Languages;
+};
+export declare const createDocsI18n: <const Languages extends readonly string[]>(config: DocsI18nInput<Languages>) => import('@vezham/docs-core/i18n').I18nAPI<Languages[number]>;
+export declare const normalizeLocale: <Locale extends string>(i18n: {
+    defaultLanguage: Locale;
+    languages: readonly Locale[];
+}, lang?: string) => Locale;
+export declare const isOptionalLocaleParam: <Locale extends string>(i18n: {
+    languages: readonly Locale[];
+}, lang?: string) => lang is Locale | undefined;
+export declare const isDefaultLocaleParam: <Locale extends string>(i18n: {
+    defaultLanguage: Locale;
+}, lang?: string) => lang is Locale;
+export declare const getDefaultLocaleRedirectHref: <Locale extends string>(i18n: {
+    defaultLanguage: Locale;
+}, href: string) => string | undefined;
+export declare const localizedUrl: <Locale extends string>(i18n: {
+    defaultLanguage: Locale;
+}, locale: Locale, path: string) => string;
+export declare const localizedRouteParam: <Locale extends string>(i18n: {
+    defaultLanguage: Locale;
+}, locale?: Locale) => Locale | undefined;
+export declare const localizeRouteBase: <Locale extends string>({ defaultLanguage, lang, languages, routeBase }: {
+    defaultLanguage?: Locale;
+    lang?: string;
+    languages: readonly Locale[];
+    routeBase: string;
+}) => string;
+//# sourceMappingURL=i18n.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../src/lib/runtime/docs/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,wBAAwB,CAAA;AAEpE,MAAM,MAAM,aAAa,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,IAAI;IAC/D,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAA;IACxD,SAAS,EAAE,SAAS,CAAA;CACrB,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,KAAK,CAAC,SAAS,SAAS,SAAS,MAAM,EAAE,EACtE,QAAQ,aAAa,CAAC,SAAS,CAAC,gEASjC,CAAA;AAED,eAAO,MAAM,eAAe,GAAI,MAAM,SAAS,MAAM,EACnD,MAAM;IACJ,eAAe,EAAE,MAAM,CAAA;IACvB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,EACD,OAAO,MAAM,KACZ,MAIF,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,MAAM,SAAS,MAAM,EACzD,MAAM;IACJ,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CAC7B,EACD,OAAO,MAAM,KACZ,IAAI,IAAI,MAAM,GAAG,SAEnB,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,MAAM,SAAS,MAAM,EACxD,MAAM;IACJ,eAAe,EAAE,MAAM,CAAA;CACxB,EACD,OAAO,MAAM,KACZ,IAAI,IAAI,MAEV,CAAA;AAMD,eAAO,MAAM,4BAA4B,GAAI,MAAM,SAAS,MAAM,EAChE,MAAM;IACJ,eAAe,EAAE,MAAM,CAAA;CACxB,EACD,MAAM,MAAM,uBAYb,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,MAAM,SAAS,MAAM,EAChD,MAAM;IACJ,eAAe,EAAE,MAAM,CAAA;CACxB,EACD,QAAQ,MAAM,EACd,MAAM,MAAM,WAOb,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAI,MAAM,SAAS,MAAM,EACvD,MAAM;IACJ,eAAe,EAAE,MAAM,CAAA;CACxB,EACD,SAAS,MAAM,uBAGhB,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAI,MAAM,SAAS,MAAM,EAAE,iDAKtD;IACD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;CAClB,WAMA,CAAA"}

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