@bendyline/docblocks 2.7.9 → 2.7.10

package/THIRD_PARTY_NOTICES.txt

@@ -14,7 +14,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 
 | Package | Version | License | Source |
 | --- | --- | --- | --- |
-| @bendyline/squisq | 2.13.8 | MIT | https://github.com/bendyline/squisq |
+| @bendyline/squisq | 2.13.9 | MIT | https://github.com/bendyline/squisq |
 | @bendyline/squisq-graph | 2.13.1 | MIT | https://github.com/bendyline/squisq |
 | @types/debug | 4.1.12 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
 | @types/hast | 3.0.4 | MIT | https://github.com/DefinitelyTyped/DefinitelyTyped |
@@ -133,7 +133,7 @@ This notice is included in the published npm tarball. Transitive packages instal
 Package-local license, copying, and notice files are reproduced below. Where a published package omits its repository license, the reviewed aggregate or README identified in `Source files` supplies the retained material.
 
 ==============================================================================
-Components: @bendyline/squisq-graph@2.13.1, @bendyline/squisq@2.13.8
+Components: @bendyline/squisq-graph@2.13.1, @bendyline/squisq@2.13.9
 Source files: node_modules/@bendyline/squisq-graph/LICENSE, node_modules/@bendyline/squisq/LICENSE
 ==============================================================================
 MIT License
@@ -189,7 +189,7 @@ repository license, the pinned upstream copy is vendored and identified below.
 COMPONENTS
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.8
+Components: @bendyline/squisq@2.13.9
 Source files: node_modules/@bendyline/squisq/NOTICE.md
 ==============================================================================
 # Third-Party Notices for @bendyline/squisq
@@ -220,7 +220,7 @@ third-party license texts for bundled code and data are shipped in
 THIRD_PARTY_LICENSES.txt.
 
 ==============================================================================
-Components: @bendyline/squisq@2.13.8
+Components: @bendyline/squisq@2.13.9
 Source files: node_modules/@bendyline/squisq/THIRD_PARTY_LICENSES.txt
 ==============================================================================
 THIRD-PARTY LICENSES FOR @bendyline/squisq

package/dist/{catalog-BmEXHaZf.d.ts → catalog-flfSruLW.d.ts}

@@ -1,5 +1,5 @@
 import { MarkdownDocument } from '@bendyline/squisq/markdown';
-import { C as CatalogSortOrder } from './settings-C-TS15JZ.js';
+import { C as CatalogSortOrder } from './settings-D_CL7AJA.js';
 
 /**
  * Synchronous outside-in path layout.

package/dist/{chunk-L7HADBCQ.js → chunk-3CCINQX5.js}

@@ -1,3 +1,128 @@
+// src/workspace-settings/sha256.ts
+var ROUND_CONSTANTS = new Uint32Array([
+  1116352408,
+  1899447441,
+  3049323471,
+  3921009573,
+  961987163,
+  1508970993,
+  2453635748,
+  2870763221,
+  3624381080,
+  310598401,
+  607225278,
+  1426881987,
+  1925078388,
+  2162078206,
+  2614888103,
+  3248222580,
+  3835390401,
+  4022224774,
+  264347078,
+  604807628,
+  770255983,
+  1249150122,
+  1555081692,
+  1996064986,
+  2554220882,
+  2821834349,
+  2952996808,
+  3210313671,
+  3336571891,
+  3584528711,
+  113926993,
+  338241895,
+  666307205,
+  773529912,
+  1294757372,
+  1396182291,
+  1695183700,
+  1986661051,
+  2177026350,
+  2456956037,
+  2730485921,
+  2820302411,
+  3259730800,
+  3345764771,
+  3516065817,
+  3600352804,
+  4094571909,
+  275423344,
+  430227734,
+  506948616,
+  659060556,
+  883997877,
+  958139571,
+  1322822218,
+  1537002063,
+  1747873779,
+  1955562222,
+  2024104815,
+  2227730452,
+  2361852424,
+  2428436474,
+  2756734187,
+  3204031479,
+  3329325298
+]);
+var INITIAL_HASH = [
+  1779033703,
+  3144134277,
+  1013904242,
+  2773480762,
+  1359893119,
+  2600822924,
+  528734635,
+  1541459225
+];
+function rotateRight(value, bits) {
+  return value >>> bits | value << 32 - bits;
+}
+function sha256Bytes(input) {
+  const blocks = new Uint8Array(Math.ceil((input.length + 9) / 64) * 64);
+  blocks.set(input);
+  blocks[input.length] = 128;
+  const view = new DataView(blocks.buffer);
+  const bitLength = input.length * 8;
+  view.setUint32(blocks.length - 8, Math.floor(bitLength / 4294967296));
+  view.setUint32(blocks.length - 4, bitLength >>> 0);
+  const hash = [...INITIAL_HASH];
+  const schedule = new Uint32Array(64);
+  for (let offset = 0; offset < blocks.length; offset += 64) {
+    for (let i = 0; i < 16; i += 1) schedule[i] = view.getUint32(offset + i * 4);
+    for (let i = 16; i < 64; i += 1) {
+      const early = schedule[i - 15];
+      const late = schedule[i - 2];
+      const s0 = rotateRight(early, 7) ^ rotateRight(early, 18) ^ early >>> 3;
+      const s1 = rotateRight(late, 17) ^ rotateRight(late, 19) ^ late >>> 10;
+      schedule[i] = schedule[i - 16] + s0 + schedule[i - 7] + s1;
+    }
+    let [a, b, c, d, e, f, g, h] = hash;
+    for (let i = 0; i < 64; i += 1) {
+      const s1 = rotateRight(e, 6) ^ rotateRight(e, 11) ^ rotateRight(e, 25);
+      const choice = e & f ^ ~e & g;
+      const temp1 = h + s1 + choice + ROUND_CONSTANTS[i] + schedule[i] >>> 0;
+      const s0 = rotateRight(a, 2) ^ rotateRight(a, 13) ^ rotateRight(a, 22);
+      const majority = a & b ^ a & c ^ b & c;
+      const temp2 = s0 + majority >>> 0;
+      h = g;
+      g = f;
+      f = e;
+      e = d + temp1 >>> 0;
+      d = c;
+      c = b;
+      b = a;
+      a = temp1 + temp2 >>> 0;
+    }
+    const round = [a, b, c, d, e, f, g, h];
+    for (let i = 0; i < 8; i += 1) hash[i] = hash[i] + round[i] >>> 0;
+  }
+  const digest = new Uint8Array(32);
+  const out = new DataView(digest.buffer);
+  for (let i = 0; i < 8; i += 1) out.setUint32(i * 4, hash[i]);
+  return digest;
+}
+
 // src/workspace-settings/catalog.ts
 var CATALOG_GENERATOR = "docblocks-workspace-catalog";
 var CATALOG_FORMAT_VERSION = 1;
@@ -324,8 +449,10 @@ function buildCatalogMarkdownDocument(catalog, outputPath) {
   return { type: "document", children };
 }
 async function sha256Hex(text) {
-  const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(text));
-  return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+  const bytes = new TextEncoder().encode(text);
+  const subtle = globalThis.crypto?.subtle;
+  const digest = subtle ? new Uint8Array(await subtle.digest("SHA-256", bytes)) : sha256Bytes(bytes);
+  return [...digest].map((byte) => byte.toString(16).padStart(2, "0")).join("");
 }
 
 // src/workspace-settings/outside-in-layout.ts

package/dist/{chunk-PQBUG5DY.js → chunk-Q7DU2EEB.js}

@@ -13,6 +13,7 @@ var WORKSPACE_SETTINGS_LIMITS = {
   maxFileBytes: 64 * 1024,
   maxTitleCharacters: 256,
   maxPathCharacters: 1024,
+  maxUrlCharacters: 2048,
   maxSchemaCharacters: 2048,
   maxExcludes: 64,
   minKeep: 1,
@@ -105,6 +106,37 @@ function checkOutputTemplatePath(value, format) {
     return { ok: false, message: shapeMessage(error) };
   }
 }
+function validateSiteUrl(value) {
+  const label = "documents.siteUrl";
+  if (typeof value !== "string" || value.length === 0 || value.length > WORKSPACE_SETTINGS_LIMITS.maxUrlCharacters) {
+    fail(
+      `${label} must be a URL of at most ${WORKSPACE_SETTINGS_LIMITS.maxUrlCharacters} characters.`
+    );
+  }
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    fail(`${label} must be an absolute URL, such as "https://example.com/posts/".`);
+  }
+  if (url.protocol !== "https:" && url.protocol !== "http:") {
+    fail(`${label} must be an http or https URL.`);
+  }
+  if (url.search || url.hash || value.includes("?") || value.includes("#")) {
+    fail(`${label} must not have a query or fragment.`);
+  }
+  return value;
+}
+function optionalSiteUrl(value) {
+  return value === void 0 ? void 0 : validateSiteUrl(value);
+}
+function checkSiteUrl(value) {
+  try {
+    return { ok: true, url: validateSiteUrl(value) };
+  } catch (error) {
+    return { ok: false, message: shapeMessage(error) };
+  }
+}
 function parseOutputTemplates(value) {
   if (value === void 0) return void 0;
   const record = exactRecord(value, "documents.outputTemplates", WORKSPACE_OUTPUT_TEMPLATE_FORMATS);
@@ -173,7 +205,7 @@ function compact(value) {
   const entries = Object.entries(value).filter(([, field]) => field !== void 0);
   return entries.length > 0 ? Object.fromEntries(entries) : void 0;
 }
-var DOCUMENT_SETTINGS_KEYS = ["defaultTheme", "outputTemplates"];
+var DOCUMENT_SETTINGS_KEYS = ["defaultTheme", "outputTemplates", "siteUrl"];
 function parseWorkspaceSettings(value) {
   const root = isRecord(value) ? value : fail("Workspace settings must be a JSON object.");
   const version = root.version;
@@ -200,7 +232,8 @@ function parseWorkspaceSettings(value) {
     const record = exactRecord(root.documents, "documents", DOCUMENT_SETTINGS_KEYS);
     documents = compact({
       defaultTheme: optionalTheme(record.defaultTheme, "documents.defaultTheme"),
-      outputTemplates: parseOutputTemplates(record.outputTemplates)
+      outputTemplates: parseOutputTemplates(record.outputTemplates),
+      siteUrl: optionalSiteUrl(record.siteUrl)
     });
   }
   let versionHistory;
@@ -310,7 +343,8 @@ function serializeWorkspaceSettings(settings) {
     const { outputTemplates } = normalized.documents;
     ordered.documents = {
       ...pick(normalized.documents, ["defaultTheme"]),
-      ...outputTemplates ? { outputTemplates: pick(outputTemplates, WORKSPACE_OUTPUT_TEMPLATE_FORMATS) } : {}
+      ...outputTemplates ? { outputTemplates: pick(outputTemplates, WORKSPACE_OUTPUT_TEMPLATE_FORMATS) } : {},
+      ...pick(normalized.documents, ["siteUrl"])
     };
   }
   if (normalized.versionHistory) {
@@ -417,7 +451,8 @@ function parseWorkspaceSettingsPatch(value) {
         record.defaultTheme,
         (input) => optionalTheme(input, "documents.defaultTheme")
       ),
-      outputTemplates: nullable(record.outputTemplates, parseOutputTemplates)
+      outputTemplates: nullable(record.outputTemplates, parseOutputTemplates),
+      siteUrl: nullable(record.siteUrl, optionalSiteUrl)
     }) ?? {};
   }
   if (root.versionHistory !== void 0) {
@@ -485,7 +520,7 @@ function tryApplyWorkspaceSettingsPatch(base, patch) {
   }
 }
 function isDefaultWorkspaceSettings(settings) {
-  return settings?.documents?.defaultTheme === void 0 && settings?.documents?.outputTemplates === void 0 && settings?.versionHistory?.enabled === void 0 && settings?.versionHistory?.keep === void 0 && settings?.catalog?.html?.enabled !== true && settings?.catalog?.json?.enabled !== true;
+  return settings?.documents?.defaultTheme === void 0 && settings?.documents?.outputTemplates === void 0 && settings?.documents?.siteUrl === void 0 && settings?.versionHistory?.enabled === void 0 && settings?.versionHistory?.keep === void 0 && settings?.catalog?.html?.enabled !== true && settings?.catalog?.json?.enabled !== true;
 }
 function resolveWorkspaceDefaultThemeId(settings) {
   return settings?.documents?.defaultTheme;
@@ -494,6 +529,11 @@ function resolveWorkspaceOutputTemplate(settings, format) {
   const templates = settings?.documents?.outputTemplates;
   return format === "html" ? templates?.html : void 0;
 }
+function resolveWorkspaceSiteUrl(settings) {
+  const url = settings?.documents?.siteUrl;
+  if (url === void 0) return void 0;
+  return url.endsWith("/") ? url : `${url}/`;
+}
 function resolveFallbackThemeId(frontmatterThemeId, settings) {
   if (frontmatterThemeId) return void 0;
   return resolveWorkspaceDefaultThemeId(settings);
@@ -536,6 +576,8 @@ export {
   EMPTY_WORKSPACE_SETTINGS,
   validateOutputTemplatePath,
   checkOutputTemplatePath,
+  validateSiteUrl,
+  checkSiteUrl,
   validateCatalogOutputPath,
   checkCatalogOutputPath,
   parseWorkspaceSettings,
@@ -550,6 +592,7 @@ export {
   isDefaultWorkspaceSettings,
   resolveWorkspaceDefaultThemeId,
   resolveWorkspaceOutputTemplate,
+  resolveWorkspaceSiteUrl,
   resolveFallbackThemeId,
   resolveWorkspaceVersioningEnabled,
   resolveCatalogOutputs

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

@@ -21,6 +21,7 @@ declare const WORKSPACE_SETTINGS_LIMITS: {
     readonly maxFileBytes: number;
     readonly maxTitleCharacters: 256;
     readonly maxPathCharacters: 1024;
+    readonly maxUrlCharacters: 2048;
     readonly maxSchemaCharacters: 2048;
     readonly maxExcludes: 64;
     readonly minKeep: 1;
@@ -48,6 +49,12 @@ interface WorkspaceDocumentSettings {
      * always wins.
      */
     readonly outputTemplates?: WorkspaceOutputTemplates;
+    /**
+     * Public `http(s)` address the workspace root is published at, such as
+     * `https://example.com/posts/`. Rendered Web pages use it to give their
+     * social preview pictures the absolute URLs social sites require.
+     */
+    readonly siteUrl?: string;
 }
 interface WorkspaceVersionHistorySettings {
     /** Absent inherits the app-wide preference. */
@@ -99,6 +106,16 @@ declare function checkOutputTemplatePath(value: unknown, format: WorkspaceOutput
     ok: false;
     message: string;
 };
+/** Validate a configured site address: an absolute `http(s)` URL with no query or fragment. */
+declare function validateSiteUrl(value: unknown): string;
+/** Try-form for UI validation messages. */
+declare function checkSiteUrl(value: unknown): {
+    ok: true;
+    url: string;
+} | {
+    ok: false;
+    message: string;
+};
 type CatalogOutputKind = 'html' | 'json';
 /**
  * Validate a configured catalog output path. Outputs may never land inside
@@ -158,8 +175,8 @@ declare function tryApplyWorkspaceSettingsPatch(base: WorkspaceSettings | null,
 };
 /**
  * True when settings change nothing about how DocBlocks treats the folder: no
- * default theme or page template, no version-history choice, and no catalog
- * output turned on.
+ * default theme, page template, or site address, 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.
@@ -169,6 +186,11 @@ declare function isDefaultWorkspaceSettings(settings: WorkspaceSettings | null |
 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 address the workspace root is published at, as a folder URL (ending in
+ * `/`) that workspace paths resolve against, or undefined when none is set.
+ */
+declare function resolveWorkspaceSiteUrl(settings: WorkspaceSettings | null | undefined): 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
@@ -193,4 +215,4 @@ interface ResolvedCatalogOutputs {
 /** Effective catalog configuration, or null when no output is enabled. */
 declare function resolveCatalogOutputs(settings: WorkspaceSettings | null | undefined): ResolvedCatalogOutputs | null;
 
-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 };
+export { isDefaultWorkspaceSettings as A, isEmptyWorkspaceSettingsPatch as B, type CatalogSortOrder as C, DEFAULT_CATALOG_HTML_PATH as D, EMPTY_WORKSPACE_SETTINGS as E, parseWorkspaceSettings as F, parseWorkspaceSettingsPatch as G, parseWorkspaceSettingsText as H, resolveCatalogOutputs as I, resolveFallbackThemeId as J, resolveWorkspaceDefaultThemeId as K, resolveWorkspaceOutputTemplate as L, resolveWorkspaceSiteUrl as M, resolveWorkspaceVersioningEnabled as N, serializeWorkspaceSettings as O, tryApplyWorkspaceSettingsPatch as P, validateCatalogOutputPath as Q, type ResolvedCatalogOutputs as R, validateOutputTemplatePath as S, validateSiteUrl as T, 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, checkSiteUrl as y, diffWorkspaceSettings as z };

package/dist/vscode/index.d.ts

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

package/dist/vscode/index.js

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

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 { e as CatalogDocumentFormat, g as CatalogOutlineEntry } from '../catalog-BmEXHaZf.js';
+import { e as CatalogDocumentFormat, g as CatalogOutlineEntry } from '../catalog-flfSruLW.js';
 import '@bendyline/squisq/markdown';
-import '../settings-C-TS15JZ.js';
+import '../settings-D_CL7AJA.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-L7HADBCQ.js";
+} from "../chunk-3CCINQX5.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-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 { R as ResolvedCatalogOutputs, W as WorkspaceSettings, a as WorkspaceSettingsPatch } from '../settings-D_CL7AJA.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 checkSiteUrl, z as diffWorkspaceSettings, A as isDefaultWorkspaceSettings, B as isEmptyWorkspaceSettingsPatch, F as parseWorkspaceSettings, G as parseWorkspaceSettingsPatch, H as parseWorkspaceSettingsText, I as resolveCatalogOutputs, J as resolveFallbackThemeId, K as resolveWorkspaceDefaultThemeId, L as resolveWorkspaceOutputTemplate, M as resolveWorkspaceSiteUrl, N as resolveWorkspaceVersioningEnabled, O as serializeWorkspaceSettings, P as tryApplyWorkspaceSettingsPatch, Q as validateCatalogOutputPath, S as validateOutputTemplatePath, T as validateSiteUrl } from '../settings-D_CL7AJA.js';
+import { C as CatalogEntry, W as WorkspaceCatalog } from '../catalog-flfSruLW.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-flfSruLW.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';
@@ -51,6 +51,13 @@ declare const WORKSPACE_SETTINGS_JSON_SCHEMA: {
                         };
                     };
                 };
+                readonly siteUrl: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly pattern: "^https?://[^?#]+$";
+                    readonly maxLength: 2048;
+                    readonly description: "Public address this folder is published at, such as \"https://example.com/posts/\". Gives rendered Web pages absolute social preview image URLs.";
+                };
             };
         };
         readonly versionHistory: {

package/dist/workspace-settings/index.js

@@ -22,7 +22,7 @@ import {
   sortCatalogEntries,
   stampCatalogDates,
   stampCatalogHtml
-} from "../chunk-L7HADBCQ.js";
+} from "../chunk-3CCINQX5.js";
 import {
   CATALOG_JSON_CONTENT_MODES,
   CATALOG_SORT_ORDERS,
@@ -40,6 +40,7 @@ import {
   applyWorkspaceSettingsPatch,
   checkCatalogOutputPath,
   checkOutputTemplatePath,
+  checkSiteUrl,
   diffWorkspaceSettings,
   isDefaultWorkspaceSettings,
   isEmptyWorkspaceSettingsPatch,
@@ -50,12 +51,14 @@ import {
   resolveFallbackThemeId,
   resolveWorkspaceDefaultThemeId,
   resolveWorkspaceOutputTemplate,
+  resolveWorkspaceSiteUrl,
   resolveWorkspaceVersioningEnabled,
   serializeWorkspaceSettings,
   tryApplyWorkspaceSettingsPatch,
   validateCatalogOutputPath,
-  validateOutputTemplatePath
-} from "../chunk-PQBUG5DY.js";
+  validateOutputTemplatePath,
+  validateSiteUrl
+} from "../chunk-Q7DU2EEB.js";
 import {
   SQUISQ_RUNTIME_DIRECTORY_NAME,
   isDiscoverableWorkspaceEntry,
@@ -111,6 +114,13 @@ var WORKSPACE_SETTINGS_JSON_SCHEMA = {
               description: 'Workspace-relative HTML page template for Web pages, such as "_templates/post.html". Its unnamed <slot> receives the page content.'
             }
           }
+        },
+        siteUrl: {
+          type: "string",
+          format: "uri",
+          pattern: "^https?://[^?#]+$",
+          maxLength: WORKSPACE_SETTINGS_LIMITS.maxUrlCharacters,
+          description: 'Public address this folder is published at, such as "https://example.com/posts/". Gives rendered Web pages absolute social preview image URLs.'
         }
       }
     },
@@ -815,6 +825,7 @@ export {
   catalogEntryFromMarkdown,
   checkCatalogOutputPath,
   checkOutputTemplatePath,
+  checkSiteUrl,
   chooseOutsideInMarkdownPath,
   collectWorkspaceCatalog,
   createWorkspaceCatalog,
@@ -842,6 +853,7 @@ export {
   resolveOutsideInLayout,
   resolveWorkspaceDefaultThemeId,
   resolveWorkspaceOutputTemplate,
+  resolveWorkspaceSiteUrl,
   resolveWorkspaceVersioningEnabled,
   saveWorkspaceSettingsPatch,
   serializeCatalogJson,
@@ -851,5 +863,6 @@ export {
   stampCatalogHtml,
   tryApplyWorkspaceSettingsPatch,
   validateCatalogOutputPath,
-  validateOutputTemplatePath
+  validateOutputTemplatePath,
+  validateSiteUrl
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/docblocks",
-  "version": "2.7.9",
+  "version": "2.7.10",
   "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.8",
+    "@bendyline/squisq": "2.13.9",
     "zod": "3.25.76"
   }
 }