@diagrammo/dgmo 0.64.1 → 0.65.0

package/dist/index.d.ts

@@ -0,0 +1,207 @@
+import { D as DiagnosticSpec, P as PaletteConfig, C as CompactViewState, a as DgmoError } from './dgmo-router-Dd5PTjxl.js';
+export { b as ChartTypeId, c as ChartTypeMeta, d as DgmoSeverity, e as DiagnosticParams, E as EmitOptions, f as PaletteColors, g as chartTypes, h as emit, i as formatDgmoError, j as getPalette, r as resolvePaletteOrFallback, p as validate } from './dgmo-router-Dd5PTjxl.js';
+import { T as Theme, M as MapDataSource } from './themes-DiUAG4Bf.js';
+export { G as Gazetteer, a as GazetteerEntry, b as MapCompletionOptions, c as MapData, d as MapLocationMatch, e as MapPlaceCompletion, f as MapRegionCompletion, R as RegionName, g as RegionNames, h as completeMapPlaces, i as completeMapRegions, p as palettes, s as searchMapLocations, t as themes } from './themes-DiUAG4Bf.js';
+
+/**
+ * Make an SVG produced by `@diagrammo/dgmo`'s static `render()` suitable for
+ * responsive inline embedding in any host (Obsidian, remark/markdown, web
+ * pages):
+ *
+ * - dgmo renders diagrams inside a fixed export canvas (e.g.
+ *   `viewBox="0 0 1200 800"`), with content often occupying only a fraction
+ *   of it. We compute a tight content bounding box from element coordinates
+ *   and set the root `viewBox` to bbox+padding, so the diagram's intrinsic
+ *   aspect ratio matches its CONTENT — no dead space above/below or beside it.
+ * - Ensure the root `<svg>` has a `viewBox` so it scales responsively.
+ * - Strip fixed `width="N"` / `height="N"` so CSS (e.g. `width:100%;
+ *   height:auto`, or an aspect-ratio derived from the tight viewBox) controls
+ *   sizing.
+ * - The root background (the theme's opaque `palette.bg` — both the inline
+ *   `background:` style and the full-canvas `<rect>` some renderers paint) is
+ *   STRIPPED by default so the embed inherits the host page surface and blends
+ *   into Obsidian / doc-site / arbitrary pages instead of showing a mismatched
+ *   rectangle. Pass `{ background: 'opaque' }` to keep it — the embedder
+ *   opt-out, and the automatic default for background-meaningful types like
+ *   `map` (whose bg is the ocean) via `defaultEmbedBackground`. Standalone
+ *   PNG/SVG export does NOT go through here and stays opaque.
+ *
+ * This is intentionally a string transform, not a DOM `getBBox()` step: dgmo
+ * can dual-render light/dark SVGs where one is hidden by color-mode CSS, and
+ * `getBBox()` returns 0 for the hidden copy. Parsing coordinates from the
+ * markup measures both copies reliably and works server-side (Node).
+ */
+interface NormalizeSvgForEmbedOptions {
+    /**
+     * `transparent` (default) strips the theme's opaque root background so the
+     * embed inherits the host page surface. `opaque` preserves it — the embedder
+     * opt-out for diagrams that need their own solid backdrop. Callers that know
+     * the chart type should resolve this via `defaultEmbedBackground`.
+     */
+    background?: 'transparent' | 'opaque';
+}
+declare function normalizeSvgForEmbed(input: string, opts?: NormalizeSvgForEmbedOptions): string;
+/**
+ * The embed background an embedder gets by default for a given chart type:
+ * `transparent` (blend into the host) for everything except
+ * background-meaningful types, which stay `opaque`.
+ */
+declare function defaultEmbedBackground(chartType?: string): 'transparent' | 'opaque';
+/**
+ * Parse the content bounding box of a normalized embed SVG, if one can be
+ * derived. Returns `null` when no usable coordinates are found (e.g. an empty
+ * diagram). Useful for hosts that want to set an explicit `aspect-ratio` from
+ * the tight viewBox.
+ */
+declare function getEmbedSvgViewBox(svg: string): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+} | null;
+
+interface MountD3Opts {
+    theme?: 'light' | 'dark' | 'transparent';
+    palette?: string;
+    /** Forwarded to the interaction adapter: source-line navigation on click. */
+    onNavigate?: (line: number) => void;
+    mutedColor?: string;
+    surface?: string;
+    text?: string;
+}
+interface MountedD3Chart {
+    /** Re-render with new content and/or theme/palette; re-attaches interactions. */
+    update: (content: string, opts?: Partial<MountD3Opts>) => Promise<void>;
+    /** Emphasize the chart element on the given source line (editor cursor sync);
+     *  pass null to clear. */
+    highlight: (line: number | null) => void;
+    /** Tear down listeners + overlays and clear the container. */
+    destroy: () => void;
+}
+declare function mountD3DataChart(container: HTMLElement, content: string, opts?: MountD3Opts): MountedD3Chart;
+
+interface DataChartInteractionOpts {
+    onNavigate?: (line: number) => void;
+    mutedColor?: string;
+    surface?: string;
+    text?: string;
+}
+interface DataChartController {
+    /** Remove all listeners + overlays. */
+    destroy: () => void;
+    /** Emphasize the chart element(s) on the given source line (editor cursor
+     *  sync); pass null to clear. No-op while the pointer is actively hovering. */
+    highlight: (line: number | null) => void;
+}
+declare function attachDataChartInteractions(svg: SVGSVGElement, opts?: DataChartInteractionOpts): DataChartController;
+
+/** All data-chart types the hand-built renderers currently cover. */
+declare const D3_DATA_CHART_TYPES: Set<string>;
+declare function supportsD3DataChart(type: string): boolean;
+
+/**
+ * The full diagnostic catalog, sorted by code. Every coded diagnostic
+ * dgmo can emit — its severity, owning chart type, canonical message,
+ * fix hint, and a triggering example. This is the enumerable source of
+ * truth for the CLI `diagnostics` subcommand, the console error-review
+ * surface, MCP, and the language-spec catalog.
+ */
+declare function listDiagnosticCodes(): DiagnosticSpec[];
+/** Look up a single spec by its code, or `undefined` if not cataloged. */
+declare function getDiagnosticSpec(code: string): DiagnosticSpec | undefined;
+
+interface RenderOptions {
+    theme?: Theme;
+    /**
+     * A `PaletteConfig` (e.g. `palettes.catppuccin`) or a palette id string
+     * (e.g. `'catppuccin'`). Unknown ids fall back to the default palette.
+     */
+    palette?: PaletteConfig | string;
+    /**
+     * How to handle parse errors:
+     *   'svg'    — render an inline error SVG (default)
+     *   'silent' — return empty svg + diagnostics; caller handles UI
+     *   'throw'  — throw an Error with the diagnostics
+     */
+    onError?: 'svg' | 'silent' | 'throw';
+    /**
+     * Pre-applied interactive view state — collapsed sections/columns,
+     * active swimlane tag-group, etc. Used to render a specific view
+     * non-interactively (server-side render, share-link decode).
+     */
+    viewState?: CompactViewState;
+    /**
+     * Canvas to draw onto, in px. Defaults to the 1200x800 export sheet.
+     *
+     * Omit these and nothing changes. Pass them when the result is going into a
+     * box whose shape you already know — fitting the default sheet to a narrow
+     * column inherits its aspect, so a one-line meter arrives as tall as a poster.
+     */
+    width?: number;
+    height?: number;
+    /**
+     * Basemap assets for `map` charts — the data itself, or a loader returning
+     * it. `render()` reads nothing from the filesystem or the network on its own,
+     * so this is the only way a map obtains a basemap, and its presence here is
+     * what tells a caller whether a render can touch the environment.
+     *
+     * - Node / CLI / SSR: pass the `loadMapData` loader from
+     *   `@diagrammo/dgmo/advanced`. It runs only when the content really is a
+     *   map, so a non-map render never pays to read the assets.
+     * - Browser / Worker / Obsidian: pass your bundled `MapData`.
+     *
+     * Omit it and a map renders empty with an `E_MAP_DATA_NOT_SUPPLIED`
+     * diagnostic. Every other chart type ignores this option.
+     */
+    mapData?: MapDataSource;
+}
+
+interface RenderResult {
+    svg: string;
+    diagnostics: DgmoError[];
+}
+/**
+ * Render DGMO source to an SVG string.
+ *
+ * @example
+ * ```ts
+ * import { render, palettes, themes } from '@diagrammo/dgmo';
+ *
+ * const { svg } = await render(text, {
+ *   palette: palettes.catppuccin,
+ *   theme: themes.dark,
+ * });
+ * document.getElementById('chart').innerHTML = svg;
+ * ```
+ */
+declare function render(text: string, options?: RenderOptions): Promise<RenderResult>;
+
+interface EncodeDiagramUrlOptions {
+    baseUrl?: string;
+    palette?: PaletteConfig;
+    theme?: Theme;
+    filename?: string;
+    /**
+     * Initial view state to embed in the URL — re-applied when the link is
+     * decoded so recipients open the diagram in the same configuration.
+     */
+    viewState?: CompactViewState;
+}
+/**
+ * Encode DGMO text into a shareable URL. Returns null if the compressed
+ * payload exceeds the 8 KB URL limit.
+ */
+declare function encodeDiagramUrl(text: string, options?: EncodeDiagramUrlOptions): string | null;
+interface DecodedDiagramUrl {
+    text: string;
+    palette?: PaletteConfig;
+    theme?: Theme;
+    filename?: string;
+}
+/**
+ * Decode a share URL back into DGMO text plus optional palette/theme/filename.
+ * Returns null if the URL contains no valid DGMO payload.
+ */
+declare function decodeDiagramUrl(url: string): DecodedDiagramUrl | null;
+
+export { CompactViewState, D3_DATA_CHART_TYPES, type DataChartInteractionOpts, type DecodedDiagramUrl, DgmoError, DiagnosticSpec, type EncodeDiagramUrlOptions, MapDataSource, type MountD3Opts, type MountedD3Chart, type NormalizeSvgForEmbedOptions, PaletteConfig, type RenderOptions, type RenderResult, Theme, attachDataChartInteractions, decodeDiagramUrl, defaultEmbedBackground, encodeDiagramUrl, getDiagnosticSpec, getEmbedSvgViewBox, listDiagnosticCodes, mountD3DataChart, normalizeSvgForEmbed, render, supportsD3DataChart };

package/dist/index.js

@@ -11,10 +11,10 @@ import {
 } from "./chunk-SQAG3UXH.js";
 import {
   render
-} from "./chunk-VOJOARA6.js";
+} from "./chunk-ZZXPYVS4.js";
 import {
   renderErrorCard
-} from "./chunk-S5RWWISJ.js";
+} from "./chunk-7L53J53J.js";
 import {
   MAP_DIAGNOSTICS
 } from "./chunk-EOYPX6SF.js";
@@ -22,27 +22,27 @@ import {
   D3_DATA_CHART_TYPES,
   renderDataChartD3,
   supportsD3DataChart
-} from "./chunk-7T3A2UK3.js";
-import "./chunk-CVVICCSB.js";
-import "./chunk-OMTBYLKN.js";
+} from "./chunk-5T7K6QND.js";
+import "./chunk-L65WI4HO.js";
+import "./chunk-TPKNA2U5.js";
 import "./chunk-YRYKTYMQ.js";
 import "./chunk-YYVTBZZC.js";
-import "./chunk-67D4MN2H.js";
-import "./chunk-6VJCURWU.js";
+import "./chunk-LK6LTSLH.js";
+import "./chunk-J2EXBAPZ.js";
 import "./chunk-RU2HHHYA.js";
 import "./chunk-A4GOY3PE.js";
-import "./chunk-RBAW7VUG.js";
-import "./chunk-ES66QH6J.js";
-import "./chunk-Z5ID35YP.js";
-import "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-2EPV7CLY.js";
+import "./chunk-FG24NXKN.js";
+import "./chunk-UTCPNJND.js";
+import "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import {
   decodeDiagramUrl,
   encodeDiagramUrl
 } from "./chunk-U7VO6JAA.js";
 import {
   parseDgmo
-} from "./chunk-AA4M6F2P.js";
+} from "./chunk-BBY57XAA.js";
 import "./chunk-2CMM36O7.js";
 import "./chunk-A2RUBBVT.js";
 import "./chunk-JWJBWNQL.js";
@@ -84,7 +84,7 @@ import {
   PERT_DIAGNOSTICS
 } from "./chunk-VXBEG3IB.js";
 import "./chunk-3TYUXC7D.js";
-import "./chunk-6BVIZW5N.js";
+import "./chunk-FLFBY5GN.js";
 import {
   EVENT_LINE_DIAGNOSTICS
 } from "./chunk-QMYJO4EL.js";
@@ -107,7 +107,7 @@ import {
 import "./chunk-SR7NGZNM.js";
 import "./chunk-NXMESY4J.js";
 import "./chunk-EK4QX7NQ.js";
-import "./chunk-NKRVFQGO.js";
+import "./chunk-BDI25HWH.js";
 import "./chunk-QE4GTFZS.js";
 import "./chunk-7NK42OIB.js";
 import {

package/dist/{layout-HBWT2G23.js → layout-4LNMXLVK.js}

@@ -2,12 +2,12 @@ import {
   fixEdgeWaypoints,
   layoutInfra,
   separateGroups
-} from "./chunk-43E26CDA.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-VS2M72PF.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-5WRI5ZAA.js";
 export {
   fixEdgeWaypoints,
   layoutInfra,
   separateGroups
 };
-//# sourceMappingURL=layout-HBWT2G23.js.map
+//# sourceMappingURL=layout-4LNMXLVK.js.map

package/dist/{layout-UU4VJTOP.js → layout-62ERBWCM.js}

@@ -1,8 +1,8 @@
 import {
   layoutMindmap
-} from "./chunk-U42ZEK7L.js";
+} from "./chunk-V4BYBIBU.js";
 import "./chunk-YYVTBZZC.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-IYULMRBE.js";
 import "./chunk-MDI5FMWO.js";
 import "./chunk-P2PUWV3Y.js";
@@ -12,4 +12,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutMindmap
 };
-//# sourceMappingURL=layout-UU4VJTOP.js.map
+//# sourceMappingURL=layout-62ERBWCM.js.map

package/dist/{layout-N6X46MWG.js → layout-6SKHNQYO.js}

@@ -1,14 +1,14 @@
 import {
   focusFamily,
   layoutFamily
-} from "./chunk-DJCZWQ2A.js";
+} from "./chunk-RTTZIX34.js";
 import "./chunk-IVKC4GID.js";
-import "./chunk-3CIOJ5YJ.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-FJ57274M.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-QQJUTGQH.js";
 import "./chunk-5WRI5ZAA.js";
 export {
   focusFamily,
   layoutFamily
 };
-//# sourceMappingURL=layout-N6X46MWG.js.map
+//# sourceMappingURL=layout-6SKHNQYO.js.map

package/dist/{layout-OH4VQ3OI.js → layout-7JULRP4Y.js}

@@ -1,8 +1,8 @@
 import {
   layoutOrg
-} from "./chunk-RKTIIU7Z.js";
-import "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-N6XI5VTA.js";
+import "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-MDI5FMWO.js";
 import "./chunk-P2PUWV3Y.js";
 import "./chunk-42IT4BG2.js";
@@ -12,4 +12,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutOrg
 };
-//# sourceMappingURL=layout-OH4VQ3OI.js.map
+//# sourceMappingURL=layout-7JULRP4Y.js.map

package/dist/{layout-QTZO6CW5.js → layout-FA37VP7V.js}

@@ -1,12 +1,12 @@
 import {
   layoutGraph
-} from "./chunk-LSFZDBAP.js";
+} from "./chunk-IKHV5IJB.js";
 import "./chunk-6EK55ART.js";
-import "./chunk-VJARCVMH.js";
+import "./chunk-MU3CJPJF.js";
 import "./chunk-5DH3KYFH.js";
 import "./chunk-NCT22MOD.js";
 import "./chunk-WGC42WJU.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-NXMESY4J.js";
 import "./chunk-QE4GTFZS.js";
 import "./chunk-7NK42OIB.js";
@@ -18,4 +18,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutGraph
 };
-//# sourceMappingURL=layout-QTZO6CW5.js.map
+//# sourceMappingURL=layout-FA37VP7V.js.map

package/dist/layout-IN53LAE6.js

@@ -0,0 +1,9 @@
+import {
+  layoutWireframe
+} from "./chunk-NVOU7N6C.js";
+import "./chunk-MTGGOCND.js";
+import "./chunk-5WRI5ZAA.js";
+export {
+  layoutWireframe
+};
+//# sourceMappingURL=layout-IN53LAE6.js.map

package/dist/{layout-H4H4OFE4.js → layout-IO6ORC5T.js}

@@ -3,8 +3,8 @@ import {
   layoutJourneyMap,
   scoreToColor,
   scoreToCurveY
-} from "./chunk-KRTO7NRK.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-D2WHS23S.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-P2PUWV3Y.js";
 import "./chunk-42IT4BG2.js";
 import "./chunk-EXNKNJ65.js";
@@ -16,4 +16,4 @@ export {
   scoreToColor,
   scoreToCurveY
 };
-//# sourceMappingURL=layout-H4H4OFE4.js.map
+//# sourceMappingURL=layout-IO6ORC5T.js.map

package/dist/{layout-54P3DAXY.js → layout-LVMWK4QY.js}

@@ -1,13 +1,13 @@
 import {
   layoutERDiagram
-} from "./chunk-5H2LIQIH.js";
-import "./chunk-LDVUPGWC.js";
+} from "./chunk-UJXCDF4E.js";
+import "./chunk-OWVDD5EC.js";
 import "./chunk-6EK55ART.js";
-import "./chunk-VJARCVMH.js";
+import "./chunk-MU3CJPJF.js";
 import "./chunk-5DH3KYFH.js";
 import "./chunk-NCT22MOD.js";
 import "./chunk-WGC42WJU.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-7NK42OIB.js";
 import "./chunk-NOTA6TEI.js";
 import "./chunk-OLMWTJVU.js";
@@ -15,4 +15,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutERDiagram
 };
-//# sourceMappingURL=layout-54P3DAXY.js.map
+//# sourceMappingURL=layout-LVMWK4QY.js.map

package/dist/{layout-WCOEZPOI.js → layout-MNOTDWXW.js}

@@ -6,9 +6,9 @@ import {
   layoutC4Context,
   layoutC4Deployment,
   rollUpContextRelationships
-} from "./chunk-SF3JAWMY.js";
-import "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-TWILCDUE.js";
+import "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-MDI5FMWO.js";
 import "./chunk-P2PUWV3Y.js";
 import "./chunk-42IT4BG2.js";
@@ -24,4 +24,4 @@ export {
   layoutC4Deployment,
   rollUpContextRelationships
 };
-//# sourceMappingURL=layout-WCOEZPOI.js.map
+//# sourceMappingURL=layout-MNOTDWXW.js.map

package/dist/{layout-2T2VCCTM.js → layout-RD7GDM4I.js}

@@ -1,15 +1,15 @@
 import {
   computeNodeSize,
   layoutBoxesAndLines
-} from "./chunk-Z5BTSBWW.js";
+} from "./chunk-WF2HDQPG.js";
 import "./chunk-WTTIODDV.js";
-import "./chunk-LDVUPGWC.js";
+import "./chunk-OWVDD5EC.js";
 import "./chunk-6EK55ART.js";
-import "./chunk-VJARCVMH.js";
+import "./chunk-MU3CJPJF.js";
 import "./chunk-5DH3KYFH.js";
 import "./chunk-NCT22MOD.js";
 import "./chunk-WGC42WJU.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-7NK42OIB.js";
 import "./chunk-NOTA6TEI.js";
 import "./chunk-OLMWTJVU.js";
@@ -18,4 +18,4 @@ export {
   computeNodeSize,
   layoutBoxesAndLines
 };
-//# sourceMappingURL=layout-2T2VCCTM.js.map
+//# sourceMappingURL=layout-RD7GDM4I.js.map

package/dist/{layout-SKQMIXTG.js → layout-SBQTN2YM.js}

@@ -1,8 +1,8 @@
 import {
   layoutSitemap
-} from "./chunk-KOHIF4LD.js";
-import "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-MBODBL7C.js";
+import "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-MDI5FMWO.js";
 import "./chunk-P2PUWV3Y.js";
 import "./chunk-42IT4BG2.js";
@@ -12,4 +12,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutSitemap
 };
-//# sourceMappingURL=layout-SKQMIXTG.js.map
+//# sourceMappingURL=layout-SBQTN2YM.js.map

package/dist/{layout-5E2NQZNM.js → layout-SGYR6HBX.js}

@@ -2,8 +2,8 @@ import {
   computeNodeSizing,
   layoutPert,
   relayoutPert
-} from "./chunk-R6HCNSP6.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-GOW5VO6M.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-3TYUXC7D.js";
 import "./chunk-EQW6HOP4.js";
 import "./chunk-5WRI5ZAA.js";
@@ -12,4 +12,4 @@ export {
   layoutPert,
   relayoutPert
 };
-//# sourceMappingURL=layout-5E2NQZNM.js.map
+//# sourceMappingURL=layout-SGYR6HBX.js.map

package/dist/{layout-W3ZBJOIK.js → layout-WIMQIHBU.js}

@@ -1,13 +1,13 @@
 import {
   layoutClassDiagram
-} from "./chunk-PCWPYOT4.js";
-import "./chunk-LDVUPGWC.js";
+} from "./chunk-ET4R3AU5.js";
+import "./chunk-OWVDD5EC.js";
 import "./chunk-6EK55ART.js";
-import "./chunk-VJARCVMH.js";
+import "./chunk-MU3CJPJF.js";
 import "./chunk-5DH3KYFH.js";
 import "./chunk-NCT22MOD.js";
 import "./chunk-WGC42WJU.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-7NK42OIB.js";
 import "./chunk-NOTA6TEI.js";
 import "./chunk-OLMWTJVU.js";
@@ -15,4 +15,4 @@ import "./chunk-5WRI5ZAA.js";
 export {
   layoutClassDiagram
 };
-//# sourceMappingURL=layout-W3ZBJOIK.js.map
+//# sourceMappingURL=layout-WIMQIHBU.js.map

package/dist/{layout-search-AJ6VUVUI.js → layout-search-C44CJQOB.js}

@@ -2,7 +2,7 @@ import {
   EDGE_LABEL_FONT_SIZE,
   computeNodeSize,
   measureEdgeLabel
-} from "./chunk-Z5BTSBWW.js";
+} from "./chunk-WF2HDQPG.js";
 import {
   groupedTierCandidates
 } from "./chunk-W4EKQ2P6.js";
@@ -10,13 +10,13 @@ import {
   NODE_HEIGHT,
   NODE_WIDTH
 } from "./chunk-WTTIODDV.js";
-import "./chunk-LDVUPGWC.js";
+import "./chunk-OWVDD5EC.js";
 import "./chunk-6EK55ART.js";
-import "./chunk-VJARCVMH.js";
+import "./chunk-MU3CJPJF.js";
 import "./chunk-5DH3KYFH.js";
 import "./chunk-NCT22MOD.js";
 import "./chunk-WGC42WJU.js";
-import "./chunk-4ASYQ347.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-7NK42OIB.js";
 import "./chunk-NOTA6TEI.js";
 import "./chunk-OLMWTJVU.js";
@@ -1807,4 +1807,4 @@ export {
   layoutBoxesAndLinesSearch,
   separateGroupBands
 };
-//# sourceMappingURL=layout-search-AJ6VUVUI.js.map
+//# sourceMappingURL=layout-search-C44CJQOB.js.map

package/dist/{legend-constants-QQU3QYBF.js → legend-constants-RGINV5SF.js}

@@ -21,8 +21,8 @@ import {
   legendChromeColors,
   measureLegendText,
   truncateLegendText
-} from "./chunk-SCJ7CAJF.js";
-import "./chunk-4ASYQ347.js";
+} from "./chunk-3HOCNSPD.js";
+import "./chunk-MTGGOCND.js";
 import "./chunk-42IT4BG2.js";
 import "./chunk-EXNKNJ65.js";
 import "./chunk-OLMWTJVU.js";
@@ -51,4 +51,4 @@ export {
   measureLegendText,
   truncateLegendText
 };
-//# sourceMappingURL=legend-constants-QQU3QYBF.js.map
+//# sourceMappingURL=legend-constants-RGINV5SF.js.map

package/dist/live-link-resolve.d.ts

@@ -0,0 +1,73 @@
+import { CloudReferenceSource, CloudReference } from './cloud-reference.js';
+
+/** Default per-request timeout. A build waits; a reader should not. */
+declare const DEFAULT_LIVE_LINK_TIMEOUT_MS = 10000;
+/**
+ * What the source endpoint said, once it has been read.
+ *
+ * Four outcomes, and the split is the whole point — a host that cannot tell
+ * `gone` from `unavailable` will either keep publishing something its author
+ * withdrew, or throw away a good copy because one request was dropped.
+ */
+type LiveLinkFetch = 
+/** 200, and the body was the shape we expect. */
+{
+    kind: 'ok';
+    entry: CloudReferenceSource;
+}
+/** 410 — the author withdrew it. Deliberate, and not a failure. */
+ | {
+    kind: 'gone';
+}
+/** 404 — no such published diagram. A typo, or never published. */
+ | {
+    kind: 'missing';
+}
+/** Network, timeout, 5xx, 429, or a body we could not read. Try again later. */
+ | {
+    kind: 'unavailable';
+    reason: string;
+};
+interface LiveLinkFetchOptions {
+    /** Cloud API origin. Default: the public one. */
+    base?: string;
+    /** Per-request timeout in milliseconds. */
+    timeoutMs?: number;
+    /**
+     * The HTTP call. Defaults to `globalThis.fetch` **bound to the global**.
+     *
+     * 🔴 The binding is not tidiness. `fetch` is a WebIDL operation whose `this`
+     * must be the global object, so holding it on an options bag and calling
+     * `opts.fetchImpl(url)` passes the bag as `this` and throws
+     * `Illegal invocation`. That exact bug shipped in every release of the browser
+     * refresh path and was invisible for the feature's whole lifetime, because the
+     * throw landed in a catch that reads any failure as "offline or CSP-blocked".
+     * Node's fetch happens to tolerate a wrong `this`, which is precisely why the
+     * browser half was never caught by a build.
+     *
+     * A host with its own client adapts it here. Obsidian's `requestUrl` becomes
+     * roughly `async (url) => { const r = await requestUrl({ url, throw: false });
+     * return new Response(r.text, { status: r.status }); }` — and note
+     * `throw: false`, because `requestUrl` throws on 400+ by default, which would
+     * turn the 410 above into an exception indistinguishable from being offline.
+     */
+    fetchImpl?: typeof fetch;
+    /**
+     * Extra attempts after an `unavailable` answer. Default 1.
+     *
+     * A retry belongs here rather than with the host because it is a reading of
+     * the response — 429 and 5xx are the server saying "not right now", which is
+     * different from "no". Anything beyond one retry is a host's patience budget:
+     * set 0 when a person is waiting.
+     */
+    retries?: number;
+}
+/**
+ * Ask the Cloud for a live link's current source, and say what came back.
+ *
+ * Never throws: every way this can fail is one of the four outcomes, because a
+ * caller that has to tell a rejected promise from a 410 will get it wrong.
+ */
+declare function fetchLiveLink(ref: CloudReference, options?: LiveLinkFetchOptions): Promise<LiveLinkFetch>;
+
+export { DEFAULT_LIVE_LINK_TIMEOUT_MS, type LiveLinkFetch, type LiveLinkFetchOptions, fetchLiveLink };