@moku-labs/web 0.1.0-alpha.1

package/dist/route-builder-Lv6HUVvP.d.cts

@@ -0,0 +1,349 @@
+import { p as OGImageConfig } from "./primitives-BBo4wxUL.cjs";
+import { n as ComponentDef } from "./factory-D0m7Xil2.cjs";
+import { Processor } from "unified";
+
+//#region src/plugins/log/types.d.ts
+/** @file log plugin types — LogEntry, LogSink, ExpectChain, LogState, LogApi. */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+type LogEntry = {
+  level: LogLevel;
+  event: string;
+  data?: unknown;
+  ts: number;
+  plugin?: string;
+};
+type LogSink = {
+  write(entry: LogEntry): void;
+};
+type ExpectChain = {
+  toHaveEvent(event: string, partial?: Record<string, unknown>): ExpectChain;
+  toHaveEventInOrder(events: string[]): ExpectChain;
+  toNotHaveEvent(event: string, partial?: Record<string, unknown>): ExpectChain;
+};
+type LogState = {
+  entries: LogEntry[];
+  sinks: LogSink[];
+};
+type LogApi = {
+  info(event: string, data?: unknown): void;
+  debug(event: string, data?: unknown): void;
+  warn(event: string, data?: unknown): void;
+  error(event: string, data?: unknown, error?: Error): void;
+  trace(): readonly LogEntry[];
+  expect(): ExpectChain;
+  addSink(sink: LogSink): void;
+  reset(): void;
+};
+//#endregion
+//#region src/plugins/env/types.d.ts
+/** @file env plugin types — schema, provider, EnvApi. */
+type EnvVarSpec = {
+  public: boolean;
+  required?: boolean;
+  default?: string;
+  secret?: boolean;
+};
+type EnvProvider = {
+  name: string;
+  load(): Record<string, string | undefined>;
+};
+type EnvConfig = {
+  schema: Record<string, EnvVarSpec>;
+  providers: EnvProvider[];
+  publicPrefix: string;
+};
+type EnvState = {
+  resolved: Map<string, string>;
+  publicMap: Map<string, string>;
+};
+type EnvApi = {
+  get<K extends string>(key: K): string | undefined;
+  require(key: string): string;
+  getPublic(): Readonly<Record<string, string>>;
+  getPublicMap(): ReadonlyMap<string, string>;
+  has(key: string): boolean;
+};
+//#endregion
+//#region src/config.d.ts
+/** Top-level framework config — flows to all plugins via context. */
+type Config = {
+  mode: 'production' | 'development';
+};
+/** Framework-level event map — plugin-specific events added by each plugin's events field. */
+type Events = {
+  'content:ready': {
+    articles: Map<string, unknown[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+  'router:registered': {
+    routeCount: number;
+  };
+  'build:phase': {
+    phase: 'bundle' | 'content' | 'pages' | 'feeds' | 'sitemap' | 'og' | 'images';
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+  'component:create': {
+    name: string;
+    element: Element;
+  };
+  'component:mount': {
+    name: string;
+    element: Element;
+  };
+  'component:unmount': {
+    name: string;
+    reason: 'navigation' | 'destroy';
+  };
+  'component:destroy': {
+    name: string;
+  };
+  'nav:start': {
+    url: string;
+    fromUrl: string;
+  };
+  'nav:end': {
+    url: string;
+  };
+};
+//#endregion
+//#region src/plugins/site/types.d.ts
+/** @file site plugin types — SiteConfig + SiteState + SiteApi. */
+type SiteConfig = {
+  /** Display name of the site. */name: string; /** Base URL of the site (no trailing slash). */
+  url: string; /** Default author name for content. */
+  author: string; /** Site description for feeds, meta tags, and preview pages. */
+  description: string;
+};
+type SiteState = {
+  config: Readonly<SiteConfig>;
+};
+type SiteApi = {
+  get(): Readonly<SiteConfig>;
+  name(): string;
+  url(): string;
+  author(): string;
+  description(): string;
+};
+//#endregion
+//#region src/plugins/i18n/types.d.ts
+/** @file i18n plugin types — I18nConfig (generic over locale tuple), I18nState, I18nApi. */
+type I18nConfig<TLocales extends readonly string[] = readonly string[]> = {
+  /** Active locale codes (literal tuple preserved). */locales: TLocales; /** Default locale (must be member of locales). */
+  defaultLocale: TLocales[number]; /** Display names per locale. */
+  localeNames: Record<TLocales[number], string>; /** OG locale format mapping (e.g., { en: 'en_US' }). */
+  ogLocaleMap?: Partial<Record<TLocales[number], string>>; /** UI translation strings per locale. */
+  translations?: Record<TLocales[number], Record<string, string>>;
+};
+type I18nState<TLocales extends readonly string[] = readonly string[]> = {
+  config: Readonly<I18nConfig<TLocales>>;
+};
+type I18nApi<TLocales extends readonly string[] = readonly string[]> = {
+  locales(): TLocales;
+  defaultLocale(): TLocales[number];
+  localeName(locale: TLocales[number]): string;
+  ogLocale(locale: TLocales[number]): string;
+  t(locale: TLocales[number], key: string): string;
+};
+//#endregion
+//#region src/plugins/router/types.d.ts
+/** @file router plugin types — RouteSpec (non-accumulating), RouteBuilder, RouterApi. */
+/** Render context passed to route handlers. */
+type RenderContext = {
+  url: string;
+  locale: string;
+  params: Record<string, string>;
+  data?: unknown;
+};
+type LayoutComponent = unknown;
+type VNode = unknown;
+type HeadConfig = unknown;
+type RouteSpec = {
+  pattern: string;
+  load?: (params: Record<string, string>) => unknown;
+  layout?: LayoutComponent;
+  render?: (ctx: RenderContext) => VNode;
+  generate?: (locale: string) => Array<{
+    params: Record<string, string>;
+  }>;
+  head?: (ctx: RenderContext) => HeadConfig;
+  meta?: Record<string, unknown>;
+  toJson?: (ctx: RenderContext) => object;
+  toFile?: (ctx: RenderContext) => {
+    name: string;
+    content: string | Uint8Array;
+  };
+};
+/**
+ * Non-accumulating fluent builder. Methods mutate an internal spec and return `this`
+ * typed as the same `RouteBuilder` — type information captured in `RouteSpec` shape,
+ * not builder generics. Prevents TS inference performance collapse at 50+ routes.
+ */
+type RouteBuilder = {
+  load<T>(fn: (params: Record<string, string>) => T | Promise<T>): RouteBuilder;
+  layout(component: LayoutComponent): RouteBuilder;
+  render(fn: (ctx: RenderContext) => VNode): RouteBuilder;
+  generate(fn: (locale: string) => Array<{
+    params: Record<string, string>;
+  }>): RouteBuilder;
+  head(fn: (ctx: RenderContext) => HeadConfig): RouteBuilder;
+  meta(data: Record<string, unknown>): RouteBuilder;
+  toJson(fn: (ctx: RenderContext) => object): RouteBuilder;
+  toFile(fn: (ctx: RenderContext) => {
+    name: string;
+    content: string | Uint8Array;
+  }): RouteBuilder; /** Internal: produce the RouteSpec object. */
+  _spec(): RouteSpec;
+};
+type RouteEntry = {
+  name: string;
+  spec: RouteSpec;
+  specificity: number;
+};
+type RouterConfig<Routes extends Record<string, RouteSpec> = Record<string, RouteSpec>> = {
+  routes: Routes;
+  defaultPage?: keyof Routes & string;
+};
+type RouterState<Routes extends Record<string, RouteSpec> = Record<string, RouteSpec>> = {
+  routes: Routes;
+  entries: ReadonlyArray<RouteEntry>;
+};
+type RouterApi<Routes extends Record<string, RouteSpec> = Record<string, RouteSpec>> = {
+  routes: Routes;
+  toUrl<K extends keyof Routes>(name: K, params: Record<string, string>): string;
+  match(url: string): {
+    entry: RouteEntry;
+    params: Record<string, string>;
+  } | null;
+  entries(): ReadonlyArray<RouteEntry>;
+};
+//#endregion
+//#region src/plugins/content/types.d.ts
+type Frontmatter = {
+  title: string;
+  date: string;
+  description: string;
+  tags: string[];
+  language: string;
+  author?: string;
+  draft?: boolean;
+  [key: string]: unknown;
+};
+type ComputedFields = {
+  contentId: string;
+  readingTimeMinutes: number;
+  wordCount: number;
+};
+type Article = {
+  slug: string;
+  locale: string;
+  frontmatter: Frontmatter;
+  html: string;
+  computed: ComputedFields;
+};
+type RehypePluginEntry = readonly [unknown, Record<string, unknown>?];
+type RemarkPluginEntry = readonly [unknown, Record<string, unknown>?];
+type ContentConfig = {
+  dir: string;
+  defaultAuthor?: string;
+  trustedContent: boolean;
+  rehypePlugins?: RehypePluginEntry[];
+  remarkPlugins?: RemarkPluginEntry[];
+};
+type ContentState = {
+  processor: Processor | null;
+  articles: Map<string, Map<string, Article>>;
+  slugs: string[] | null;
+  lastPaths: Set<string>; /** Paths marked stale by `invalidate()` — re-read on next `loadAll()` then cleared. */
+  dirtyPaths: Set<string>;
+};
+type ContentApi = {
+  loadAll(): Promise<Map<string, Article[]>>;
+  load(slug: string, locale: string): Promise<Article | null>;
+  discoverSlugs(): Promise<string[]>;
+  render(markdown: string): Promise<string>;
+  invalidate(paths: string[]): void;
+  reset(): void;
+};
+//#endregion
+//#region src/plugins/build/types.d.ts
+type BuildConfig = {
+  outdir: string;
+  mode: 'production' | 'development';
+  renderMode: 'ssg' | 'spa' | 'hybrid';
+  cssEntry?: string;
+  jsEntry?: string;
+  articleRouteKey?: string;
+  sourcemap?: 'none' | 'external' | 'inline';
+};
+type BundleManifest = {
+  cssPaths: string[];
+  jsPaths: string[];
+  assets: Map<string, string>;
+};
+type BuildState = {
+  manifest: BundleManifest | null;
+  lastResult: BuildResult | null;
+};
+type BuildResult = {
+  pages: number;
+  durationMs: number;
+  manifest: BundleManifest;
+};
+type BuildApi = {
+  run(): Promise<BuildResult>;
+  getManifest(): Readonly<BundleManifest> | null;
+};
+//#endregion
+//#region src/project.d.ts
+/**
+ * Map each consumer `RouteBuilder` to the `RouteSpec` shape the router stores.
+ *
+ * Keys are preserved so `toUrl(name, ...)` and `defaultPage` stay typed.
+ */
+type RouteSpecMap<Routes extends Record<string, RouteBuilder>> = { [K in keyof Routes]: RouteSpec };
+/**
+ * Consumer-facing flat config shape.
+ *
+ * Generic over Routes (a record of `RouteBuilder`) so the literal route-name
+ * keys flow through to `app.router.routes` after the wrapper assembles the app.
+ */
+type WebAppConfig<Routes extends Record<string, RouteBuilder>> = {
+  mode?: 'production' | 'development';
+  site: SiteConfig;
+  i18n: I18nConfig;
+  routes: Routes;
+  components?: ComponentDef[];
+  spa?: {
+    viewTransitions?: boolean;
+    progressBar?: boolean;
+  };
+  ogImage?: OGImageConfig;
+  contentDir: string;
+  defaultPage?: keyof Routes & string;
+  trustedContent?: boolean;
+};
+//#endregion
+//#region src/plugins/router/route-builder.d.ts
+/**
+ * Build a `RouteSpec` via a fluent, non-accumulating builder.
+ *
+ * Methods mutate a single internal `RouteSpec` and return the same builder typed
+ * as `RouteBuilder` (NOT `RouteBuilder<T>`). Type information lives on the
+ * `RouteSpec` shape, not in builder generics — this keeps TS inference O(1) per
+ * route and prevents the 50+ route inference collapse described in D5.
+ *
+ * @param pattern - URL pattern (e.g. `/about`, `/{slug}`, `/{lang:?}/{slug}/`).
+ * @returns A `RouteBuilder` that mutates an internal spec.
+ * @example
+ * ```ts
+ * const home = route('/{lang:?}/').render(({ locale }) => <Home locale={locale} />)
+ * ```
+ */
+declare function route(pattern: string): RouteBuilder;
+//#endregion
+export { EnvApi as C, EnvVarSpec as D, EnvState as E, LogApi as O, Events as S, EnvProvider as T, I18nConfig as _, BuildConfig as a, SiteState as b, ContentApi as c, RouteBuilder as d, RouteSpec as f, I18nApi as g, RouterState as h, BuildApi as i, LogState as k, ContentConfig as l, RouterConfig as m, RouteSpecMap as n, BuildState as o, RouterApi as p, WebAppConfig as r, Article as s, route as t, ContentState as u, I18nState as v, EnvConfig as w, Config as x, SiteApi as y };

package/dist/test.cjs

@@ -0,0 +1,82 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_project = require('./project-C1vtMxE8.cjs');
+const require_factory = require('./factory-CixCpR9C.cjs');
+const require_index = require('./index.cjs');
+let _moku_labs_core = require("@moku-labs/core");
+
+//#region src/test.ts
+/** @file Test sub-path — createTestApp + createTestLog + createTestEnv factories. NEVER module-level singletons. */
+/**
+* Returns a FRESH log core-plugin instance per call — never a shared singleton.
+*
+* Each invocation constructs a new `createCorePlugin('log', ...)` so two calls
+* produce two distinct plugin instances with isolated state. Use when you
+* need a standalone trace separate from a running app's log.
+*
+* @returns A new log core-plugin instance, forced to `mode: 'test'`.
+* @example
+* ```ts
+* import { createTestLog } from '@moku-labs/web/test'
+* const log = createTestLog()
+* // pass to createCore({ plugins: [log] }) for an isolated test app
+* ```
+*/
+const createTestLog = () => (0, _moku_labs_core.createCorePlugin)("log", {
+	config: {
+		level: "debug",
+		mode: "test"
+	},
+	createState: require_factory.createLogState,
+	api: require_factory.createLogApi
+});
+/**
+* Returns a FRESH env core-plugin instance per call — never a shared singleton.
+*
+* Useful for testing env-dependent behavior in isolation: pass a stub `providers`
+* array of inline `{ name, load }` objects to inject deterministic values without
+* touching `process.env`, `.env.local`, or Cloudflare globals.
+*
+* @param config - Partial EnvConfig overrides. Defaults: empty schema, no providers, `PUBLIC_` prefix.
+* @returns A new env core-plugin instance.
+* @example
+* ```ts
+* import { createTestEnv } from '@moku-labs/web/test'
+* const env = createTestEnv({
+*   schema: { PUBLIC_X: { public: true, required: true } },
+*   providers: [{ name: 'inline', load: () => ({ PUBLIC_X: 'value' }) }],
+* })
+* // pass to createCore({ plugins: [env] }) for an isolated test app
+* ```
+*/
+const createTestEnv = (config = {}) => (0, _moku_labs_core.createCorePlugin)("env", {
+	config: {
+		schema: {},
+		providers: [],
+		publicPrefix: "PUBLIC_",
+		...config
+	},
+	createState: require_factory.createEnvState,
+	api: require_factory.createEnvApi,
+	onInit: require_factory.validateSchema
+});
+/**
+* Returns a fresh app instance configured for tests.
+*
+* Forces `mode: 'development'` so plugins skip production-only side effects
+* (eager bundle, watchers) and routes consumers through the standard Layer-2
+* assembly so cross-plugin wiring is exercised the same way a real app would.
+*
+* @param input - The same flat `WebAppConfig` you'd pass to `createApp`.
+* @returns The assembled app with the consumer's typed routes.
+*/
+function createTestApp(input) {
+	return require_index.createApp({
+		...input,
+		mode: "development"
+	});
+}
+
+//#endregion
+exports.createTestApp = createTestApp;
+exports.createTestEnv = createTestEnv;
+exports.createTestLog = createTestLog;

package/dist/test.d.cts

@@ -0,0 +1,61 @@
+import { C as EnvApi, D as EnvVarSpec, E as EnvState, O as LogApi, T as EnvProvider, d as RouteBuilder, k as LogState, r as WebAppConfig, w as EnvConfig } from "./route-builder-Lv6HUVvP.cjs";
+import { WebApp } from "./index.cjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/test.d.ts
+/**
+ * Returns a FRESH log core-plugin instance per call — never a shared singleton.
+ *
+ * Each invocation constructs a new `createCorePlugin('log', ...)` so two calls
+ * produce two distinct plugin instances with isolated state. Use when you
+ * need a standalone trace separate from a running app's log.
+ *
+ * @returns A new log core-plugin instance, forced to `mode: 'test'`.
+ * @example
+ * ```ts
+ * import { createTestLog } from '@moku-labs/web/test'
+ * const log = createTestLog()
+ * // pass to createCore({ plugins: [log] }) for an isolated test app
+ * ```
+ */
+declare const createTestLog: () => _moku_labs_core0.CorePluginInstance<"log", {
+  level: "debug";
+  mode: "test";
+}, LogState, LogApi>;
+/**
+ * Returns a FRESH env core-plugin instance per call — never a shared singleton.
+ *
+ * Useful for testing env-dependent behavior in isolation: pass a stub `providers`
+ * array of inline `{ name, load }` objects to inject deterministic values without
+ * touching `process.env`, `.env.local`, or Cloudflare globals.
+ *
+ * @param config - Partial EnvConfig overrides. Defaults: empty schema, no providers, `PUBLIC_` prefix.
+ * @returns A new env core-plugin instance.
+ * @example
+ * ```ts
+ * import { createTestEnv } from '@moku-labs/web/test'
+ * const env = createTestEnv({
+ *   schema: { PUBLIC_X: { public: true, required: true } },
+ *   providers: [{ name: 'inline', load: () => ({ PUBLIC_X: 'value' }) }],
+ * })
+ * // pass to createCore({ plugins: [env] }) for an isolated test app
+ * ```
+ */
+declare const createTestEnv: (config?: Partial<EnvConfig>) => _moku_labs_core0.CorePluginInstance<"env", {
+  schema: Record<string, EnvVarSpec>;
+  providers: EnvProvider[];
+  publicPrefix: string;
+}, EnvState, EnvApi>;
+/**
+ * Returns a fresh app instance configured for tests.
+ *
+ * Forces `mode: 'development'` so plugins skip production-only side effects
+ * (eager bundle, watchers) and routes consumers through the standard Layer-2
+ * assembly so cross-plugin wiring is exercised the same way a real app would.
+ *
+ * @param input - The same flat `WebAppConfig` you'd pass to `createApp`.
+ * @returns The assembled app with the consumer's typed routes.
+ */
+declare function createTestApp<Routes extends Record<string, RouteBuilder>>(input: WebAppConfig<Routes>): WebApp<Routes>;
+//#endregion
+export { createTestApp, createTestEnv, createTestLog };

package/dist/test.d.mts

@@ -0,0 +1,61 @@
+import { C as EnvApi, D as EnvVarSpec, E as EnvState, O as LogApi, T as EnvProvider, d as RouteBuilder, k as LogState, r as WebAppConfig, w as EnvConfig } from "./index-CWdZdegx.mjs";
+import { WebApp } from "./index.mjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/test.d.ts
+/**
+ * Returns a FRESH log core-plugin instance per call — never a shared singleton.
+ *
+ * Each invocation constructs a new `createCorePlugin('log', ...)` so two calls
+ * produce two distinct plugin instances with isolated state. Use when you
+ * need a standalone trace separate from a running app's log.
+ *
+ * @returns A new log core-plugin instance, forced to `mode: 'test'`.
+ * @example
+ * ```ts
+ * import { createTestLog } from '@moku-labs/web/test'
+ * const log = createTestLog()
+ * // pass to createCore({ plugins: [log] }) for an isolated test app
+ * ```
+ */
+declare const createTestLog: () => _moku_labs_core0.CorePluginInstance<"log", {
+  level: "debug";
+  mode: "test";
+}, LogState, LogApi>;
+/**
+ * Returns a FRESH env core-plugin instance per call — never a shared singleton.
+ *
+ * Useful for testing env-dependent behavior in isolation: pass a stub `providers`
+ * array of inline `{ name, load }` objects to inject deterministic values without
+ * touching `process.env`, `.env.local`, or Cloudflare globals.
+ *
+ * @param config - Partial EnvConfig overrides. Defaults: empty schema, no providers, `PUBLIC_` prefix.
+ * @returns A new env core-plugin instance.
+ * @example
+ * ```ts
+ * import { createTestEnv } from '@moku-labs/web/test'
+ * const env = createTestEnv({
+ *   schema: { PUBLIC_X: { public: true, required: true } },
+ *   providers: [{ name: 'inline', load: () => ({ PUBLIC_X: 'value' }) }],
+ * })
+ * // pass to createCore({ plugins: [env] }) for an isolated test app
+ * ```
+ */
+declare const createTestEnv: (config?: Partial<EnvConfig>) => _moku_labs_core0.CorePluginInstance<"env", {
+  schema: Record<string, EnvVarSpec>;
+  providers: EnvProvider[];
+  publicPrefix: string;
+}, EnvState, EnvApi>;
+/**
+ * Returns a fresh app instance configured for tests.
+ *
+ * Forces `mode: 'development'` so plugins skip production-only side effects
+ * (eager bundle, watchers) and routes consumers through the standard Layer-2
+ * assembly so cross-plugin wiring is exercised the same way a real app would.
+ *
+ * @param input - The same flat `WebAppConfig` you'd pass to `createApp`.
+ * @returns The assembled app with the consumer's typed routes.
+ */
+declare function createTestApp<Routes extends Record<string, RouteBuilder>>(input: WebAppConfig<Routes>): WebApp<Routes>;
+//#endregion
+export { createTestApp, createTestEnv, createTestLog };

package/dist/test.mjs

@@ -0,0 +1,79 @@
+import { _ as createEnvState, g as validateSchema, h as createLogApi, m as createLogState, v as createEnvApi } from "./factory-DwpBwjDk.mjs";
+import "./project-BTNUWbGQ.mjs";
+import { createApp } from "./index.mjs";
+import { createCorePlugin } from "@moku-labs/core";
+
+//#region src/test.ts
+/** @file Test sub-path — createTestApp + createTestLog + createTestEnv factories. NEVER module-level singletons. */
+/**
+* Returns a FRESH log core-plugin instance per call — never a shared singleton.
+*
+* Each invocation constructs a new `createCorePlugin('log', ...)` so two calls
+* produce two distinct plugin instances with isolated state. Use when you
+* need a standalone trace separate from a running app's log.
+*
+* @returns A new log core-plugin instance, forced to `mode: 'test'`.
+* @example
+* ```ts
+* import { createTestLog } from '@moku-labs/web/test'
+* const log = createTestLog()
+* // pass to createCore({ plugins: [log] }) for an isolated test app
+* ```
+*/
+const createTestLog = () => createCorePlugin("log", {
+	config: {
+		level: "debug",
+		mode: "test"
+	},
+	createState: createLogState,
+	api: createLogApi
+});
+/**
+* Returns a FRESH env core-plugin instance per call — never a shared singleton.
+*
+* Useful for testing env-dependent behavior in isolation: pass a stub `providers`
+* array of inline `{ name, load }` objects to inject deterministic values without
+* touching `process.env`, `.env.local`, or Cloudflare globals.
+*
+* @param config - Partial EnvConfig overrides. Defaults: empty schema, no providers, `PUBLIC_` prefix.
+* @returns A new env core-plugin instance.
+* @example
+* ```ts
+* import { createTestEnv } from '@moku-labs/web/test'
+* const env = createTestEnv({
+*   schema: { PUBLIC_X: { public: true, required: true } },
+*   providers: [{ name: 'inline', load: () => ({ PUBLIC_X: 'value' }) }],
+* })
+* // pass to createCore({ plugins: [env] }) for an isolated test app
+* ```
+*/
+const createTestEnv = (config = {}) => createCorePlugin("env", {
+	config: {
+		schema: {},
+		providers: [],
+		publicPrefix: "PUBLIC_",
+		...config
+	},
+	createState: createEnvState,
+	api: createEnvApi,
+	onInit: validateSchema
+});
+/**
+* Returns a fresh app instance configured for tests.
+*
+* Forces `mode: 'development'` so plugins skip production-only side effects
+* (eager bundle, watchers) and routes consumers through the standard Layer-2
+* assembly so cross-plugin wiring is exercised the same way a real app would.
+*
+* @param input - The same flat `WebAppConfig` you'd pass to `createApp`.
+* @returns The assembled app with the consumer's typed routes.
+*/
+function createTestApp(input) {
+	return createApp({
+		...input,
+		mode: "development"
+	});
+}
+
+//#endregion
+export { createTestApp, createTestEnv, createTestLog };