@bendyline/squisq 2.11.11 → 2.11.13

package/README.md

@@ -20,7 +20,7 @@ npm install @bendyline/squisq
 | **schemas**  | Type definitions — `Doc`, `BlockTemplate`, `Viewport`, `Theme`, `LayoutStrategy` |
 | **doc**      | Template registry, 26 block templates, animation/theme utilities                 |
 | **markdown** | Markdown parsing, stringifying, AST types (`MarkdownDocument`), tree utilities   |
-| **spatial**  | Haversine distance, Geohash encode/decode                                        |
+| **spatial**  | Haversine distance and bearing, great-circle paths, Geohash encode/decode        |
 | **storage**  | `StorageAdapter` interface, Memory + LocalStorage + LocalForage adapters         |
 
 ## New in this release
@@ -92,10 +92,19 @@ the original fence byte-for-byte for markdown round-trips.
 ### Spatial Utilities
 
 ```ts
-import { encodeGeohash, haversineDistance } from '@bendyline/squisq/spatial';
+import {
+  destinationPoint,
+  encodeGeohash,
+  haversineDistance,
+  sampleGreatCircle,
+} from '@bendyline/squisq/spatial';
 
 const distanceKm = haversineDistance({ lat: 47.6, lng: -122.3 }, { lat: 37.7, lng: -122.4 });
 const hash = encodeGeohash(47.6, -122.3, 7);
+
+// Points along the shortest route, and a position projected 5 km due east.
+const route = sampleGreatCircle({ lat: 47.6, lng: -122.3 }, { lat: 51.5, lng: -0.1 }, 20);
+const ahead = destinationPoint({ lat: 47.6, lng: -122.3 }, 90, 5_000);
 ```
 
 ### Materialize a Block

package/dist/{chunk-UNVHAK3A.js → chunk-GIYWXYCK.js}

@@ -329,20 +329,43 @@ function scopeContainer(parent, prefix) {
 // src/storage/MediaProviderFromContainer.ts
 function createMediaProviderFromContainer(container) {
   const blobUrlCache = /* @__PURE__ */ new Map();
-  return {
-    async resolveUrl(relativePath) {
-      const cached = blobUrlCache.get(relativePath);
-      if (cached) return cached;
+  const pending = /* @__PURE__ */ new Map();
+  const generations = /* @__PURE__ */ new Map();
+  let disposed = false;
+  function invalidate(path) {
+    generations.set(path, (generations.get(path) ?? 0) + 1);
+    pending.delete(path);
+    const cached = blobUrlCache.get(path);
+    if (cached) URL.revokeObjectURL(cached);
+    blobUrlCache.delete(path);
+  }
+  function resolveUrl(relativePath) {
+    if (disposed) return Promise.resolve(relativePath);
+    const cached = blobUrlCache.get(relativePath);
+    if (cached) return Promise.resolve(cached);
+    const existing = pending.get(relativePath);
+    if (existing) return existing;
+    const generation = generations.get(relativePath) ?? 0;
+    const work = (async () => {
       const data = await container.readFile(relativePath);
+      const entries = data ? await container.listFiles() : [];
+      if (disposed) return relativePath;
+      if ((generations.get(relativePath) ?? 0) !== generation) return resolveUrl(relativePath);
       if (!data) return relativePath;
-      const entries = await container.listFiles();
-      const entry = entries.find((e) => e.path === relativePath);
-      const mimeType = entry?.mimeType ?? "application/octet-stream";
-      const blob = new Blob([data], { type: mimeType });
-      const url = URL.createObjectURL(blob);
+      const mimeType = entries.find((e) => e.path === relativePath)?.mimeType;
+      const url = URL.createObjectURL(
+        new Blob([data], { type: mimeType ?? "application/octet-stream" })
+      );
       blobUrlCache.set(relativePath, url);
       return url;
-    },
+    })().finally(() => {
+      if (pending.get(relativePath) === work) pending.delete(relativePath);
+    });
+    pending.set(relativePath, work);
+    return work;
+  }
+  return {
+    resolveUrl,
     async listMedia() {
       const entries = await container.listFiles();
       return entries.filter((e) => !e.path.toLowerCase().endsWith(".md")).map((e) => ({
@@ -352,11 +375,7 @@ function createMediaProviderFromContainer(container) {
       }));
     },
     async addMedia(name, data, mimeType) {
-      const cached = blobUrlCache.get(name);
-      if (cached) {
-        URL.revokeObjectURL(cached);
-        blobUrlCache.delete(name);
-      }
+      invalidate(name);
       let buffer;
       if (data instanceof Blob) {
         buffer = await data.arrayBuffer();
@@ -364,17 +383,17 @@ function createMediaProviderFromContainer(container) {
         buffer = data;
       }
       await container.writeFile(name, buffer, mimeType);
+      invalidate(name);
       return name;
     },
     async removeMedia(relativePath) {
-      const cached = blobUrlCache.get(relativePath);
-      if (cached) {
-        URL.revokeObjectURL(cached);
-        blobUrlCache.delete(relativePath);
-      }
+      invalidate(relativePath);
       await container.removeFile(relativePath);
+      invalidate(relativePath);
     },
     dispose() {
+      disposed = true;
+      pending.clear();
       for (const url of blobUrlCache.values()) {
         URL.revokeObjectURL(url);
       }

package/dist/{chunk-R3KTTOMS.js → chunk-JQLUGVII.js}

@@ -109,6 +109,53 @@ function geohashOverlapsBounds(hash, bounds) {
   return !(hashNorth < bounds.south || hashSouth > bounds.north || hashEast < bounds.west || hashWest > bounds.east);
 }
 
+// src/spatial/GreatCircle.ts
+var DEG2RAD = Math.PI / 180;
+var RAD2DEG = 180 / Math.PI;
+var EARTH_RADIUS_METERS = 6371e3;
+function interpolateGreatCircle(from, to, fraction) {
+  const lat1 = from.lat * DEG2RAD;
+  const lon1 = from.lng * DEG2RAD;
+  const lat2 = to.lat * DEG2RAD;
+  const lon2 = to.lng * DEG2RAD;
+  const dLat = lat2 - lat1;
+  const dLon = lon2 - lon1;
+  const a = Math.sin(dLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(dLon / 2) ** 2;
+  const delta = 2 * Math.asin(Math.min(1, Math.sqrt(a)));
+  if (delta === 0) return { lat: from.lat, lng: from.lng };
+  const A = Math.sin((1 - fraction) * delta) / Math.sin(delta);
+  const B = Math.sin(fraction * delta) / Math.sin(delta);
+  const x = A * Math.cos(lat1) * Math.cos(lon1) + B * Math.cos(lat2) * Math.cos(lon2);
+  const y = A * Math.cos(lat1) * Math.sin(lon1) + B * Math.cos(lat2) * Math.sin(lon2);
+  const z = A * Math.sin(lat1) + B * Math.sin(lat2);
+  const lat = Math.atan2(z, Math.sqrt(x * x + y * y));
+  const lon = Math.atan2(y, x);
+  return { lat: lat * RAD2DEG, lng: lon * RAD2DEG };
+}
+function sampleGreatCircle(from, to, samples) {
+  const n = Math.max(2, Math.floor(samples));
+  const points = [];
+  for (let i = 0; i < n; i++) {
+    points.push(interpolateGreatCircle(from, to, i / (n - 1)));
+  }
+  return points;
+}
+function destinationPoint(from, bearingDeg, distanceMeters) {
+  const delta = distanceMeters / EARTH_RADIUS_METERS;
+  const theta = bearingDeg * DEG2RAD;
+  const lat1 = from.lat * DEG2RAD;
+  const lon1 = from.lng * DEG2RAD;
+  const lat2 = Math.asin(
+    Math.sin(lat1) * Math.cos(delta) + Math.cos(lat1) * Math.sin(delta) * Math.cos(theta)
+  );
+  const lon2 = lon1 + Math.atan2(
+    Math.sin(theta) * Math.sin(delta) * Math.cos(lat1),
+    Math.cos(delta) - Math.sin(lat1) * Math.sin(lat2)
+  );
+  const lng = ((lon2 * RAD2DEG + 180) % 360 + 360) % 360 - 180;
+  return { lat: lat2 * RAD2DEG, lng };
+}
+
 export {
   haversineDistance,
   calculateBearing,
@@ -119,5 +166,8 @@ export {
   getGeohashPrefix,
   geohashToHierarchicalPath,
   getGeohashPath,
-  geohashOverlapsBounds
+  geohashOverlapsBounds,
+  interpolateGreatCircle,
+  sampleGreatCircle,
+  destinationPoint
 };

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

@@ -7,10 +7,10 @@ export { M as MediaEntry, a as MediaProvider } from './MediaProvider-wpSe21B3.js
 export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from './ImageEditDoc-CYRQK8so.js';
 export { ASCII_CHAR_H, ASCII_CHAR_W, ASCII_DIAGRAM_FENCE_LANGS, ASCII_TIMELINE_FENCE_LANGS, AccentLayout, AsciiDiagram, AsciiDiagramDetection, AsciiDiagramEdge, AsciiDiagramNode, AsciiTimeline, AsciiTimelineDetection, AsciiTimelineEvent, AsciiTimelineLink, AsciiTimelineMarker, AsciiTimelineSide, AsciiTimelineStats, AsciiTimelineStyle, AsciiTimelineTrack, AudioSegmentTiming, BASE_INPUT_DESCRIPTORS, BLOCK_MEDIA_LAYOUT_POLICIES, BUILTIN_DASHBOARD_LAYOUTS, BlockLayerMaterialization, BlockMediaLayoutPolicy, BuildPreviewDocOptions, BuiltInTemplateName, CONTAINER_TEMPLATES, COVER_SLIDE_FRONTMATTER_KEYS, COVER_SLIDE_TEMPLATE_OPTIONS, ClipBox, ConnectorAnchor, ConnectorPort, ConnectorRouting, ConnectorSnapPoint, CoverBlockInput, CoverSlidePlayback, CoverSlideSettings, CoverSlideTemplate, CoverSlideTemplateOption, DASHBOARD_AUTO_LAYOUT_ID, DASHBOARD_FRONTMATTER_KEYS, DASHBOARD_STYLES, DASHBOARD_STYLE_IDS, DASHBOARD_ZOOM_LEVELS, DATA_FILE_EXTENSIONS, DEFAULT_COVER_SLIDE_SETTINGS, DEFAULT_DASHBOARD_SETTINGS, DEFAULT_DASHBOARD_STYLE, DEFAULT_LAYOUT, DEFAULT_WORD_STAGGER, DIAGRAM_LABEL_HORIZONTAL_PADDING, DIAGRAM_LABEL_LINE_HEIGHT, DIAGRAM_LABEL_MIN_FONT_SIZE, DIAGRAM_LABEL_VERTICAL_PADDING, DashboardCell, DashboardCellChrome, DashboardCellDefinition, DashboardCellFrame, DashboardDiagnostic, DashboardLayoutDefinition, DashboardLayoutSummary, DashboardLayoutValidationError, DashboardLayoutValidationResult, DashboardMaterialization, DashboardRectPct, DashboardSettings, DashboardSettingsOverrides, DashboardStyleId, DashboardStyleSummary, DashboardTitle, DashboardTitleSlotDefinition, DashboardZoomCandidate, DashboardZoomLevel, DashboardZoomMode, DataFenceParseResult, DataSourceReadOptions, DataSourceReader, DataSourceStats, DataSourceTable, DeriveTemplateInputsOptions, DetectAsciiTimelineOptions, DiagramEdge, DiagramLabelFit, DiagramLayout, DiagramLayoutOptions, DiagramNodePosition, DrawingConnector, DrawingLayout, DrawingLayoutOptions, DrawingShape, DrawingShapeKind, EmbeddedVideo, ExpandDocBlocksOptions, ExtractedTableData, FRONTMATTER_DASHBOARD_LAYOUTS_KEY, FirstImage, Flashcard, FlashcardChoice, FlashcardDeck, FlashcardDiagnostic, FlashcardDiagnosticCode, FlashcardFace, FlashcardKind, FlashcardSourceMode, GEOMETRY_BOUND_TEMPLATES, InputCoercion, LayerMaterializationDiagnostic, LayerMaterializationFailureMode, LayerMaterializationSource, LayoutLayerDefaults, LayoutLayersResult, MAX_COVER_SLIDE_DURATION_SECONDS, MarkdownToDocOptions, MarkdownValidationResult, MaterializeBlockLayersOptions, MaterializeDashboardOptions, MaterializeFlashcardsOptions, NarrationResolution, NativeMediaLayout, NoMediaLayout, PAGE_BASE_CSS, PATH_SHAPE_KINDS, PageSectionContext, PageSectionDraft, ParsedStat, RenderAsciiDiagramOptions, RenderAsciiTimelineOptions, RenderTreeOptions, RepairResult, ResolveDataReferencesOptions, ResolvedDashboardCell, ResolvedDataReferences, ResolvedPageBlock, RichListItem, RuntimeTemplateRegistry, SHAPE_NAMES, SectionExtractor, SupplementalMediaLayoutVariant, SupplementalMediaShape, SupplementalMediaVariantMatrix, TABLE_FED_TEMPLATES, TEMPLATE_AUTHORING_METADATA, TEMPLATE_INPUT_DESCRIPTORS, TEMPLATE_METADATA, TREE_FENCE_LANGS, TemplateAuthoringMetadata, TemplateAuthoringRole, TemplateBodyPolicy, TemplateInputDescriptor, TemplateMediaOwnership, TemplateMetadata, TemplateParamFinding, Tree, TreeDetection, TreeItem, TreeNode, UnconsumedMediaBehavior, ValidateOptions, adjustY, anchorPoint, applyNarrationTiming, applyRenderStyleToLayers, asciiCellToCanvas, asciiDiagramFromBlocks, asciiDiagramFromTemplateData, asciiDiagramToTemplateData, asciiTimelineToTemplateData, autoTemplatePreservesContent, bigText, buildDashboardCellChrome, buildPageCss, buildPageCssVars, buildPreviewDoc, buildRegistry, canvasToAsciiCell, chooseDashboardLayout, clipEndpoints, clipPoint, coerceTemplateParams, comparisonBar, composeDashboardLayers, computeDiagramLayout, computeDrawingLayout, computeLayoutLayers, connectorPath, contentBlock, countBlocks, countUpSpecFor, coverBlock, createAccentLayers, cssFilterForTreatment, dashboardCanvasFill, dashboardCellAccent, dataSidecarPrefix, dataTable, dateEvent, definitionCard, deriveTemplateInputs, desiredCellZoom, detectAsciiDiagram, detectAsciiTimeline, detectTree, diagramBlock, docToMarkdown, documentTitleFromFileName, drawingBlock, expandCoverBlock, expandDocBlocks, expandPersistentLayers, extractBlockquoteText, extractBodyPlainText, extractEmbeddedVideos, extractFirstEmbeddedVideo, extractFirstImage, extractImages, extractListItems, extractRichListItems, extractTableData, extractTableFromContents, factCard, fallbackBlockLayers, findFirstList, findFirstTable, fitBigTextSize, fitDiagramLabel, flattenBlocks, flattenRenderableBlocks, formatCountUp, formatCountValue, fullBleedQuote, getAccentLayout, getAnimationProgress, getAnimationStyle, getAvailableTemplates, getBlockBodyText, getBlockDepth, getBlockMediaLayoutPolicy, getDashboardLayoutSummaries, getDefaultAnimation, getDefaultAnimationDuration, getMotionProfile, getOverlayOpacity, getPersistentLayersFromTheme, getPinnedBlockMeta, getTemplateHint, getThemeFont, getTransitionClass, hasTemplate, imageWithCaption, isAsciiDiagramFence, isAsciiTimelineFence, isContainerTemplate, isDataFence, isDataFilePath, isEligibleAsciiFenceLang, isEligibleAsciiTimelineFenceLang, isEligibleTreeFenceLang, isExplicitDiagramLang, isExplicitTimelineLang, isExplicitTreeLang, isGeometryBoundTemplate, isRepairableDiagram, isShapeName, isTemplatedPageBlock, isTreeFence, isWrappedFlowTimelineSource, layoutBlock, layoutCapacity, leftFeature, lineStyleDasharray, lintTemplateParams, listBlock, listDashboardLayouts, mapBlock, markdownBlockSeparatorLines, markdownToDoc, markerPath, materializeBlockLayers, materializeDashboard, materializeFlashcards, motionDelay, motionEntrance, motionStateTransform, nearestSnapPoint, normalizeDashboardZoom, normalizeShapeKind, pageStyleDataAttributes, parseAsciiDiagram, parseAsciiTimeline, parseAsciiTimelineWithStats, parseDataFence, parseStatNumber, parseTree, parseWrappedFlowTimeline, parseYamlSubset, photoGrid, pullQuote, quoteBlock, readCustomTemplatesFromFrontmatter, readCustomThemesFromFrontmatter, readDashboardLayoutsFromFrontmatter, renderAsciiDiagram, renderAsciiTimeline, renderMarkdownBlocksHtml, renderTree, repairAsciiDiagram, replaceDataFence, resolveAudioMapping, resolveColorScheme, resolveCoverSlideSettings, resolveDashboardLayoutDefinition, resolveDashboardSettings, resolveDashboardStyleId, resolveDashboardZooms, resolveDataReferences, resolveFlashcardMarker, resolveLayoutCells, resolvePageBlock, resolvePersistentLayers, resolveTemplateName, resolveThemeForDoc, rightFeature, scaleAnimationDuration, scoreTextSimilarity, sectionExtractors, sectionHeader, shapePath, shouldUseShadow, snapEndpoints, snapPoints, statHighlight, stripBlockBackdropLayer, stripsBlockBackdrop, templateRegistry, themeWantsAmbientMotion, themedEntrance, themedFontSize, themedImageTreatment, themedScrim, themedSurfaceGradient, timelineBlock, titleBlock, transformOriginFor, transposeCells, treeBlock, treeFromMarkdownList, treeFromTemplateData, treeToTemplateData, twoColumn, validateDashboardLayoutDefinition, validateMarkdownDoc, validateMarkdownSource, videoPullQuote, videoWithCaption, wordRevealDelay, wrapWithPersistentLayers, writeCustomTemplatesToFrontmatter, writeCustomThemesToFrontmatter, writeDashboardLayoutsToFrontmatter } from './doc/index.js';
 export { M as MaterializePageSectionOptions, a as MaterializePageSectionsOptions, P as PageMedia, b as PageRichText, c as PageSection, d as PageSectionDiagnostic, e as PageSectionItem, f as PageSectionMaterialization, g as PageSectionSource, h as PageSpatialKind, i as PageTransformHints, m as materializePageSection, j as materializePageSections, r as resolvePageStyle } from './materializePageSection-Db7pABI0.js';
-export { calculateBearing, decodeGeohash, encodeGeohash, geohashOverlapsBounds, geohashToHierarchicalPath, getGeohash4Neighbors, getGeohashPath, getGeohashPrefix, getNeighbors, haversineDistance } from './spatial/index.js';
+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

@@ -158,6 +158,7 @@ import {
 import {
   calculateBearing,
   decodeGeohash,
+  destinationPoint,
   encodeGeohash,
   geohashOverlapsBounds,
   geohashToHierarchicalPath,
@@ -165,8 +166,10 @@ import {
   getGeohashPath,
   getGeohashPrefix,
   getNeighbors,
-  haversineDistance
-} from "./chunk-R3KTTOMS.js";
+  haversineDistance,
+  interpolateGreatCircle,
+  sampleGreatCircle
+} from "./chunk-JQLUGVII.js";
 import {
   BUILTIN_DASHBOARD_LAYOUTS,
   COVER_SLIDE_FRONTMATTER_KEYS,
@@ -525,7 +528,7 @@ import {
   createMediaProviderFromContainer,
   findDocumentPath,
   scopeContainer
-} from "./chunk-UNVHAK3A.js";
+} from "./chunk-GIYWXYCK.js";
 import {
   DEFAULT_INTERACTIVE_RESOURCE_POLICY,
   DEFAULT_RESOURCE_MAX_BYTES,
@@ -539,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,
@@ -844,6 +849,7 @@ export {
   deriveScale,
   deriveTemplateInputs,
   desiredCellZoom,
+  destinationPoint,
   detectAsciiDiagram,
   detectAsciiTimeline,
   detectMarkdownWrapState,
@@ -961,6 +967,7 @@ export {
   inferDocumentTitle,
   inferSchema,
   inspectAnimatedImage,
+  interpolateGreatCircle,
   isAsciiDiagramFence,
   isAsciiTimelineFence,
   isContainerTemplate,
@@ -1020,6 +1027,7 @@ export {
   nearestSnapPoint,
   needsQuoting,
   normalizeDashboardZoom,
+  normalizeDocfxMarkdown,
   normalizeShapeKind,
   normalizeTransitionDirection,
   normalizeTransitionType,
@@ -1114,7 +1122,9 @@ export {
   resolveTransitionDuration,
   revertToImageEditVersion,
   revertToVersion,
+  rewriteMarkdownReferences,
   rightFeature,
+  sampleGreatCircle,
   sanitizeHtmlNodes,
   sanitizeUrl,
   saveImageEditVersion,

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/dist/spatial/index.d.ts

@@ -113,4 +113,32 @@ declare function geohashOverlapsBounds(hash: string, bounds: {
     west: number;
 }): boolean;
 
-export { calculateBearing, decodeGeohash, encodeGeohash, geohashOverlapsBounds, geohashToHierarchicalPath, getGeohash4Neighbors, getGeohashPath, getGeohashPrefix, getNeighbors, haversineDistance };
+/**
+ * Great-circle paths on a spherical Earth.
+ *
+ * `interpolateGreatCircle` and `sampleGreatCircle` walk the shortest path between two
+ * coordinates (spherical linear interpolation), which stays true over long and high-latitude
+ * routes where a straight lat/lng line distorts badly: use them to sample points along a route,
+ * for example to find places near it. `destinationPoint` goes the other way: from a coordinate
+ * along a compass bearing for a distance, for example to project a moving position ahead of
+ * itself. The sphere is the same one `haversineDistance` uses (mean radius 6,371 km), so the
+ * two agree.
+ */
+
+/**
+ * Interpolate a point a `fraction` (0..1) of the way along the great-circle path from `from`
+ * to `to`. At fraction 0 returns `from`; at 1 returns `to`.
+ */
+declare function interpolateGreatCircle(from: Coordinates, to: Coordinates, fraction: number): Coordinates;
+/**
+ * Sample `samples` evenly spaced points (both endpoints included) along the great-circle path.
+ * `samples` is clamped to at least 2.
+ */
+declare function sampleGreatCircle(from: Coordinates, to: Coordinates, samples: number): Coordinates[];
+/**
+ * The point `distanceMeters` from `from` along the great circle that starts at compass bearing
+ * `bearingDeg` (0 north, 90 east). Longitude is normalized to [-180, 180).
+ */
+declare function destinationPoint(from: Coordinates, bearingDeg: number, distanceMeters: number): Coordinates;
+
+export { calculateBearing, decodeGeohash, destinationPoint, encodeGeohash, geohashOverlapsBounds, geohashToHierarchicalPath, getGeohash4Neighbors, getGeohashPath, getGeohashPrefix, getNeighbors, haversineDistance, interpolateGreatCircle, sampleGreatCircle };

package/dist/spatial/index.js

@@ -1,6 +1,7 @@
 import {
   calculateBearing,
   decodeGeohash,
+  destinationPoint,
   encodeGeohash,
   geohashOverlapsBounds,
   geohashToHierarchicalPath,
@@ -8,11 +9,14 @@ import {
   getGeohashPath,
   getGeohashPrefix,
   getNeighbors,
-  haversineDistance
-} from "../chunk-R3KTTOMS.js";
+  haversineDistance,
+  interpolateGreatCircle,
+  sampleGreatCircle
+} from "../chunk-JQLUGVII.js";
 export {
   calculateBearing,
   decodeGeohash,
+  destinationPoint,
   encodeGeohash,
   geohashOverlapsBounds,
   geohashToHierarchicalPath,
@@ -20,5 +24,7 @@ export {
   getGeohashPath,
   getGeohashPrefix,
   getNeighbors,
-  haversineDistance
+  haversineDistance,
+  interpolateGreatCircle,
+  sampleGreatCircle
 };

package/dist/storage/index.js

@@ -7,7 +7,7 @@ import {
   createMediaProviderFromContainer,
   findDocumentPath,
   scopeContainer
-} from "../chunk-UNVHAK3A.js";
+} from "../chunk-GIYWXYCK.js";
 export {
   LocalForageAdapter,
   LocalStorageAdapter,

package/package.json

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