@moku-labs/web 0.1.0-alpha.3 → 0.2.0

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

@@ -1,413 +0,0 @@
-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/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/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/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/plugins/deploy/types.d.ts
-/** @file deploy plugin types — DeployConfig, DeployState, DeployResult, RunOptions, DeployApi. */
-/**
- * Deployment target. Phase 1 ships `'pages'` only; `'workers'` is reserved
- * for the Workers Static Assets expansion path and `buildWranglerArgs`
- * throws "not implemented in Phase 1" if invoked with it.
- */
-type DeployTarget = 'pages' | 'workers';
-/**
- * deploy plugin config.
- *
- * `outdir` precedence at deploy time: `wrangler.jsonc#pages_build_output_dir`
- * (written by `moku deploy init`) — this is the deploy-time single source of
- * truth, NOT `DeployConfig.outdir`. The config field is the *init-time* default;
- * once `wrangler.jsonc` exists, it owns the value.
- *
- * Forbidden: reading the `build` plugin's config via `ctx.has(build)` /
- * `ctx.require(build).config.outdir`. The core `HasFunction` takes a name
- * string and returns a non-narrowing boolean; `RequireFunction` returns the
- * API surface only (`BuildApi = { run, getManifest }`). The optional coupling
- * is a `ctx.log.warn` at init time when divergence is detectable through the
- * directly-imported `build` plugin instance, never via the core API.
- */
-type DeployConfig = {
-  /** Deployment target. Default: `'pages'`. */target: DeployTarget; /** Build output directory used at init only. Default: `'dist'` (matches build plugin default). */
-  outdir: string; /** Production branch name. Default: `'main'`. Overwritten by `init` via `git symbolic-ref`. */
-  productionBranch: string; /** Optional explicit override for the Cloudflare Pages project name. Default: derived from `site.name`. */
-  projectName?: string;
-};
-/**
- * In-memory deploy plugin state.
- *
- * `lastDeployment` is reset per `createApp()` call and captures the most
- * recent deploy's metadata (URL, deployment ID, branch, duration). Used by
- * the future REST-API-based rollback command (deferred from Phase 1).
- */
-type DeployState = {
-  lastDeployment: DeployResult | null;
-};
-/** Result of a successful `app.deploy.run()` invocation. */
-type DeployResult = {
-  /** Production URL (e.g., `https://<project>.pages.dev`) or branch-alias preview URL. */url: string; /** Cloudflare deployment ID — captured for future rollback support. */
-  deploymentId: string; /** Branch the deploy was published to. */
-  branch: string; /** Total subprocess duration in milliseconds (init + upload + finalize). */
-  durationMs: number;
-};
-/**
- * Options accepted by `app.deploy.run()`.
- *
- * `branch` overrides the production branch from wrangler.jsonc (defaults to
- * `DeployConfig.productionBranch`). `build` runs `app.build.run()` first
- * when true — used only for local convenience; the generated CI workflow
- * always issues the two-step `moku build` then `moku deploy` pattern.
- */
-type RunOptions = {
-  /** Override the production branch for this deploy. */branch?: string; /** Run `app.build.run()` first (local convenience). Default: `false`. */
-  build?: boolean;
-};
-/** Public deploy plugin API surface, attached as `app.deploy`. */
-type DeployApi = {
-  /** Run a deploy. Reads outdir from wrangler.jsonc; errors if missing. */run(options?: RunOptions): Promise<DeployResult>; /** Read the last deployment result without re-running. */
-  getLastDeployment(): Readonly<DeployResult> | 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 { EnvVarSpec as A, SiteState as C, EnvConfig as D, EnvApi as E, LogState as M, EnvProvider as O, SiteApi as S, Events as T, ContentConfig as _, DeployConfig as a, I18nConfig as b, BuildConfig as c, RouteSpec as d, RouterApi as f, ContentApi as g, Article as h, DeployApi as i, LogApi as j, EnvState as k, BuildState as l, RouterState as m, RouteSpecMap as n, DeployState as o, RouterConfig as p, WebAppConfig as r, BuildApi as s, route as t, RouteBuilder as u, ContentState as v, Config as w, I18nState as x, I18nApi as y };

package/dist/test.cjs

@@ -1,82 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_project = require('./project-1pAh4RxJ.cjs');
-const require_factory = require('./factory-DVcAQYEZ.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

@@ -1,61 +0,0 @@
-import { A as EnvVarSpec, D as EnvConfig, E as EnvApi, M as LogState, O as EnvProvider, j as LogApi, k as EnvState, r as WebAppConfig, u as RouteBuilder } from "./route-builder-CKvvehVO.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

@@ -1,61 +0,0 @@
-import { A as EnvVarSpec, D as EnvConfig, E as EnvApi, M as LogState, O as EnvProvider, j as LogApi, k as EnvState, r as WebAppConfig, u as RouteBuilder } from "./index-CddOHo8I.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

@@ -1,79 +0,0 @@
-import { _ as createEnvState, g as validateSchema, h as createLogApi, m as createLogState, v as createEnvApi } from "./factory-DwpBwjDk.mjs";
-import "./project-BaG_ipVz.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 };