@rse/gradia 1.1.3 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +42 -34
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -256,24 +256,32 @@ type is silently ignored. Without both, the type defaults to `graph`.
256
256
  A `#config` directive sets one of the rendering options, which otherwise
257
257
  are settable through the corresponding `--config <option>=<value>`
258
258
  command-line options (`font-embed` being command-line only, see below).
259
- The recognized options are:
259
+ The recognized options, and their default values, are:
260
260
 
261
261
  ```
262
- font-family color-edge-name graph-channel-width-min
263
- font-embed color-edge-arity graph-gutter-height-max
264
- color-node-regular-name color-edge-halo graph-gutter-height-min
265
- color-node-regular-box size-canvas-margin graph-node-separation
266
- color-node-regular-border size-node-width-min graph-rank-separation
267
- color-node-primary-name size-node-width-max graph-node-degree-max
268
- color-node-primary-box size-node-height-scale hub-channel-width-max
269
- color-node-primary-border size-edge-corner-radius hub-channel-width-min
270
- color-node-ghost-name size-edge-hop-radius hub-node-gap
271
- color-node-ghost-box size-edge-track-gap hub-node-degree-max
272
- color-node-ghost-border size-edge-port-gap grid-columns-max
273
- color-group-name group-box-padding grid-columns-min
274
- color-group-box group-box-gap grid-gap-horizontal
275
- color-group-border graph-columns-max grid-gap-vertical
276
- color-edge-line graph-channel-width-max grid-node-width-equal
262
+ font-family Helvetica size-edge-hop-radius 8
263
+ font-embed false size-edge-track-gap 12
264
+ color-node-regular-name #336699 size-edge-port-gap 24
265
+ color-node-regular-box #e0f0ff group-box-padding 30
266
+ color-node-regular-border #c0d0e0 group-box-gap 40
267
+ color-node-primary-name #ffffff graph-columns-max 4
268
+ color-node-primary-box #336699 graph-channel-width-max 140
269
+ color-node-primary-border #003366 graph-channel-width-min 24
270
+ color-node-ghost-name #666666 graph-gutter-height-max 90
271
+ color-node-ghost-box #f0f0f0 graph-gutter-height-min 20
272
+ color-node-ghost-border #a0a0a0 graph-node-separation 30
273
+ color-group-name #6699cc graph-rank-separation 60
274
+ color-group-box #f4f8fc graph-node-degree-max 3
275
+ color-group-border #c0d0e0 hub-channel-width-max 340
276
+ color-edge-line #999999 hub-channel-width-min 240
277
+ color-edge-name #333333 hub-node-gap 20
278
+ color-edge-arity #333333 hub-node-degree-max 3
279
+ color-edge-halo #ffffff grid-columns-max 4
280
+ size-canvas-margin 40 grid-columns-min 3
281
+ size-node-width-min 220 grid-gap-horizontal 40
282
+ size-node-width-max 0 grid-gap-vertical 20
283
+ size-node-height-scale 2.25 grid-node-width-equal true
284
+ size-edge-corner-radius 20
277
285
  ```
278
286
 
279
287
  The `size-*`, `group-*`, `graph-*`, `hub-*`, and `grid-*` options
@@ -285,17 +293,17 @@ The `size-node-width-max` option additionally enables the word-wrapping
285
293
  of the node box texts: given a positive value, the node name, its type,
286
294
  and its attribute lines are greedily broken at whitespace so that the
287
295
  node box stays within the given width and grows in height instead. The
288
- default `0` disables the wrapping entirely and hence lets a node box
296
+ value `0` disables the wrapping entirely and hence lets a node box
289
297
  become as wide as its longest text. A single word wider than the
290
298
  maximum is never broken and still widens the box beyond the maximum.
291
299
 
292
- The `size-edge-port-gap` option (default `24`) controls the distance of
293
- the edge attachment ports along a node side, and hence the vertical
294
- distance of the parallel edges and their labels. It is a *maximum*: a
295
- node box too small to hold all its ports at that distance packs them
296
- closer together instead. A node side carrying more edges than
297
- `graph-node-degree-max` respectively `hub-node-degree-max` grows its box
298
- height by this very distance per additional edge.
300
+ The `size-edge-port-gap` option controls the distance of the edge
301
+ attachment ports along a node side, and hence the vertical distance of
302
+ the parallel edges and their labels. It is a *maximum*: a node box too
303
+ small to hold all its ports at that distance packs them closer together
304
+ instead. A node side carrying more edges than `graph-node-degree-max`
305
+ respectively `hub-node-degree-max` grows its box height by this very
306
+ distance per additional edge.
299
307
 
300
308
  The `graph-channel-width-*` and `graph-gutter-height-*` options control
301
309
  the spacing of a `graph` diagram: its inter-column channels and
@@ -303,21 +311,21 @@ inter-row gutters are sized by the edges routed through them and by the
303
311
  edge labels landing inside them -- a channel by the widest label demand
304
312
  it has to hold (an edge name placed along it, or an edge arity set back
305
313
  from its arrow head), a gutter by one text line per edge name placed
306
- along its run. The `-min` options (defaults `24` and `20`) raise the
307
- result, so that even an unlabeled diagram can be spaced out, while the
308
- `-max` options (defaults `140` and `90`) cap it, so that neither many
309
- parallel edges nor a long label can push the nodes apart without bound.
314
+ along its run. The `-min` options raise the result, so that even an
315
+ unlabeled diagram can be spaced out, while the `-max` options cap it, so
316
+ that neither many parallel edges nor a long label can push the nodes
317
+ apart without bound.
310
318
 
311
319
  The `grid-columns-min` and `grid-columns-max` options control the column
312
320
  count of a `grid` diagram, which by default is derived from the node
313
- count as a roughly square grid: `grid-columns-min` (default `3`) raises
314
- the derived count, so that a few nodes still share a single row instead
315
- of being stacked, while `grid-columns-max` (default `4`) caps it, so
316
- that larger diagrams grow in height only. The column count never
317
- exceeds the node count and the maximum always wins over the minimum.
321
+ count as a roughly square grid: `grid-columns-min` raises the derived
322
+ count, so that a few nodes still share a single row instead of being
323
+ stacked, while `grid-columns-max` caps it, so that larger diagrams grow
324
+ in height only. The column count never exceeds the node count and the
325
+ maximum always wins over the minimum.
318
326
 
319
327
  The `grid-node-width-equal` option controls the tile widths of a `grid`
320
- diagram: its default `true` forces all node boxes to the width of the
328
+ diagram: the value `true` forces all node boxes to the width of the
321
329
  widest one and hence yields a strictly regular grid, while `false` lets
322
330
  each column become only as wide as its own widest node box.
323
331
 
package/package.json CHANGED
@@ -3,7 +3,7 @@
3
3
  "description": "Object Graph Diagram Rendering",
4
4
  "keywords": [ "object", "graph", "diagram", "rendering", "svg", "layout", "api", "cli" ],
5
5
  "publishConfig": { "access": "public" },
6
- "version": "1.1.3",
6
+ "version": "1.1.4",
7
7
  "license": "MIT",
8
8
  "author": {
9
9
  "name": "Dr. Ralf S. Engelschall",