@populationgenomics/gene-glyph 0.0.0-stage → 1.1.0

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 (154) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +58 -2
  3. package/dist/adapters/clinvar.d.ts +34 -0
  4. package/dist/adapters/clinvar.d.ts.map +1 -0
  5. package/dist/adapters/clinvar.test.d.ts +2 -0
  6. package/dist/adapters/clinvar.test.d.ts.map +1 -0
  7. package/dist/adapters/rmc.d.ts +31 -0
  8. package/dist/adapters/rmc.d.ts.map +1 -0
  9. package/dist/adapters/rmc.test.d.ts +2 -0
  10. package/dist/adapters/rmc.test.d.ts.map +1 -0
  11. package/dist/chrome/default-minimap.d.ts +26 -0
  12. package/dist/chrome/default-minimap.d.ts.map +1 -0
  13. package/dist/chrome/default-minimap.test.d.ts +2 -0
  14. package/dist/chrome/default-minimap.test.d.ts.map +1 -0
  15. package/dist/chrome/default-track-chevron.d.ts +37 -0
  16. package/dist/chrome/default-track-chevron.d.ts.map +1 -0
  17. package/dist/chrome/default-track-chevron.test.d.ts +2 -0
  18. package/dist/chrome/default-track-chevron.test.d.ts.map +1 -0
  19. package/dist/coordinate-mapper.d.ts +13 -0
  20. package/dist/coordinate-mapper.d.ts.map +1 -0
  21. package/dist/coordinate-mapper.test.d.ts +2 -0
  22. package/dist/coordinate-mapper.test.d.ts.map +1 -0
  23. package/dist/data-source.d.ts +24 -0
  24. package/dist/data-source.d.ts.map +1 -0
  25. package/dist/data-source.test.d.ts +2 -0
  26. package/dist/data-source.test.d.ts.map +1 -0
  27. package/dist/debug-leash.d.ts +73 -0
  28. package/dist/debug-leash.d.ts.map +1 -0
  29. package/dist/export.d.ts +69 -0
  30. package/dist/export.d.ts.map +1 -0
  31. package/dist/export.test.d.ts +2 -0
  32. package/dist/export.test.d.ts.map +1 -0
  33. package/dist/feature-id-hash.d.ts +26 -0
  34. package/dist/feature-id-hash.d.ts.map +1 -0
  35. package/dist/feature-id-hash.test.d.ts +2 -0
  36. package/dist/feature-id-hash.test.d.ts.map +1 -0
  37. package/dist/figure-scale.d.ts +145 -0
  38. package/dist/figure-scale.d.ts.map +1 -0
  39. package/dist/figure-scale.test.d.ts +2 -0
  40. package/dist/figure-scale.test.d.ts.map +1 -0
  41. package/dist/gutter.test.d.ts +2 -0
  42. package/dist/gutter.test.d.ts.map +1 -0
  43. package/dist/index.d.ts +62 -0
  44. package/dist/index.d.ts.map +1 -0
  45. package/dist/index.js +7910 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/layout-engine.d.ts +52 -0
  48. package/dist/layout-engine.d.ts.map +1 -0
  49. package/dist/layout-engine.test.d.ts +2 -0
  50. package/dist/layout-engine.test.d.ts.map +1 -0
  51. package/dist/pack-lanes.d.ts +27 -0
  52. package/dist/pack-lanes.d.ts.map +1 -0
  53. package/dist/pack-lanes.test.d.ts +2 -0
  54. package/dist/pack-lanes.test.d.ts.map +1 -0
  55. package/dist/painter/index.d.ts +4 -0
  56. package/dist/painter/index.d.ts.map +1 -0
  57. package/dist/painter/svg-painter.d.ts +6 -0
  58. package/dist/painter/svg-painter.d.ts.map +1 -0
  59. package/dist/painter/svg-painter.test.d.ts +2 -0
  60. package/dist/painter/svg-painter.test.d.ts.map +1 -0
  61. package/dist/projection-frame.d.ts +92 -0
  62. package/dist/projection-frame.d.ts.map +1 -0
  63. package/dist/projection-frame.test.d.ts +2 -0
  64. package/dist/projection-frame.test.d.ts.map +1 -0
  65. package/dist/segments.d.ts +86 -0
  66. package/dist/segments.d.ts.map +1 -0
  67. package/dist/slots.test.d.ts +2 -0
  68. package/dist/slots.test.d.ts.map +1 -0
  69. package/dist/styles.css +1127 -0
  70. package/dist/symbol-encoding.d.ts +103 -0
  71. package/dist/symbol-encoding.d.ts.map +1 -0
  72. package/dist/symbol-encoding.test.d.ts +2 -0
  73. package/dist/symbol-encoding.test.d.ts.map +1 -0
  74. package/dist/test-setup.d.ts +2 -0
  75. package/dist/test-setup.d.ts.map +1 -0
  76. package/dist/tracks/aa-track.d.ts +67 -0
  77. package/dist/tracks/aa-track.d.ts.map +1 -0
  78. package/dist/tracks/aa-track.test.d.ts +2 -0
  79. package/dist/tracks/aa-track.test.d.ts.map +1 -0
  80. package/dist/tracks/clinvar-summary-track.d.ts +29 -0
  81. package/dist/tracks/clinvar-summary-track.d.ts.map +1 -0
  82. package/dist/tracks/clinvar-summary-track.test.d.ts +2 -0
  83. package/dist/tracks/clinvar-summary-track.test.d.ts.map +1 -0
  84. package/dist/tracks/clinvar-track.d.ts +161 -0
  85. package/dist/tracks/clinvar-track.d.ts.map +1 -0
  86. package/dist/tracks/clinvar-track.test.d.ts +2 -0
  87. package/dist/tracks/clinvar-track.test.d.ts.map +1 -0
  88. package/dist/tracks/exon-track.d.ts +25 -0
  89. package/dist/tracks/exon-track.d.ts.map +1 -0
  90. package/dist/tracks/exon-track.test.d.ts +2 -0
  91. package/dist/tracks/exon-track.test.d.ts.map +1 -0
  92. package/dist/tracks/interpro-track.d.ts +69 -0
  93. package/dist/tracks/interpro-track.d.ts.map +1 -0
  94. package/dist/tracks/interpro-track.test.d.ts +2 -0
  95. package/dist/tracks/interpro-track.test.d.ts.map +1 -0
  96. package/dist/tracks/nucleotide-track.d.ts +84 -0
  97. package/dist/tracks/nucleotide-track.d.ts.map +1 -0
  98. package/dist/tracks/nucleotide-track.test.d.ts +2 -0
  99. package/dist/tracks/nucleotide-track.test.d.ts.map +1 -0
  100. package/dist/tracks/overview-track.d.ts +50 -0
  101. package/dist/tracks/overview-track.d.ts.map +1 -0
  102. package/dist/tracks/overview-track.test.d.ts +2 -0
  103. package/dist/tracks/overview-track.test.d.ts.map +1 -0
  104. package/dist/tracks/parse-user-variants.d.ts +55 -0
  105. package/dist/tracks/parse-user-variants.d.ts.map +1 -0
  106. package/dist/tracks/parse-user-variants.test.d.ts +2 -0
  107. package/dist/tracks/parse-user-variants.test.d.ts.map +1 -0
  108. package/dist/tracks/pfam-track.d.ts +33 -0
  109. package/dist/tracks/pfam-track.d.ts.map +1 -0
  110. package/dist/tracks/pfam-track.test.d.ts +2 -0
  111. package/dist/tracks/pfam-track.test.d.ts.map +1 -0
  112. package/dist/tracks/profile-track.d.ts +133 -0
  113. package/dist/tracks/profile-track.d.ts.map +1 -0
  114. package/dist/tracks/profile-track.test.d.ts +2 -0
  115. package/dist/tracks/profile-track.test.d.ts.map +1 -0
  116. package/dist/tracks/scale-track.d.ts +70 -0
  117. package/dist/tracks/scale-track.d.ts.map +1 -0
  118. package/dist/tracks/scale-track.test.d.ts +2 -0
  119. package/dist/tracks/scale-track.test.d.ts.map +1 -0
  120. package/dist/tracks/segment-band-track.d.ts +86 -0
  121. package/dist/tracks/segment-band-track.d.ts.map +1 -0
  122. package/dist/tracks/segment-band-track.test.d.ts +2 -0
  123. package/dist/tracks/segment-band-track.test.d.ts.map +1 -0
  124. package/dist/tracks/user-variant-track.d.ts +50 -0
  125. package/dist/tracks/user-variant-track.d.ts.map +1 -0
  126. package/dist/tracks/user-variant-track.test.d.ts +2 -0
  127. package/dist/tracks/user-variant-track.test.d.ts.map +1 -0
  128. package/dist/tracks/variant-summary-track.d.ts +24 -0
  129. package/dist/tracks/variant-summary-track.d.ts.map +1 -0
  130. package/dist/tracks/variant-summary-track.test.d.ts +2 -0
  131. package/dist/tracks/variant-summary-track.test.d.ts.map +1 -0
  132. package/dist/tracks/variant-track.d.ts +89 -0
  133. package/dist/tracks/variant-track.d.ts.map +1 -0
  134. package/dist/tracks/variant-track.test.d.ts +2 -0
  135. package/dist/tracks/variant-track.test.d.ts.map +1 -0
  136. package/dist/types.d.ts +671 -0
  137. package/dist/types.d.ts.map +1 -0
  138. package/dist/use-viewport-interactions.d.ts +49 -0
  139. package/dist/use-viewport-interactions.d.ts.map +1 -0
  140. package/dist/viewer-interactions.test.d.ts +2 -0
  141. package/dist/viewer-interactions.test.d.ts.map +1 -0
  142. package/dist/viewer-overlay.test.d.ts +2 -0
  143. package/dist/viewer-overlay.test.d.ts.map +1 -0
  144. package/dist/viewer-selection-range.test.d.ts +2 -0
  145. package/dist/viewer-selection-range.test.d.ts.map +1 -0
  146. package/dist/viewer.d.ts +319 -0
  147. package/dist/viewer.d.ts.map +1 -0
  148. package/dist/viewer.test.d.ts +2 -0
  149. package/dist/viewer.test.d.ts.map +1 -0
  150. package/dist/viewport.d.ts +352 -0
  151. package/dist/viewport.d.ts.map +1 -0
  152. package/dist/viewport.test.d.ts +2 -0
  153. package/dist/viewport.test.d.ts.map +1 -0
  154. package/package.json +65 -4
@@ -0,0 +1,52 @@
1
+ import { type TrackOrGroup, type TrackRect, type Viewport } from './types.js';
2
+ export interface LayoutItem {
3
+ kind: 'track' | 'group';
4
+ id: string;
5
+ /** Label, set from `TrackGroup.label` for groups and from `Track.label`
6
+ * for tracks (optional on tracks). Surfaced via gutter slots so hosts
7
+ * can render group + sub-track labels (e.g. multi-level InterPro
8
+ * nesting) without re-walking the input track list. */
9
+ label?: string;
10
+ rect: TrackRect;
11
+ didTruncate: boolean;
12
+ droppedCount: number;
13
+ /** Group members, populated when `kind === 'group'`. Recursive — a
14
+ * group's children may themselves be groups (RD-1110 follow-up). */
15
+ children?: LayoutItem[];
16
+ /** For groups: vertical pixels reserved at the top of the group's
17
+ * extent for its label slot (mirrors {@link TrackGroup.headerHeight}).
18
+ * The gutter uses this to size the parent's chevron cell so it
19
+ * doesn't overlap the first child's cell. Undefined / 0 means flush
20
+ * layout (the parent's label shares the first child's row). */
21
+ headerHeight?: number;
22
+ }
23
+ export interface LayoutResult {
24
+ totalHeight: number;
25
+ items: LayoutItem[];
26
+ /** Flat lookup from track id -> rect, including tracks inside nested
27
+ * groups. */
28
+ trackRects: Map<string, TrackRect>;
29
+ }
30
+ export interface LayoutEngineArgs {
31
+ tracks: TrackOrGroup[];
32
+ viewport: Viewport;
33
+ data: Map<string, unknown>;
34
+ totalHeightBudget: number;
35
+ /** Top y-coordinate to lay the first track from. Defaults to 0. */
36
+ yStart?: number;
37
+ /** Group ids that should render as folded. When a folded group carries
38
+ * a {@link TrackGroup.summaryTrack} the engine lays out the summary
39
+ * track in its place; when it doesn't, the group contributes zero
40
+ * height (today's "remove rows" semantics). Consulted at every level
41
+ * of nesting, so a parent group can be expanded while one of its
42
+ * child groups is folded. */
43
+ collapsedGroupIds?: ReadonlySet<string>;
44
+ }
45
+ /**
46
+ * Negotiate vertical layout by walking items top-to-bottom and offering each
47
+ * the remaining height as `hint.maxPx`. Tracks return their actual height plus
48
+ * whether they truncated; groups recurse over their sub-entries (which may
49
+ * themselves be groups) within their own optionally-explicit `heightBudget`.
50
+ */
51
+ export declare function layoutTracks(args: LayoutEngineArgs): LayoutResult;
52
+ //# sourceMappingURL=layout-engine.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"layout-engine.d.ts","sourceRoot":"","sources":["../src/layout-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,QAAQ,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;;;4DAGwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB;yEACqE;IACrE,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB;;;;oEAIgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB;kBACc;IACd,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;kCAK8B;IAC9B,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACzC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAejE"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=layout-engine.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"layout-engine.test.d.ts","sourceRoot":"","sources":["../src/layout-engine.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Lane packing: assign each input interval to the lowest-index lane such that
3
+ * no two items in the same lane overlap. A small horizontal `gap` may be
4
+ * required between consecutive items in the same lane so labels don't crash.
5
+ *
6
+ * Used by any track that wants to lay out a flat list of intervals as a fixed
7
+ * number of stacked rows; InterPro is the first caller, but the API is kept
8
+ * generic so user-annotation, ClinVar-cluster, and brush-bound tracks can
9
+ * reuse it. Ported from lit-manager's `packLanes`.
10
+ */
11
+ export interface LaneInput<T> {
12
+ item: T;
13
+ xStart: number;
14
+ xEnd: number;
15
+ }
16
+ export interface PackedItem<T> {
17
+ item: T;
18
+ lane: number;
19
+ xStart: number;
20
+ xEnd: number;
21
+ }
22
+ export interface PackResult<T> {
23
+ items: PackedItem<T>[];
24
+ laneCount: number;
25
+ }
26
+ export declare function packLanes<T>(inputs: LaneInput<T>[], gap?: number): PackResult<T>;
27
+ //# sourceMappingURL=pack-lanes.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pack-lanes.d.ts","sourceRoot":"","sources":["../src/pack-lanes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,SAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAuB3E"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=pack-lanes.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pack-lanes.test.d.ts","sourceRoot":"","sources":["../src/pack-lanes.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,4 @@
1
+ export type { Painter, PainterMode, DrawRectArgs, DrawLineArgs, DrawTextArgs, DrawPathArgs, DrawCircleArgs, GroupArgs, } from '../types.js';
2
+ export { createSvgPainter } from './svg-painter.js';
3
+ export type { SvgPainterOptions } from './svg-painter.js';
4
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/painter/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { Painter, PainterMode } from '../types.js';
2
+ export interface SvgPainterOptions {
3
+ mode?: PainterMode;
4
+ }
5
+ export declare function createSvgPainter(options?: SvgPainterOptions): Painter;
6
+ //# sourceMappingURL=svg-painter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"svg-painter.d.ts","sourceRoot":"","sources":["../../src/painter/svg-painter.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAOV,OAAO,EACP,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,WAAW,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAuKzE"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=svg-painter.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"svg-painter.test.d.ts","sourceRoot":"","sources":["../../src/painter/svg-painter.test.tsx"],"names":[],"mappings":""}
@@ -0,0 +1,92 @@
1
+ import { type Segment } from './segments.js';
2
+ import type { BaselineGeometry, ViewMode } from './types.js';
3
+ /** Per-exon CDS bp bounds used by the frame for ruler ↔ baseline mapping in
4
+ * CDS modes. Protein-mode projection is linear in aa and doesn't consult
5
+ * these. */
6
+ export interface FrameExon {
7
+ readonly cdsStart: number;
8
+ readonly cdsEnd: number;
9
+ }
10
+ /** Per-render layout derived from `(baseline, zoomScale, displayOffset,
11
+ * width, mode)`. Each exon gets a current-frame screen-x and a shared
12
+ * `exonScale` applied to baseline widths. */
13
+ export interface ExonLayout {
14
+ readonly exonScale: number;
15
+ readonly exonCurrentX: readonly number[];
16
+ }
17
+ export interface ProjectionFrameInit {
18
+ baseline: BaselineGeometry;
19
+ /** Multiplier on flexible piece widths. Constant under pan, varies
20
+ * only with zoom. */
21
+ zoomScale: number;
22
+ /** Display-x of the first piece's left edge inside the viewport. The
23
+ * viewport `[0, width]` shows the slice `[displayOffset, displayOffset
24
+ * + width]` of the static layout. Pan adjusts this directly. */
25
+ displayOffset: number;
26
+ width: number;
27
+ mode: ViewMode;
28
+ /** CDS bp bounds for each baseline exon, indexed by `exonIdx`. */
29
+ exons: readonly FrameExon[];
30
+ }
31
+ /**
32
+ * Pure value object describing the projection from baseline-x onto live
33
+ * screen-x for one `(baseline, zoom, offset, width, mode)` tuple.
34
+ *
35
+ * The static layout is shared across pan: changing only `displayOffset`
36
+ * doesn't trigger any layout work. Ruler ↔ baseline-x is a per-segment
37
+ * walk; baseline-x ↔ screen-x is `figure-scale` + an offset.
38
+ */
39
+ export declare class ProjectionFrame {
40
+ readonly baseline: BaselineGeometry;
41
+ readonly zoomScale: number;
42
+ readonly displayOffset: number;
43
+ readonly width: number;
44
+ readonly mode: ViewMode;
45
+ private readonly _segments;
46
+ private readonly _pieces;
47
+ private _layout;
48
+ private _exonLayout;
49
+ constructor(init: ProjectionFrameInit);
50
+ /** Ruler → baseline screen-x. CDS bp in CDS modes, aa in protein mode.
51
+ * Per-segment linear interpolation between `(rulerStart, rulerEnd)`
52
+ * and `(xStart, xEnd)`. Extrapolates past the gene edges using
53
+ * `baseline.pxPerBp`. */
54
+ rulerToBaselineX(rulerPos: number): number;
55
+ /** Inverse of {@link rulerToBaselineX}. */
56
+ baselineXToRuler(S: number): number;
57
+ /** Baseline screen-x → live screen-x. Pure: layout(zoom) lookup plus
58
+ * an offset subtraction. */
59
+ baselineToCurrent(baselineX: number): number | null;
60
+ /** Inverse: live screen-x → baseline-x. */
61
+ currentToBaseline(currentX: number): number | null;
62
+ /** Local display-per-baseline-px derivative at the given current
63
+ * screen-x. Inside an exon (or flank) this equals `zoomScale`; inside
64
+ * a fixed-budget bulk it equals the bulk's reserved-display / baseline
65
+ * ratio (= 1 by construction for the default budget). At a zero-
66
+ * baseline-width breakpoint it's +Infinity. */
67
+ localScreenScaleAt(currentX: number): number;
68
+ /** Live screen-space zoom factor: `width / visibleBaselineSpan`.
69
+ * Derived from the layout; in genome mode with fixed-budget gaps in
70
+ * view it differs from `zoomScale` because part of the viewport is
71
+ * consumed by fixed pixels. */
72
+ zoomFactor(): number;
73
+ /** Per-render exon layout — `{exonScale, exonCurrentX[exonIdx]}`. */
74
+ exonLayout(): ExonLayout;
75
+ /** Live display-x of the start of the segment with the given index. */
76
+ segmentCurrentX(segmentIndex: number): number;
77
+ /** Live display width of the segment with the given index. */
78
+ segmentCurrentWidth(segmentIndex: number): number;
79
+ /** Segment array — accessible for callers that want to walk piece-by-
80
+ * piece (publish, intron decoration positioning). */
81
+ segments(): readonly Segment[];
82
+ /** Total display width of the figure at the current zoom — i.e., the
83
+ * width of the laid-out figure independent of the viewport. Useful for
84
+ * pan clamping (the figure can pan from `displayOffset = 0` down to
85
+ * `displayOffset = totalDisplayWidth - viewportWidth`). */
86
+ totalDisplayWidth(): number;
87
+ /** Fit-zoom scale: the `zoomScale` that would make the whole figure
88
+ * fit exactly in `width` display pixels. Cached per layout. */
89
+ fitZoomScale(): number;
90
+ private figureLayout;
91
+ }
92
+ //# sourceMappingURL=projection-frame.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projection-frame.d.ts","sourceRoot":"","sources":["../src/projection-frame.ts"],"names":[],"mappings":"AASA,OAAO,EAAiC,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE7D;;aAEa;AACb,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;8CAE8C;AAC9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B;0BACsB;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB;;qEAEiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAA2B;gBAElC,IAAI,EAAE,mBAAmB;IAUrC;;;8BAG0B;IAC1B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAqB1C,2CAA2C;IAC3C,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM;IAkBnC;iCAC6B;IAC7B,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKnD,2CAA2C;IAC3C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKlD;;;;oDAIgD;IAChD,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAK5C;;;oCAGgC;IAChC,UAAU,IAAI,MAAM;IASpB,qEAAqE;IACrE,UAAU,IAAI,UAAU;IAexB,uEAAuE;IACvE,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAI7C,8DAA8D;IAC9D,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAKjD;0DACsD;IACtD,QAAQ,IAAI,SAAS,OAAO,EAAE;IAI9B;;;gEAG4D;IAC5D,iBAAiB,IAAI,MAAM;IAI3B;oEACgE;IAChE,YAAY,IAAI,MAAM;IAItB,OAAO,CAAC,YAAY;CAKrB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=projection-frame.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projection-frame.test.d.ts","sourceRoot":"","sources":["../src/projection-frame.test.ts"],"names":[],"mappings":""}
@@ -0,0 +1,86 @@
1
+ import type { BaselineGeometry, ViewMode, Viewport, RangeSegment } from './types.js';
2
+ import type { Piece } from './figure-scale.js';
3
+ import type { FrameExon } from './projection-frame.js';
4
+ /** Display behaviour of a segment under live zoom.
5
+ *
6
+ * - **`linear`** (mapped to FigureScale `flexible`): the segment's screen
7
+ * width scales with the live zoom factor. Exon bodies in every mode
8
+ * use this; intron flanks (splice-site preservation pieces) too.
9
+ * - **`fixed-budget`** (mapped to FigureScale `fixed`): the segment's
10
+ * screen width stays constant under zoom. The inter-exon gap bulk in
11
+ * `genome` is fixed-budget so Pfam / InterPro segments in adjacent
12
+ * exons stay visually close at deep zoom.
13
+ */
14
+ export type SegmentScaleRule = 'linear' | 'fixed-budget';
15
+ /** One linear or fixed display segment, ordered 5'→3' across the figure.
16
+ *
17
+ * Each segment owns:
18
+ * - a baseline-x interval `[xStart, xEnd]` (fit-gene screen pixels) —
19
+ * this doubles as the segment's figure-x interval for the live
20
+ * FigureScale layout;
21
+ * - a ruler interval `[rulerStart, rulerEnd]` in the active mode's
22
+ * coords (CDS bp in CDS modes, aa in protein mode);
23
+ * - a {@link SegmentScaleRule} that controls how the screen width
24
+ * behaves under live zoom.
25
+ *
26
+ * Phase 3 splice-site flanks are first-class segments here — the
27
+ * legacy "flank widths embedded inside an intron-collapsed segment"
28
+ * encoding is gone. An intron with flanks emits three segments in
29
+ * order: `flank-donor` (linear), `intron-bulk` (fixed), `flank-acceptor`
30
+ * (linear). An intron without flanks emits a single `intron-bulk`. */
31
+ export interface Segment {
32
+ /** Position in the segment array. Stable for the lifetime of the
33
+ * baseline; the layout math indexes by this. */
34
+ index: number;
35
+ /** Segment kind. `exon` is an exon body. `intron-bulk` is the
36
+ * bulk-collapsed portion of an intron (the intron-decoration target).
37
+ * `flank-donor` / `flank-acceptor` are linear-scale intronic pieces
38
+ * adjacent to the upstream / downstream exon edges (splice-site
39
+ * preservation). */
40
+ kind: 'exon' | 'intron-bulk' | 'flank-donor' | 'flank-acceptor';
41
+ /** For exon segments, the exon's index in the transcript. For intron
42
+ * / flank segments, undefined. */
43
+ exonIdx?: number;
44
+ /** For intron-bulk and flank segments, the bracketing exon indices. */
45
+ exonIdxA?: number;
46
+ exonIdxB?: number;
47
+ /** Ruler endpoints in active-mode units. Exon segments cover their
48
+ * exonic CDS bp range (CDS modes) or their aa range (protein). Intron
49
+ * / flank segments share a "fictitious ruler" linearly interpolated
50
+ * from the upstream exon's ruler end to the downstream exon's ruler
51
+ * start, sliced proportionally to each piece's baseline width.
52
+ * Powers ruler ↔ baseline-x continuity through the gap. */
53
+ rulerStart: number;
54
+ rulerEnd: number;
55
+ /** Baseline (fit-gene) screen-x interval — also the segment's figure-x
56
+ * interval as far as the live FigureScale layout is concerned. */
57
+ xStart: number;
58
+ xEnd: number;
59
+ width: number;
60
+ scaleRule: SegmentScaleRule;
61
+ }
62
+ /** Project a {@link Segment} onto a FigureScale {@link Piece}: figure-x
63
+ * is the segment's baseline-x interval, the scale rule translates
64
+ * flexible/fixed, and fixed pieces declare their full baseline width as
65
+ * their reserved display budget. */
66
+ export declare function segmentToPiece(seg: Segment): Piece;
67
+ /** Derive the segment array for a precomputed baseline. Today's baseline
68
+ * carries `exons[]` and `gaps[]` separately; this folds them into a
69
+ * single ordered sequence with explicit scale rules. The frame's math
70
+ * works uniformly over the result regardless of mode.
71
+ *
72
+ * `mode` decides how ruler endpoints are sourced:
73
+ * - CDS modes: rulerStart/rulerEnd come from `FrameExon.cdsStart/cdsEnd`
74
+ * for exon segments; for intron / flank segments they're interpolated
75
+ * between the bracketing exons' ruler bounds.
76
+ * - protein: rulerStart/rulerEnd are derived from each exon's
77
+ * `xStart / pxPerBp + 1` (aa equivalent). */
78
+ export declare function buildSegments(baseline: BaselineGeometry, exons: readonly FrameExon[], mode: ViewMode): Segment[];
79
+ export interface ProjectedBounds {
80
+ xStart: number;
81
+ xEnd: number;
82
+ xMid: number;
83
+ segments: RangeSegment[];
84
+ }
85
+ export declare function projectProteinRangeBounds(viewport: Viewport, aaStart: number, aaEnd: number): ProjectedBounds | null;
86
+ //# sourceMappingURL=segments.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../src/segments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;uEAeuE;AACvE,MAAM,WAAW,OAAO;IACtB;qDACiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd;;;;yBAIqB;IACrB,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,aAAa,GAAG,gBAAgB,CAAC;IAChE;uCACmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;gEAK4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB;uEACmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED;;;qCAGqC;AACrC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAclD;AAED;;;;;;;;;;gDAUgD;AAChD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,IAAI,EAAE,QAAQ,GACb,OAAO,EAAE,CA8HX;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,eAAe,GAAG,IAAI,CAexB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=slots.test.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"slots.test.d.ts","sourceRoot":"","sources":["../src/slots.test.tsx"],"names":[],"mappings":""}