appos 0.8.3-0 → 0.9.0-0

package/dist/api/auth.d.mts

@@ -1,4 +1,4 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import { a as AuthCaptchaConfig, c as AuthSessionConfig, d as defineAuth, f as defineEndpointRateLimits, i as Auth, l as DefineAuthOptions, n as AccessController, o as AuthConfig, p as defineAuthSchema, r as AuditAction, s as AuthPasskeyConfig, t as AccessControlRoles, u as auditActionSchema } from "../auth-BqCtM79d.mjs";
+import { a as AuthCaptchaConfig, c as AuthSessionConfig, d as defineAuth, f as defineEndpointRateLimits, i as Auth, l as DefineAuthOptions, n as AccessController, o as AuthConfig, p as defineAuthSchema, r as AuditAction, s as AuthPasskeyConfig, t as AccessControlRoles, u as auditActionSchema } from "../auth-Bs8ySjT9.mjs";
 export { AccessControlRoles, AccessController, AuditAction, Auth, AuthCaptchaConfig, AuthConfig, AuthPasskeyConfig, AuthSessionConfig, DefineAuthOptions, auditActionSchema, defineAuth, defineAuthSchema, defineEndpointRateLimits };

package/dist/api/cli.d.mts

@@ -1,8 +1,8 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { n as Container } from "../container-CESX86sZ.mjs";
+import { n as Container } from "../container-COgW9sJZ.mjs";
 import { z } from "zod";
 import { ChildProcess } from "node:child_process";
 import * as p from "@clack/prompts";

package/dist/api/cli.mjs

@@ -1,13 +1,13 @@
 import "../auth-schema-DF53iTDS.mjs";
 import "../redis-DwTSiGWI.mjs";
-import { C as version, a as COMMANDS_DIR, b as TEST_EXTENSIONS, f as FILE_EXT, h as MAIN_ENTRY, o as DATABASES_DIR, p as FIXTURES_DIR, r as BUILD_DIR, t as APPOS_DIR, u as EMAIL_THEME_FILE, v as ROOT_CSS_FILE, x as WEB_DIR } from "../constants-CA1iNKYs.mjs";
-import { a as loadEvents } from "../event-Ub9iLczk.mjs";
-import { i as loadWorkflows } from "../workflow-CRh7IYCp.mjs";
-import { r as defineMigrationOpts } from "../database-Bru1mHUy.mjs";
-import { t as defineServer } from "../server-D-KQTOit.mjs";
+import { S as WEB_DIR, a as COMMANDS_DIR, d as EMAIL_THEME_FILE, g as MAIN_ENTRY, m as FIXTURES_DIR, o as DATABASES_DIR, p as FILE_EXT, r as BUILD_DIR, t as APPOS_DIR, w as version, x as TEST_EXTENSIONS, y as ROOT_CSS_FILE } from "../constants-DS-JRVg4.mjs";
+import { a as loadEvents } from "../event-D1796YqX.mjs";
+import { i as loadWorkflows } from "../workflow-1INsBemZ.mjs";
+import { r as defineMigrationOpts } from "../database-BI18y32D.mjs";
+import { t as defineServer } from "../server-D_b4mKte.mjs";
 import "../instrumentation-NIH3Iibm.mjs";
 import "../app-context-D1ZdyKbf.mjs";
-import "../openapi-bsEnbzry.mjs";
+import "../openapi-DSnhsnI5.mjs";
 import "../context-tMoLkr9-.mjs";
 import { t as defineWorker } from "../worker-Dv-oM9rL.mjs";
 import { createRequire } from "node:module";
@@ -458,13 +458,12 @@ var build_default = defineCommand({
 						"-o",
 						`${BUILD_DIR}/storybook`,
 						"--config-dir",
-						configDir,
-						"--quiet"
+						configDir
 					]);
 				});
 				ctx.success("Built design system successfully");
 			} catch (error) {
-				ctx.warn(`Storybook build failed: ${error instanceof Error ? error.message : String(error)}`);
+				ctx.fail(`Storybook build failed: ${error instanceof Error ? error.message : String(error)}`);
 			}
 		}
 		const entryPoints = await collectEntryPoints();

package/dist/api/container.d.mts

@@ -1,6 +1,6 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { An as DefineAppContextOpts, Mn as defineAppContext, On as isLocalDev, a as defineAppContainer, i as WorkerConfig, jn as SessionData, kn as AppContext, n as Container, r as ServerConfig, t as AppContainer } from "../container-CESX86sZ.mjs";
+import { An as DefineAppContextOpts, Mn as defineAppContext, On as isLocalDev, a as defineAppContainer, i as WorkerConfig, jn as SessionData, kn as AppContext, n as Container, r as ServerConfig, t as AppContainer } from "../container-COgW9sJZ.mjs";
 export { AppContainer, AppContext, Container, DefineAppContextOpts, ServerConfig, SessionData, WorkerConfig, defineAppContainer, defineAppContext, isLocalDev };

package/dist/api/database.mjs

@@ -1,5 +1,5 @@
-import "../constants-CA1iNKYs.mjs";
-import { a as migrationsSchema, i as defineTestDatabase, n as defineDatabase, r as defineMigrationOpts, t as dbChanges } from "../database-Bru1mHUy.mjs";
+import "../constants-DS-JRVg4.mjs";
+import { a as migrationsSchema, i as defineTestDatabase, n as defineDatabase, r as defineMigrationOpts, t as dbChanges } from "../database-BI18y32D.mjs";
 
 export * from "drizzle-orm"
 

package/dist/api/event.d.mts

@@ -1,6 +1,6 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { Bn as defineEvent, Fn as Event, Hn as loadEvents, In as EventBus, Ln as EventContext, Nn as DbChangeInput, Pn as DefineEventBusOptions, Rn as dbChangeInputSchema, Vn as defineEventBus, zn as dbChangesEvent } from "../container-CESX86sZ.mjs";
+import { Bn as defineEvent, Fn as Event, Hn as loadEvents, In as EventBus, Ln as EventContext, Nn as DbChangeInput, Pn as DefineEventBusOptions, Rn as dbChangeInputSchema, Vn as defineEventBus, zn as dbChangesEvent } from "../container-COgW9sJZ.mjs";
 export { DbChangeInput, DefineEventBusOptions, Event, EventBus, EventContext, dbChangeInputSchema, dbChangesEvent, defineEvent, defineEventBus, loadEvents };

package/dist/api/event.mjs

@@ -1,5 +1,5 @@
 import "../redis-DwTSiGWI.mjs";
-import "../constants-CA1iNKYs.mjs";
-import { a as loadEvents, i as defineEventBus, n as dbChangesEvent, r as defineEvent, t as dbChangeInputSchema } from "../event-Ub9iLczk.mjs";
+import "../constants-DS-JRVg4.mjs";
+import { a as loadEvents, i as defineEventBus, n as dbChangesEvent, r as defineEvent, t as dbChangeInputSchema } from "../event-D1796YqX.mjs";
 
 export { dbChangeInputSchema, dbChangesEvent, defineEvent, defineEventBus, loadEvents };

package/dist/api/mailer.d.mts

@@ -1,6 +1,6 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { $ as EmailButtonProps, A as Row, B as render, C as MailerPayloadReact, D as Preview, E as MarkdownProps, F as TailwindProps, G as EmailTheme, H as EmailLayout, I as defineEmail, J as getDefaultEmailTheme, K as defineEmailTailwindConfig, L as defineMailer, M as Section, N as SectionProps, O as PreviewProps, P as Tailwind, Q as Container, R as plainTextSelectors, S as MailerPayloadHtml, T as Markdown, U as EmailLayoutProps, V as toPlainText, W as EMAIL_THEME_KEYS, X as CodeBlock, Y as Button, Z as CodeInline, _ as HeadProps, _t as emailImgVariantKeys, at as EmailImgProps, b as Mailer, c as DefineEmailOptions, ct as Heading, d as EmailColumn, dt as Link, et as EmailCodeBlockProps, f as EmailColumnProps, ft as Text, g as Head, gt as emailHeadingSizeKeys, h as FontProps, ht as emailContainerVariantKeys, it as EmailHrProps, j as RowProps, k as RenderOptions, l as DefineMailerOptions, lt as Hr, m as Font, mt as emailButtonVariantKeys, nt as EmailContainerProps, o as Body, ot as EmailLinkProps, p as EmailComponent, pt as emailButtonSizeKeys, q as defineEmailTheme, rt as EmailHeadingProps, s as BodyProps, st as EmailTextProps, tt as EmailCodeInlineProps, u as DefineMailerOptionsWithQueue, ut as Img, v as Html, vt as emailTextVariantKeys, w as MailerWithQueue, x as MailerPayload, y as HtmlProps, z as pretty } from "../container-CESX86sZ.mjs";
+import { $ as EmailButtonProps, A as Row, B as render, C as MailerPayloadReact, D as Preview, E as MarkdownProps, F as TailwindProps, G as EmailTheme, H as EmailLayout, I as defineEmail, J as getDefaultEmailTheme, K as defineEmailTailwindConfig, L as defineMailer, M as Section, N as SectionProps, O as PreviewProps, P as Tailwind, Q as Container, R as plainTextSelectors, S as MailerPayloadHtml, T as Markdown, U as EmailLayoutProps, V as toPlainText, W as EMAIL_THEME_KEYS, X as CodeBlock, Y as Button, Z as CodeInline, _ as HeadProps, _t as emailImgVariantKeys, at as EmailImgProps, b as Mailer, c as DefineEmailOptions, ct as Heading, d as EmailColumn, dt as Link, et as EmailCodeBlockProps, f as EmailColumnProps, ft as Text, g as Head, gt as emailHeadingSizeKeys, h as FontProps, ht as emailContainerVariantKeys, it as EmailHrProps, j as RowProps, k as RenderOptions, l as DefineMailerOptions, lt as Hr, m as Font, mt as emailButtonVariantKeys, nt as EmailContainerProps, o as Body, ot as EmailLinkProps, p as EmailComponent, pt as emailButtonSizeKeys, q as defineEmailTheme, rt as EmailHeadingProps, s as BodyProps, st as EmailTextProps, tt as EmailCodeInlineProps, u as DefineMailerOptionsWithQueue, ut as Img, v as Html, vt as emailTextVariantKeys, w as MailerWithQueue, x as MailerPayload, y as HtmlProps, z as pretty } from "../container-COgW9sJZ.mjs";
 export { Body, BodyProps, Button, CodeBlock, CodeInline, DefineEmailOptions, DefineMailerOptions, DefineMailerOptionsWithQueue, EMAIL_THEME_KEYS, EmailButtonProps, EmailCodeBlockProps, EmailCodeInlineProps, EmailColumn, EmailColumnProps, EmailComponent, Container as EmailContainer, EmailContainerProps, EmailHeadingProps, EmailHrProps, EmailImgProps, EmailLayout, EmailLayoutProps, EmailLinkProps, EmailTextProps, EmailTheme, Font, FontProps, Head, HeadProps, Heading, Hr, Html, HtmlProps, Img, Link, Mailer, MailerPayload, MailerPayloadHtml, MailerPayloadReact, MailerWithQueue, Markdown, MarkdownProps, Preview, PreviewProps, RenderOptions, Row, RowProps, Section, SectionProps, Tailwind, TailwindProps, Text, defineEmail, defineEmailTailwindConfig, defineEmailTheme, defineMailer, emailButtonSizeKeys, emailButtonVariantKeys, emailContainerVariantKeys, emailHeadingSizeKeys, emailImgVariantKeys, emailTextVariantKeys, getDefaultEmailTheme, plainTextSelectors, pretty, render, toPlainText };

package/dist/api/mailer.mjs

@@ -1,8 +1,8 @@
 import "../auth-schema-DF53iTDS.mjs";
 import "../redis-DwTSiGWI.mjs";
-import { i as BUILD_OUTPUT_DIR, u as EMAIL_THEME_FILE, v as ROOT_CSS_FILE, x as WEB_DIR } from "../constants-CA1iNKYs.mjs";
-import "../event-Ub9iLczk.mjs";
-import { a as sendEmail } from "../workflow-CRh7IYCp.mjs";
+import { S as WEB_DIR, d as EMAIL_THEME_FILE, i as BUILD_OUTPUT_DIR, y as ROOT_CSS_FILE } from "../constants-DS-JRVg4.mjs";
+import "../event-D1796YqX.mjs";
+import { a as sendEmail } from "../workflow-1INsBemZ.mjs";
 import { n as parseThemeFromString } from "../colors-BNWHnGHM.mjs";
 import { join } from "node:path";
 import { existsSync, readFileSync } from "node:fs";

package/dist/api/openapi.d.mts

@@ -1,6 +1,6 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { $t as DefineOpenAPIConfigInput, Qt as DefineOpenAPIConfig, an as RouteModule, cn as defineOpenAPIConfig, dn as generateOpenAPIDocument, en as DefineOpenAPIReturn, fn as loadAndRegisterAPIRoutes, hn as writeOpenAPISpecs, in as OpenAPIRegistration, ln as defineOpenAPIEndpoint, mn as scanAPIRoutes, nn as OpenAPIMethodSpec, on as ValidationErrorResponse, pn as registerRoutes, rn as OpenAPIObjectConfigV31, sn as defineOpenAPI, tn as HandlerParams, un as defineTypedResponses } from "../container-CESX86sZ.mjs";
+import { $t as DefineOpenAPIConfigInput, Qt as DefineOpenAPIConfig, an as RouteModule, cn as defineOpenAPIConfig, dn as generateOpenAPIDocument, en as DefineOpenAPIReturn, fn as loadAndRegisterAPIRoutes, hn as writeOpenAPISpecs, in as OpenAPIRegistration, ln as defineOpenAPIEndpoint, mn as scanAPIRoutes, nn as OpenAPIMethodSpec, on as ValidationErrorResponse, pn as registerRoutes, rn as OpenAPIObjectConfigV31, sn as defineOpenAPI, tn as HandlerParams, un as defineTypedResponses } from "../container-COgW9sJZ.mjs";
 export { DefineOpenAPIConfig, DefineOpenAPIConfigInput, DefineOpenAPIReturn, HandlerParams, OpenAPIMethodSpec, OpenAPIObjectConfigV31, OpenAPIRegistration, RouteModule, ValidationErrorResponse, defineOpenAPI, defineOpenAPIConfig, defineOpenAPIEndpoint, defineTypedResponses, generateOpenAPIDocument, loadAndRegisterAPIRoutes, registerRoutes, scanAPIRoutes, writeOpenAPISpecs };

package/dist/api/openapi.mjs

@@ -1,5 +1,5 @@
-import "../constants-CA1iNKYs.mjs";
+import "../constants-DS-JRVg4.mjs";
 import "../app-context-D1ZdyKbf.mjs";
-import { a as generateOpenAPIDocument, c as scanAPIRoutes, i as defineTypedResponses, l as writeOpenAPISpecs, n as defineOpenAPIConfig, o as loadAndRegisterAPIRoutes, r as defineOpenAPIEndpoint, s as registerRoutes, t as defineOpenAPI } from "../openapi-bsEnbzry.mjs";
+import { a as generateOpenAPIDocument, c as scanAPIRoutes, i as defineTypedResponses, l as writeOpenAPISpecs, n as defineOpenAPIConfig, o as loadAndRegisterAPIRoutes, r as defineOpenAPIEndpoint, s as registerRoutes, t as defineOpenAPI } from "../openapi-DSnhsnI5.mjs";
 
 export { defineOpenAPI, defineOpenAPIConfig, defineOpenAPIEndpoint, defineTypedResponses, generateOpenAPIDocument, loadAndRegisterAPIRoutes, registerRoutes, scanAPIRoutes, writeOpenAPISpecs };

package/dist/api/server.d.mts

@@ -1,6 +1,6 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import "../auth-BqCtM79d.mjs";
+import "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { Cn as defineServer, Dn as i18n, En as defineI18n, Sn as ServerInstance, Tn as defaultI18nConfig, _n as defineMiddleware, bn as DefineServerOptions, gn as Middleware, vn as loadMiddleware, wn as I18nInitOptions, xn as Server, yn as App } from "../container-CESX86sZ.mjs";
+import { Cn as defineServer, Dn as i18n, En as defineI18n, Sn as ServerInstance, Tn as defaultI18nConfig, _n as defineMiddleware, bn as DefineServerOptions, gn as Middleware, vn as loadMiddleware, wn as I18nInitOptions, xn as Server, yn as App } from "../container-COgW9sJZ.mjs";
 export { App, DefineServerOptions, I18nInitOptions, Middleware, Server, ServerInstance, defaultI18nConfig, defineI18n, defineMiddleware, defineServer, i18n, loadMiddleware };

package/dist/api/server.mjs

@@ -1,8 +1,8 @@
-import "../constants-CA1iNKYs.mjs";
-import { a as loadMiddleware, i as defineMiddleware, n as defaultI18nConfig, r as defineI18n, t as defineServer } from "../server-D-KQTOit.mjs";
+import "../constants-DS-JRVg4.mjs";
+import { a as loadMiddleware, i as defineMiddleware, n as defaultI18nConfig, r as defineI18n, t as defineServer } from "../server-D_b4mKte.mjs";
 import "../instrumentation-NIH3Iibm.mjs";
 import "../app-context-D1ZdyKbf.mjs";
-import "../openapi-bsEnbzry.mjs";
+import "../openapi-DSnhsnI5.mjs";
 import "../context-tMoLkr9-.mjs";
 
 export { defaultI18nConfig, defineI18n, defineMiddleware, defineServer, loadMiddleware };

package/dist/api/ssr.d.mts

@@ -1,8 +1,8 @@
 import "../logger-C8gOLrUv.mjs";
 import "../database-CxDXJbvJ.mjs";
-import { m as AuthPaths, o as AuthConfig } from "../auth-BqCtM79d.mjs";
+import { m as AuthPaths, o as AuthConfig } from "../auth-Bs8ySjT9.mjs";
 import "../cache-M0z3800A.mjs";
-import { kn as AppContext } from "../container-CESX86sZ.mjs";
+import { kn as AppContext } from "../container-COgW9sJZ.mjs";
 import * as react_router0 from "react-router";
 import { RouterContextProvider } from "react-router";
 import { GetLoadContextFunction } from "@react-router/express";
@@ -92,7 +92,240 @@ interface AuthRoutesConfig {
  */
 declare function defineAuthRoutes(options: AuthRoutesOptions): AuthRoutesConfig;
 //#endregion
+//#region src/web/routes/docs/utils.d.ts
+/**
+ * Options for configuring documentation routes.
+ */
+interface DocsRoutesOptions {
+  /**
+   * Base URL path for documentation.
+   *
+   * @default "/docs"
+   */
+  basePath?: string;
+  /**
+   * Directory containing documentation MDX files.
+   *
+   * @default "docs"
+   */
+  dir?: string;
+  /**
+   * Explicit version list. If not provided, versions are auto-discovered
+   * from docs/v*\/ folders (or docs/{defaultLanguage}/v*\/ with i18n).
+   *
+   * @example ["v1", "v2"]
+   */
+  versions?: string[];
+  /**
+   * i18n configuration for docs. Matches vite.config.ts docs.i18n structure.
+   *
+   * When provided, version discovery looks inside the default language folder
+   * (e.g., docs/en/v1, docs/en/v2) instead of docs/ directly.
+   *
+   * @example
+   * ```typescript
+   * i18n: {
+   *   languages: ["en", "zh-CN", "zh-TW"],
+   *   defaultLanguage: "en",
+   * }
+   * ```
+   */
+  i18n?: {
+    /** List of supported language codes. */languages: string[]; /** Default language code used for version discovery. */
+    defaultLanguage: string;
+  };
+}
+/**
+ * Middleware function type for React Router v7.
+ */
+type MiddlewareFunction = (args: {
+  request: Request;
+  params: Record<string, string | undefined>;
+}, next: () => Promise<Response>) => Promise<Response> | Response;
+/**
+ * Configuration object returned by defineDocsRoutes().
+ */
+interface DocsRoutesConfig {
+  /**
+   * Route configuration to spread into your routes.ts default export.
+   *
+   * @example
+   * ```typescript
+   * export default [
+   *   ...docsRoutes.routes,
+   *   ...flatRoutes({ config }),
+   * ];
+   * ```
+   */
+  routes: RouteConfigEntry[];
+  /**
+   * Middleware to add to root.tsx for handling .mdx requests.
+   *
+   * Rewrites /docs/*.mdx requests to internal /__mdx.docs/* route.
+   *
+   * @example
+   * ```typescript
+   * // root.tsx
+   * import { docsRoutes } from "./routes.ts";
+   * export const middleware = [docsRoutes.middleware];
+   * ```
+   */
+  middleware: MiddlewareFunction;
+  /**
+   * The base URL path for documentation.
+   */
+  basePath: string;
+  /**
+   * Discovered or provided version list.
+   */
+  versions: string[];
+}
+/**
+ * Generates documentation route configuration.
+ *
+ * Creates routes for a Fumadocs-powered documentation site with:
+ * - Version support (auto-discovered from docs/v*\/ folders)
+ * - Clean URLs for latest version (no version prefix)
+ * - Full-text search via Fumadocs
+ *
+ * Language is determined by Accept-Language header via i18n middleware.
+ *
+ * @param options - Configuration options
+ * @returns Configuration object with routes and metadata
+ *
+ * @example
+ * ```typescript
+ * import { defineDocsRoutes, defineFlatRoutes } from "appos/api/ssr";
+ *
+ * export const docsRoutes = defineDocsRoutes({
+ *   basePath: "/docs",
+ * });
+ *
+ * export default [
+ *   ...await defineFlatRoutes({ config }),
+ *   ...docsRoutes.routes,
+ * ];
+ * ```
+ */
+declare function defineDocsRoutes(options?: DocsRoutesOptions): DocsRoutesConfig;
+/**
+ * Parsed components from a documentation URL path.
+ */
+interface ParsedDocsPath {
+  /**
+   * Version from URL (e.g., "v1") or resolved latest version.
+   */
+  version: string | null;
+  /**
+   * Remaining path segments after version.
+   */
+  slug: string[];
+  /**
+   * Whether this resolves to the latest version.
+   * True when no version in URL or version equals latest.
+   */
+  isLatest: boolean;
+}
+/**
+ * Parses a docs path into version and slug components.
+ *
+ * If no version in URL and versions exist, resolves to latest version.
+ * Handles both versioned and non-versioned documentation structures.
+ *
+ * @param path - Path after the docs base path (e.g., "v1/getting-started")
+ * @returns Parsed path components
+ *
+ * @example
+ * ```typescript
+ * // With versions ["v1", "v2"], latest is "v2"
+ * parseDocsPath("v1/getting-started")
+ * // → { version: "v1", slug: ["getting-started"], isLatest: false }
+ *
+ * parseDocsPath("getting-started")
+ * // → { version: "v2", slug: ["getting-started"], isLatest: true }
+ * ```
+ */
+declare function parseDocsPath(path: string): ParsedDocsPath;
+declare global {
+  var __APPOS_DOCS_VERSIONS__: string[] | undefined;
+  var __APPOS_DOCS_LATEST_VERSION__: string | null | undefined;
+  var __APPOS_DOCS_DIR__: string | undefined;
+  var __APPOS_DOCS_BASE_PATH__: string | undefined;
+}
+/**
+ * Creates middleware for handling raw MDX file requests.
+ *
+ * Rewrites requests like `/docs/*.mdx` to the internal MDX resource route.
+ * Must be called after `defineDocsRoutes()` has been executed, as it reads
+ * from the global config set by that function.
+ *
+ * If docs are not configured (i.e., `defineDocsRoutes()` was not called or
+ * returned no routes), returns a no-op middleware.
+ *
+ * @returns Middleware function to add to root.tsx middleware array.
+ *
+ * @example
+ * ```typescript
+ * // routes.ts
+ * export const docsRoutes = defineDocsRoutes({ basePath: "/docs" });
+ *
+ * // root.tsx
+ * import { defineDocsMiddleware } from "appos/api/ssr";
+ * export const middleware = [defineDocsMiddleware()];
+ * ```
+ */
+declare function defineDocsMiddleware(): MiddlewareFunction;
+/**
+ * Options for building a docs page URL.
+ */
+interface BuildDocsPageUrlOptions {
+  /** Base path for docs (e.g., "/docs"). */
+  basePath: string;
+  /** Page path segments from fumadocs (e.g., ["v2", "getting-started"]). */
+  slugs: string[];
+  /** Latest version identifier (e.g., "v2"). */
+  latestVersion?: string | null;
+}
+/**
+ * Builds a docs page URL with proper latest version omission.
+ *
+ * URL patterns:
+ * - Latest version: /docs/getting-started
+ * - Non-latest version: /docs/v1/getting-started
+ *
+ * @param options - URL building options.
+ * @returns URL path string.
+ *
+ * @example
+ * ```typescript
+ * // Latest version
+ * buildDocsPageUrl({
+ *   basePath: "/docs",
+ *   slugs: ["v2", "getting-started"],
+ *   latestVersion: "v2",
+ * });
+ * // Returns: "/docs/getting-started"
+ * ```
+ */
+declare function buildDocsPageUrl(options: BuildDocsPageUrlOptions): string;
+//#endregion
 //#region src/web/routes.d.ts
+/**
+ * Resolves absolute path to a route file in this package.
+ *
+ * Finds the package root by walking up until finding package.json,
+ * then returns path to src/web/routes/{relativePath}.
+ *
+ * @param relativePath - Path relative to src/web/routes/
+ * @returns Absolute path to the route file
+ *
+ * @example
+ * ```typescript
+ * resolveRoutePath("auth/login.tsx")
+ * // → "/path/to/appos/src/web/routes/auth/login.tsx"
+ * ```
+ */
+declare function resolveRoutePath(relativePath: string): string;
 /**
  * Options for configuring flat routes.
  */
@@ -147,4 +380,4 @@ declare function defineFlatRoutes(options: DefineFlatRoutesOptions): Promise<Rou
  */
 declare const appLoadContext: react_router0.RouterContext<AppContext>;
 //#endregion
-export { type AuthPaths, type AuthRoutesConfig, type AuthRoutesOptions, type Config, DefineFlatRoutesOptions, type GetLoadContextFunction, type RenderToPipeableStreamOptions, type RouteConfig, RouterContextProvider, appLoadContext, createReadableStreamFromReadable, defineAuthRoutes, defineFlatRoutes, isbot, renderToPipeableStream };
+export { type AuthPaths, type AuthRoutesConfig, type AuthRoutesOptions, type BuildDocsPageUrlOptions, type Config, DefineFlatRoutesOptions, type DocsRoutesConfig, type DocsRoutesOptions, type GetLoadContextFunction, type MiddlewareFunction, type ParsedDocsPath, type RenderToPipeableStreamOptions, type RouteConfig, RouterContextProvider, appLoadContext, buildDocsPageUrl, createReadableStreamFromReadable, defineAuthRoutes, defineDocsMiddleware, defineDocsRoutes, defineFlatRoutes, isbot, parseDocsPath, renderToPipeableStream, resolveRoutePath };