@zombie-mermaid/core 4.0.0 → 4.1.0

package/dist/index.d.cts

@@ -63,22 +63,15 @@ export declare function applyInitConfig(options: RenderOptions, config: InitConf
  * Any other value is treated as a literal font name: sanitized and quoted
  * exactly as before.
  *
- * `hasMonoFont`'s `.mono` rule (class-diagram method signatures, ER-diagram
- * attribute types) never reaches out to Google Fonts at all — it used to
- * `@import` 'JetBrains Mono' from Google's CDN, a third-party network
- * dependency a published library's default SVG output had no business
- * making (#1061, filed as a follow-up from #1059's ASCII-side self-hosting
- * fix). It now embeds {@link SVG_MONO_FONT_FACE_CSS} — a small, subsetted
- * (Basic Latin + Latin-1 Supplement), self-hosted `@font-face` as a base64
- * `woff2` data URI, generated by scripts/build-mono-font-subset.ts into
- * ./generated/mono-font-subset.ts — directly in the SVG's own `<style>`
- * block. Unlike `font` above, this isn't caller-configurable: it's the same
- * embed for every consumer, on by default, with no network request either
- * way — a strict improvement over the dead-or-alive CDN fetch it replaces,
- * and the only way a *standalone* SVG (no surrounding host page providing
- * its own copy of the font) renders `.mono` text correctly out of the box.
+ * `mono`'s `.mono` rule (class-diagram method signatures, ER-diagram
+ * attribute types) never reaches out to Google Fonts at all. The caller
+ * supplies a self-hosted {@link MonoFontEmbed} (a base64 `woff2` `@font-face`
+ * plus its family name), which is inlined directly in the SVG's own `<style>`
+ * block (#1061). The font data itself lives in `@zombie-mermaid/svg-renderer`
+ * (see its `buildSvgStyleBlock`), not here, so ASCII-only consumers of
+ * `core` never carry it (#1319). Pass `false` to omit the `.mono` rule.
  */
-export declare function buildStyleBlock(font: string, hasMonoFont: boolean, nonce?: string): string;
+export declare function buildStyleBlock(font: string, mono: MonoFontEmbed | false, nonce?: string): string;
 
 /**
  * Options applicable to class diagrams (`classDiagram`). Class diagrams use
@@ -292,6 +285,15 @@ export declare interface InitConfig {
 /** True when `value` is one of the five directions Mermaid recognizes. */
 export declare function isDirection(value: string): value is Direction;
 
+/**
+ * True when one endpoint of `edge` is a subgraph id and the other is a node or
+ * subgraph nested inside it, at any depth.
+ */
+export declare function isEdgeWithinOwnCluster(edge: {
+    source: string;
+    target: string;
+}, subgraphById: Map<string, MermaidSubgraph>): boolean;
+
 /** True if `line` is an init directive. */
 export declare function isInitDirective(line: string): boolean;
 
@@ -451,6 +453,17 @@ export declare function mixHexColors(fg: string, bg: string, pct: number): strin
  */
 export declare function mixSrgb(c1: RgbaColor, c2: RgbaColor, p1?: number, p2?: number): RgbaColor | null;
 
+/**
+ * A self-hosted monospace font a caller embeds in the SVG `<style>` block
+ * for the `.mono` rule. See `buildStyleBlock`.
+ */
+export declare interface MonoFontEmbed {
+    /** Font family name, listed first in the `.mono` rule's font stack. */
+    family: string;
+    /** The complete `@font-face { ... }` rule (typically a base64 data URI). */
+    faceCss: string;
+}
+
 /** Metrics for multi-line text measurement */
 export declare interface MultilineMetrics {
     /** Maximum line width in pixels */
@@ -1243,6 +1256,16 @@ export declare function withDirectionOverride<T extends {
     direction?: Direction;
 }>(diagram: T, override: Direction | undefined): T;
 
+/**
+ * `graph` without its edges between a node and a subgraph that contains it.
+ * The parser also registers a subgraph id used as an edge endpoint as a
+ * placeholder entry in `graph.nodes`; one no remaining edge refers to is
+ * removed too, so the result equals the graph parsed without those edges.
+ * Returns `graph` itself (same reference) when it has none, and never mutates
+ * its input.
+ */
+export declare function withoutOwnClusterEdges(graph: MermaidGraph): MermaidGraph;
+
 /**
  * Options applicable to XY charts (`xychart-beta`). XY charts have no
  * spacing/`direction`/`curve`/`fontSizes`/`layoutCache` concept (layout is

package/dist/index.d.ts

@@ -63,22 +63,15 @@ export declare function applyInitConfig(options: RenderOptions, config: InitConf
  * Any other value is treated as a literal font name: sanitized and quoted
  * exactly as before.
  *
- * `hasMonoFont`'s `.mono` rule (class-diagram method signatures, ER-diagram
- * attribute types) never reaches out to Google Fonts at all — it used to
- * `@import` 'JetBrains Mono' from Google's CDN, a third-party network
- * dependency a published library's default SVG output had no business
- * making (#1061, filed as a follow-up from #1059's ASCII-side self-hosting
- * fix). It now embeds {@link SVG_MONO_FONT_FACE_CSS} — a small, subsetted
- * (Basic Latin + Latin-1 Supplement), self-hosted `@font-face` as a base64
- * `woff2` data URI, generated by scripts/build-mono-font-subset.ts into
- * ./generated/mono-font-subset.ts — directly in the SVG's own `<style>`
- * block. Unlike `font` above, this isn't caller-configurable: it's the same
- * embed for every consumer, on by default, with no network request either
- * way — a strict improvement over the dead-or-alive CDN fetch it replaces,
- * and the only way a *standalone* SVG (no surrounding host page providing
- * its own copy of the font) renders `.mono` text correctly out of the box.
+ * `mono`'s `.mono` rule (class-diagram method signatures, ER-diagram
+ * attribute types) never reaches out to Google Fonts at all. The caller
+ * supplies a self-hosted {@link MonoFontEmbed} (a base64 `woff2` `@font-face`
+ * plus its family name), which is inlined directly in the SVG's own `<style>`
+ * block (#1061). The font data itself lives in `@zombie-mermaid/svg-renderer`
+ * (see its `buildSvgStyleBlock`), not here, so ASCII-only consumers of
+ * `core` never carry it (#1319). Pass `false` to omit the `.mono` rule.
  */
-export declare function buildStyleBlock(font: string, hasMonoFont: boolean, nonce?: string): string;
+export declare function buildStyleBlock(font: string, mono: MonoFontEmbed | false, nonce?: string): string;
 
 /**
  * Options applicable to class diagrams (`classDiagram`). Class diagrams use
@@ -292,6 +285,15 @@ export declare interface InitConfig {
 /** True when `value` is one of the five directions Mermaid recognizes. */
 export declare function isDirection(value: string): value is Direction;
 
+/**
+ * True when one endpoint of `edge` is a subgraph id and the other is a node or
+ * subgraph nested inside it, at any depth.
+ */
+export declare function isEdgeWithinOwnCluster(edge: {
+    source: string;
+    target: string;
+}, subgraphById: Map<string, MermaidSubgraph>): boolean;
+
 /** True if `line` is an init directive. */
 export declare function isInitDirective(line: string): boolean;
 
@@ -451,6 +453,17 @@ export declare function mixHexColors(fg: string, bg: string, pct: number): strin
  */
 export declare function mixSrgb(c1: RgbaColor, c2: RgbaColor, p1?: number, p2?: number): RgbaColor | null;
 
+/**
+ * A self-hosted monospace font a caller embeds in the SVG `<style>` block
+ * for the `.mono` rule. See `buildStyleBlock`.
+ */
+export declare interface MonoFontEmbed {
+    /** Font family name, listed first in the `.mono` rule's font stack. */
+    family: string;
+    /** The complete `@font-face { ... }` rule (typically a base64 data URI). */
+    faceCss: string;
+}
+
 /** Metrics for multi-line text measurement */
 export declare interface MultilineMetrics {
     /** Maximum line width in pixels */
@@ -1243,6 +1256,16 @@ export declare function withDirectionOverride<T extends {
     direction?: Direction;
 }>(diagram: T, override: Direction | undefined): T;
 
+/**
+ * `graph` without its edges between a node and a subgraph that contains it.
+ * The parser also registers a subgraph id used as an edge endpoint as a
+ * placeholder entry in `graph.nodes`; one no remaining edge refers to is
+ * removed too, so the result equals the graph parsed without those edges.
+ * Returns `graph` itself (same reference) when it has none, and never mutates
+ * its input.
+ */
+export declare function withoutOwnClusterEdges(graph: MermaidGraph): MermaidGraph;
+
 /**
  * Options applicable to XY charts (`xychart-beta`). XY charts have no
  * spacing/`direction`/`curve`/`fontSizes`/`layoutCache` concept (layout is