@bendyline/docblocks 2.7.7 → 2.7.9

package/dist/{reconcile-electron-DuwLsuic.d.ts → reconcile-electron-BcwJ7z5Z.d.ts}

@@ -1,5 +1,5 @@
 import { d as FileSystemProvider } from './types-DLteNrK0.js';
-import { a4 as ElectronWorkspaceInfo, aq as HostEnvironment } from './capabilities-D4Z1xYZV.js';
+import { al as ElectronWorkspaceInfo, aH as HostEnvironment } from './capabilities-CH66e2pR.js';
 
 /**
  * Origin of a transient workspace — records where its contents came from and

package/dist/{settings-HrrCikVX.d.ts → settings-C-TS15JZ.d.ts}

@@ -32,9 +32,22 @@ declare const CATALOG_SORT_ORDERS: readonly ["title", "path", "date"];
 type CatalogSortOrder = (typeof CATALOG_SORT_ORDERS)[number];
 declare const CATALOG_JSON_CONTENT_MODES: readonly ["metadata", "markdown"];
 type CatalogJsonContent = (typeof CATALOG_JSON_CONTENT_MODES)[number];
+/** Rendered formats a workspace can name a default page template for. */
+declare const WORKSPACE_OUTPUT_TEMPLATE_FORMATS: readonly ["html"];
+type WorkspaceOutputTemplateFormat = (typeof WORKSPACE_OUTPUT_TEMPLATE_FORMATS)[number];
+/** Workspace-relative page template path, by rendered output format. */
+type WorkspaceOutputTemplates = {
+    readonly [Format in WorkspaceOutputTemplateFormat]?: string;
+};
 interface WorkspaceDocumentSettings {
     /** Theme for documents whose frontmatter names none. */
     readonly defaultTheme?: string;
+    /**
+     * Page template for rendered documents whose frontmatter names none
+     * (`squisq-output-template`). A document's own choice, including `none`,
+     * always wins.
+     */
+    readonly outputTemplates?: WorkspaceOutputTemplates;
 }
 interface WorkspaceVersionHistorySettings {
     /** Absent inherits the app-wide preference. */
@@ -76,6 +89,16 @@ type WorkspaceSettingsParseResult = {
     readonly status: 'invalid' | 'unsupported-version';
     readonly message: string;
 };
+/** Validate a configured page template path for one rendered format. */
+declare function validateOutputTemplatePath(value: unknown, format: WorkspaceOutputTemplateFormat): WorkspacePath;
+/** Try-form for UI validation messages. */
+declare function checkOutputTemplatePath(value: unknown, format: WorkspaceOutputTemplateFormat): {
+    ok: true;
+    path: WorkspacePath;
+} | {
+    ok: false;
+    message: string;
+};
 type CatalogOutputKind = 'html' | 'json';
 /**
  * Validate a configured catalog output path. Outputs may never land inside
@@ -135,7 +158,8 @@ declare function tryApplyWorkspaceSettingsPatch(base: WorkspaceSettings | null,
 };
 /**
  * True when settings change nothing about how DocBlocks treats the folder: no
- * default theme, no version-history choice, and no catalog output turned on.
+ * default theme or page template, no version-history choice, and no catalog
+ * output turned on.
  * Fields that only configure a disabled output (a catalog title, path, order,
  * or page theme) are inert. Such settings are never worth creating a
  * `.docblocks/` folder for.
@@ -143,6 +167,8 @@ declare function tryApplyWorkspaceSettingsPatch(base: WorkspaceSettings | null,
 declare function isDefaultWorkspaceSettings(settings: WorkspaceSettings | null | undefined): boolean;
 /** The workspace default theme, or undefined to use the built-in default. */
 declare function resolveWorkspaceDefaultThemeId(settings: WorkspaceSettings | null | undefined): string | undefined;
+/** The workspace default page template for a rendered format, workspace-relative. */
+declare function resolveWorkspaceOutputTemplate(settings: WorkspaceSettings | null | undefined, format: string): string | undefined;
 /**
  * The theme a renderer should be told about explicitly. Every Squisq
  * exporter lets an explicit theme beat the document's own frontmatter, so a
@@ -167,4 +193,4 @@ interface ResolvedCatalogOutputs {
 /** Effective catalog configuration, or null when no output is enabled. */
 declare function resolveCatalogOutputs(settings: WorkspaceSettings | null | undefined): ResolvedCatalogOutputs | null;
 
-export { resolveCatalogOutputs as A, resolveFallbackThemeId as B, type CatalogSortOrder as C, DEFAULT_CATALOG_HTML_PATH as D, EMPTY_WORKSPACE_SETTINGS as E, resolveWorkspaceDefaultThemeId as F, resolveWorkspaceVersioningEnabled as G, serializeWorkspaceSettings as H, tryApplyWorkspaceSettingsPatch as I, validateCatalogOutputPath as J, type ResolvedCatalogOutputs as R, UnsupportedWorkspaceSettingsVersionError as U, type WorkspaceSettings as W, type WorkspaceSettingsPatch as a, CATALOG_JSON_CONTENT_MODES as b, CATALOG_SORT_ORDERS as c, type CatalogJsonContent as d, type CatalogOutputKind as e, DEFAULT_CATALOG_JSON_PATH as f, DEFAULT_CATALOG_TITLE as g, WORKSPACE_SETTINGS_DIRECTORY as h, WORKSPACE_SETTINGS_LIMITS as i, WORKSPACE_SETTINGS_PATH as j, WORKSPACE_SETTINGS_VERSION as k, WORKSPACE_THEME_ID_PATTERN as l, type WorkspaceCatalogHtmlSettings as m, type WorkspaceCatalogJsonSettings as n, type WorkspaceCatalogSettings as o, type WorkspaceDocumentSettings as p, type WorkspaceSettingsParseResult as q, type WorkspaceVersionHistorySettings as r, applyWorkspaceSettingsPatch as s, checkCatalogOutputPath as t, diffWorkspaceSettings as u, isDefaultWorkspaceSettings as v, isEmptyWorkspaceSettingsPatch as w, parseWorkspaceSettings as x, parseWorkspaceSettingsPatch as y, parseWorkspaceSettingsText as z };
+export { isEmptyWorkspaceSettingsPatch as A, parseWorkspaceSettings as B, type CatalogSortOrder as C, DEFAULT_CATALOG_HTML_PATH as D, EMPTY_WORKSPACE_SETTINGS as E, parseWorkspaceSettingsPatch as F, parseWorkspaceSettingsText as G, resolveCatalogOutputs as H, resolveFallbackThemeId as I, resolveWorkspaceDefaultThemeId as J, resolveWorkspaceOutputTemplate as K, resolveWorkspaceVersioningEnabled as L, serializeWorkspaceSettings as M, tryApplyWorkspaceSettingsPatch as N, validateCatalogOutputPath as O, validateOutputTemplatePath as P, type ResolvedCatalogOutputs as R, UnsupportedWorkspaceSettingsVersionError as U, type WorkspaceSettings as W, type WorkspaceSettingsPatch as a, CATALOG_JSON_CONTENT_MODES as b, CATALOG_SORT_ORDERS as c, type CatalogJsonContent as d, type CatalogOutputKind as e, DEFAULT_CATALOG_JSON_PATH as f, DEFAULT_CATALOG_TITLE as g, WORKSPACE_OUTPUT_TEMPLATE_FORMATS as h, WORKSPACE_SETTINGS_DIRECTORY as i, WORKSPACE_SETTINGS_LIMITS as j, WORKSPACE_SETTINGS_PATH as k, WORKSPACE_SETTINGS_VERSION as l, WORKSPACE_THEME_ID_PATTERN as m, type WorkspaceCatalogHtmlSettings as n, type WorkspaceCatalogJsonSettings as o, type WorkspaceCatalogSettings as p, type WorkspaceDocumentSettings as q, type WorkspaceOutputTemplateFormat as r, type WorkspaceOutputTemplates as s, type WorkspaceSettingsParseResult as t, type WorkspaceVersionHistorySettings as u, applyWorkspaceSettingsPatch as v, checkCatalogOutputPath as w, checkOutputTemplatePath as x, diffWorkspaceSettings as y, isDefaultWorkspaceSettings as z };

package/dist/vscode/index.d.ts

@@ -1,4 +1,4 @@
-import { W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-HrrCikVX.js';
+import { W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-C-TS15JZ.js';
 import '../workspace-path-CWVrcuPL.js';
 
 /**

package/dist/vscode/index.js

@@ -1,7 +1,7 @@
 import {
   parseWorkspaceSettings,
   parseWorkspaceSettingsPatch
-} from "../chunk-BC42VRYW.js";
+} from "../chunk-PQBUG5DY.js";
 import {
   HOST_WIRE_LIMITS,
   isBoundedString

package/dist/workspace/index.d.ts

@@ -1,9 +1,9 @@
-export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from '../reconcile-electron-DuwLsuic.js';
+export { D as DEFAULT_WORKSPACE_ID, E as ElectronWorkspaceReconciliation, T as TransientOrigin, W as WorkspaceDescriptor, e as ensureDefaultWorkspace, g as getTransientWorkspace, a as getWorkspace, l as listWorkspaces, p as parsePersistedWorkspaceList, r as reconcileElectronWorkspaceDescriptors, b as registerTransientWorkspace, c as removeWorkspace, s as saveWorkspace, t as touchWorkspace, u as unregisterTransientWorkspace } from '../reconcile-electron-BcwJ7z5Z.js';
 import { ContentContainer } from '@bendyline/squisq/storage';
 import { o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
 import '../types-DLteNrK0.js';
-import '../capabilities-D4Z1xYZV.js';
+import '../capabilities-CH66e2pR.js';
 import '../filesystem-v2-CXdAPR27.js';
 
 declare const WORKSPACE_BACKUP_MANIFEST = "docblocks-backup.json";

package/dist/workspace-index/index.d.ts

@@ -1,8 +1,8 @@
 import { o as FileSystemProviderV2, n as FileSystemProviderCapabilities } from '../v2-DwxWjFC0.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
-import { d as CatalogDocumentFormat, f as CatalogOutlineEntry } from '../catalog-BQK05tne.js';
+import { e as CatalogDocumentFormat, g as CatalogOutlineEntry } from '../catalog-BmEXHaZf.js';
 import '@bendyline/squisq/markdown';
-import '../settings-HrrCikVX.js';
+import '../settings-C-TS15JZ.js';
 
 /**
  * What the index reads from. Only read methods are reachable, so the index

package/dist/workspace-index/index.js

@@ -3,7 +3,7 @@ import {
   chooseOutsideInMarkdownPath,
   normalizeLineEndings,
   resolveOutsideInLayout
-} from "../chunk-R2JX5N3F.js";
+} from "../chunk-L7HADBCQ.js";
 import {
   isCompanionDirectoryName,
   isDiscoverableWorkspaceEntry,

package/dist/workspace-settings/index.d.ts

@@ -1,7 +1,7 @@
-import { R as ResolvedCatalogOutputs, W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-HrrCikVX.js';
-export { b as CATALOG_JSON_CONTENT_MODES, c as CATALOG_SORT_ORDERS, d as CatalogJsonContent, e as CatalogOutputKind, C as CatalogSortOrder, D as DEFAULT_CATALOG_HTML_PATH, f as DEFAULT_CATALOG_JSON_PATH, g as DEFAULT_CATALOG_TITLE, E as EMPTY_WORKSPACE_SETTINGS, U as UnsupportedWorkspaceSettingsVersionError, h as WORKSPACE_SETTINGS_DIRECTORY, i as WORKSPACE_SETTINGS_LIMITS, j as WORKSPACE_SETTINGS_PATH, k as WORKSPACE_SETTINGS_VERSION, l as WORKSPACE_THEME_ID_PATTERN, m as WorkspaceCatalogHtmlSettings, n as WorkspaceCatalogJsonSettings, o as WorkspaceCatalogSettings, p as WorkspaceDocumentSettings, q as WorkspaceSettingsParseResult, r as WorkspaceVersionHistorySettings, s as applyWorkspaceSettingsPatch, t as checkCatalogOutputPath, u as diffWorkspaceSettings, v as isDefaultWorkspaceSettings, w as isEmptyWorkspaceSettingsPatch, x as parseWorkspaceSettings, y as parseWorkspaceSettingsPatch, z as parseWorkspaceSettingsText, A as resolveCatalogOutputs, B as resolveFallbackThemeId, F as resolveWorkspaceDefaultThemeId, G as resolveWorkspaceVersioningEnabled, H as serializeWorkspaceSettings, I as tryApplyWorkspaceSettingsPatch, J as validateCatalogOutputPath } from '../settings-HrrCikVX.js';
-import { C as CatalogEntry, W as WorkspaceCatalog } from '../catalog-BQK05tne.js';
-export { a as CATALOG_FORMAT_VERSION, b as CATALOG_GENERATOR, c as CATALOG_LIMITS, d as CatalogDocumentFormat, e as CatalogEntryHints, f as CatalogOutlineEntry, g as CatalogSource, O as OUTSIDE_IN_FORMAT_IDS, h as OutsideInFormatId, i as OutsideInLayout, j as buildCatalogMarkdownDocument, k as catalogEntryForUnreadable, l as catalogEntryFromDocument, m as catalogEntryFromMarkdown, n as chooseOutsideInMarkdownPath, o as createWorkspaceCatalog, p as isGeneratedCatalogHtml, q as isGeneratedCatalogJson, r as readCatalogHtmlDigest, s as relativeCatalogLink, t as relocateOutsideInLayout, u as resolveOutsideInLayout, v as serializeCatalogJson, w as sortCatalogEntries, x as stampCatalogHtml } from '../catalog-BQK05tne.js';
+import { R as ResolvedCatalogOutputs, W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-C-TS15JZ.js';
+export { b as CATALOG_JSON_CONTENT_MODES, c as CATALOG_SORT_ORDERS, d as CatalogJsonContent, e as CatalogOutputKind, C as CatalogSortOrder, D as DEFAULT_CATALOG_HTML_PATH, f as DEFAULT_CATALOG_JSON_PATH, g as DEFAULT_CATALOG_TITLE, E as EMPTY_WORKSPACE_SETTINGS, U as UnsupportedWorkspaceSettingsVersionError, h as WORKSPACE_OUTPUT_TEMPLATE_FORMATS, i as WORKSPACE_SETTINGS_DIRECTORY, j as WORKSPACE_SETTINGS_LIMITS, k as WORKSPACE_SETTINGS_PATH, l as WORKSPACE_SETTINGS_VERSION, m as WORKSPACE_THEME_ID_PATTERN, n as WorkspaceCatalogHtmlSettings, o as WorkspaceCatalogJsonSettings, p as WorkspaceCatalogSettings, q as WorkspaceDocumentSettings, r as WorkspaceOutputTemplateFormat, s as WorkspaceOutputTemplates, t as WorkspaceSettingsParseResult, u as WorkspaceVersionHistorySettings, v as applyWorkspaceSettingsPatch, w as checkCatalogOutputPath, x as checkOutputTemplatePath, y as diffWorkspaceSettings, z as isDefaultWorkspaceSettings, A as isEmptyWorkspaceSettingsPatch, B as parseWorkspaceSettings, F as parseWorkspaceSettingsPatch, G as parseWorkspaceSettingsText, H as resolveCatalogOutputs, I as resolveFallbackThemeId, J as resolveWorkspaceDefaultThemeId, K as resolveWorkspaceOutputTemplate, L as resolveWorkspaceVersioningEnabled, M as serializeWorkspaceSettings, N as tryApplyWorkspaceSettingsPatch, O as validateCatalogOutputPath, P as validateOutputTemplatePath } from '../settings-C-TS15JZ.js';
+import { C as CatalogEntry, W as WorkspaceCatalog } from '../catalog-BmEXHaZf.js';
+export { a as CATALOG_FORMAT_VERSION, b as CATALOG_GENERATOR, c as CATALOG_LIMITS, d as CatalogDateRecord, e as CatalogDocumentFormat, f as CatalogEntryHints, g as CatalogOutlineEntry, h as CatalogSource, O as OUTSIDE_IN_FORMAT_IDS, i as OutsideInFormatId, j as OutsideInLayout, k as buildCatalogMarkdownDocument, l as catalogEntryForUnreadable, m as catalogEntryFromDocument, n as catalogEntryFromMarkdown, o as chooseOutsideInMarkdownPath, p as createWorkspaceCatalog, q as isGeneratedCatalogHtml, r as isGeneratedCatalogJson, s as readCatalogDateHistory, t as readCatalogHtmlDigest, u as relativeCatalogLink, v as relocateOutsideInLayout, w as resolveOutsideInLayout, x as serializeCatalogJson, y as sortCatalogEntries, z as stampCatalogDates, A as stampCatalogHtml } from '../catalog-BmEXHaZf.js';
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
 import { v as FileSystemVersion, o as FileSystemProviderV2 } from '../v2-DwxWjFC0.js';
 import { a as WorkspacePath } from '../workspace-path-CWVrcuPL.js';
@@ -37,6 +37,20 @@ declare const WORKSPACE_SETTINGS_JSON_SCHEMA: {
                     readonly type: "string";
                     readonly pattern: string;
                 };
+                readonly outputTemplates: {
+                    readonly type: "object";
+                    readonly additionalProperties: false;
+                    readonly description: "Page templates for rendered documents whose frontmatter names none (squisq-output-template). A document’s own choice, including \"none\", always wins.";
+                    readonly properties: {
+                        readonly html: {
+                            readonly pattern: "\\.html?$";
+                            readonly description: "Workspace-relative HTML page template for Web pages, such as \"_templates/post.html\". Its unnamed <slot> receives the page content.";
+                            readonly type: "string";
+                            readonly minLength: 1;
+                            readonly maxLength: 1024;
+                        };
+                    };
+                };
             };
         };
         readonly versionHistory: {
@@ -154,6 +168,11 @@ interface WorkspaceOutputsRenderer {
     }): string | Promise<string>;
     /** Parse rendered HTML that has no Markdown companion yet. Optional. */
     importHtml?(html: string): MarkdownDocument | Promise<MarkdownDocument>;
+    /**
+     * True for an HTML page template — the chrome other pages are generated
+     * through, not a document of its own — which the catalog leaves out. Optional.
+     */
+    isPageTemplate?(html: string): boolean;
 }
 declare const WORKSPACE_OUTPUT_LIMITS: {
     readonly maxDocuments: 5000;
@@ -188,6 +207,8 @@ interface RefreshWorkspaceOutputsOptions {
     /** Compute everything, write nothing. */
     readonly dryRun?: boolean;
     readonly limits?: Partial<WorkspaceOutputLimits>;
+    /** Time stamped on new or changed documents in the catalog JSON. Defaults to now. */
+    readonly now?: Date;
 }
 type WorkspaceOutputStatus = 'written' | 'unchanged' | 'blocked' | 'would-write';
 interface WorkspaceOutputResult {
@@ -211,7 +232,7 @@ declare function isCatalogRelevantPath(path: string, settings: WorkspaceSettings
 /** True for the workspace settings directory or anything inside it. */
 declare function isWorkspaceSettingsPath(path: string): boolean;
 /** Walk the workspace and build its catalog without writing anything. */
-declare function collectWorkspaceCatalog(io: WorkspaceOutputsIO, resolved: ResolvedCatalogOutputs, renderer: Pick<WorkspaceOutputsRenderer, 'importHtml'>, options?: Omit<RefreshWorkspaceOutputsOptions, 'force' | 'dryRun'>): Promise<WorkspaceCatalog>;
+declare function collectWorkspaceCatalog(io: WorkspaceOutputsIO, resolved: ResolvedCatalogOutputs, renderer: Pick<WorkspaceOutputsRenderer, 'importHtml' | 'isPageTemplate'>, options?: Omit<RefreshWorkspaceOutputsOptions, 'force' | 'dryRun' | 'now'>): Promise<WorkspaceCatalog>;
 /**
  * Regenerate every enabled catalog output for one workspace. Throws
  * {@link WorkspaceOutputsLimitError} when over budget, `FsError('aborted')`

package/dist/workspace-settings/index.js

@@ -11,6 +11,8 @@ import {
   createWorkspaceCatalog,
   isGeneratedCatalogHtml,
   isGeneratedCatalogJson,
+  normalizeLineEndings,
+  readCatalogDateHistory,
   readCatalogHtmlDigest,
   relativeCatalogLink,
   relocateOutsideInLayout,
@@ -18,8 +20,9 @@ import {
   serializeCatalogJson,
   sha256Hex,
   sortCatalogEntries,
+  stampCatalogDates,
   stampCatalogHtml
-} from "../chunk-R2JX5N3F.js";
+} from "../chunk-L7HADBCQ.js";
 import {
   CATALOG_JSON_CONTENT_MODES,
   CATALOG_SORT_ORDERS,
@@ -28,6 +31,7 @@ import {
   DEFAULT_CATALOG_TITLE,
   EMPTY_WORKSPACE_SETTINGS,
   UnsupportedWorkspaceSettingsVersionError,
+  WORKSPACE_OUTPUT_TEMPLATE_FORMATS,
   WORKSPACE_SETTINGS_DIRECTORY,
   WORKSPACE_SETTINGS_LIMITS,
   WORKSPACE_SETTINGS_PATH,
@@ -35,6 +39,7 @@ import {
   WORKSPACE_THEME_ID_PATTERN,
   applyWorkspaceSettingsPatch,
   checkCatalogOutputPath,
+  checkOutputTemplatePath,
   diffWorkspaceSettings,
   isDefaultWorkspaceSettings,
   isEmptyWorkspaceSettingsPatch,
@@ -44,11 +49,13 @@ import {
   resolveCatalogOutputs,
   resolveFallbackThemeId,
   resolveWorkspaceDefaultThemeId,
+  resolveWorkspaceOutputTemplate,
   resolveWorkspaceVersioningEnabled,
   serializeWorkspaceSettings,
   tryApplyWorkspaceSettingsPatch,
-  validateCatalogOutputPath
-} from "../chunk-BC42VRYW.js";
+  validateCatalogOutputPath,
+  validateOutputTemplatePath
+} from "../chunk-PQBUG5DY.js";
 import {
   SQUISQ_RUNTIME_DIRECTORY_NAME,
   isDiscoverableWorkspaceEntry,
@@ -92,6 +99,18 @@ var WORKSPACE_SETTINGS_JSON_SCHEMA = {
         defaultTheme: {
           ...themeId,
           description: "Theme for documents whose frontmatter does not name one. A document\u2019s own theme always wins."
+        },
+        outputTemplates: {
+          type: "object",
+          additionalProperties: false,
+          description: 'Page templates for rendered documents whose frontmatter names none (squisq-output-template). A document\u2019s own choice, including "none", always wins.',
+          properties: {
+            html: {
+              ...relativePath,
+              pattern: "\\.html?$",
+              description: 'Workspace-relative HTML page template for Web pages, such as "_templates/post.html". Its unnamed <slot> receives the page content.'
+            }
+          }
         }
       }
     },
@@ -351,7 +370,7 @@ async function collectWorkspaceCatalog(io, resolved, renderer, options = {}) {
       const text = new TextDecoder("utf-8").decode(read.data);
       if (target.mode === "markdown") {
         entry = await catalogEntryFromMarkdown(target.source, text, { includeMarkdown });
-      } else if (isGeneratedCatalogHtml(text)) {
+      } else if (isGeneratedCatalogHtml(text) || renderer.isPageTemplate?.(text)) {
         entry = null;
       } else if (renderer.importHtml) {
         const head = text.slice(0, 64 * 1024);
@@ -362,6 +381,7 @@ async function collectWorkspaceCatalog(io, resolved, renderer, options = {}) {
       } else {
         entry = catalogEntryForUnreadable(target.source);
       }
+      if (entry) entry = { ...entry, contentHash: await sha256Hex(normalizeLineEndings(text)) };
     }
     cache?.set(target.source.path, {
       readPath: target.readPath,
@@ -426,7 +446,9 @@ async function writeOutput(io, request, limits, options) {
       return blocked(`${path} is an edited document. Choose another catalog path.`);
     }
   }
-  const bytes = new TextEncoder().encode(await request.produce());
+  const bytes = new TextEncoder().encode(
+    await request.produce(existing ? new TextDecoder("utf-8").decode(existing.data) : null)
+  );
   if (bytes.byteLength > limits.maxOutputBytes) {
     return blocked(
       `The catalog would exceed ${Math.round(limits.maxOutputBytes / 1024 / 1024)} MiB and was not written.`
@@ -451,13 +473,20 @@ async function refreshWorkspaceOutputs(io, settings, renderer, options = {}) {
   if (resolved.json) {
     throwIfAborted(options.signal);
     const content = resolved.json.content;
+    const now = options.now ?? /* @__PURE__ */ new Date();
     outputs.push(
       await writeOutput(
         io,
         {
           kind: "json",
           path: resolved.json.path,
-          produce: async () => serializeCatalogJson(content === "markdown" ? catalog : metadataCatalog)
+          produce: async (previous) => serializeCatalogJson(
+            stampCatalogDates(
+              content === "markdown" ? catalog : metadataCatalog,
+              readCatalogDateHistory(previous ?? ""),
+              now
+            )
+          )
         },
         limits,
         options
@@ -771,6 +800,7 @@ export {
   WORKSPACE_OUTPUTS_DEBOUNCE_MS,
   WORKSPACE_OUTPUTS_MAX_WAIT_MS,
   WORKSPACE_OUTPUT_LIMITS,
+  WORKSPACE_OUTPUT_TEMPLATE_FORMATS,
   WORKSPACE_SETTINGS_DIRECTORY,
   WORKSPACE_SETTINGS_JSON_SCHEMA,
   WORKSPACE_SETTINGS_LIMITS,
@@ -784,6 +814,7 @@ export {
   catalogEntryFromDocument,
   catalogEntryFromMarkdown,
   checkCatalogOutputPath,
+  checkOutputTemplatePath,
   chooseOutsideInMarkdownPath,
   collectWorkspaceCatalog,
   createWorkspaceCatalog,
@@ -800,6 +831,7 @@ export {
   parseWorkspaceSettings,
   parseWorkspaceSettingsPatch,
   parseWorkspaceSettingsText,
+  readCatalogDateHistory,
   readCatalogHtmlDigest,
   readWorkspaceSettings,
   refreshWorkspaceOutputs,
@@ -809,12 +841,15 @@ export {
   resolveFallbackThemeId,
   resolveOutsideInLayout,
   resolveWorkspaceDefaultThemeId,
+  resolveWorkspaceOutputTemplate,
   resolveWorkspaceVersioningEnabled,
   saveWorkspaceSettingsPatch,
   serializeCatalogJson,
   serializeWorkspaceSettings,
   sortCatalogEntries,
+  stampCatalogDates,
   stampCatalogHtml,
   tryApplyWorkspaceSettingsPatch,
-  validateCatalogOutputPath
+  validateCatalogOutputPath,
+  validateOutputTemplatePath
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.7.7",
+  "version": "2.7.9",
   "description": "Core data structures and filesystem abstractions for DocBlocks",
   "license": "MIT",
   "author": "Bendyline",
@@ -126,7 +126,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@bendyline/squisq": "2.13.3",
+    "@bendyline/squisq": "2.13.8",
     "zod": "3.25.76"
   }
 }