stig-gradle-plugin/com.stigway.gradle.dsl/DiagramOutputFormatsDsl

DiagramOutputFormatsDsl

Per-element / per-group / project-defaults DSL controlling which diagram output formats the issue-13 single P7 task emits.

SVG and Cytoscape default to factory value true; Sigma is opt-in and defaults to false. The Monaco source browser defaults to SourceBrowserMode.NONE. Published report-asset size is unlimited unless a defaults, group, or element layer configures maxArtifactSizeMiB.

Layering

The same class is used at three cascade levels. A null field means "inherit from the parent level"; a true/false value overrides. Resolution order: element → group → project defaults → format-specific factory value.

stig {
    // project-wide defaults
    diagramOutputs {
        svg = true
        cytoscape = true
        sigma = true    // opt in to sigma project-wide
        sourceBrowser = SourceBrowserMode.GENERATE
        maxArtifactSizeMiB = 95
    }

    element {
        diagramOutputs {
            cytoscape = false  // … but skip cytoscape here
        }
    }
}

The fields are nullable so the cascade can distinguish "unset" from "set to false". End-user code never has to touch the null value directly; the resolver applies DiagramOutputFormats.FACTORY.

Constructors

DiagramOutputFormatsDsl

constructor()

Properties

cytoscape

var cytoscape: Boolean?

Cytoscape .cyjson export — interactive rendering via the vendored cytoscape.js stack (issue 13/C). P7 retains the complete raw file; report publication uses a lossless .cyjson.gz task output. Factory default: true.

maxArtifactSizeMiB

var maxArtifactSizeMiB: Int?

Maximum size of one asset placed into the published report in MiB. P7 always retains the complete generated artifact under build/. The limit applies to lossless gzip bytes for Cytoscape and ordinary file bytes for other formats; larger publication assets are omitted and reported as HIGH problems. null keeps publication sizes unlimited at this cascade level.

sigma

var sigma: Boolean?

Sigma .sigma.json export — interactive rendering via the vendored sigma.js. Factory default: false.

sourceBrowser

var sourceBrowser: SourceBrowserMode?

Monaco source-browser lifecycle. Factory default: SourceBrowserMode.NONE. SourceBrowserMode.GENERATE keeps the source content local, while SourceBrowserMode.GENERATE_AND_PUBLISH also includes it in Pages output.

svg

var svg: Boolean?

SVG export — pure-JVM ELK + raw SVG string. Factory default: true.

Functions

copy

fun copy(): DiagramOutputFormatsDsl

Used by the cascade resolver to materialise a defensive copy.