@moku-labs/web 0.1.0-alpha.1 → 0.1.0-alpha.4

package/dist/{factory-BBVQO5ZG.d.mts → factory-DRFGSslp.d.mts}

@@ -1,4 +1,6 @@
-//#region src/plugins/spa/types.d.ts
+declare namespace types_d_exports {
+  export { ComponentDef, ComponentHooks, ComponentInstance, ComponentMap, ComponentsSubApi, EventBus, EventBusListener, HeadSubApi, LifecycleEventMap, MountContext, NavEndContext, NavStartContext, PageData, ProgressSubApi, RouterHandlers, RouterSubApi, SpaApi, SpaConfig, SpaRuntime, SpaState, UnMountContext };
+}
 /** @file spa plugin shared types — config envelope, composed state, composed API, ComponentDef. */
 type ComponentHooks = {
   onCreate?(element: Element): void;
@@ -39,6 +41,7 @@ type SpaConfig = {
   config: SpaRuntime;
   components: ComponentDef[];
 };
+type ComponentMap = ComponentDef[];
 type EventBusListener = (payload: unknown) => void;
 type EventBus = {
   on(event: string, listener: EventBusListener): () => void;
@@ -83,8 +86,29 @@ type SpaApi = {
   progress: ProgressSubApi;
   components: ComponentsSubApi;
 };
+type MountContext = {
+  container: Element;
+  pageData?: unknown;
+  url: string;
+};
+type NavStartContext = {
+  url: string;
+  fromUrl: string;
+};
+type NavEndContext = {
+  url: string;
+  pageData?: unknown;
+  doc?: Document;
+};
+type UnMountContext = {
+  reason: 'navigation' | 'destroy';
+  element: Element;
+};
+type PageData = unknown;
+type RouterHandlers = unknown;
+type LifecycleEventMap = unknown;
 //#endregion
 //#region src/plugins/spa/components/factory.d.ts
 declare const createComponent: (name: string, hooks: ComponentHooks) => ComponentDef;
 //#endregion
-export { SpaConfig as a, SpaApi as i, ComponentDef as n, SpaState as o, ComponentHooks as r, createComponent as t };
+export { SpaConfig as a, SpaApi as i, ComponentDef as n, SpaState as o, ComponentHooks as r, types_d_exports as s, createComponent as t };

package/dist/{factory-DwpBwjDk.mjs → factory-DiKypQqs.mjs}

@@ -1,4 +1,4 @@
-import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-gO5i1tD8.mjs";
+import { a as meta, i as jsonLd, n as feedLink, o as og, r as hreflang, s as twitter, t as canonical } from "./primitives-Dhko-oLM.mjs";
 import { buildArticleHead } from "./plugins/head/build.mjs";
 import { createCoreConfig, createCorePlugin } from "@moku-labs/core";
 
@@ -1599,4 +1599,4 @@ const createComponent = (name, hooks) => {
 };
 
 //#endregion
-export { createEnvState as _, createSpaApi as a, route as c, coreConfig as d, createCore as f, validateSchema as g, createLogApi as h, createClientRuntime as i, site as l, createLogState as m, createSpaState as n, head as o, createPlugin as p, registerSpaEvents as r, router as s, createComponent as t, i18n as u, createEnvApi as v };
+export { env as _, createSpaApi as a, createEnvApi as b, route as c, coreConfig as d, createCore as f, createLogApi as g, createLogState as h, createClientRuntime as i, site as l, log as m, createSpaState as n, head as o, createPlugin as p, registerSpaEvents as r, router as s, createComponent as t, i18n as u, validateSchema as v, createEnvState as y };

package/dist/{factory-D0m7Xil2.d.cts → factory-k-YoScgB.d.cts}

@@ -1,4 +1,6 @@
-//#region src/plugins/spa/types.d.ts
+declare namespace types_d_exports {
+  export { ComponentDef, ComponentHooks, ComponentInstance, ComponentMap, ComponentsSubApi, EventBus, EventBusListener, HeadSubApi, LifecycleEventMap, MountContext, NavEndContext, NavStartContext, PageData, ProgressSubApi, RouterHandlers, RouterSubApi, SpaApi, SpaConfig, SpaRuntime, SpaState, UnMountContext };
+}
 /** @file spa plugin shared types — config envelope, composed state, composed API, ComponentDef. */
 type ComponentHooks = {
   onCreate?(element: Element): void;
@@ -39,6 +41,7 @@ type SpaConfig = {
   config: SpaRuntime;
   components: ComponentDef[];
 };
+type ComponentMap = ComponentDef[];
 type EventBusListener = (payload: unknown) => void;
 type EventBus = {
   on(event: string, listener: EventBusListener): () => void;
@@ -83,8 +86,29 @@ type SpaApi = {
   progress: ProgressSubApi;
   components: ComponentsSubApi;
 };
+type MountContext = {
+  container: Element;
+  pageData?: unknown;
+  url: string;
+};
+type NavStartContext = {
+  url: string;
+  fromUrl: string;
+};
+type NavEndContext = {
+  url: string;
+  pageData?: unknown;
+  doc?: Document;
+};
+type UnMountContext = {
+  reason: 'navigation' | 'destroy';
+  element: Element;
+};
+type PageData = unknown;
+type RouterHandlers = unknown;
+type LifecycleEventMap = unknown;
 //#endregion
 //#region src/plugins/spa/components/factory.d.ts
 declare const createComponent: (name: string, hooks: ComponentHooks) => ComponentDef;
 //#endregion
-export { SpaConfig as a, SpaApi as i, ComponentDef as n, SpaState as o, ComponentHooks as r, createComponent as t };
+export { SpaConfig as a, SpaApi as i, ComponentDef as n, SpaState as o, ComponentHooks as r, types_d_exports as s, createComponent as t };

package/dist/{index-CWdZdegx.d.mts → index-DH3jlpNi.d.mts}

@@ -1,8 +1,12 @@
-import { p as OGImageConfig } from "./primitives-kuZFxqV7.mjs";
-import { n as ComponentDef } from "./factory-BBVQO5ZG.mjs";
+import { d as HeadPluginConfig, f as HeadState, l as HeadApi, p as OGImageConfig } from "./primitives-DKgZfRAO.mjs";
+import { n as ComponentDef } from "./factory-DRFGSslp.mjs";
+import * as _moku_labs_core0 from "@moku-labs/core";
 import { Processor } from "unified";
 
 //#region src/plugins/log/types.d.ts
+declare namespace types_d_exports$7 {
+  export { ExpectChain, LogApi, LogConfig, LogEntry, LogLevel, LogSink, LogState };
+}
 /** @file log plugin types — LogEntry, LogSink, ExpectChain, LogState, LogApi. */
 type LogLevel = 'debug' | 'info' | 'warn' | 'error';
 type LogEntry = {
@@ -24,6 +28,10 @@ type LogState = {
   entries: LogEntry[];
   sinks: LogSink[];
 };
+type LogConfig = {
+  level: LogLevel;
+  mode: 'auto' | 'production' | 'test' | 'dev';
+};
 type LogApi = {
   info(event: string, data?: unknown): void;
   debug(event: string, data?: unknown): void;
@@ -34,8 +42,9 @@ type LogApi = {
   addSink(sink: LogSink): void;
   reset(): void;
 };
-//#endregion
-//#region src/plugins/env/types.d.ts
+declare namespace types_d_exports$6 {
+  export { EnvApi, EnvConfig, EnvProvider, EnvState, EnvVarSpec };
+}
 /** @file env plugin types — schema, provider, EnvApi. */
 type EnvVarSpec = {
   public: boolean;
@@ -110,8 +119,24 @@ type Events = {
     url: string;
   };
 };
-//#endregion
-//#region src/plugins/site/types.d.ts
+declare const createPlugin: _moku_labs_core0.BoundCreatePluginFunction<Config, Events, _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>]>>, createCore: _moku_labs_core0.BoundCreateCoreFunction<Config, Events, [_moku_labs_core0.CorePluginInstance<"log", {
+    level: "info";
+    mode: "auto";
+  }, LogState, LogApi>, _moku_labs_core0.CorePluginInstance<"env", {
+    schema: {};
+    providers: never[];
+    publicPrefix: string;
+  }, EnvState, EnvApi>]>;
+declare namespace types_d_exports$5 {
+  export { SiteApi, SiteConfig, SiteState };
+}
 /** @file site plugin types — SiteConfig + SiteState + SiteApi. */
 type SiteConfig = {
   /** Display name of the site. */name: string; /** Base URL of the site (no trailing slash). */
@@ -129,8 +154,9 @@ type SiteApi = {
   author(): string;
   description(): string;
 };
-//#endregion
-//#region src/plugins/i18n/types.d.ts
+declare namespace types_d_exports$4 {
+  export { I18nApi, I18nConfig, I18nState };
+}
 /** @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). */
@@ -149,8 +175,58 @@ type I18nApi<TLocales extends readonly string[] = readonly string[]> = {
   ogLocale(locale: TLocales[number]): string;
   t(locale: TLocales[number], key: string): string;
 };
-//#endregion
-//#region src/plugins/router/types.d.ts
+declare namespace types_d_exports$3 {
+  export { Article, ComputedFields, ContentApi, ContentConfig, ContentState, Frontmatter, RehypePluginEntry, RemarkPluginEntry };
+}
+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;
+};
+declare namespace types_d_exports$2 {
+  export { HeadConfig, LayoutComponent, RenderContext, RouteBuilder, RouteEntry, RouteSpec, RouterApi, RouterConfig, RouterState, VNode };
+}
 /** @file router plugin types — RouteSpec (non-accumulating), RouteBuilder, RouterApi. */
 /** Render context passed to route handlers. */
 type RenderContext = {
@@ -221,56 +297,11 @@ type RouterApi<Routes extends Record<string, RouteSpec> = Record<string, RouteSp
   } | 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
+declare namespace types_d_exports$1 {
+  export { BuildApi, BuildConfig, BuildPhase, BuildResult, BuildState, BundleManifest };
+}
+/** @file build plugin types — BuildConfig, BuildState, BuildApi, BundleManifest, BuildResult. */
+type BuildPhase = 'bundle' | 'content' | 'pages' | 'feeds' | 'sitemap' | 'og' | 'images';
 type BuildConfig = {
   outdir: string;
   mode: 'production' | 'development';
@@ -298,6 +329,71 @@ type BuildApi = {
   run(): Promise<BuildResult>;
   getManifest(): Readonly<BundleManifest> | null;
 };
+declare namespace types_d_exports {
+  export { DeployApi, DeployConfig, DeployResult, DeployState, DeployTarget, RunOptions };
+}
+/** @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
 /**
@@ -328,6 +424,49 @@ type WebAppConfig<Routes extends Record<string, RouteBuilder>> = {
   trustedContent?: boolean;
 };
 //#endregion
+//#region src/plugins/build/index.d.ts
+declare const build: _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>;
+//#endregion
+//#region src/plugins/content/index.d.ts
+declare const content: _moku_labs_core0.PluginInstance<"content", ContentConfig, ContentState, ContentApi, {
+  'content:ready': {
+    articles: Map<string, Article[]>;
+  };
+  'content:invalidated': {
+    paths: string[];
+  };
+}> & Record<never, never>;
+//#endregion
+//#region src/plugins/deploy/index.d.ts
+declare const deploy: _moku_labs_core0.PluginInstance<"deploy", DeployConfig, DeployState, DeployApi, {}> & Record<never, never>;
+//#endregion
+//#region src/plugins/env/index.d.ts
+declare const env: _moku_labs_core0.CorePluginInstance<"env", {
+  schema: {};
+  providers: never[];
+  publicPrefix: string;
+}, EnvState, EnvApi>;
+//#endregion
+//#region src/plugins/head/index.d.ts
+declare const head: _moku_labs_core0.PluginInstance<"head", HeadPluginConfig, HeadState, HeadApi, {}> & Record<never, never>;
+//#endregion
+//#region src/plugins/i18n/index.d.ts
+declare const i18n: _moku_labs_core0.PluginInstance<"i18n", I18nConfig, I18nState<readonly string[]>, I18nApi<readonly string[]>, {}> & Record<never, never>;
+//#endregion
+//#region src/plugins/log/index.d.ts
+declare const log: _moku_labs_core0.CorePluginInstance<"log", {
+  level: "info";
+  mode: "auto";
+}, LogState, LogApi>;
+//#endregion
 //#region src/plugins/router/route-builder.d.ts
 /**
  * Build a `RouteSpec` via a fluent, non-accumulating builder.
@@ -346,4 +485,19 @@ type WebAppConfig<Routes extends Record<string, RouteBuilder>> = {
  */
 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 };
+//#region src/plugins/router/index.d.ts
+declare const router: _moku_labs_core0.PluginInstance<"router", RouterConfig, RouterState, RouterApi, {
+  'router:registered': {
+    routeCount: number;
+  };
+}> & Record<never, never>;
+//#endregion
+//#region src/plugins/site/index.d.ts
+declare const site: _moku_labs_core0.PluginInstance<"site", {
+  name: string;
+  url: string;
+  author: string;
+  description: string;
+}, SiteState, SiteApi, {}> & Record<never, never>;
+//#endregion
+export { ContentState as A, Events as B, RouterApi as C, Article as D, types_d_exports$2 as E, types_d_exports$4 as F, EnvState as G, EnvApi as H, SiteApi as I, LogApi as J, EnvVarSpec as K, SiteState as L, I18nApi as M, I18nConfig as N, ContentApi as O, I18nState as P, types_d_exports$5 as R, RouteSpec as S, RouterState as T, EnvConfig as U, createPlugin as V, EnvProvider as W, types_d_exports$7 as X, LogState as Y, BuildApi as _, i18n as a, types_d_exports$1 as b, deploy as c, RouteSpecMap as d, WebAppConfig as f, types_d_exports as g, DeployState as h, log as i, types_d_exports$3 as j, ContentConfig as k, content as l, DeployConfig as m, router as n, head as o, DeployApi as p, types_d_exports$6 as q, route as r, env as s, site as t, build as u, BuildConfig as v, RouterConfig as w, RouteBuilder as x, BuildState as y, Config as z };