@moku-labs/web 0.1.0-alpha.1

package/dist/index-CWdZdegx.d.mts

@@ -0,0 +1,349 @@
+import { p as OGImageConfig } from "./primitives-kuZFxqV7.mjs";
+import { n as ComponentDef } from "./factory-BBVQO5ZG.mjs";
+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/index.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_project = require('./project-C1vtMxE8.cjs');
+const require_factory = require('./factory-CixCpR9C.cjs');
+const require_primitives = require('./primitives-BYUp6kae.cjs');
+const require_plugins_spa_index = require('./plugins/spa/index.cjs');
+
+//#region src/index.ts
+/** @file Framework entry — Layer-2 createApp wrapper + barrel re-exports. */
+const { createApp: kernelCreateApp } = require_factory.createCore(require_factory.coreConfig, { plugins: [
+	require_factory.site,
+	require_factory.i18n,
+	require_project.content,
+	require_factory.router,
+	require_factory.head,
+	require_project.build,
+	require_plugins_spa_index.spa
+] });
+/**
+* Layer-2 createApp wrapper — generic-preserving signature.
+*
+* Projects the consumer's flat config into pluginConfigs before delegating to
+* the kernel-bound createApp. The Routes generic flows through to
+* `app.router.routes` so callers get typed access to their route names.
+*
+* @param input - Consumer-facing flat web-app config.
+* @returns The assembled app with typed router routes.
+*/
+function createApp(input) {
+	const projected = require_project.project(input);
+	return kernelCreateApp({
+		...projected.config === void 0 ? {} : { config: projected.config },
+		pluginConfigs: projected.pluginConfigs
+	});
+}
+
+//#endregion
+exports.canonical = require_primitives.canonical;
+exports.createApp = createApp;
+exports.createComponent = require_factory.createComponent;
+exports.feedLink = require_primitives.feedLink;
+exports.hreflang = require_primitives.hreflang;
+exports.jsonLd = require_primitives.jsonLd;
+exports.meta = require_primitives.meta;
+exports.og = require_primitives.og;
+exports.route = require_factory.route;
+exports.twitter = require_primitives.twitter;

package/dist/index.d.cts

@@ -0,0 +1,135 @@
+import { C as EnvApi, E as EnvState, O as LogApi, S as Events, _ as I18nConfig, a as BuildConfig, b as SiteState, c as ContentApi, d as RouteBuilder, f as RouteSpec, g as I18nApi, h as RouterState, i as BuildApi, k as LogState, l as ContentConfig, m as RouterConfig, n as RouteSpecMap, o as BuildState, p as RouterApi, r as WebAppConfig, s as Article, t as route, u as ContentState, v as I18nState, x as Config, y as SiteApi } from "./route-builder-Lv6HUVvP.cjs";
+import { a as meta, d as HeadPluginConfig, f as HeadState, i as jsonLd, l as HeadApi, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-BBo4wxUL.cjs";
+import { a as SpaConfig, i as SpaApi, n as ComponentDef, o as SpaState, r as ComponentHooks, t as createComponent } from "./factory-D0m7Xil2.cjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/index.d.ts
+declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_core0.AnyPluginInstance[] = readonly []>(options?: _moku_labs_core0.CreateAppOptions<Config, Events, (_moku_labs_core0.PluginInstance<"site", {
+  name: string;
+  url: string;
+  author: string;
+  description: string;
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+  'router:registered': {
+    routeCount: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  '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;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+  level: "info";
+  mode: "auto";
+}, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
+  schema: {};
+  providers: never[];
+  publicPrefix: string;
+}, EnvState, EnvApi>]>> | undefined) => _moku_labs_core0.App<Config, Events, (_moku_labs_core0.PluginInstance<"site", {
+  name: string;
+  url: string;
+  author: string;
+  description: string;
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+  'router:registered': {
+    routeCount: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  '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;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | ExtraPlugins[number], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+  level: "info";
+  mode: "auto";
+}, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
+  schema: {};
+  providers: never[];
+  publicPrefix: string;
+}, EnvState, EnvApi>]>>;
+/**
+ * Kernel app augmented so `app.router.routes` carries the consumer's literal
+ * route-name keys (with `RouteSpec` values — the shape the router stores).
+ */
+type WebApp<Routes extends Record<string, RouteBuilder>> = Omit<ReturnType<typeof kernelCreateApp>, 'router'> & {
+  router: RouterApi<RouteSpecMap<Routes>>;
+};
+/**
+ * Layer-2 createApp wrapper — generic-preserving signature.
+ *
+ * Projects the consumer's flat config into pluginConfigs before delegating to
+ * the kernel-bound createApp. The Routes generic flows through to
+ * `app.router.routes` so callers get typed access to their route names.
+ *
+ * @param input - Consumer-facing flat web-app config.
+ * @returns The assembled app with typed router routes.
+ */
+declare function createApp<Routes extends Record<string, RouteBuilder>>(input: WebAppConfig<Routes>): WebApp<Routes>;
+//#endregion
+export { type ComponentDef, type ComponentHooks, type Config, type Events, type RouteBuilder, type RouteSpec, WebApp, type WebAppConfig, canonical, createApp, createComponent, feedLink, hreflang, jsonLd, meta, og, route, twitter };

package/dist/index.d.mts

@@ -0,0 +1,135 @@
+import { C as EnvApi, E as EnvState, O as LogApi, S as Events, _ as I18nConfig, a as BuildConfig, b as SiteState, c as ContentApi, d as RouteBuilder, f as RouteSpec, g as I18nApi, h as RouterState, i as BuildApi, k as LogState, l as ContentConfig, m as RouterConfig, n as RouteSpecMap, o as BuildState, p as RouterApi, r as WebAppConfig, s as Article, t as route, u as ContentState, v as I18nState, x as Config, y as SiteApi } from "./index-CWdZdegx.mjs";
+import { a as meta, d as HeadPluginConfig, f as HeadState, i as jsonLd, l as HeadApi, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-kuZFxqV7.mjs";
+import { a as SpaConfig, i as SpaApi, n as ComponentDef, o as SpaState, r as ComponentHooks, t as createComponent } from "./factory-BBVQO5ZG.mjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
+
+//#region src/index.d.ts
+declare const kernelCreateApp: <const ExtraPlugins extends readonly _moku_labs_core0.AnyPluginInstance[] = readonly []>(options?: _moku_labs_core0.CreateAppOptions<Config, Events, (_moku_labs_core0.PluginInstance<"site", {
+  name: string;
+  url: string;
+  author: string;
+  description: string;
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+  'router:registered': {
+    routeCount: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  '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;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | ExtraPlugins[number], [...ExtraPlugins], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+  level: "info";
+  mode: "auto";
+}, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
+  schema: {};
+  providers: never[];
+  publicPrefix: string;
+}, EnvState, EnvApi>]>> | undefined) => _moku_labs_core0.App<Config, Events, (_moku_labs_core0.PluginInstance<"site", {
+  name: string;
+  url: string;
+  author: string;
+  description: string;
+}, SiteState, SiteApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+  'router:registered': {
+    routeCount: number;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"spa", SpaConfig, SpaState, SpaApi, {
+  '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;
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>) | (_moku_labs_core0.PluginInstance<"build", BuildConfig, BuildState, BuildApi, {
+  'build:phase': {
+    phase: "bundle" | "content" | "pages" | "feeds" | "sitemap" | "og" | "images";
+  };
+  'build:complete': {
+    pages: number;
+    durationMs: number;
+  };
+}> & Record<never, never>) | ExtraPlugins[number], _moku_labs_core0.CoreApisFromTuple<[_moku_labs_core0.CorePluginInstance<"log", {
+  level: "info";
+  mode: "auto";
+}, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
+  schema: {};
+  providers: never[];
+  publicPrefix: string;
+}, EnvState, EnvApi>]>>;
+/**
+ * Kernel app augmented so `app.router.routes` carries the consumer's literal
+ * route-name keys (with `RouteSpec` values — the shape the router stores).
+ */
+type WebApp<Routes extends Record<string, RouteBuilder>> = Omit<ReturnType<typeof kernelCreateApp>, 'router'> & {
+  router: RouterApi<RouteSpecMap<Routes>>;
+};
+/**
+ * Layer-2 createApp wrapper — generic-preserving signature.
+ *
+ * Projects the consumer's flat config into pluginConfigs before delegating to
+ * the kernel-bound createApp. The Routes generic flows through to
+ * `app.router.routes` so callers get typed access to their route names.
+ *
+ * @param input - Consumer-facing flat web-app config.
+ * @returns The assembled app with typed router routes.
+ */
+declare function createApp<Routes extends Record<string, RouteBuilder>>(input: WebAppConfig<Routes>): WebApp<Routes>;
+//#endregion
+export { type ComponentDef, type ComponentHooks, type Config, type Events, type RouteBuilder, type RouteSpec, WebApp, type WebAppConfig, canonical, createApp, createComponent, feedLink, hreflang, jsonLd, meta, og, route, twitter };