@moku-labs/web 1.1.0 → 1.3.0

package/README.md

@@ -211,7 +211,7 @@ Each plugin is small, single-purpose, and documented on its own. **Click a name
 | [`content`](src/plugins/content/README.md) | node-only | Markdown → sanitized HTML pipeline, frontmatter, reading time, locale-keyed `Article` model |
 | [`build`](src/plugins/build/README.md) | node-only | SSG orchestrator: pages, feeds (RSS/Atom/JSON), sitemap, OG images → `dist/` |
 | [`deploy`](src/plugins/deploy/README.md) | node-only | Cloudflare Pages: `wrangler.jsonc` scaffolding, secret scrubbing, deploy |
-| [`cli`](src/plugins/cli/README.md) | node-only | Developer CLI — `build` / `serve` / `preview` / `deploy` with a boxed Panel UI + live progress |
+| [`cli`](src/plugins/cli/README.md) | node-only | Developer CLI — `build` / `serve` / `preview` / `deploy` with the animated Velocity Panel UI (lockup + version banner, live phase tree, boxed panels, live pulse) |
 | [`data`](src/plugins/data/README.md) | optional provider | Agnostic `page path → JSON` contract: `write()` on Node, `at()` in the browser, for DATA nav |
 | [`env`](src/plugins/env/README.md) | core | Multi-provider environment / secret injection, validated and frozen at `onInit` |
 | [`log`](src/plugins/log/README.md) | core | Structured logging + an in-memory trace with an `expect()` DSL for testable workflows |

package/dist/browser.d.mts

@@ -1853,7 +1853,7 @@ type DataProvider = {
  */
 declare const dataPlugin: import("@moku-labs/core").PluginInstance<"data", DataConfig, DataState, DataProvider, {}> & Record<never, never>;
 declare namespace types_d_exports {
-  export { Api, Article, ArticleCard, ComputedFields, Config, ContentApiContext, ContentEvents, ContentProvider, ContentProviderState, FileSystemContentOptions, Frontmatter, State };
+  export { Api, Article, ArticleCard, ComputedFields, Config, ContentApiContext, ContentEvents, ContentProvider, ContentProviderState, FileSystemContentOptions, Frontmatter, LoadAllOptions, State };
 }
 /**
  * YAML frontmatter parsed from each article file.
@@ -2072,6 +2072,24 @@ type ContentApiContext = {
   defaultLocale: () => string; /** The resolved content source (merged from `config.providers`). */
   provider: ContentProvider;
 };
+/**
+ * Options for {@link Api.loadAll}.
+ *
+ * @example
+ * ```ts
+ * await app.content.loadAll({ reuse: true });
+ * ```
+ */
+type LoadAllOptions = {
+  /**
+   * Reuse already-cached articles for slugs NOT dropped by a preceding `invalidate()`,
+   * re-reading + re-rendering (Shiki) ONLY the invalidated (dirty) articles. The
+   * post-sort `contentId` ordinals are always recomputed across the full set, so order +
+   * ids match a full load. Default `false` (a full load that re-reads every article).
+   * Used by dev incremental rebuilds; a fresh process / production build never reuses.
+   */
+  reuse?: boolean;
+};
 /**
  * Public API for the content plugin.
  *
@@ -2084,8 +2102,10 @@ type Api = {
   /**
    * Load every article across every active locale, returning a locale-keyed
    * map of date-descending Article arrays. Emits content:ready.
+   *
+   * @param options - Optional load behaviour ({@link LoadAllOptions}); omit for a full load.
    */
-  loadAll(): Promise<Map<string, Article[]>>;
+  loadAll(options?: LoadAllOptions): Promise<Map<string, Article[]>>;
   /**
    * Resolve and render a single article for one locale, with locale fallback.
    *

package/dist/browser.mjs

@@ -4355,18 +4355,24 @@ function isPublished(article, isProduction) {
 * locale collection: existing files only, drafts dropped in production, sorted
 * date-descending. The single load+filter+sort step behind {@link createContentApi.loadAll}.
 *
+* When a `cached` map is supplied (incremental dev rebuild), a slug already present in it
+* is reused as-is (skipping the re-read + Markdown/Shiki re-render); only slugs absent
+* from it — the ones a preceding `invalidate()` dropped, plus any never-loaded — are
+* resolved fresh. With no `cached` map every slug is resolved (the full load).
+*
 * @param ctx - Kernel-free domain context (provider + i18n helpers + stage).
 * @param slugs - Every known article slug from the provider.
 * @param locale - The locale to resolve and collect.
+* @param cached - Optional per-locale article cache to reuse for unchanged slugs.
 * @returns The published (date-descending) articles for this locale.
 * @example
 * ```ts
 * const present = await loadAndFilterArticles(ctx, slugs, "en");
 * ```
 */
-async function loadAndFilterArticles(ctx, slugs, locale) {
+async function loadAndFilterArticles(ctx, slugs, locale, cached) {
 	const isProduction = ctx.global.stage === "production";
-	return (await Promise.all(slugs.map((slug) => resolveArticle(ctx, slug, locale)))).filter((article) => article !== null).filter((article) => isPublished(article, isProduction)).toSorted(byDateDescending);
+	return (await Promise.all(slugs.map((slug) => cached?.get(slug) ?? resolveArticle(ctx, slug, locale)))).filter((article) => article !== null).filter((article) => isPublished(article, isProduction)).toSorted(byDateDescending);
 }
 /**
 * Derive the article slug from a source file path — the parent directory name
@@ -4403,19 +4409,26 @@ function createContentApi(ctx) {
 		* Load every article across every active locale (locale fallback, production
 		* draft exclusion, date sort, `contentId` after sort), cache them, emit `content:ready`.
 		*
+		* With `{ reuse: true }` (dev incremental rebuild) cached articles are reused for
+		* every slug a preceding `invalidate()` did not drop, so only the dirty articles
+		* re-read + re-run the Markdown/Shiki pipeline; the `contentId` ordinals are still
+		* recomputed across the FULL sorted set, so ids + order match a full load.
+		*
+		* @param options - Optional load behaviour (`reuse`); omit for a full load.
 		* @returns A locale-keyed map of date-descending articles.
 		* @example
 		* ```ts
 		* const byLocale = await api.loadAll();
 		* ```
 		*/
-		async loadAll() {
+		async loadAll(options) {
+			const reuse = options?.reuse === true;
 			const slugs = await ctx.provider.slugs();
 			const locales = ctx.locales();
 			const result = /* @__PURE__ */ new Map();
 			let total = 0;
 			for (const locale of locales) {
-				const present = await loadAndFilterArticles(ctx, slugs, locale);
+				const present = await loadAndFilterArticles(ctx, slugs, locale, reuse ? ctx.state.articles.get(locale) : void 0);
 				const cache = /* @__PURE__ */ new Map();
 				let index = 0;
 				for (const article of present) {