@knowvah/dot-engine 0.1.0

package/dist/gvc/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../src/gvc/anchor.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAU,MAAM,kBAAkB,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAY,MAAM,oBAAoB,CAAC;AAK/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAoHnE;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAM1E;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,CAAC,EAAE,KAAK,EACR,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,QAAQ,GACZ,IAAI,CAoBN;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,MAAM,GAAG,IAAI,EAClB,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,EAAE,EAAE,MAAM,GACT,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAK/E;AAqBD;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IAAG,EAAE,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;CAAE;AAEtG;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,CAKzD;AAoGD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAsB3E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAKnE;AAED,uFAAuF;AACvF,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAG9E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAQrF;AAsGD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,KAAK,EAAE,EAAE,CAIrF"}

package/dist/gvc/context.d.ts

@@ -0,0 +1,177 @@
+/**
+ * GVC context and plugin registry.
+ *
+ * Ports GVC_t / GVC_s (lib/gvc/gvcint.h) and the plugin capability
+ * negotiation order from lib/gvc/gvplugin.c.  libltdl dynamic loading
+ * is replaced by static registration (AD-2).
+ *
+ * renderToString is NOT on GvcContext — it lives in src/gvc/device.ts as
+ * render(ctx, g, format) to avoid a circular import: device.ts imports
+ * GvcContext, so GvcContext cannot import device.ts.
+ *
+ * @see lib/gvc/gvcint.h
+ * @see lib/gvc/gvplugin.c:gvplugin_install
+ * @see lib/gvc/gvcjob.h
+ */
+import type { Graph } from '../model/graph.js';
+import type { Node } from '../model/node.js';
+import type { Edge } from '../model/edge.js';
+import type { Point, Box } from '../model/geom.js';
+import type { TextSpan } from '../common/emit-types.js';
+import type { TextMeasurer } from '../common/textmeasure.js';
+import type { DebugOptions } from '../debug.js';
+import type { RenderJob } from './job.js';
+/** @see lib/gvc/gvcjob.h:label_type */
+export declare const enum LabelType {
+    Plain = 0,
+    Html = 1
+}
+/** @see lib/gvc/gvcjob.h:pen_type */
+export declare const enum PenType {
+    None = 0,
+    Dashed = 1,
+    Dotted = 2,
+    Solid = 3
+}
+/** @see lib/gvc/gvcjob.h:fill_type */
+export declare const enum FillType {
+    None = 0,
+    Solid = 1,
+    Linear = 2,
+    Radial = 3
+}
+/**
+ * Fused equivalent of gvplugin_installed_t + gvrender_engine_s vtable.
+ *
+ * AD-2 collapses the two-step install/load into one self-contained object.
+ * Plugins are registered with GvcContext.register() and selected by
+ * bestRenderer() using the capability negotiation order from gvplugin_install.
+ *
+ * @see lib/gvc/gvcext.h:gvrender_engine_s
+ * @see lib/gvc/gvplugin.c:gvplugin_install
+ */
+export interface RendererPlugin {
+    /** Format name, e.g. "svg", "dot:core". Type prefix (before `:`) is the sort key. */
+    readonly type: string;
+    /** Capability quality — higher wins when multiple plugins match the same format. */
+    readonly quality: number;
+    beginGraph(g: Graph, job: RenderJob): void;
+    endGraph(g: Graph, job: RenderJob): void;
+    /** Per-layer group (only called when numLayers > 1). @see svg_begin_layer */
+    beginLayer?(name: string, job: RenderJob): void;
+    endLayer?(job: RenderJob): void;
+    /** Per-page content (graph group + background); split from beginGraph so it
+     * can be re-emitted per layer. @see svg_begin_page */
+    beginPage?(g: Graph, job: RenderJob): void;
+    /** Page background polygon; split from beginPage so the page loop can wrap
+     * it (and the graph label) in the graph anchor. @see emit_page */
+    pageBackground?(g: Graph, job: RenderJob): void;
+    endPage?(g: Graph, job: RenderJob): void;
+    beginNode(n: Node, job: RenderJob): void;
+    endNode(n: Node, job: RenderJob): void;
+    beginEdge(e: Edge, job: RenderJob): void;
+    endEdge(e: Edge, job: RenderJob): void;
+    textspan(pos: Point, span: TextSpan, job: RenderJob): void;
+    ellipse(center: Point, rx: number, ry: number, filled: boolean, job: RenderJob): void;
+    polygon(pts: Point[], filled: boolean, job: RenderJob): void;
+    bezier(pts: Point[], filled: boolean, job: RenderJob): void;
+    polyline(pts: Point[], job: RenderJob): void;
+    /** Edge-label attachment line (decorate=true): default line style, pen =
+     *  label fontcolor — NOT the edge's style. @see lib/common/emit.c:emit_attachment */
+    attachmentPolyline?(pts: Point[], pencolor: string, job: RenderJob): void;
+    comment?(text: string, job: RenderJob): void;
+    beginAnchor?(href: string, tooltip: string, target: string, id: string, job: RenderJob): void;
+    endAnchor?(job: RenderJob): void;
+    /**
+     * Set the pending hot-spot rectangle (graph-coordinate box) for the anchor
+     * about to open, mirroring C's `emit_map_rect(job, b)` call inside
+     * `initAnchor`. The map renderer records it as `obj.urlMapPts`; other
+     * renderers no-op. @see lib/common/emit.c:640 emit_map_rect
+     */
+    emitMapRect?(box: Box, job: RenderJob): void;
+    beginLabel?(type: LabelType, job: RenderJob): void;
+    endLabel?(job: RenderJob): void;
+    beginCluster?(sg: Graph, job: RenderJob): void;
+    endCluster?(sg: Graph, job: RenderJob): void;
+    /**
+     * Draw a user image filling box b (graph coordinates, as C's
+     * loadimage plugins receive it). Renderers without image support
+     * omit this — C formats without a loadimage plugin skip the shape.
+     * @see lib/gvc/gvrender.c:gvrender_usershape
+     * @see plugin/core/gvloadimage_core.c:core_loadimage_svg
+     */
+    usershape?(src: string, b: Box, job: RenderJob): void;
+}
+/**
+ * The layout engines bundled by the default context (see makeContext in
+ * src/index.ts — the source of truth for what `renderSvg` registers).
+ * Mirrors the `const char *engine` plugin keys of C's gvLayout.
+ * @see lib/gvc/gvc.h:gvLayout
+ */
+export type BuiltinEngine = 'dot' | 'neato' | 'fdp' | 'sfdp' | 'circo' | 'twopi' | 'osage' | 'patchwork';
+/**
+ * A layout-engine name. The registry is open — callers may `register` custom
+ * engines — so any string is accepted; `(string & {})` keeps editor
+ * autocomplete for the built-ins without closing the set. Unknown names throw
+ * at `layout`/`freeLayout` time, mirroring C's gvLayout error on a missing
+ * plugin.
+ */
+export type EngineName = BuiltinEngine | (string & {});
+/**
+ * TypeScript equivalent of the layout-engine plugin vtable.
+ *
+ * @see lib/gvc/gvplugin.h:gvlayout_engine_s
+ */
+export interface LayoutEngine {
+    /** Engine name, e.g. "dot", "neato". */
+    readonly type: EngineName;
+    layout(g: Graph): void;
+    cleanup(g: Graph): void;
+}
+/**
+ * Root Graphviz context.  Owns the plugin registry, text measurer, and
+ * the layout-engine dispatch.
+ *
+ * Counterpart of GVC_t in lib/gvc/gvcint.h.
+ *
+ * @see lib/gvc/gvc.h:gvContext
+ */
+export declare class GvcContext {
+    private readonly renderers;
+    private readonly layouts;
+    textMeasurer: TextMeasurer;
+    readonly debug: DebugOptions | undefined;
+    constructor(measurer: TextMeasurer, options?: {
+        debug?: DebugOptions;
+    });
+    /** Register a renderer or layout engine; overload discriminated by `quality`. */
+    register(p: RendererPlugin): void;
+    register(p: LayoutEngine): void;
+    /**
+     * Return the first registered renderer whose type prefix matches format.
+     * Because renderers are sorted quality-descending within a prefix, the first
+     * match is always the highest-quality one (last-registered wins on tie).
+     *
+     * @throws Error if no renderer is registered for format
+     * @see lib/gvc/gvplugin.c:gvplugin_find
+     */
+    bestRenderer(format: string): RendererPlugin;
+    /**
+     * Run layout on g using engineName. Engine cleanup is deferred to
+     * freeLayout, matching C's gvLayoutJobs / gvFreeLayout split —
+     * rendering happens in between and must see the layout state
+     * (e.g. cluster arrays).
+     *
+     * @throws Error if the engine is not registered
+     * @see lib/gvc/gvlayout.c:gvLayoutJobs
+     */
+    layout(g: Graph, engineName: EngineName): void;
+    /**
+     * Release engine layout state after rendering.
+     *
+     * @throws Error if the engine is not registered
+     * @see lib/gvc/gvlayout.c:gvFreeLayout
+     */
+    freeLayout(g: Graph, engineName: EngineName): void;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/gvc/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/gvc/context.ts"],"names":[],"mappings":"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"}

package/dist/gvc/default-context.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Factory that builds a GvcContext with all built-in layout engines and
+ * every built-in renderer registered.  This replaces the module-private
+ * makeContext() in src/index.ts and will be wired in by T9.
+ *
+ * @see lib/gvc/gvc.c:gvContext
+ */
+import { GvcContext } from './context.js';
+/**
+ * Build a GvcContext with all 8 built-in layout engines and all 11 built-in
+ * renderer plugins registered.
+ *
+ * Engines: dot, neato, fdp, sfdp, circo, twopi, osage, patchwork
+ * Renderers: svg, dot, xdot, json0, json, plain, plain-ext, imap, imap-np,
+ *            cmapx, cmapx-np
+ *
+ * @see lib/gvc/gvc.c:gvContext
+ */
+export declare function createDefaultContext(): GvcContext;
+//# sourceMappingURL=default-context.d.ts.map

package/dist/gvc/default-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-context.d.ts","sourceRoot":"","sources":["../../src/gvc/default-context.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAsB1C;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,IAAI,UAAU,CA2BjD"}

package/dist/gvc/device-cluster.d.ts

@@ -0,0 +1,25 @@
+import type { Graph } from '../model/graph.js';
+import { RenderJob } from './job.js';
+/**
+ * Read a cluster graph-attribute with ancestor inheritance (agxget): a cluster
+ * with no value of its own inherits an ancestor's `graph[key=...]`. C resolves
+ * every cluster attr this way (late_string(sg, agfindgraphattr(sg, key), ...)),
+ * so a root-level style/color/pencolor/fillcolor/bgcolor/penwidth/gradientangle
+ * applies to the cluster boundary as the oracle does.
+ * @see lib/common/emit.c:emit_clusters (cluster attrs via agxget)
+ */
+export declare function clusterAttr(sg: Graph, key: string): string | undefined;
+/** Cluster `style` with ancestor inheritance. @see clusterAttr */
+export declare function clusterStyle(sg: Graph): string | undefined;
+/**
+ * Cluster `peripheries`, mirroring `late_int(sg, G_peripheries, 1, 0)`:
+ * default 1, non-numeric → default, clamped to a minimum of 0.
+ * @see lib/common/emit.c:3878
+ */
+export declare function clusterPeripheries(sg: Graph): number;
+/**
+ * Apply cluster fill/pen state to job.obj from resolved cluster attrs.
+ * @see lib/common/emit.c:emit_clusters:3805-3874
+ */
+export declare function applyClusterObjState(sg: Graph, job: RenderJob): boolean;
+//# sourceMappingURL=device-cluster.d.ts.map

package/dist/gvc/device-cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-cluster.d.ts","sourceRoot":"","sources":["../../src/gvc/device-cluster.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAwBrC;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMtE;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,CAE1D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM,CAMpD;AA6BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAgBvE"}

package/dist/gvc/device.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Device render loop and coordinate transform.
+ *
+ * Ports gvrender_ptf, gvrender_begin_graph, and gvrender_end_graph from
+ * lib/gvc/gvrender.c.  render() is the top-level entry point; it lives here
+ * (not on GvcContext) to avoid a circular import.
+ *
+ * @see lib/gvc/gvrender.c
+ * @see lib/gvc/gvdevice.c
+ */
+import type { Point } from '../model/geom.js';
+import type { Graph } from '../model/graph.js';
+import type { Node } from '../model/node.js';
+import type { Edge } from '../model/edge.js';
+import type { RendererPlugin, GvcContext } from './context.js';
+import type { TextlabelT } from '../common/types.js';
+import { RenderJob } from './job.js';
+/** Cluster labels go through the single emit_label port. @see labels.c:emit_label */
+export declare function renderClusterLabel(sg: Graph, renderer: RendererPlugin, job: RenderJob): void;
+declare module './job.js' {
+    interface RenderJob {
+        /** When true, usershape() inlines resolved image bytes as a data: URI. */
+        inlineImages?: boolean;
+    }
+}
+/**
+ * Transform a point from graph to device coordinates.
+ * Short-circuits when GVRENDER_DOES_TRANSFORM is set (renderer owns mapping).
+ *
+ * @see lib/gvc/gvrender.c:gvrender_ptf
+ */
+export declare function transformPoint(p: Point, job: RenderJob): Point;
+/** Rotation branch: out.x = -(p.y+ty)*sx, out.y = (p.x+tx)*sy @see gvrender_ptf */
+export declare function applyRotation(p: Point, tx: number, ty: number, sx: number, sy: number): Point;
+/** No-rotation branch: out.x = (p.x+tx)*sx, out.y = (p.y+ty)*sy @see gvrender_ptf */
+export declare function applyScale(p: Point, tx: number, ty: number, sx: number, sy: number): Point;
+/** Construct a Point value. Extracted to avoid inline object literals in return position. */
+export declare function buildPoint(x: number, y: number): Point;
+/**
+ * Render a single node if not already rendered.
+ * push_obj_state before emit_begin_node; pop_obj_state in emit_end_node.
+ * @see lib/common/emit.c:emit_node
+ * @see lib/common/emit.c:emit_begin_node:1654
+ * @see lib/common/emit.c:emit_end_node:1794
+ */
+export declare function renderNode(n: Node, renderer: RendererPlugin, job: RenderJob, done: Set<Node>): void;
+export declare function renderEdge(e: Edge, renderer: RendererPlugin, job: RenderJob): void;
+/**
+ * Emit one label's text spans if present and placed.
+ * Shared by edge-label, node-xlabel, and graph-label slots.
+ * URL/anchor/map machinery and E_decorate attachment (emit.c:emit_attachment)
+ * are not ported, matching the live path's AD-2 scope.
+ * @see lib/common/emit.c:emit_label
+ * @see lib/common/labels.c:emit_label
+ */
+export declare function renderOneLabel(lp: TextlabelT | undefined, renderer: RendererPlugin, job: RenderJob): void;
+/**
+ * Emit node external label (ND_xlabel) if placed.
+ * Must run inside the node group, after codefn (shape draw), matching C order.
+ * @see lib/common/emit.c:emit_node (1829-1830)
+ */
+export declare function renderNodeXLabel(n: Node, renderer: RendererPlugin, job: RenderJob): void;
+/**
+ * Emit root-graph label (GD_label) if present and placed.
+ * Must run before clusters and nodes (emit_page order: background, then label,
+ * then emit_view which contains clusters+nodes+edges).
+ * @see lib/common/emit.c:emit_page (3656-3657)
+ */
+export declare function renderGraphLabel(g: Graph, renderer: RendererPlugin, job: RenderJob): void;
+/**
+ * Render cluster boundary polygons and labels, depth-first.
+ * Corner order matches C's gvrender_box: LL, (LL.x,UR.y), UR, (UR.x,LL.y).
+ * @see lib/gvc/gvrender.c:gvrender_box
+ * @see lib/common/emit.c:emit_clusters
+ */
+export declare function renderClusters(g: Graph, renderer: RendererPlugin, job: RenderJob): void;
+/**
+ * Primary render loop: beginGraph → graph-label → clusters → nodes → edges → endGraph.
+ * Graph label emits before clusters/nodes to match C's emit_page order
+ * (emit_background, GD_label, then emit_view).
+ *
+ * @see lib/gvc/gvrender.c:gvrender_begin_graph
+ * @see lib/gvc/gvrender.c:gvrender_end_graph
+ * @see lib/common/emit.c:emit_page (3655-3660)
+ */
+export declare function renderGraph(g: Graph, job: RenderJob, renderer: RendererPlugin): string;
+/**
+ * Select renderer, create job, initialise bb from graph, then render.
+ *
+ * @param inlineImages - AD-1 (additive, default false): when true, the SVG
+ *   renderer's usershape() consults the registered image resolver
+ *   (`setImageResolver`) and inlines a `data:` URI on a hit instead of the
+ *   raw src passthrough. Unset/false reproduces byte-identical pre-AD-1
+ *   output. @see src/render/public.ts:RenderOptions.inlineImages
+ * @throws Error if no renderer is registered for format
+ * @see lib/gvc/gvrender.c:gvrender_select
+ */
+export declare function render(ctx: GvcContext, g: Graph, format: string, inlineImages?: boolean): string;
+//# sourceMappingURL=device.d.ts.map

package/dist/gvc/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/gvc/device.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAO,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/D,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,SAAS,EAAmF,MAAM,UAAU,CAAC;AAuBtH,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAE5F;AAcD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,SAAS;QACjB,0EAA0E;QAC1E,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB;CACF;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,KAAK,CAe9D;AAED,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAI7F;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,KAAK,CAI1F;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAGtD;AA+DD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAwBnG;AA2BD,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA8BlF;AAsBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,UAAU,GAAG,SAAS,EAC1B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,SAAS,GACb,IAAI,CAwBN;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAIzF;AAkFD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAQvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAyBtF;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,UAAQ,GAAG,MAAM,CA2E9F"}

package/dist/gvc/edge-labels.d.ts

@@ -0,0 +1,10 @@
+import type { Edge } from '../model/edge.js';
+import type { RendererPlugin } from './context.js';
+import type { RenderJob } from './job.js';
+/**
+ * Emit all four edge label slots in C order: label, xlabel, head, tail. Must
+ * run inside the edge group, after the path and arrow polygons.
+ * @see lib/common/emit.c:emit_end_edge (3010-3025)
+ */
+export declare function renderEdgeLabels(e: Edge, renderer: RendererPlugin, job: RenderJob): void;
+//# sourceMappingURL=edge-labels.d.ts.map

package/dist/gvc/edge-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-labels.d.ts","sourceRoot":"","sources":["../../src/gvc/edge-labels.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAQ1C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA2BxF"}

package/dist/gvc/emit-walk.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Node/edge emission walk for the device renderer — C's `emit_view` body.
+ * Split from device.ts to keep that file under the size cap.
+ *
+ * The output order follows the `outputorder` graph attr (chkOrder): `nodesfirst`
+ * → all nodes then all edges (EMIT_SORTED), `edgesfirst` → the reverse
+ * (EMIT_EDGE_SORTED), otherwise C's breadth-first graph walk (emit each node,
+ * then its out-edges' heads + edges).
+ *
+ * @see lib/common/emit.c:emit_view
+ * @see lib/common/emit.c:chkOrder
+ */
+import type { Graph } from '../model/graph.js';
+import type { RendererPlugin } from './context.js';
+import type { RenderJob } from './job.js';
+import { type LayerInfo } from '../common/layers.js';
+/**
+ * Render nodes and edges per the graph's `outputorder`.
+ * @see lib/common/emit.c:emit_view
+ */
+export declare function walkNodesAndEdges(g: Graph, renderer: RendererPlugin, job: RenderJob, info?: LayerInfo): void;
+//# sourceMappingURL=emit-walk.d.ts.map

package/dist/gvc/emit-walk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-walk.d.ts","sourceRoot":"","sources":["../../src/gvc/emit-walk.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,KAAK,SAAS,EAA4B,MAAM,qBAAqB,CAAC;AAuD/E;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI,CAiB5G"}

package/dist/gvc/image-resolver.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Image byte resolution + browser-safe base64 for inline (data: URI) SVG
+ * image embedding.
+ *
+ * Mirrors `src/gvc/usershape.ts`'s `setImageSizer` pattern (AD3): C resolves
+ * images through a process-global filesystem dictionary
+ * (gvusershape.c ImageDict) that is browser-hostile, so the port exposes a
+ * caller-injected resolver in the same global-registry position instead.
+ * Unlike `ImageSizer` (which only reports intrinsic dimensions for HTML
+ * `<IMG>` layout), `ImageResolver` supplies the actual bytes so the SVG
+ * emitter can inline them as a `data:` URI (AD-1, additive — not a C
+ * behavior; native Graphviz never inlines image bytes).
+ *
+ * @see lib/gvc/gvusershape.c (ImageDict, gvusershape_find/size)
+ */
+/**
+ * Caller-supplied image resolver: given a node's `image=`/HTML `<IMG SRC=>`
+ * value, return the raw bytes (optionally with an explicit MIME type), or
+ * `null` when the source cannot be resolved.
+ */
+export type ImageResolver = (src: string) => {
+    bytes: Uint8Array;
+    mime?: string;
+} | Uint8Array | null;
+/**
+ * Register (or clear, with null) the global image resolver consulted when
+ * `RenderOptions.inlineImages` is set. Mirrors gvusershape's process-global
+ * dictionary and `setImageSizer`'s registration shape.
+ */
+export declare function setImageResolver(fn: ImageResolver | null): void;
+/**
+ * Resolve `src` via the registered resolver, normalizing a bare `Uint8Array`
+ * return into `{ bytes, mime }` (inferring `mime` from the `src` extension
+ * when the resolver omits it). Returns `null` when no resolver is set or the
+ * resolver itself returns `null` — the graceful-miss path that keeps the raw
+ * `src` passthrough in `usershape()`.
+ */
+export declare function findImageBytes(src: string): {
+    bytes: Uint8Array;
+    mime: string;
+} | null;
+/** Build a `data:` URI from raw bytes + MIME type. Browser-safe base64. */
+export declare function toDataUri(bytes: Uint8Array, mime: string): string;
+//# sourceMappingURL=image-resolver.d.ts.map

package/dist/gvc/image-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-resolver.d.ts","sourceRoot":"","sources":["../../src/gvc/image-resolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;GAcG;AAMH;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,GAAG,EAAE,MAAM,KACR;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,GAAG,IAAI,CAAC;AAI9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAE/D;AA6BD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQ5C;AA+CD,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE"}