semiotic 3.10.0 → 3.10.1

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 (191) hide show
  1. package/README.md +55 -59
  2. package/ai/artifact-surface-inventory.json +1 -1
  3. package/ai/componentMetadata.cjs +3 -1
  4. package/ai/dist/mcp-server.js +45 -45
  5. package/ai/examples.md +67 -0
  6. package/ai/reference.md +75 -1
  7. package/ai/schema.json +5199 -1
  8. package/ai/surface-manifest.json +24 -3
  9. package/ai/task-packets/compare-category-totals.json +6 -6
  10. package/ai/task-packets/compare-category-totals.md +3 -3
  11. package/ai/task-packets/correct-published-chart.json +6 -6
  12. package/ai/task-packets/correct-published-chart.md +3 -3
  13. package/ai/task-packets/index.json +6 -6
  14. package/ai/task-packets/update-live-chart.json +6 -6
  15. package/ai/task-packets/update-live-chart.md +3 -3
  16. package/dist/c-2RL2QPZJ.min.js +1 -0
  17. package/dist/c-45CQWZZ6.min.js +1 -0
  18. package/dist/{c-PP6VY3QU.min.js → c-4BRHKVKV.min.js} +1 -1
  19. package/dist/c-7DVPSB5C.min.js +1 -0
  20. package/dist/{c-XDQKXPX4.min.js → c-A7OGOFSL.min.js} +1 -1
  21. package/dist/{c-AZKPVBOC.min.js → c-AH5HWZWS.min.js} +1 -1
  22. package/dist/c-B7GW7IHJ.min.js +1 -0
  23. package/dist/{c-ROEHCIGV.min.js → c-C3TZLTZK.min.js} +1 -1
  24. package/dist/c-CGQAQWBV.min.js +1 -0
  25. package/dist/c-DIPEYUOW.min.js +1 -0
  26. package/dist/{c-WNGH47HF.min.js → c-E72OTUZU.min.js} +1 -1
  27. package/dist/{c-DY2676CR.min.js → c-EUMPMDCS.min.js} +1 -1
  28. package/dist/c-EZZT2WAE.min.js +1 -0
  29. package/dist/c-FHBVFCQB.min.js +1 -0
  30. package/dist/{c-E32M6XW5.min.js → c-G4HCO2IQ.min.js} +1 -1
  31. package/dist/{c-ZYPXQF7B.min.js → c-G5VIJEOK.min.js} +1 -1
  32. package/dist/c-GHVOXAYH.min.js +1 -0
  33. package/dist/{c-EBOQ7ER7.min.js → c-HP4ZFM47.min.js} +1 -1
  34. package/dist/{c-IDJV3CZK.min.js → c-HYDTS5OP.min.js} +1 -1
  35. package/dist/c-IK33LNZ6.min.js +1 -0
  36. package/dist/c-IK3PZHRY.min.js +1 -0
  37. package/dist/{c-JO2UGTCP.min.js → c-J6DVC236.min.js} +1 -1
  38. package/dist/{c-MXCP7GNZ.min.js → c-JIMJF6F6.min.js} +1 -1
  39. package/dist/{c-4FN7Q6VQ.min.js → c-KKPMHAZC.min.js} +1 -1
  40. package/dist/c-L6WNDBHV.min.js +1 -0
  41. package/dist/c-LDEX5OFW.min.js +1 -0
  42. package/dist/{c-CPSPZH6A.min.js → c-LESEUVC5.min.js} +1 -1
  43. package/dist/c-MB6CV5NC.min.js +1 -0
  44. package/dist/{c-OO5QLMJC.min.js → c-MOKJOIPE.min.js} +1 -1
  45. package/dist/{c-BNG5ECK5.min.js → c-N3FXLRNT.min.js} +1 -1
  46. package/dist/c-N5NPTJVJ.min.js +1 -0
  47. package/dist/{c-DE5Q3U2X.min.js → c-NHBL4J67.min.js} +1 -1
  48. package/dist/{c-LMGSSD2E.min.js → c-ODG6TFSY.min.js} +1 -1
  49. package/dist/{c-HXDKPIKR.min.js → c-PSKKFZNP.min.js} +1 -1
  50. package/dist/{c-NYZ2QNAM.min.js → c-R2P4RR7Q.min.js} +1 -1
  51. package/dist/{c-KCRJGUHP.min.js → c-RFC7UAG7.min.js} +1 -1
  52. package/dist/c-SGAURYHG.min.js +1 -0
  53. package/dist/{c-DK662R77.min.js → c-SJMWU6UX.min.js} +1 -1
  54. package/dist/c-STIIGQOD.min.js +1 -0
  55. package/dist/c-T2ASIJVZ.min.js +1 -0
  56. package/dist/c-TX3THUTO.min.js +1 -0
  57. package/dist/{c-55BAJ333.min.js → c-TX7XJM3Z.min.js} +1 -1
  58. package/dist/c-UMXSJIOV.min.js +1 -0
  59. package/dist/{c-JLGRHXGZ.min.js → c-VRSXMLYF.min.js} +1 -1
  60. package/dist/c-VSLWSAN2.min.js +1 -0
  61. package/dist/{c-33QOXEUG.min.js → c-WCBRPILW.min.js} +1 -1
  62. package/dist/{c-WH2O53VI.min.js → c-WGHT7OCY.min.js} +1 -1
  63. package/dist/c-WWCW3APR.min.js +1 -0
  64. package/dist/c-Y6PYUMFU.min.js +1 -0
  65. package/dist/c-ZIVPFTOC.min.js +1 -0
  66. package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
  67. package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
  68. package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
  69. package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
  70. package/dist/components/charts/shared/hooks.d.ts +3 -1
  71. package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
  72. package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
  73. package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
  74. package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
  75. package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
  76. package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
  77. package/dist/components/recipes/atlas/braid.d.ts +62 -0
  78. package/dist/components/recipes/atlas/capsules.d.ts +18 -0
  79. package/dist/components/recipes/atlas/compare.d.ts +4 -0
  80. package/dist/components/recipes/atlas/completeness.d.ts +2 -0
  81. package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
  82. package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
  83. package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
  84. package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
  85. package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
  86. package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
  87. package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
  88. package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
  89. package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
  90. package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
  91. package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
  92. package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
  93. package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
  94. package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
  95. package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
  96. package/dist/components/recipes/atlas/forests.d.ts +11 -0
  97. package/dist/components/recipes/atlas/ids.d.ts +6 -0
  98. package/dist/components/recipes/atlas/index.d.ts +26 -0
  99. package/dist/components/recipes/atlas/ledger.d.ts +7 -0
  100. package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
  101. package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
  102. package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
  103. package/dist/components/recipes/atlas/motifs.d.ts +3 -0
  104. package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
  105. package/dist/components/recipes/atlas/prepare.d.ts +14 -0
  106. package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
  107. package/dist/components/recipes/atlas/profile.d.ts +19 -0
  108. package/dist/components/recipes/atlas/publish.d.ts +10 -0
  109. package/dist/components/recipes/atlas/queries.d.ts +34 -0
  110. package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
  111. package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
  112. package/dist/components/recipes/atlas/sections.d.ts +3 -0
  113. package/dist/components/recipes/atlas/support.d.ts +7 -0
  114. package/dist/components/recipes/atlas/types.d.ts +278 -0
  115. package/dist/components/recipes/atlas/validate.d.ts +12 -0
  116. package/dist/components/semiotic-atlas-core.d.ts +20 -0
  117. package/dist/components/semiotic-atlas.d.ts +8 -0
  118. package/dist/components/semiotic-recipes-core.d.ts +9 -0
  119. package/dist/components/server/serverChartConfigs.d.ts +3 -0
  120. package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
  121. package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
  122. package/dist/components/stream/canvasSetup.d.ts +1 -2
  123. package/dist/components/stream/fontLoading.d.ts +4 -0
  124. package/dist/components/stream/networkCustomLayout.d.ts +8 -0
  125. package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
  126. package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
  127. package/dist/components/stream/physics/physicsSemanticUI.d.ts +2 -0
  128. package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
  129. package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
  130. package/dist/components/stream/shallowEqual.d.ts +2 -0
  131. package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
  132. package/dist/geo.min.js +1 -1
  133. package/dist/geo.module.min.js +1 -1
  134. package/dist/network.module.min.js +1 -1
  135. package/dist/ordinal.module.min.js +1 -1
  136. package/dist/physics.module.min.js +1 -1
  137. package/dist/rough.module.min.js +1 -1
  138. package/dist/semiotic-access.module.min.js +1 -1
  139. package/dist/semiotic-ai-core.min.js +1 -1
  140. package/dist/semiotic-ai-core.module.min.js +1 -1
  141. package/dist/semiotic-ai.module.min.js +1 -1
  142. package/dist/semiotic-artifact.min.js +1 -1
  143. package/dist/semiotic-artifact.module.min.js +1 -1
  144. package/dist/semiotic-atlas-core.d.ts +20 -0
  145. package/dist/semiotic-atlas-core.min.js +1 -0
  146. package/dist/semiotic-atlas-core.module.min.js +1 -0
  147. package/dist/semiotic-atlas-selection.module.min.js +2 -0
  148. package/dist/semiotic-atlas.d.ts +8 -0
  149. package/dist/semiotic-atlas.min.js +2 -0
  150. package/dist/semiotic-atlas.module.min.js +2 -0
  151. package/dist/semiotic-client-cjs-shared.min.js +1 -1
  152. package/dist/semiotic-evidence.min.js +1 -1
  153. package/dist/semiotic-evidence.module.min.js +1 -1
  154. package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
  155. package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
  156. package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
  157. package/dist/semiotic-experimental-vacp.min.js +1 -1
  158. package/dist/semiotic-experimental-vacp.module.min.js +1 -1
  159. package/dist/semiotic-line.module.min.js +1 -1
  160. package/dist/semiotic-realtime-core.module.min.js +1 -1
  161. package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
  162. package/dist/semiotic-recipes-core.d.ts +9 -0
  163. package/dist/semiotic-recipes-core.module.min.js +1 -1
  164. package/dist/semiotic-server-edge-node.module.min.js +1 -1
  165. package/dist/semiotic-server-edge.min.js +1 -1
  166. package/dist/semiotic-server-edge.module.min.js +1 -1
  167. package/dist/semiotic-server-node.min.js +1 -1
  168. package/dist/semiotic-server-node.module.min.js +1 -1
  169. package/dist/semiotic-text.min.js +1 -1
  170. package/dist/semiotic-text.module.min.js +1 -1
  171. package/dist/semiotic-utils-core.min.js +1 -1
  172. package/dist/semiotic-utils-core.module.min.js +1 -1
  173. package/dist/semiotic.module.min.js +1 -1
  174. package/dist/server.min.js +1 -1
  175. package/dist/server.module.min.js +1 -1
  176. package/dist/xy.module.min.js +1 -1
  177. package/package.json +16 -1
  178. package/dist/c-447VIMRO.min.js +0 -1
  179. package/dist/c-553QUDKA.min.js +0 -1
  180. package/dist/c-7HP7MB2I.min.js +0 -1
  181. package/dist/c-7NBU5ZKS.min.js +0 -1
  182. package/dist/c-CCTGN5CK.min.js +0 -1
  183. package/dist/c-GSZRZRD6.min.js +0 -1
  184. package/dist/c-GWX7JGMF.min.js +0 -1
  185. package/dist/c-ITKX3RC5.min.js +0 -1
  186. package/dist/c-JG2JCQLP.min.js +0 -1
  187. package/dist/c-LYVKDBQJ.min.js +0 -1
  188. package/dist/c-NG7BLZTR.min.js +0 -1
  189. package/dist/c-PYNW54D2.min.js +0 -1
  190. package/dist/c-TIXX5CAU.min.js +0 -1
  191. /package/dist/{c-OOVX2JPQ.min.js → c-UC7SIU2W.min.js} +0 -0
@@ -0,0 +1,278 @@
1
+ import type { DominatorResult, RequiredPathsSpec } from "./dependencyTypes";
2
+ export declare const NETWORK_ATLAS_SCHEMA_VERSION: "0.2";
3
+ export type CompletenessStatus = "known" | "unknown" | "incomplete" | "truncated" | "unsupported-template";
4
+ export type EvidenceStatus = "exact" | "estimated" | "unknown" | "incomplete";
5
+ export type UnitKind = "stock" | "rate" | "capacity";
6
+ export type AtlasCountUnit = "entity" | "occurrence" | "embedding" | "work-item";
7
+ export type MotifTemplate = "serial-chain" | "repeated-state-episode" | "fan-out" | "fan-in" | "split-rejoin-diamond" | "shared-upstream-source" | "connector-bypass";
8
+ export declare const MOTIF_CATALOG_TEMPLATES: readonly MotifTemplate[];
9
+ export declare const PHASE1_MOTIF_MATCHERS: readonly MotifTemplate[];
10
+ export declare const PHASE2_MOTIF_MATCHERS: readonly MotifTemplate[];
11
+ export type MeasureSpec = {
12
+ unitKind: UnitKind;
13
+ countUnit: AtlasCountUnit;
14
+ timeDenominator?: string;
15
+ description?: string;
16
+ };
17
+ export type CoordinateSpec = {
18
+ kind: "ordinal";
19
+ sectionIds: string[];
20
+ } | {
21
+ kind: "numeric";
22
+ field: string;
23
+ unit: string;
24
+ };
25
+ export type RelationPolicy = {
26
+ directed: true;
27
+ edgeIdRequired: true;
28
+ parallelEdges: "keep-by-id";
29
+ selfLoops: "keep-by-id";
30
+ };
31
+ export type MotifSpec = {
32
+ catalogId: string;
33
+ catalogVersion: string;
34
+ countUnit: AtlasCountUnit;
35
+ denominatorRef?: string;
36
+ timeWindowMs?: number;
37
+ anchor: "completion";
38
+ matchBudget?: number;
39
+ };
40
+ export type DisplayForestSpec = {
41
+ kind: "rooted-backbone";
42
+ roots: string[];
43
+ rankingPolicyId: string;
44
+ } | {
45
+ kind: "observed-prefix";
46
+ roots?: string[];
47
+ rankingPolicyId?: string;
48
+ referencePartition?: string;
49
+ };
50
+ export type SharedPartitionComparison = {
51
+ partitions: string[];
52
+ denominatorMeasureId: string;
53
+ referencePartition?: string;
54
+ };
55
+ export type TemporalContract = {
56
+ kind: "snapshot";
57
+ } | {
58
+ kind: "window";
59
+ start: number;
60
+ end: number;
61
+ };
62
+ export type NetworkAtlasSpec = {
63
+ schemaVersion: typeof NETWORK_ATLAS_SCHEMA_VERSION;
64
+ coordinate: CoordinateSpec;
65
+ relations: RelationPolicy;
66
+ evidencePolicyId: string;
67
+ measures: Record<string, MeasureSpec>;
68
+ motifs: MotifSpec;
69
+ forest: {
70
+ display: DisplayForestSpec;
71
+ requiredPaths?: RequiredPathsSpec;
72
+ };
73
+ comparison?: SharedPartitionComparison;
74
+ dataRevision: string;
75
+ temporal: TemporalContract;
76
+ };
77
+ export type AtlasNode = {
78
+ id: string;
79
+ sectionId?: string;
80
+ completeness?: CompletenessStatus;
81
+ };
82
+ export type AtlasEdge = {
83
+ id: string;
84
+ source: string;
85
+ target: string;
86
+ };
87
+ export type AtlasOccurrence = {
88
+ id: string;
89
+ entityId: string;
90
+ entityCount?: number;
91
+ nodePath: string[];
92
+ /** Traffic at each nodePath step. Omit to use entityCount at every step. */
93
+ stepEntityCounts?: number[];
94
+ complete: boolean;
95
+ missingPrehistory?: boolean;
96
+ partition?: string;
97
+ groupKeys?: Record<string, string>;
98
+ };
99
+ export type AtlasMeasureValue = {
100
+ measureId: string;
101
+ subjectId: string;
102
+ value: number;
103
+ status: EvidenceStatus;
104
+ };
105
+ export type NetworkAtlasSource = {
106
+ graphRef: string;
107
+ revision: string;
108
+ nodes: AtlasNode[];
109
+ edges: AtlasEdge[];
110
+ occurrences?: AtlasOccurrence[];
111
+ measureValues: AtlasMeasureValue[];
112
+ };
113
+ export type AtlasIssueSeverity = "fatal" | "warn";
114
+ export type AtlasIssue = {
115
+ kind: string;
116
+ severity: AtlasIssueSeverity;
117
+ message: string;
118
+ id?: string;
119
+ };
120
+ export type SectionIndex = {
121
+ kind: "ordinal";
122
+ sectionIds: string[];
123
+ nodeIdsBySection: Record<string, string[]>;
124
+ };
125
+ export type MotifFlags = {
126
+ occurrence: boolean;
127
+ temporal: boolean;
128
+ trajectorySupported: boolean;
129
+ enriched: boolean;
130
+ };
131
+ export type MotifMatch = {
132
+ id: string;
133
+ template: MotifTemplate;
134
+ roles: Record<string, string | string[]>;
135
+ nodePath: string[];
136
+ edgeIds: string[];
137
+ startSectionId?: string;
138
+ completionSectionId?: string;
139
+ intersectSectionIds: string[];
140
+ entityIds: string[];
141
+ entityWeights: Record<string, number>;
142
+ entityCount: number;
143
+ flags: MotifFlags;
144
+ truncation?: {
145
+ disclosed: true;
146
+ omitted: number;
147
+ fullCount: number;
148
+ };
149
+ };
150
+ export type MotifMatchIndex = {
151
+ catalogId: string;
152
+ catalogVersion: string;
153
+ matches: MotifMatch[];
154
+ incompleteCandidates: Array<{
155
+ template: MotifTemplate;
156
+ occurrenceId: string;
157
+ reason: "missing-prehistory";
158
+ }>;
159
+ unsupportedTemplates: MotifTemplate[];
160
+ };
161
+ export type DisplayForest = {
162
+ kind: "rooted-backbone";
163
+ roots: string[];
164
+ rankingPolicyId: string;
165
+ backboneEdgeIds: string[];
166
+ primaryParentEdgeIdByNode: Record<string, string>;
167
+ };
168
+ export type PrefixForestNode = {
169
+ id: string;
170
+ stateId: string;
171
+ prefix: string[];
172
+ parentId: string | null;
173
+ childIds: string[];
174
+ entityCount: number;
175
+ occurrenceIds: string[];
176
+ partitionCounts: Record<string, number>;
177
+ };
178
+ export type PrefixForest = {
179
+ kind: "observed-prefix";
180
+ rootIds: string[];
181
+ nodes: PrefixForestNode[];
182
+ order: string[];
183
+ referencePartition?: string;
184
+ };
185
+ export type PreparedComparison = {
186
+ partitions: string[];
187
+ denominatorMeasureId: string;
188
+ referencePartition?: string;
189
+ rows: Array<{
190
+ partition: string;
191
+ assigned: number;
192
+ motifUsers: Record<string, number>;
193
+ outcomes: Record<string, number>;
194
+ }>;
195
+ };
196
+ export type OriginalEdgeIndex = {
197
+ residualEdgeIds: string[];
198
+ originalEdgeIds: string[];
199
+ };
200
+ export type SupportedHop = {
201
+ from: string;
202
+ to: string;
203
+ via?: string;
204
+ occurrenceIds: string[];
205
+ };
206
+ export type RouteSupportIndex = {
207
+ hops: SupportedHop[];
208
+ graphAdjacency: Array<{
209
+ source: string;
210
+ target: string;
211
+ edgeId: string;
212
+ }>;
213
+ };
214
+ export type LedgerEntry = {
215
+ measureId: string;
216
+ subjectId: string;
217
+ subjectKind: "node" | "section" | "global";
218
+ value: number;
219
+ status: EvidenceStatus;
220
+ unitKind: UnitKind;
221
+ countUnit: AtlasCountUnit;
222
+ timeDenominator?: string;
223
+ };
224
+ export type MeasureLedger = {
225
+ entries: LedgerEntry[];
226
+ };
227
+ export type CompletenessReport = {
228
+ nodes: Record<string, CompletenessStatus>;
229
+ motifs: Record<string, CompletenessStatus>;
230
+ traces: CompletenessStatus;
231
+ truncation?: {
232
+ disclosed: true;
233
+ template: MotifTemplate;
234
+ omitted: number;
235
+ };
236
+ };
237
+ export type AtlasProvenance = {
238
+ sourceRevision: string;
239
+ analysisRevision: string;
240
+ generation: number;
241
+ relationScope: string;
242
+ motifCatalogVersion: string;
243
+ coordinatePolicy: string;
244
+ forestRoots: string[];
245
+ rankingPolicyId: string;
246
+ population: AtlasCountUnit;
247
+ temporalHorizon: string;
248
+ evidencePolicyId: string;
249
+ };
250
+ export type PreparedNetworkAtlas = {
251
+ sourceGraphRef: string;
252
+ analysisRevision: string;
253
+ spec: NetworkAtlasSpec;
254
+ source: NetworkAtlasSource;
255
+ sections: SectionIndex;
256
+ motifs: MotifMatchIndex;
257
+ forest: DisplayForest;
258
+ residualEdges: OriginalEdgeIndex;
259
+ ports: RouteSupportIndex;
260
+ ledger: MeasureLedger;
261
+ completeness: CompletenessReport;
262
+ provenance: AtlasProvenance;
263
+ prefixForest?: PrefixForest;
264
+ comparison?: PreparedComparison;
265
+ requiredPaths?: DominatorResult;
266
+ };
267
+ export type QueryResult<T> = {
268
+ status: EvidenceStatus | "truncated";
269
+ value?: T;
270
+ units?: string;
271
+ countUnit?: AtlasCountUnit;
272
+ unitKind?: UnitKind;
273
+ scope: string;
274
+ sourceRevision: string;
275
+ analysisRevision: string;
276
+ evidenceRefs: string[];
277
+ limitations: string[];
278
+ };
@@ -0,0 +1,12 @@
1
+ import { type AtlasIssue, type NetworkAtlasSource, type NetworkAtlasSpec } from "./types";
2
+ export type AtlasValidation = {
3
+ ok: boolean;
4
+ issues: AtlasIssue[];
5
+ };
6
+ export declare function validateAtlas(spec: NetworkAtlasSpec, source: NetworkAtlasSource): AtlasValidation;
7
+ export declare function measuresAreComparable(leftId: string, rightId: string, spec: NetworkAtlasSpec): {
8
+ ok: true;
9
+ } | {
10
+ ok: false;
11
+ reason: string;
12
+ };
@@ -0,0 +1,20 @@
1
+ /** Network Atlas preparation and evidence queries. Safe outside React. */
2
+ export * from "./recipes/atlas/types";
3
+ export * from "./recipes/atlas/dependencyTypes";
4
+ export * from "./recipes/atlas/flowCircuitTypes";
5
+ export { prepareNetworkAtlas } from "./recipes/atlas/prepare";
6
+ export type { PrepareOptions, PrepareResult } from "./recipes/atlas/prepare";
7
+ export { prepareNetworkAtlasAsync } from "./recipes/atlas/prepareAsync";
8
+ export { validateAtlas, measuresAreComparable } from "./recipes/atlas/validate";
9
+ export { ledgerValue } from "./recipes/atlas/ledger";
10
+ export { prepareMotifBraid, ribbonSupportsRoute } from "./recipes/atlas/braid";
11
+ export type { MotifBraidProjection, TrajectoryGroup, BraidRibbon, SignedReadout } from "./recipes/atlas/braid";
12
+ export * from "./recipes/atlas/queries";
13
+ export * from "./recipes/atlas/dependencyQueries";
14
+ export * from "./recipes/atlas/dependencyForest";
15
+ export { prepareFlowCircuit, explainCircuitModule } from "./recipes/atlas/flowCircuit";
16
+ export { admitCircuitEdition, readCircuitEdition, exportCircuitEvidence } from "./recipes/atlas/flowCircuitTape";
17
+ export { buildMotifProfile } from "./recipes/atlas/profile";
18
+ export type { MotifProfileCell, MotifProfileStrip } from "./recipes/atlas/profile";
19
+ export { publishPreparedAtlas } from "./recipes/atlas/publish";
20
+ export type { AtlasPublicationStore } from "./recipes/atlas/publish";
@@ -0,0 +1,8 @@
1
+ /** Evidence-backed readers for prepared Network Atlas artifacts. */
2
+ export { MotifBraidChart } from "./recipes/atlas/MotifBraidChart";
3
+ export type { MotifBraidChartProps } from "./recipes/atlas/MotifBraidChart";
4
+ export { DependencyForestChart } from "./recipes/atlas/DependencyForestChart";
5
+ export type { DependencyForestChartProps } from "./recipes/atlas/DependencyForestChart";
6
+ export { FlowCircuitChart } from "./recipes/atlas/FlowCircuitChart";
7
+ export type { FlowCircuitChartProps } from "./recipes/atlas/FlowCircuitChart";
8
+ export { DependencyMatrix } from "./recipes/atlas/DependencyMatrix";
@@ -32,6 +32,15 @@ export { transitDiagramLayout, computeTransitDiagramPositions, octilinearRoute,
32
32
  export type { TransitDiagramConfig, TransitDiagramLineDescriptor, TransitDiagramLineValue, TransitDiagramMode, TransitDiagramPoint, TransitDiagramPositionOptions, TransitDiagramPositionResult, TransitDiagramPositionedNode, TransitDiagramStationRenderInfo, } from "./recipes/transitDiagram";
33
33
  export { lineageDagLayout } from "./recipes/lineageDag";
34
34
  export type { LineageDagConfig, LineageLod, LineageStoreSlot } from "./recipes/lineageDag";
35
+ export { prepareNetworkAtlasAsync } from "./recipes/atlas/prepareAsync";
36
+ export type { PrepareOptions as PrepareNetworkAtlasOptions, PrepareResult as PrepareNetworkAtlasResult } from "./recipes/atlas/prepare";
37
+ export type { NetworkAtlasSpec, NetworkAtlasSource, PreparedNetworkAtlas, AtlasNode, AtlasEdge, AtlasOccurrence, AtlasMeasureValue, AtlasIssue } from "./recipes/atlas/types";
38
+ export { prepareMotifBraid } from "./recipes/atlas/prepareAsync";
39
+ export type { MotifBraidProjection, TrajectoryGroup, BraidRibbon, SignedReadout } from "./recipes/atlas/braid";
40
+ export type { MotifCapsule } from "./recipes/atlas/capsules";
41
+ export type { MotifProfileCell, MotifProfileStrip } from "./recipes/atlas/profile";
42
+ export { motifBraidLayout } from "./recipes/atlas/motifBraidLayout";
43
+ export type { MotifBraidLayoutConfig } from "./recipes/atlas/motifBraidLayout";
35
44
  export { mermaidDagLayout } from "./recipes/mermaidDag";
36
45
  export type { MermaidDagConfig } from "./recipes/mermaidDag";
37
46
  export { netEnsembleLayout, analyzeNetEnsemble } from "./recipes/netEnsembleLayout";
@@ -5,6 +5,9 @@
5
5
  */
6
6
  import type { ChartConfig } from "./serverChartConfigShared";
7
7
  export declare const CHART_CONFIGS: {
8
+ MotifBraidChart: ChartConfig;
9
+ DependencyForestChart: ChartConfig;
10
+ FlowCircuitChart: ChartConfig;
8
11
  Sparkline: ChartConfig;
9
12
  BumpChart: ChartConfig;
10
13
  LineChart: ChartConfig;
@@ -0,0 +1,4 @@
1
+ import type { ChartConfig } from "./serverChartConfigShared";
2
+ export declare const motifBraidChart: ChartConfig;
3
+ export declare const dependencyForestChart: ChartConfig;
4
+ export declare const flowCircuitChart: ChartConfig;
@@ -53,6 +53,7 @@ export declare class NetworkPipelineStore implements UpdateResultStore {
53
53
  * StreamNetworkFrame). Empty for built-in chart types. */
54
54
  customLayoutHtmlMarks: NetworkHtmlMark[];
55
55
  private _customLayoutDiagnosticsWarned;
56
+ private _customLayoutCache;
56
57
  /** Per-frame restyle callbacks from the custom layout result. When set, the
57
58
  * frame routes selection changes through `restyleScene()` (style-only repaint)
58
59
  * instead of a full `buildScene()`. */
@@ -10,8 +10,7 @@ export interface CanvasMargin {
10
10
  bottom: number;
11
11
  left: number;
12
12
  }
13
- /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
14
- export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
13
+ export { subscribeToCanvasFontInvalidation } from "./fontLoading";
15
14
  /**
16
15
  * Keep a canvas's backing store and CSS box aligned with the frame size.
17
16
  * This is separate from context preparation so an idle interaction layer can
@@ -0,0 +1,4 @@
1
+ /** Empty native load events (including Firefox's initial event) change no metrics. */
2
+ export declare function hasLoadedFontFaces(event: Event): boolean;
3
+ /** Repaint canvas text after an asynchronously loaded web font becomes usable. */
4
+ export declare function subscribeToCanvasFontInvalidation(listener: () => void): () => void;
@@ -37,6 +37,14 @@ export interface NetworkLayoutSelection {
37
37
  * rects, lines, beziers — and optional labels/overlays. The frame still
38
38
  * owns hit testing, decay, accessibility, and SSR.
39
39
  *
40
+ * Bounded client mounts ingest data before invoking the layout. The retained
41
+ * scene is reused while data, plot dimensions, layout/config identity, theme,
42
+ * and geometry-driving selection are unchanged. A measured container can
43
+ * require a second call at its measured size. Treat inputs as immutable;
44
+ * replace changed data/config references. `ref.relayout()` forces a fresh
45
+ * call, and failed calls remain retriable. Empty push-mode frames may invoke
46
+ * the layout for decorations. SSR and client hydration execute separately.
47
+ *
40
48
  * Mirrors the XY `CustomLayout` pattern. Reach for it when the catalog
41
49
  * (force, sankey, chord, tree, treemap, circle-pack, orbit) doesn't fit
42
50
  * — e.g. `d3-flextree`, `dagre`, custom radial layouts.
@@ -0,0 +1,12 @@
1
+ import type { NetworkPipelineConfig } from "./networkTypes";
2
+ import type { CustomLayoutSelection } from "./customLayoutSelection";
3
+ /** One successful input state per store; failures remain retriable. */
4
+ export declare class NetworkCustomLayoutCache {
5
+ private restyle;
6
+ private key;
7
+ private pending;
8
+ constructor(restyle: (selection: CustomLayoutSelection | null) => void);
9
+ reuse(config: NetworkPipelineConfig, size: [number, number], dataRevision: number, layoutVersion: number, hasRestyle: boolean): boolean;
10
+ commit(): void;
11
+ clear(): void;
12
+ }
@@ -13,10 +13,3 @@ export type NetworkPipelineConfigSources = Pick<StreamNetworkFrameProps, "chartT
13
13
  currentTheme: SemioticTheme | null | undefined;
14
14
  };
15
15
  export declare function buildNetworkPipelineConfig(sources: NetworkPipelineConfigSources): NetworkPipelineConfig;
16
- /** Fields that force re-ingest / re-layout when changed. */
17
- export type NetworkLayoutConfigSignature = Pick<NetworkPipelineConfigSources, "chartType" | "nodeIDAccessor" | "sourceAccessor" | "targetAccessor" | "valueAccessor" | "edgeIdAccessor" | "childrenAccessor" | "hierarchySum" | "orientation" | "nodeAlign" | "nodePaddingRatio" | "nodeWidth" | "iterations" | "forceStrength" | "padAngle" | "groupWidth" | "sortGroups" | "edgeSort" | "treeOrientation" | "edgeType" | "padding" | "paddingTop" | "random" | "seed" | "tensionConfig" | "customNetworkLayout"> & {
18
- orbitMode?: NetworkPipelineConfigSources["orbitMode"];
19
- orbitSize?: NetworkPipelineConfigSources["orbitSize"];
20
- orbitEccentricity?: NetworkPipelineConfigSources["orbitEccentricity"];
21
- };
22
- export declare function buildNetworkLayoutConfigSignature(sources: NetworkLayoutConfigSignature): Record<string, unknown>;
@@ -7,6 +7,8 @@ import type { PhysicsBodyState } from "./PhysicsKernel";
7
7
  import type { PhysicsSimulationState } from "./PhysicsPipelineStore";
8
8
  import type { PhysicsHoverData, PhysicsSemanticItem, StreamPhysicsFrameProps } from "./StreamPhysicsTypes";
9
9
  export declare const SR_ONLY_STYLE: React.CSSProperties;
10
+ /** Announce hover or focus once, outside the frame's atomic role="img". */
11
+ export declare function renderPhysicsAnnouncements(items: PhysicsSemanticItem[], focusedSemanticItem: PhysicsSemanticItem | null, hoverData: PhysicsHoverData | null, liveRegionId: string): React.JSX.Element;
10
12
  declare function physicsHoverData(body: PhysicsBodyState): PhysicsHoverData;
11
13
  declare function createBodySemanticItems(bodies: readonly PhysicsBodyState[], simulationState: PhysicsSimulationState, bodySemanticItems: StreamPhysicsFrameProps["bodySemanticItems"], limit: number): PhysicsSemanticItem[];
12
14
  declare function semanticItemsChanged(previous: readonly PhysicsSemanticItem[], next: readonly PhysicsSemanticItem[]): boolean;
@@ -6,11 +6,13 @@ import type { PhysicsHoverData, StreamPhysicsFrameProps } from "./StreamPhysicsT
6
6
  import type { PhysicsFrameObservationPayload } from "./physicsFrameObservations";
7
7
  type PhysicsFrameObservationEmitter = (type: "hover", payload: PhysicsFrameObservationPayload) => void;
8
8
  interface PhysicsCanvasPointerOptions {
9
+ resolveSemanticBody?: (body: PhysicsBodyState) => PhysicsBodyState;
9
10
  canvasRef: React.RefObject<HTMLCanvasElement | null>;
10
11
  clearHover: () => void;
11
12
  emitObservation: PhysicsFrameObservationEmitter;
12
13
  enableHover: boolean;
13
14
  hoverRadius: number;
15
+ hoverDataRef: React.MutableRefObject<PhysicsHoverData | null>;
14
16
  onBodyHover: StreamPhysicsFrameProps["onBodyHover"];
15
17
  setHoverData: React.Dispatch<React.SetStateAction<PhysicsHoverData | null>>;
16
18
  storeRef: React.RefObject<PhysicsPipelineStore | null>;
@@ -22,7 +24,7 @@ export interface PhysicsBodyCursorCollection {
22
24
  }
23
25
  declare function collectPhysicsBodyCursor(collection: PhysicsBodyCursorCollection, body: PhysicsBodyState, style: Style, customRenderer: boolean): void;
24
26
  /** Owns canvas hit-testing that is shared by physics hover and authored cursors. */
25
- export declare function usePhysicsCanvasPointer({ canvasRef, clearHover, emitObservation, enableHover, hoverRadius, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
27
+ export declare function usePhysicsCanvasPointer({ resolveSemanticBody, canvasRef, clearHover, emitObservation, enableHover, hoverRadius, hoverDataRef, onBodyHover, setHoverData, storeRef }: PhysicsCanvasPointerOptions): {
26
28
  begin: () => PhysicsBodyCursorCollection;
27
29
  collect: typeof collectPhysicsBodyCursor;
28
30
  handlePointerLeave: (event: React.PointerEvent<HTMLCanvasElement>) => void;
@@ -21,11 +21,13 @@ interface PhysicsSemanticNavigationOptions {
21
21
  storeRef: MutableRefObject<PhysicsPipelineStore | null>;
22
22
  }
23
23
  export interface PhysicsSemanticNavigationResult {
24
+ resolveSemanticBody: (body: PhysicsBodyState) => PhysicsBodyState;
24
25
  clearHover: () => void;
25
26
  focusedBodyIdRef: MutableRefObject<string | null>;
26
27
  focusedSemanticItem: PhysicsSemanticItem | null;
27
28
  handleCanvasPointerDown: (event: PointerEvent<HTMLCanvasElement>) => void;
28
29
  hoverData: PhysicsHoverData | null;
30
+ hoverDataRef: MutableRefObject<PhysicsHoverData | null>;
29
31
  onKeyDown: (event: KeyboardEvent<HTMLDivElement>) => void;
30
32
  setFocusedSemanticItem: Dispatch<SetStateAction<PhysicsSemanticItem | null>>;
31
33
  setHoverData: Dispatch<SetStateAction<PhysicsHoverData | null>>;
@@ -0,0 +1,2 @@
1
+ /** Shared pure equality for frame configs and retained custom-layout inputs. */
2
+ export declare function shallowEqualTwoLevel(a: unknown, b: unknown): boolean;
@@ -1,4 +1,4 @@
1
- import { type MutableRefObject } from "react";
1
+ import { type MutableRefObject, type RefObject } from "react";
2
2
  import type { StreamChartType } from "./types";
3
3
  /**
4
4
  * Keep LineChart's static graph free of candlestick/heatmap/bar, while
@@ -15,4 +15,6 @@ import type { StreamChartType } from "./types";
15
15
  * transition/restyle/pulse/resolution change). `scheduleRender` alone
16
16
  * after the first frame is not enough.
17
17
  */
18
- export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void): void;
18
+ export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void, storeRef: RefObject<{
19
+ markStylePaintPending(): void;
20
+ } | null>): void;