@bendyline/squisq 2.11.12 → 2.11.13

package/dist/{chunk-XZVBR5BP.js → chunk-RLBHQSUG.js}

@@ -6,7 +6,9 @@ import {
 import {
   formatFrontmatterYaml,
   getChildren,
-  splitFrontmatterBlock
+  splitFrontmatterBlock,
+  stringifyHtmlNodes,
+  walkMarkdownTree
 } from "./chunk-X7BNDUNI.js";
 
 // src/markdown/stringify.ts
@@ -964,6 +966,175 @@ function detectMarkdownWrapState(source) {
   };
 }
 
+// src/markdown/contentReferences.ts
+function rewriteMarkdownReferences(source, options = {}) {
+  const { frontmatter, body } = splitFrontmatterBlock(source);
+  const document = parseMarkdown(body, { frontmatter: false });
+  const html = (nodes, insidePicture = false) => {
+    let changed = false;
+    const output2 = nodes.flatMap((node) => {
+      if (node.type !== "htmlElement") return [node];
+      if (options.images === "omit" && node.tagName === "picture") {
+        changed = true;
+        return html(node.children, true).nodes;
+      }
+      if (options.images === "omit" && (node.tagName === "img" || node.tagName === "source" && insidePicture)) {
+        changed = true;
+        const alt = node.tagName === "img" ? node.attributes.alt : void 0;
+        return alt ? [
+          {
+            type: "htmlText",
+            value: alt.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;")
+          }
+        ] : [];
+      }
+      const child = html(node.children);
+      changed || (changed = child.changed);
+      const copy = { ...node, attributes: { ...node.attributes }, children: child.nodes };
+      const key = node.tagName === "a" ? "href" : node.tagName === "img" ? "src" : void 0;
+      if (key && node.attributes[key]) {
+        const value = options.rewriteUrl?.(node.attributes[key], key === "href" ? "link" : "image");
+        if (value !== void 0 && value !== node.attributes[key]) {
+          copy.attributes[key] = value;
+          changed = true;
+        }
+      }
+      return [copy];
+    });
+    return { nodes: output2, changed };
+  };
+  const blocks = /* @__PURE__ */ new Set([
+    "heading",
+    "paragraph",
+    "blockquote",
+    "code",
+    "thematicBreak",
+    "list",
+    "table",
+    "htmlBlock",
+    "mathBlock",
+    "definition",
+    "footnoteDefinition",
+    "containerDirective",
+    "leafDirective",
+    "definitionList"
+  ]);
+  const structural = /* @__PURE__ */ new Set([
+    "listItem",
+    "tableRow",
+    "tableCell",
+    "definitionTerm",
+    "definitionDescription"
+  ]);
+  const render = (node) => {
+    if (node.type === "document") return stringifyMarkdown(node).trimEnd();
+    return stringifyMarkdown({
+      type: "document",
+      children: blocks.has(node.type) ? [node] : [{ type: "paragraph", children: [node] }]
+    }).trimEnd();
+  };
+  const visit = (node) => {
+    const children = getChildren(node).map(visit);
+    const childChanged = children.some((child) => child.changed);
+    let clone = childChanged && "children" in node ? { ...node, children: children.map((child) => child.node) } : node;
+    let ownChange = false;
+    if ((node.type === "image" || node.type === "imageReference") && options.images === "omit") {
+      clone = { type: "text", value: node.alt ?? "" };
+      ownChange = true;
+    } else if (node.type === "htmlBlock" || node.type === "htmlInline") {
+      const transformed = html(node.htmlChildren);
+      if (transformed.changed) {
+        clone = {
+          ...node,
+          htmlChildren: transformed.nodes,
+          rawHtml: stringifyHtmlNodes(transformed.nodes)
+        };
+        ownChange = true;
+      }
+    } else if (clone.type === "link" || clone.type === "image" || clone.type === "definition") {
+      const url = options.rewriteUrl?.(clone.url, clone.type === "image" ? "image" : "link");
+      if (url !== void 0 && url !== clone.url) {
+        clone = { ...clone, url };
+        ownChange = true;
+      }
+    }
+    const changed = ownChange || childChanged;
+    const pending = ownChange || children.some((child) => child.pending);
+    const start = node.position?.start.offset;
+    const end = node.position?.end.offset;
+    if (pending && start !== void 0 && end !== void 0 && !structural.has(node.type)) {
+      return { node: clone, changed, pending: false, edits: [{ start, end, text: render(clone) }] };
+    }
+    return { node: clone, changed, pending, edits: children.flatMap((child) => child.edits) };
+  };
+  const result = visit(document);
+  if (result.pending) throw new Error("Reference edit has no positioned ancestor");
+  const edits = result.edits;
+  let output = body;
+  let boundary = body.length;
+  for (const e of edits.sort((a, b) => b.start - a.start)) {
+    if (e.end > boundary) throw new Error("Overlapping reference edits");
+    output = output.slice(0, e.start) + e.text + output.slice(e.end);
+    boundary = e.start;
+  }
+  return (frontmatter ?? "") + output;
+}
+
+// src/markdown/docfxMarkdown.ts
+function normalizeDocfxMarkdown(source, options = {}) {
+  const { frontmatter, body } = splitFrontmatterBlock(source);
+  const protectedSpans = [];
+  for (const comment of body.matchAll(/<!--[\s\S]*?-->/g))
+    protectedSpans.push([comment.index, comment.index + comment[0].length]);
+  walkMarkdownTree(parseMarkdown(body, { frontmatter: false }), (node) => {
+    if ((node.type === "code" || node.type === "inlineCode") && node.position?.start.offset !== void 0 && node.position.end.offset !== void 0)
+      protectedSpans.push([node.position.start.offset, node.position.end.offset]);
+  });
+  const escape = (text) => stringifyMarkdown({
+    type: "document",
+    children: [{ type: "paragraph", children: [{ type: "text", value: text }] }]
+  }).trimEnd();
+  const output = body.replace(
+    /(^[^\S\n]*(?:>\s*)?):::\s*([\w-]+)([^\n]*?)(?=\r?$)|(^[^\S\n]*>\s*)\[!(NOTE|TIP|IMPORTANT|WARNING|CAUTION|div)\b([^\]]*)\]|:::\s*(image)\b([^\n]*?):::/gim,
+    (match, prefix, name, raw, quote, admonition, _extra, inlineName, inlineRaw, offset) => {
+      if (protectedSpans.some(([start, end]) => offset >= start && offset < end)) return match;
+      if (admonition)
+        return admonition.toLowerCase() === "div" ? quote ?? "" : `${quote}**${admonition[0] + admonition.slice(1).toLowerCase()}:**`;
+      name ?? (name = inlineName);
+      raw ?? (raw = inlineRaw);
+      const attributes = /* @__PURE__ */ new Map();
+      for (const attr of (raw ?? "").matchAll(/([\w-]+)\s*=\s*(?:"([^"]*)"|'([^']*)')/g))
+        attributes.set(attr[1], attr[2] ?? attr[3]);
+      switch (name?.toLowerCase()) {
+        case "image": {
+          const alt = attributes.get("alt-text") ?? "";
+          const url = attributes.get("source");
+          if (options.images === "omit") return `${prefix ?? ""}${escape(alt)}`;
+          if (!url) throw new Error("DocFX image has no source");
+          const image = stringifyMarkdown({
+            type: "document",
+            children: [{ type: "paragraph", children: [{ type: "image", url, alt }] }]
+          }).trimEnd();
+          return `${prefix ?? ""}${image}`;
+        }
+        case "zone":
+          return attributes.has("pivot") ? `${prefix ?? ""}**Applies to: ${escape(attributes.get("pivot"))}**
+` : "";
+        case "zone-end":
+        case "image-end":
+        case "row":
+        case "row-end":
+        case "column":
+        case "column-end":
+          return "";
+        default:
+          throw new Error(`Unsupported DocFX directive: ${name}`);
+      }
+    }
+  );
+  return (frontmatter ?? "") + output;
+}
+
 export {
   stringifyMarkdown,
   DEFAULT_RESOURCE_MAX_BYTES,
@@ -979,5 +1150,7 @@ export {
   unwrapMarkdownSource,
   wrapMarkdownSource,
   cleanupMarkdownSource,
-  detectMarkdownWrapState
+  detectMarkdownWrapState,
+  rewriteMarkdownReferences,
+  normalizeDocfxMarkdown
 };

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions
 export { calculateBearing, decodeGeohash, destinationPoint, encodeGeohash, geohashOverlapsBounds, geohashToHierarchicalPath, getGeohash4Neighbors, getGeohashPath, getGeohashPrefix, getNeighbors, haversineDistance, interpolateGreatCircle, sampleGreatCircle } from './spatial/index.js';
 export { LocalForageAdapter, LocalForageAdapterOptions, LocalStorageAdapter, MemoryStorageAdapter, ScopedContentContainer, StorageAdapter, createMediaProviderFromContainer, scopeContainer } from './storage/index.js';
 export { C as ContentContainer, a as ContentEntry, M as MemoryContentContainer, f as findDocumentPath } from './ContentContainer-B2w9sUoL.js';
-export { DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, FetchResourceBytesOptions, FetchedResource, HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownSourceEdit, MarkdownSourceTransform, MarkdownSourceTransformId, MarkdownSourceTransformOptions, MarkdownSourceTransformResult, MarkdownWrapState, ResourcePolicy, ResourcePolicyError, SanitizeUrlOptions, TrailingAnnotationMatch, UrlKind, applyMarkdownSourceTransform, cleanupMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, walkMarkdownTree, wrapMarkdownSource } from './markdown/index.js';
+export { DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, DocfxMarkdownOptions, FetchResourceBytesOptions, FetchedResource, HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownReferenceOptions, MarkdownSourceEdit, MarkdownSourceTransform, MarkdownSourceTransformId, MarkdownSourceTransformOptions, MarkdownSourceTransformResult, MarkdownWrapState, ResourcePolicy, ResourcePolicyError, SanitizeUrlOptions, TrailingAnnotationMatch, UrlKind, applyMarkdownSourceTransform, cleanupMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, normalizeDocfxMarkdown, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, rewriteMarkdownReferences, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, walkMarkdownTree, wrapMarkdownSource } from './markdown/index.js';
 export { B as BLOCK_META_KEY_DESCRIPTORS, a as BlockMetaKeyDescriptor, K as KNOWN_BLOCK_META_KEYS, b as KnownBlockMetaKey, p as parseTimeSeconds } from './annotationCoercion-Ckqpu33y.js';
 export { BuildCaptionTrackOptions, CaptionSegmentSource, DEFAULT_WORDS_PER_SECOND, NarrationTimeEstimate, NarrationTimeOptions, ReadingTimeEstimate, ReadingTimeOptions, buildCaptionTrack, calculatePrefixDuration, countSpokenWords, estimateNarrationDuration, estimateNarrationTime, estimateReadingTime, estimateSpokenWordCount, estimateTimeFromText } from './timing/index.js';
 export { SeededRandom, hashString } from './random/index.js';

package/dist/index.js

@@ -542,10 +542,12 @@ import {
   detectMarkdownWrapState,
   fetchResourceBytes,
   isResourceUrlAllowed,
+  normalizeDocfxMarkdown,
+  rewriteMarkdownReferences,
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "./chunk-XZVBR5BP.js";
+} from "./chunk-RLBHQSUG.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -1025,6 +1027,7 @@ export {
   nearestSnapPoint,
   needsQuoting,
   normalizeDashboardZoom,
+  normalizeDocfxMarkdown,
   normalizeShapeKind,
   normalizeTransitionDirection,
   normalizeTransitionType,
@@ -1119,6 +1122,7 @@ export {
   resolveTransitionDuration,
   revertToImageEditVersion,
   revertToVersion,
+  rewriteMarkdownReferences,
   rightFeature,
   sampleGreatCircle,
   sanitizeHtmlNodes,

package/dist/markdown/index.d.ts

@@ -616,4 +616,29 @@ declare function cleanupMarkdownSource(source: string, options?: MarkdownSourceT
  */
 declare function detectMarkdownWrapState(source: string): MarkdownWrapState;
 
-export { DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, type FetchResourceBytesOptions, type FetchedResource, HeadingAttributes, HtmlNode, type HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownDocument, MarkdownNode, type MarkdownSourceEdit, type MarkdownSourceTransform, type MarkdownSourceTransformId, type MarkdownSourceTransformOptions, type MarkdownSourceTransformResult, type MarkdownWrapState, ParseOptions, type ResourcePolicy, ResourcePolicyError, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, applyMarkdownSourceTransform, cleanupMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, walkMarkdownTree, wrapMarkdownSource };
+interface MarkdownReferenceOptions {
+    /** Return undefined to retain a URL. The caller owns source-specific resolution. */
+    rewriteUrl?: (url: string, kind: 'link' | 'image') => string | undefined;
+    /** Omit image nodes, retaining their alternative text; default preserve. */
+    images?: 'preserve' | 'omit';
+}
+/**
+ * Rewrite references using the Markdown and HTML trees. Only changed node
+ * spans are serialized: frontmatter, prose, and code outside those spans stay
+ * byte-identical. Handles inline and reference links, images, and raw HTML.
+ * Does not fetch resources and is not an HTML sanitizer.
+ */
+declare function rewriteMarkdownReferences(source: string, options?: MarkdownReferenceOptions): string;
+
+interface DocfxMarkdownOptions {
+    /** Image omission retains descriptive alt text. */
+    images?: 'preserve' | 'omit';
+}
+/** Convert presentational DocFX directives to portable Markdown without fetching.
+ * Includes and code transclusions remain the source adapter's responsibility.
+ * All zone variants are retained with their pivot labels. Code examples and
+ * frontmatter remain untouched. Unsupported directives throw instead of losing text.
+ */
+declare function normalizeDocfxMarkdown(source: string, options?: DocfxMarkdownOptions): string;
+
+export { DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, type DocfxMarkdownOptions, type FetchResourceBytesOptions, type FetchedResource, HeadingAttributes, HtmlNode, type HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownDocument, MarkdownNode, type MarkdownReferenceOptions, type MarkdownSourceEdit, type MarkdownSourceTransform, type MarkdownSourceTransformId, type MarkdownSourceTransformOptions, type MarkdownSourceTransformResult, type MarkdownWrapState, ParseOptions, type ResourcePolicy, ResourcePolicyError, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, applyMarkdownSourceTransform, cleanupMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, normalizeDocfxMarkdown, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, rewriteMarkdownReferences, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, walkMarkdownTree, wrapMarkdownSource };

package/dist/markdown/index.js

@@ -11,10 +11,12 @@ import {
   detectMarkdownWrapState,
   fetchResourceBytes,
   isResourceUrlAllowed,
+  normalizeDocfxMarkdown,
+  rewriteMarkdownReferences,
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "../chunk-XZVBR5BP.js";
+} from "../chunk-RLBHQSUG.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -94,6 +96,7 @@ export {
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
   needsQuoting,
+  normalizeDocfxMarkdown,
   parseFrontmatter,
   parseHtmlToNodes,
   parseMarkdown,
@@ -103,6 +106,7 @@ export {
   quoteAttrValue,
   readFrontmatterThemeId,
   resolveMarkdownSafetyLimits,
+  rewriteMarkdownReferences,
   sanitizeHtmlNodes,
   sanitizeUrl,
   serializePandocAttributes,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.11.12",
+  "version": "2.11.13",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",