@issuegraph/viewer 0.2.0 → 0.5.0

package/dist/styles.js.map

@@ -1 +1 @@
-{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoX/B,CAAC"}
+{"version":3,"file":"styles.js","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgmC/B,CAAC"}

package/dist/theme.d.ts

@@ -22,12 +22,41 @@
  */
 export declare const COLOR_TOKENS: readonly ["--ig-bg", "--ig-surface", "--ig-surface-2", "--ig-line", "--ig-text", "--ig-text-body", "--ig-text-muted", "--ig-accent", "--ig-focus", "--ig-station-ready", "--ig-station-pending", "--ig-station-held", "--ig-edge-blocked-by", "--ig-edge-serialize-with", "--ig-edge-together-with", "--ig-edge-duplicate-of", "--ig-edge-decomposed-from", "--ig-state-invalid", "--ig-state-failed", "--ig-state-conflict"];
 export type ColorToken = (typeof COLOR_TOKENS)[number];
-/** Type tokens. `lineHeight` is unitless; the rest carry their own units. */
-export declare const TYPE_TOKENS: readonly ["--ig-font-ui", "--ig-font-mono", "--ig-font-size", "--ig-font-size-small", "--ig-line-height"];
+/**
+ * Type tokens. `lineHeight` is unitless; the rest carry their own units.
+ *
+ * WEIGHT AND TRACKING ARE TYPE, NOT GEOMETRY, even though a reader might file
+ * them under either. They are emitted VERBATIM, which is the property that
+ * settles it: a weight is a unitless number and a tracking value is an `em`,
+ * and {@link METRIC_TOKENS} would give both a `px` unit and silently void the
+ * declaration.
+ */
+export declare const TYPE_TOKENS: readonly ["--ig-font-ui", "--ig-font-mono", "--ig-font-size", "--ig-font-size-small", "--ig-line-height", "--ig-font-size-micro", "--ig-font-size-pill", "--ig-weight-regular", "--ig-weight-medium", "--ig-weight-strong", "--ig-weight-heavy", "--ig-tracking-label", "--ig-tracking-group", "--ig-tracking-pill", "--ig-tracking-badge", "--ig-font-size-meta", "--ig-font-size-compact", "--ig-font-size-row", "--ig-font-size-rank"];
 export type TypeToken = (typeof TYPE_TOKENS)[number];
 /** Geometry tokens. Every value is a number of CSS pixels. */
-export declare const METRIC_TOKENS: readonly ["--ig-space", "--ig-space-tight", "--ig-radius", "--ig-row-height", "--ig-station-size", "--ig-station-halo", "--ig-stroke", "--ig-stroke-connector", "--ig-terminal-length", "--ig-terminal-width", "--ig-gutter-width", "--ig-spine-width", "--ig-char-width", "--ig-label-char-width", "--ig-focus-ring"];
+export declare const METRIC_TOKENS: readonly ["--ig-space", "--ig-space-tight", "--ig-radius", "--ig-row-height", "--ig-station-size", "--ig-station-halo", "--ig-stroke", "--ig-stroke-connector", "--ig-stroke-audit", "--ig-terminal-length", "--ig-terminal-width", "--ig-gutter-width", "--ig-spine-width", "--ig-char-width", "--ig-label-char-width", "--ig-focus-ring", "--ig-space-micro", "--ig-space-snug", "--ig-space-loose", "--ig-space-wide", "--ig-radius-small", "--ig-radius-large", "--ig-row-min-height", "--ig-row-padding-block", "--ig-band-rail", "--ig-rank-column", "--ig-station-box", "--ig-card-line"];
 export type MetricToken = (typeof METRIC_TOKENS)[number];
+/**
+ * Surface-treatment tokens: values that are none of a colour, a type value or
+ * a pixel length, and so belong to none of the three groups above.
+ *
+ * A FOURTH GROUP RATHER THAN A HOME OF CONVENIENCE IN AN EXISTING ONE. A tint
+ * strength is a proportion and an elevation is a whole `box-shadow`; put
+ * either in {@link METRIC_TOKENS} and `themeCss` appends `px` to it, which is
+ * not a value any browser reads. Put them in {@link TYPE_TOKENS} and the group
+ * that documents itself as "type" starts carrying shadows — the same
+ * one-token-two-meanings problem the edit-state hues are kept apart from.
+ *
+ * NO TINT CARRIES A COLOUR. A tint is a PROPORTION, applied by the consumer
+ * against a colour token that already exists — `color-mix(in srgb,
+ * var(--ig-edge-blocked-by) var(--ig-tint-fill), transparent)` — so the
+ * palette stays fixed and a host retheming a relationship retints it too. The
+ * two ELEVATIONS are the exception and the only values here that name a
+ * colour; `theme.test.ts` pins that split rather than checking the tints
+ * alone, so a colour cannot arrive in this group unannounced.
+ */
+export declare const EFFECT_TOKENS: readonly ["--ig-tint-fill", "--ig-tint-border", "--ig-tint-wash", "--ig-tint-unit", "--ig-elevation-raised", "--ig-elevation-overlay"];
+export type EffectToken = (typeof EFFECT_TOKENS)[number];
 /** Every custom property the stylesheet may reference. */
 export declare const THEME_TOKENS: readonly string[];
 export interface Theme {
@@ -35,6 +64,8 @@ export interface Theme {
     readonly type: Readonly<Record<TypeToken, string>>;
     /** Numbers, in CSS pixels. Layout reads these; `themeCss` renders them. */
     readonly metrics: Readonly<Record<MetricToken, number>>;
+    /** Strings, emitted verbatim — proportions and whole shadow values. */
+    readonly effects: Readonly<Record<EffectToken, string>>;
 }
 /**
  * The default theme.
@@ -51,6 +82,7 @@ export interface ThemeOverride {
     readonly colors?: Partial<Record<ColorToken, string>> | undefined;
     readonly type?: Partial<Record<TypeToken, string>> | undefined;
     readonly metrics?: Partial<Record<MetricToken, number>> | undefined;
+    readonly effects?: Partial<Record<EffectToken, string>> | undefined;
 }
 /**
  * Merge an override onto a base theme, per token.
@@ -68,10 +100,9 @@ export declare function extendTheme(base: Theme, override: ThemeOverride): Theme
  * package and stored. Adding a token then puts a hole in it, and the hole does
  * not fail loudly: a missing metric reads `undefined`, arithmetic on it yields
  * `NaN`, and every comparison against `NaN` is false. Measured when
- * `--ig-label-char-width` was added — a 0.1.0 theme made `fitLabel` return a
- * 60-character title with an ellipsis APPENDED, which is worse overflow than
- * the defect that token was added to fix, and `themeCss` emitted
- * `undefinedpx`.
+ * `--ig-label-char-width` was added — a 0.1.0 theme made every measured width
+ * `NaN`, so a card's height came out `NaN` and every station stacked at the
+ * same y, and `themeCss` emitted `undefinedpx`.
  *
  * A TypeScript caller is told about a new token by the compiler; a JavaScript
  * one is not, and neither is a theme deserialized from storage. This is the
@@ -84,9 +115,9 @@ export declare function resolveTheme(theme?: Theme | undefined): Theme;
 /**
  * Render a theme as one CSS rule of custom properties.
  *
- * Values are emitted verbatim for colours and type — a theme's author owns
- * their spelling — and metrics gain a `px` unit here, which is the single place
- * the numbers become CSS.
+ * Values are emitted verbatim for colours, type and effects — a theme's author
+ * owns their spelling — and metrics gain a `px` unit here, which is the single
+ * place the numbers become CSS.
  */
 export declare function themeCss(theme: Theme, selector?: string): string;
 //# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,+ZAgCd,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,6EAA6E;AAC7E,eAAO,MAAM,WAAW,2GAMb,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,8DAA8D;AAC9D,eAAO,MAAM,aAAa,wTAgBf,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAIxC,CAAC;AAEH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,KAqFzB,CAAC;AAEH,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,KAAK,CAMvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,SAAU,GAAG,MAAM,CAUjE"}
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,+ZAgCd,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,2aAgDb,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,8DAA8D;AAC9D,eAAO,MAAM,aAAa,kkBAyDf,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,aAAa,wIAsBf,CAAC;AAEZ,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,0DAA0D;AAC1D,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAKxC,CAAC;AAEH,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACxD,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,KA2MzB,CAAC;AAEH,mEAAmE;AACnE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACrE;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,aAAa,GAAG,KAAK,CAOvE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAE7D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,SAAU,GAAG,MAAM,CAWjE"}

package/dist/theme.js

@@ -53,13 +53,63 @@ export const COLOR_TOKENS = Object.freeze([
     '--ig-state-failed',
     '--ig-state-conflict',
 ]);
-/** Type tokens. `lineHeight` is unitless; the rest carry their own units. */
+/**
+ * Type tokens. `lineHeight` is unitless; the rest carry their own units.
+ *
+ * WEIGHT AND TRACKING ARE TYPE, NOT GEOMETRY, even though a reader might file
+ * them under either. They are emitted VERBATIM, which is the property that
+ * settles it: a weight is a unitless number and a tracking value is an `em`,
+ * and {@link METRIC_TOKENS} would give both a `px` unit and silently void the
+ * declaration.
+ */
 export const TYPE_TOKENS = Object.freeze([
     '--ig-font-ui',
     '--ig-font-mono',
     '--ig-font-size',
     '--ig-font-size-small',
     '--ig-line-height',
+    // ADDED IN SOURCE ORDER, AFTER THE ONES THAT SHIPPED, in this group and in
+    // {@link METRIC_TOKENS} both. `themeCss` emits in list order, so appending
+    // rather than interleaving keeps every declaration a host already had in the
+    // position it already had — the emitted rule stays a strict superset instead
+    // of a reshuffle a snapshotting consumer has to re-approve. Reading order
+    // loses a little; the diff a host sees loses nothing.
+    //
+    // TWO SIZE STEPS BELOW `--ig-font-size-small`, because the design draws two
+    // and this file named neither. A relationship badge is 10px and an uppercase
+    // status pill is 9.5px (§16a); with 11px as the smallest token, both had to
+    // be drawn a size too large, which is why the badge row reads as body copy.
+    '--ig-font-size-micro',
+    '--ig-font-size-pill',
+    // THE FOUR WEIGHTS THE DESIGN USES, and the reason a rail row read as one
+    // undifferentiated object: with no weight token every string rendered at
+    // 400, so a row's title and its metadata carried the same emphasis.
+    '--ig-weight-regular',
+    '--ig-weight-medium',
+    '--ig-weight-strong',
+    '--ig-weight-heavy',
+    // Uppercase labels are TRACKED in this design, and tracking is NOT derivable
+    // from the size — §16a sets `.06em` and `.08em` on two pills of the same
+    // 9.5px sitting in the same list. One token reused for all of them is the
+    // approximation that makes uppercase type look mechanically stretched, so
+    // there is one per value the frames draw.
+    '--ig-tracking-label',
+    '--ig-tracking-group',
+    '--ig-tracking-pill',
+    '--ig-tracking-badge',
+    // THE FOUR STEPS BETWEEN `--ig-font-size-micro` AND `--ig-font-size`, for the
+    // same reason the two below `small` were added: the frames draw them and this
+    // file named none of them, so every one had to be approximated by 11px or
+    // 13px. §16a alone spends 10.5 (a footer row's id), 12.5 (a footer row's
+    // title and §16b's node title), 13.5 (a rank row's title) and 14 (the rank
+    // number itself) — four values in one frame, none of them derivable from the
+    // two that shipped. Approximating them is what made a rank row read as one
+    // undifferentiated block of body copy: with title, id and provenance all at
+    // 11-13px, the row had no type hierarchy to see.
+    '--ig-font-size-meta',
+    '--ig-font-size-compact',
+    '--ig-font-size-row',
+    '--ig-font-size-rank',
 ]);
 /** Geometry tokens. Every value is a number of CSS pixels. */
 export const METRIC_TOKENS = Object.freeze([
@@ -71,6 +121,7 @@ export const METRIC_TOKENS = Object.freeze([
     '--ig-station-halo',
     '--ig-stroke',
     '--ig-stroke-connector',
+    '--ig-stroke-audit',
     '--ig-terminal-length',
     '--ig-terminal-width',
     '--ig-gutter-width',
@@ -78,12 +129,95 @@ export const METRIC_TOKENS = Object.freeze([
     '--ig-char-width',
     '--ig-label-char-width',
     '--ig-focus-ring',
+    // Appended, for the reason {@link TYPE_TOKENS} gives.
+    //
+    // SIX SPACING STEPS, WHICH IS A CHOICE AND SAYS SO. §16a and §16b do not run
+    // a scale — they spend a near-continuum from 2px to 20px, with 7px and 9px
+    // as common as any tokenised step — so a token set has to pick, and the
+    // honest statement is which values it rounds. These six span the range the
+    // frames spend and keep the two that shipped exactly where they were: a
+    // chip's `2px 7px` padding draws its inline half at `--ig-space-tight`, and
+    // a 9px or 10px gap at `--ig-space-snug` or `--ig-space`. What two steps
+    // could not do is span it at all — a 2px gap between a title and its
+    // metadata and a 20px panel inset both resolved to 6px or 12px, and the rail
+    // lost its grouping.
+    '--ig-space-micro',
+    '--ig-space-snug',
+    '--ig-space-loose',
+    '--ig-space-wide',
+    '--ig-radius-small',
+    '--ig-radius-large',
+    // A ROW WHOSE HEIGHT CAN FOLLOW ITS CONTENT. `--ig-row-height` stays what it
+    // has always been — the FIXED height of a rail row — because a host has that
+    // number and its meaning must not move under them. These two are the
+    // vocabulary a content-sized row needs instead: a floor, and the padding its
+    // content grows against.
+    '--ig-row-min-height',
+    '--ig-row-padding-block',
+    // The accent rail a banded row carries down its leading edge (§16a's
+    // WORKING NOW band, `inset 3px 0 0`). It pairs with `--ig-tint-wash`: the
+    // wash is the band's fill and this is its edge.
+    '--ig-band-rail',
+    // §16a's rank TRACK, `grid-template-columns: 34px 1fr`. It is a column width
+    // rather than a derived one because the frame fixes it: the rank figure and
+    // the readiness dot stack inside it and the title column starts at the same
+    // x on every row, held or not. Deriving it from the station size and a gap
+    // would make the alignment grid move whenever either did, which is the one
+    // thing this column exists to prevent.
+    '--ig-rank-column',
+    // §16b's spine furniture: the station disc that sits ON the spine line, and
+    // the line height a card's own height is counted in.
+    '--ig-station-box',
+    '--ig-card-line',
+]);
+/**
+ * Surface-treatment tokens: values that are none of a colour, a type value or
+ * a pixel length, and so belong to none of the three groups above.
+ *
+ * A FOURTH GROUP RATHER THAN A HOME OF CONVENIENCE IN AN EXISTING ONE. A tint
+ * strength is a proportion and an elevation is a whole `box-shadow`; put
+ * either in {@link METRIC_TOKENS} and `themeCss` appends `px` to it, which is
+ * not a value any browser reads. Put them in {@link TYPE_TOKENS} and the group
+ * that documents itself as "type" starts carrying shadows — the same
+ * one-token-two-meanings problem the edit-state hues are kept apart from.
+ *
+ * NO TINT CARRIES A COLOUR. A tint is a PROPORTION, applied by the consumer
+ * against a colour token that already exists — `color-mix(in srgb,
+ * var(--ig-edge-blocked-by) var(--ig-tint-fill), transparent)` — so the
+ * palette stays fixed and a host retheming a relationship retints it too. The
+ * two ELEVATIONS are the exception and the only values here that name a
+ * colour; `theme.test.ts` pins that split rather than checking the tints
+ * alone, so a colour cannot arrive in this group unannounced.
+ */
+export const EFFECT_TOKENS = Object.freeze([
+    // Read from §16a's badge row, where a relationship chip is a fill of its own
+    // hue inside a heavier border of the same hue. That is what "badges with
+    // tinted fills rather than bare borders" costs in tokens, and with no way to
+    // express it every badge shipped as a bare outline.
+    '--ig-tint-fill',
+    '--ig-tint-border',
+    // Two washes, and they are not interchangeable: the band marking the row
+    // being worked NOW sits at 5% of the accent, and the together-unit row at
+    // 3%. Collapsing them to one value either loses the band or draws every
+    // compound station as loud as the one in flight.
+    '--ig-tint-wash',
+    '--ig-tint-unit',
+    // Elevation, and it is the one pair here NOT read from a §16 frame — §16
+    // draws no drop shadow at all, separating its panels with `1px solid
+    // var(--ig-line)`. The values are the kit's own two, from the surfaces that
+    // do float: the device frame the comps sit in, and a floating toast. They
+    // are here because the token set is the whole visual vocabulary and an
+    // overlay has nowhere else to come from; a §16 panel keeps its border, and
+    // reaching for one of these to lift a panel is a decision, not a default.
+    '--ig-elevation-raised',
+    '--ig-elevation-overlay',
 ]);
 /** Every custom property the stylesheet may reference. */
 export const THEME_TOKENS = Object.freeze([
     ...COLOR_TOKENS,
     ...TYPE_TOKENS,
     ...METRIC_TOKENS,
+    ...EFFECT_TOKENS,
 ]);
 /**
  * The default theme.
@@ -139,6 +273,42 @@ export const defaultTheme = Object.freeze({
         '--ig-font-size': '13px',
         '--ig-font-size-small': '11px',
         '--ig-line-height': '1.45',
+        // §16a draws a relationship badge at 10px and an uppercase status pill
+        // ("now", "⧉ one unit · 2 issues") at 9.5px. Both are read values, not a
+        // ratio continued downward — the design does not run a scale here.
+        '--ig-font-size-micro': '10px',
+        '--ig-font-size-pill': '9.5px',
+        // Regular is the ground the file already rendered everything at; medium is
+        // §16's emphasis weight; strong is §16a's list rank number, its active
+        // toggle and its pills, and is the most-used weight in the frames. Heavy
+        // is §16b's STATION rank numbers, which are 700 where §16a's list numbers
+        // are 600 — the same figure at two weights in two projections, so three
+        // weights could not draw both.
+        '--ig-weight-regular': '400',
+        '--ig-weight-medium': '500',
+        '--ig-weight-strong': '600',
+        '--ig-weight-heavy': '700',
+        // "Order preview", the panel's own label, at 11px uppercase.
+        '--ig-tracking-label': '0.14em',
+        // §16b's column headers — "The work order ↓", "Explains the order", "Not
+        // worked" — which name a group WITHIN a frame rather than the frame.
+        '--ig-tracking-group': '0.1em',
+        // §16a's status pill ("now") and its unit badge ("⧉ one unit · 2 issues"),
+        // both 9.5px uppercase and sitting in the same list at DIFFERENT tracking.
+        // That pair is the reason tracking is its own axis here: it cannot be
+        // derived from the size, because these two share one.
+        '--ig-tracking-pill': '0.08em',
+        '--ig-tracking-badge': '0.06em',
+        // Read values, in the same sense as `micro` and `pill`: §16a's footer row
+        // prints its id at 10.5 and its title at 12.5, its rank rows print titles
+        // at 13.5, and the rank figure itself is 14. §16b reuses `compact` for a
+        // node title and `meta` for a node id, which is why they are named for
+        // their ROLE rather than for a position in a scale — there is no scale
+        // here to be a position in.
+        '--ig-font-size-meta': '10.5px',
+        '--ig-font-size-compact': '12.5px',
+        '--ig-font-size-row': '13.5px',
+        '--ig-font-size-rank': '14px',
     }),
     metrics: Object.freeze({
         '--ig-space': 12,
@@ -153,13 +323,32 @@ export const defaultTheme = Object.freeze({
         // The `together-with` hairline connector, which is deliberately finer than
         // an ordinary edge so the enclosure stays the primary read.
         '--ig-stroke-connector': 1.6,
+        // §17d's ambient audit bar, which the design fixes at 2px in those words —
+        // heavier than an edge stroke because it has to be findable while the
+        // reader is scrolling past it doing something else, and no heavier because
+        // §17d's whole argument is attention without nagging.
+        //
+        // IT LIVES IN THIS THEME, NOT THE AUDIT'S. `editor/src/audit/styles.ts`
+        // records shipping an `--ig-audit-bar` of its own behind a second theme
+        // function and reversing it: a host that installed the viewer's theme and
+        // forgot the second got a `var()` resolving to nothing, and the bar
+        // silently stopped drawing. A token here has no such state — every host
+        // installs this theme — so the value stays retunable without the failure
+        // that reversal was paid for.
+        '--ig-stroke-audit': 2,
         // The terminal marker's own box. It is theme data rather than a constant
         // in the drawing code because it is a SIZE, and R5 admits no exceptions:
         // a host scaling the type up needs the arrowheads to follow.
         '--ig-terminal-length': 9,
         '--ig-terminal-width': 8,
-        '--ig-gutter-width': 208,
-        '--ig-spine-width': 360,
+        // §16b's own column widths: a 250px left gutter, a 330px spine card and a
+        // 270px right gutter, inside an 1180px panel. One gutter token serves both
+        // sides — the frame's 20px difference between them carries no stated
+        // meaning, and two tokens would ask a host to reproduce an asymmetry it
+        // cannot read a reason for. The sum lands the canvas at 1164, which is the
+        // frame's panel less its own border and scroll allowance.
+        '--ig-gutter-width': 260,
+        '--ig-spine-width': 330,
         // The advance width of one character at `--ig-font-size` in the mono face.
         // Layout measures text with it, so a host changing the type scale changes
         // this too and the boxes stay around their contents.
@@ -171,13 +360,76 @@ export const defaultTheme = Object.freeze({
         // title overflow its node: 24 all-capital characters "fitted" 187.2px of
         // room and drew about 240px, straight across the routing channel.
         //
-        // AN AVERAGE, because `fitLabel` scales it per character class rather than
+        // AN AVERAGE, because `labelWidth` scales it per character class rather than
         // assuming every glyph is the same width — see `labelWidth` there. A flat
         // CEILING was tried and is wrong in the other direction: at the widest
         // glyph's advance, ordinary titles truncate at roughly half their length,
         // which this package's own fixtures caught immediately.
         '--ig-label-char-width': 6,
         '--ig-focus-ring': 2,
+        // Read off §16a: 2px between a row title and its metadata, 8px between the
+        // row's blocks, 16px and 20px for the panel's own inset
+        // (`padding: 16px 20px`). 6px and 12px are the two that already shipped
+        // and did not move.
+        '--ig-space-micro': 2,
+        '--ig-space-snug': 8,
+        '--ig-space-loose': 16,
+        '--ig-space-wide': 20,
+        // §16a's micro badge is 4px and its outer panel 14px. The existing 6px
+        // sits between them and is the chip's, so neither end could be drawn.
+        '--ig-radius-small': 4,
+        '--ig-radius-large': 14,
+        // The FLOOR, matching today's fixed height so a row that grows starts from
+        // exactly where a rail row sits now; the same number carries a different
+        // meaning, which is why it is a different token rather than a reuse.
+        '--ig-row-min-height': 44,
+        // §16a's rank row is `padding: 13px 20px`. The block half is what a
+        // content-sized row grows against; the inline half is `--ig-space-wide`.
+        '--ig-row-padding-block': 13,
+        // §16a's WORKING NOW band, `box-shadow: inset 3px 0 0 var(--cyan)`.
+        '--ig-band-rail': 3,
+        // §16a's rank track, read straight off `grid-template-columns: 34px 1fr`.
+        '--ig-rank-column': 34,
+        // §16b's station disc, 26px across on the spine.
+        '--ig-station-box': 26,
+        // One line of text inside a §16b node card, which is what lets the layout
+        // give a card a height WITHOUT measuring one. A card's contents are known
+        // — a title that may wrap, an identity, a badge row — so its height is a
+        // count of lines times this. Chosen as a CEILING on the compact size times
+        // the line height (12.5 x 1.45 = 18.1), for the reason `measureLabel` gives
+        // about its own metric: a card that reserves slightly too much leaves a
+        // gap, and one that reserves too little overlaps the row beneath it.
+        '--ig-card-line': 18,
+    }),
+    effects: Object.freeze({
+        // ONE PAIR FOR ALL FIVE RELATIONSHIP CHIPS, at the value §16a draws most
+        // often: the fills across its chips are `.08 .08 .08 .09 .09 .10` and the
+        // borders `.28 .28 .30 .30 .30 .30 .30 .35 .35 .35`, so the mode is 8% and
+        // 30%. Five hues at five alphas would be a palette rather than a
+        // treatment, and the chips that draw hotter are the ACCENT ones — a host
+        // wanting that emphasis raises the pair rather than being given it by
+        // default on a blocked-by.
+        '--ig-tint-fill': '8%',
+        '--ig-tint-border': '30%',
+        // §16a's WORKING NOW band, `background: rgba(23,188,238,.05)`.
+        '--ig-tint-wash': '5%',
+        // §16a's rank-2 row, `background: rgba(23,188,238,.03)` — the ONE row that
+        // carries a fill, and it carries it because it is the `together-with`
+        // compound station. The other four rank rows have no background: this is
+        // not a zebra stripe and drawing it as one would invent a treatment §16
+        // does not have.
+        '--ig-tint-unit': '3%',
+        // The kit's own two drop shadows, verbatim: the floating toast, and the
+        // device frame the comps are mounted in. See EFFECT_TOKENS on why they are
+        // here rather than read from a §16 frame.
+        //
+        // DELIBERATELY LITERAL rather than mixed against `--ig-bg`. A shadow is
+        // dark on a light ground as well as a dark one, so expressing it against
+        // the background would turn it white on the documented paper theme and
+        // delete it. These two are the only values in this group that carry a
+        // colour, and a host retheming to a light palette owns them.
+        '--ig-elevation-raised': '0 16px 40px -16px rgba(0, 0, 0, 0.9)',
+        '--ig-elevation-overlay': '0 30px 80px -40px rgba(0, 0, 0, 0.8)',
     }),
 });
 /**
@@ -192,6 +444,7 @@ export function extendTheme(base, override) {
         colors: Object.freeze({ ...base.colors, ...override.colors }),
         type: Object.freeze({ ...base.type, ...override.type }),
         metrics: Object.freeze({ ...base.metrics, ...override.metrics }),
+        effects: Object.freeze({ ...base.effects, ...override.effects }),
     });
 }
 /**
@@ -202,10 +455,9 @@ export function extendTheme(base, override) {
  * package and stored. Adding a token then puts a hole in it, and the hole does
  * not fail loudly: a missing metric reads `undefined`, arithmetic on it yields
  * `NaN`, and every comparison against `NaN` is false. Measured when
- * `--ig-label-char-width` was added — a 0.1.0 theme made `fitLabel` return a
- * 60-character title with an ellipsis APPENDED, which is worse overflow than
- * the defect that token was added to fix, and `themeCss` emitted
- * `undefinedpx`.
+ * `--ig-label-char-width` was added — a 0.1.0 theme made every measured width
+ * `NaN`, so a card's height came out `NaN` and every station stacked at the
+ * same y, and `themeCss` emitted `undefinedpx`.
  *
  * A TypeScript caller is told about a new token by the compiler; a JavaScript
  * one is not, and neither is a theme deserialized from storage. This is the
@@ -220,9 +472,9 @@ export function resolveTheme(theme) {
 /**
  * Render a theme as one CSS rule of custom properties.
  *
- * Values are emitted verbatim for colours and type — a theme's author owns
- * their spelling — and metrics gain a `px` unit here, which is the single place
- * the numbers become CSS.
+ * Values are emitted verbatim for colours, type and effects — a theme's author
+ * owns their spelling — and metrics gain a `px` unit here, which is the single
+ * place the numbers become CSS.
  */
 export function themeCss(theme, selector = ':root') {
     // RESOLVED HERE TOO: this is an exported entry point taking a caller's theme
@@ -236,6 +488,8 @@ export function themeCss(theme, selector = ':root') {
         lines.push(`  ${token}: ${filled.type[token]};`);
     for (const token of METRIC_TOKENS)
         lines.push(`  ${token}: ${String(filled.metrics[token])}px;`);
+    for (const token of EFFECT_TOKENS)
+        lines.push(`  ${token}: ${filled.effects[token]};`);
     return `${selector} {\n${lines.join('\n')}\n}\n`;
 }
 //# sourceMappingURL=theme.js.map

package/dist/theme.js.map

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

package/dist/vocabulary.d.ts

@@ -27,6 +27,20 @@ export interface EdgeTreatment {
     readonly hueToken: string;
     /** Announced to a screen reader, and used as the badge's accessible name. */
     readonly label: string;
+    /**
+     * The same relationship read from the OTHER end.
+     *
+     * A directed edge states one fact, and which end you stand at decides the
+     * verb: #488 is what #512 is blocked by, and #512 is what #488 BLOCKS. The
+     * badge that shipped said "blocked by #512 (incoming)" on #488's row —
+     * technically true, and it asks a reader to invert a sentence in their head
+     * on the row where the plain reading was available. §16a draws the plain
+     * reading, so the vocabulary carries it.
+     *
+     * A symmetric edge reads the same both ways and carries none: `undefined`
+     * here is what says so, rather than a duplicate of {@link label}.
+     */
+    readonly reverseLabel?: string;
     readonly ordering: OrderingEffect;
     /**
      * Whether the edge reads the same both ways. A symmetric edge is drawn once
@@ -47,6 +61,7 @@ export declare const EDGE_TREATMENTS: Readonly<{
         readonly glyph: "⊘";
         readonly hueToken: "--ig-edge-blocked-by";
         readonly label: "blocked by";
+        readonly reverseLabel: "blocks";
         readonly ordering: "strict-directed";
         readonly symmetric: false;
     };
@@ -74,6 +89,7 @@ export declare const EDGE_TREATMENTS: Readonly<{
         readonly glyph: "≡";
         readonly hueToken: "--ig-edge-duplicate-of";
         readonly label: "duplicate of";
+        readonly reverseLabel: "duplicated by";
         readonly ordering: "never-worked";
         readonly symmetric: false;
     };
@@ -83,12 +99,35 @@ export declare const EDGE_TREATMENTS: Readonly<{
         readonly glyph: "⑃";
         readonly hueToken: "--ig-edge-decomposed-from";
         readonly label: "decomposed from";
+        readonly reverseLabel: "decomposed into";
         readonly ordering: "provenance-only";
         readonly symmetric: false;
     };
 }>;
 /** The treatment for a relationship. Total over the format's fields. */
 export declare function treatmentFor(field: EdgeField): EdgeTreatment;
+/**
+ * A relationship's word, read from the end the reader is standing at.
+ *
+ * THE VERB CHANGES, NOT THE NOUN. Read from the far end an asymmetric edge has
+ * its own plain wording and the vocabulary carries it, so a surface never has
+ * to say "(incoming)" and leave the reader to invert a sentence in their head.
+ *
+ * IT IS A FUNCTION HERE RATHER THAN A TEST AT EACH CALL SITE, and that is the
+ * whole reason it exists: the badge row in `parts.ts` and §17a's inspector row
+ * in `@issuegraph/editor` draw the SAME edge one zone apart on one screen, and
+ * two copies of this expression would be free to disagree the moment either was
+ * edited. They were, briefly, and a comment at one of them claimed to be "layer
+ * 1's own expression" while being a second copy of it — which is the failure
+ * this package names everywhere else: not a wrong answer, a second answer.
+ *
+ * A symmetric kind takes {@link EdgeTreatment.label} at either end, because
+ * `serialize-with` and `together-with` state one fact whichever way round they
+ * are stored; `reverseLabel` is `undefined` on them for that reason rather than
+ * by omission. The `??` is not a second answer to that question — it is what
+ * the optional field's type requires, and it lands on the same string.
+ */
+export declare function labelFrom(treatment: EdgeTreatment, outgoing: boolean): string;
 /**
  * The dash patterns, as SVG `stroke-dasharray` values keyed by dash name.
  *

package/dist/vocabulary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE/D,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9E,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,KAAK,CAAC;AAEpF,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,GACb,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8C0B,CAAC;AAEvD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAE5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAY1D;AAED,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAgB,CAAC"}
+{"version":3,"file":"vocabulary.d.ts","sourceRoot":"","sources":["../src/vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE/D,kFAAkF;AAClF,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9E,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,GAAG,eAAe,GAAG,KAAK,CAAC;AAEpF,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GACtB,iBAAiB,GACjB,qBAAqB,GACrB,aAAa,GACb,cAAc,GACd,iBAAiB,CAAC;AAEtB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiD0B,CAAC;AAEvD,wEAAwE;AACxE,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa,CAE5D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE7E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI,CAY1D;AAED,0FAA0F;AAC1F,eAAO,MAAM,UAAU,EAAE,SAAS,SAAS,EAAgB,CAAC"}

package/dist/vocabulary.js

@@ -24,6 +24,7 @@ export const EDGE_TREATMENTS = Object.freeze({
         glyph: '⊘',
         hueToken: '--ig-edge-blocked-by',
         label: 'blocked by',
+        reverseLabel: 'blocks',
         ordering: 'strict-directed',
         symmetric: false,
     },
@@ -51,6 +52,7 @@ export const EDGE_TREATMENTS = Object.freeze({
         glyph: '≡',
         hueToken: '--ig-edge-duplicate-of',
         label: 'duplicate of',
+        reverseLabel: 'duplicated by',
         ordering: 'never-worked',
         symmetric: false,
     },
@@ -60,6 +62,7 @@ export const EDGE_TREATMENTS = Object.freeze({
         glyph: '⑃',
         hueToken: '--ig-edge-decomposed-from',
         label: 'decomposed from',
+        reverseLabel: 'decomposed into',
         ordering: 'provenance-only',
         symmetric: false,
     },
@@ -68,6 +71,30 @@ export const EDGE_TREATMENTS = Object.freeze({
 export function treatmentFor(field) {
     return EDGE_TREATMENTS[field];
 }
+/**
+ * A relationship's word, read from the end the reader is standing at.
+ *
+ * THE VERB CHANGES, NOT THE NOUN. Read from the far end an asymmetric edge has
+ * its own plain wording and the vocabulary carries it, so a surface never has
+ * to say "(incoming)" and leave the reader to invert a sentence in their head.
+ *
+ * IT IS A FUNCTION HERE RATHER THAN A TEST AT EACH CALL SITE, and that is the
+ * whole reason it exists: the badge row in `parts.ts` and §17a's inspector row
+ * in `@issuegraph/editor` draw the SAME edge one zone apart on one screen, and
+ * two copies of this expression would be free to disagree the moment either was
+ * edited. They were, briefly, and a comment at one of them claimed to be "layer
+ * 1's own expression" while being a second copy of it — which is the failure
+ * this package names everywhere else: not a wrong answer, a second answer.
+ *
+ * A symmetric kind takes {@link EdgeTreatment.label} at either end, because
+ * `serialize-with` and `together-with` state one fact whichever way round they
+ * are stored; `reverseLabel` is `undefined` on them for that reason rather than
+ * by omission. The `??` is not a second answer to that question — it is what
+ * the optional field's type requires, and it lands on the same string.
+ */
+export function labelFrom(treatment, outgoing) {
+    return outgoing || treatment.symmetric ? treatment.label : (treatment.reverseLabel ?? treatment.label);
+}
 /**
  * The dash patterns, as SVG `stroke-dasharray` values keyed by dash name.
  *