npm - @moku-labs/web - Versions diffs - 1.14.0 → 1.15.0 - Mend

@moku-labs/web 1.14.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (7) hide show

package/dist/index.d.cts CHANGED Viewed

@@ -231,6 +231,28 @@ type Api$6 = {
   t(locale: string, key: string): string;
 };
 //#endregion
+//#region src/plugins/i18n/index.d.ts
+/**
+ * Internationalization plugin — locale registry plus a flat translation helper
+ * with default-locale fallback. Pure config-as-data (no state or events);
+ * consumed read-only by content, router, head, and build.
+ *
+ * @example Register locales and translations
+ * ```ts
+ * const app = createApp({
+ *   pluginConfigs: {
+ *     i18n: {
+ *       locales: ["en", "uk"],
+ *       defaultLocale: "en",
+ *       localeNames: { en: "English", uk: "Українська" },
+ *       translations: { uk: { "nav.home": "Головна" } }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
+//#endregion
 //#region src/plugins/router/iso-match.d.ts
 /**
  * A compiled, engine-agnostic path matcher: the same `.exec({ pathname })` shape the
@@ -1252,7 +1274,7 @@ type PhaseContext = {
   readonly global: Readonly<{
     stage: Stage;
   }>; /** Resolve a depended-upon plugin instance to its public API. */
-  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect the OPTIONAL `data` plugin. */
+  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect OPTIONAL plugins (`data`, `content`, `i18n`, `head`). */
   has: (name: string) => boolean; /** Emit a build event (notification-only). */
   emit: PhaseEmit; /** Structured logger (core `log` API). */
   readonly log: PhaseLog;
@@ -1585,7 +1607,8 @@ type Api$3 = {
 /**
  * Build plugin — the static-site-generation orchestrator. Renders every route to
  * `outDir`, and optionally emits feeds, a sitemap, optimized images, and OG
- * images. Depends on site, i18n, content, router, and head; emits `build:phase`.
+ * images. Hard-depends only on site, router, and head; `content` and `i18n` are
+ * OPTIONAL (a content-less or single-locale site builds without them). Emits `build:phase`.
  *
  * @example Configure the production build
  * ```ts
@@ -2835,7 +2858,8 @@ type Api = {
  * (locale fallback, draft filtering, sort, caching, events) lives here; source I/O +
  * the Markdown pipeline live in a {@link ContentProvider} you compose (like `env`
  * providers). The shell imports zero node code, so `contentPlugin` is browser-safe.
- * Depends on i18n; emits `content:ready` and `content:invalidated`.
+ * i18n is OPTIONAL (single default-locale fallback when absent); emits `content:ready`
+ * and `content:invalidated`.
  *
  * @example Compose the node filesystem provider with a content dir + Shiki theme
  * ```ts
@@ -3127,7 +3151,7 @@ declare function buildArticleHead(articleMeta: ArticleMeta, canonicalUrl: string
  * Head plugin — composes per-route `<head>` metadata (title template, Open Graph,
  * Twitter cards, canonical, hreflang). Use the re-exported SEO primitives
  * ({@link meta}, {@link og}, {@link twitter}, …) inside a route's `.head()`.
- * Depends on site, i18n, and router.
+ * Depends on site and router; i18n is OPTIONAL (single default-locale fallback when absent).
  *
  * @example Set global head defaults
  * ```ts
@@ -3153,28 +3177,6 @@ declare const headPlugin: import("@moku-labs/core").PluginInstance<"head", Confi
   buildArticleHead: typeof buildArticleHead;
 };
 //#endregion
-//#region src/plugins/i18n/index.d.ts
-/**
- * Internationalization plugin — locale registry plus a flat translation helper
- * with default-locale fallback. Pure config-as-data (no state or events);
- * consumed read-only by content, router, head, and build.
- *
- * @example Register locales and translations
- * ```ts
- * const app = createApp({
- *   pluginConfigs: {
- *     i18n: {
- *       locales: ["en", "uk"],
- *       defaultLocale: "en",
- *       localeNames: { en: "English", uk: "Українська" },
- *       translations: { uk: { "nav.home": "Головна" } }
- *     }
- *   }
- * });
- * ```
- */
-declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
-//#endregion
 //#region src/plugins/router/builders/route-builder.d.ts
 /**
  * Create a fluent route builder from a URL pattern string. Captures the pattern
@@ -3238,8 +3240,8 @@ declare function createUrls<T extends RouteMap>(routes: T, defaultLocale?: strin
 /**
  * Router plugin — typed, named route definitions with locale-aware URL generation
  * and matching. Author routes with {@link route}, then register them the normal config
- * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL)
- * and i18n (locales).
+ * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL);
+ * i18n (locales) is OPTIONAL — falls back to a single default locale ("en") when absent.
  *
  * @example Register routes via config, then start/build
  * ```ts

package/dist/index.d.mts CHANGED Viewed

@@ -229,6 +229,28 @@ type Api$6 = {
   t(locale: string, key: string): string;
 };
 //#endregion
+//#region src/plugins/i18n/index.d.ts
+/**
+ * Internationalization plugin — locale registry plus a flat translation helper
+ * with default-locale fallback. Pure config-as-data (no state or events);
+ * consumed read-only by content, router, head, and build.
+ *
+ * @example Register locales and translations
+ * ```ts
+ * const app = createApp({
+ *   pluginConfigs: {
+ *     i18n: {
+ *       locales: ["en", "uk"],
+ *       defaultLocale: "en",
+ *       localeNames: { en: "English", uk: "Українська" },
+ *       translations: { uk: { "nav.home": "Головна" } }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
+//#endregion
 //#region src/plugins/router/iso-match.d.ts
 /**
  * A compiled, engine-agnostic path matcher: the same `.exec({ pathname })` shape the
@@ -1250,7 +1272,7 @@ type PhaseContext = {
   readonly global: Readonly<{
     stage: Stage;
   }>; /** Resolve a depended-upon plugin instance to its public API. */
-  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect the OPTIONAL `data` plugin. */
+  require: PhaseRequire; /** Whether a plugin is registered (by name) — used to detect OPTIONAL plugins (`data`, `content`, `i18n`, `head`). */
   has: (name: string) => boolean; /** Emit a build event (notification-only). */
   emit: PhaseEmit; /** Structured logger (core `log` API). */
   readonly log: PhaseLog;
@@ -1583,7 +1605,8 @@ type Api$3 = {
 /**
  * Build plugin — the static-site-generation orchestrator. Renders every route to
  * `outDir`, and optionally emits feeds, a sitemap, optimized images, and OG
- * images. Depends on site, i18n, content, router, and head; emits `build:phase`.
+ * images. Hard-depends only on site, router, and head; `content` and `i18n` are
+ * OPTIONAL (a content-less or single-locale site builds without them). Emits `build:phase`.
  *
  * @example Configure the production build
  * ```ts
@@ -2833,7 +2856,8 @@ type Api = {
  * (locale fallback, draft filtering, sort, caching, events) lives here; source I/O +
  * the Markdown pipeline live in a {@link ContentProvider} you compose (like `env`
  * providers). The shell imports zero node code, so `contentPlugin` is browser-safe.
- * Depends on i18n; emits `content:ready` and `content:invalidated`.
+ * i18n is OPTIONAL (single default-locale fallback when absent); emits `content:ready`
+ * and `content:invalidated`.
  *
  * @example Compose the node filesystem provider with a content dir + Shiki theme
  * ```ts
@@ -3125,7 +3149,7 @@ declare function buildArticleHead(articleMeta: ArticleMeta, canonicalUrl: string
  * Head plugin — composes per-route `<head>` metadata (title template, Open Graph,
  * Twitter cards, canonical, hreflang). Use the re-exported SEO primitives
  * ({@link meta}, {@link og}, {@link twitter}, …) inside a route's `.head()`.
- * Depends on site, i18n, and router.
+ * Depends on site and router; i18n is OPTIONAL (single default-locale fallback when absent).
  *
  * @example Set global head defaults
  * ```ts
@@ -3151,28 +3175,6 @@ declare const headPlugin: import("@moku-labs/core").PluginInstance<"head", Confi
   buildArticleHead: typeof buildArticleHead;
 };
 //#endregion
-//#region src/plugins/i18n/index.d.ts
-/**
- * Internationalization plugin — locale registry plus a flat translation helper
- * with default-locale fallback. Pure config-as-data (no state or events);
- * consumed read-only by content, router, head, and build.
- *
- * @example Register locales and translations
- * ```ts
- * const app = createApp({
- *   pluginConfigs: {
- *     i18n: {
- *       locales: ["en", "uk"],
- *       defaultLocale: "en",
- *       localeNames: { en: "English", uk: "Українська" },
- *       translations: { uk: { "nav.home": "Головна" } }
- *     }
- *   }
- * });
- * ```
- */
-declare const i18nPlugin: import("@moku-labs/core").PluginInstance<"i18n", Config$6, Record<string, never>, Api$6, {}> & Record<never, never>;
-//#endregion
 //#region src/plugins/router/builders/route-builder.d.ts
 /**
  * Create a fluent route builder from a URL pattern string. Captures the pattern
@@ -3236,8 +3238,8 @@ declare function createUrls<T extends RouteMap>(routes: T, defaultLocale?: strin
 /**
  * Router plugin — typed, named route definitions with locale-aware URL generation
  * and matching. Author routes with {@link route}, then register them the normal config
- * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL)
- * and i18n (locales).
+ * way via `pluginConfigs.router.routes` (compiled at init). Depends on site (base URL);
+ * i18n (locales) is OPTIONAL — falls back to a single default locale ("en") when absent.
  *
  * @example Register routes via config, then start/build
  * ```ts