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.
- package/README.md +55 -59
- package/ai/artifact-surface-inventory.json +1 -1
- package/ai/componentMetadata.cjs +3 -1
- package/ai/dist/mcp-server.js +45 -45
- package/ai/examples.md +67 -0
- package/ai/reference.md +75 -1
- package/ai/schema.json +5199 -1
- package/ai/surface-manifest.json +24 -3
- package/ai/task-packets/compare-category-totals.json +6 -6
- package/ai/task-packets/compare-category-totals.md +3 -3
- package/ai/task-packets/correct-published-chart.json +6 -6
- package/ai/task-packets/correct-published-chart.md +3 -3
- package/ai/task-packets/index.json +6 -6
- package/ai/task-packets/update-live-chart.json +6 -6
- package/ai/task-packets/update-live-chart.md +3 -3
- package/dist/c-2RL2QPZJ.min.js +1 -0
- package/dist/c-45CQWZZ6.min.js +1 -0
- package/dist/{c-PP6VY3QU.min.js → c-4BRHKVKV.min.js} +1 -1
- package/dist/c-7DVPSB5C.min.js +1 -0
- package/dist/{c-XDQKXPX4.min.js → c-A7OGOFSL.min.js} +1 -1
- package/dist/{c-AZKPVBOC.min.js → c-AH5HWZWS.min.js} +1 -1
- package/dist/c-B7GW7IHJ.min.js +1 -0
- package/dist/{c-ROEHCIGV.min.js → c-C3TZLTZK.min.js} +1 -1
- package/dist/c-CGQAQWBV.min.js +1 -0
- package/dist/c-DIPEYUOW.min.js +1 -0
- package/dist/{c-WNGH47HF.min.js → c-E72OTUZU.min.js} +1 -1
- package/dist/{c-DY2676CR.min.js → c-EUMPMDCS.min.js} +1 -1
- package/dist/c-EZZT2WAE.min.js +1 -0
- package/dist/c-FHBVFCQB.min.js +1 -0
- package/dist/{c-E32M6XW5.min.js → c-G4HCO2IQ.min.js} +1 -1
- package/dist/{c-ZYPXQF7B.min.js → c-G5VIJEOK.min.js} +1 -1
- package/dist/c-GHVOXAYH.min.js +1 -0
- package/dist/{c-EBOQ7ER7.min.js → c-HP4ZFM47.min.js} +1 -1
- package/dist/{c-IDJV3CZK.min.js → c-HYDTS5OP.min.js} +1 -1
- package/dist/c-IK33LNZ6.min.js +1 -0
- package/dist/c-IK3PZHRY.min.js +1 -0
- package/dist/{c-JO2UGTCP.min.js → c-J6DVC236.min.js} +1 -1
- package/dist/{c-MXCP7GNZ.min.js → c-JIMJF6F6.min.js} +1 -1
- package/dist/{c-4FN7Q6VQ.min.js → c-KKPMHAZC.min.js} +1 -1
- package/dist/c-L6WNDBHV.min.js +1 -0
- package/dist/c-LDEX5OFW.min.js +1 -0
- package/dist/{c-CPSPZH6A.min.js → c-LESEUVC5.min.js} +1 -1
- package/dist/c-MB6CV5NC.min.js +1 -0
- package/dist/{c-OO5QLMJC.min.js → c-MOKJOIPE.min.js} +1 -1
- package/dist/{c-BNG5ECK5.min.js → c-N3FXLRNT.min.js} +1 -1
- package/dist/c-N5NPTJVJ.min.js +1 -0
- package/dist/{c-DE5Q3U2X.min.js → c-NHBL4J67.min.js} +1 -1
- package/dist/{c-LMGSSD2E.min.js → c-ODG6TFSY.min.js} +1 -1
- package/dist/{c-HXDKPIKR.min.js → c-PSKKFZNP.min.js} +1 -1
- package/dist/{c-NYZ2QNAM.min.js → c-R2P4RR7Q.min.js} +1 -1
- package/dist/{c-KCRJGUHP.min.js → c-RFC7UAG7.min.js} +1 -1
- package/dist/c-SGAURYHG.min.js +1 -0
- package/dist/{c-DK662R77.min.js → c-SJMWU6UX.min.js} +1 -1
- package/dist/c-STIIGQOD.min.js +1 -0
- package/dist/c-T2ASIJVZ.min.js +1 -0
- package/dist/c-TX3THUTO.min.js +1 -0
- package/dist/{c-55BAJ333.min.js → c-TX7XJM3Z.min.js} +1 -1
- package/dist/c-UMXSJIOV.min.js +1 -0
- package/dist/{c-JLGRHXGZ.min.js → c-VRSXMLYF.min.js} +1 -1
- package/dist/c-VSLWSAN2.min.js +1 -0
- package/dist/{c-33QOXEUG.min.js → c-WCBRPILW.min.js} +1 -1
- package/dist/{c-WH2O53VI.min.js → c-WGHT7OCY.min.js} +1 -1
- package/dist/c-WWCW3APR.min.js +1 -0
- package/dist/c-Y6PYUMFU.min.js +1 -0
- package/dist/c-ZIVPFTOC.min.js +1 -0
- package/dist/components/charts/shared/chartDataProps.d.ts +3 -0
- package/dist/components/charts/shared/chartSpecAtlasSchemas.d.ts +5 -0
- package/dist/components/charts/shared/chartSpecCore.d.ts +4 -0
- package/dist/components/charts/shared/chartSpecsAtlas.d.ts +2 -0
- package/dist/components/charts/shared/hooks.d.ts +3 -1
- package/dist/components/charts/shared/knownChartComponents.d.ts +1 -1
- package/dist/components/recipes/atlas/DependencyForestChart.d.ts +20 -0
- package/dist/components/recipes/atlas/DependencyMatrix.d.ts +7 -0
- package/dist/components/recipes/atlas/FlowCircuitChart.d.ts +20 -0
- package/dist/components/recipes/atlas/MotifBraidChart.d.ts +17 -0
- package/dist/components/recipes/atlas/atlasChartOptions.d.ts +11 -0
- package/dist/components/recipes/atlas/braid.d.ts +62 -0
- package/dist/components/recipes/atlas/capsules.d.ts +18 -0
- package/dist/components/recipes/atlas/compare.d.ts +4 -0
- package/dist/components/recipes/atlas/completeness.d.ts +2 -0
- package/dist/components/recipes/atlas/dependencyForest.d.ts +32 -0
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +58 -0
- package/dist/components/recipes/atlas/dependencyForestLayout.d.ts +17 -0
- package/dist/components/recipes/atlas/dependencyQueries.d.ts +20 -0
- package/dist/components/recipes/atlas/dependencyTypes.d.ts +21 -0
- package/dist/components/recipes/atlas/directedGraph.d.ts +9 -0
- package/dist/components/recipes/atlas/entityCounts.d.ts +3 -0
- package/dist/components/recipes/atlas/flowCircuit.d.ts +32 -0
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +72 -0
- package/dist/components/recipes/atlas/flowCircuitChrome.d.ts +18 -0
- package/dist/components/recipes/atlas/flowCircuitGeometry.d.ts +11 -0
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +20 -0
- package/dist/components/recipes/atlas/flowCircuitSemantics.d.ts +26 -0
- package/dist/components/recipes/atlas/flowCircuitTape.d.ts +22 -0
- package/dist/components/recipes/atlas/flowCircuitTypes.d.ts +144 -0
- package/dist/components/recipes/atlas/forests.d.ts +11 -0
- package/dist/components/recipes/atlas/ids.d.ts +6 -0
- package/dist/components/recipes/atlas/index.d.ts +26 -0
- package/dist/components/recipes/atlas/ledger.d.ts +7 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +51 -0
- package/dist/components/recipes/atlas/motifBraidGeometry.d.ts +5 -0
- package/dist/components/recipes/atlas/motifBraidLayout.d.ts +11 -0
- package/dist/components/recipes/atlas/motifs.d.ts +3 -0
- package/dist/components/recipes/atlas/prefixForest.d.ts +9 -0
- package/dist/components/recipes/atlas/prepare.d.ts +14 -0
- package/dist/components/recipes/atlas/prepareAsync.d.ts +7 -0
- package/dist/components/recipes/atlas/profile.d.ts +19 -0
- package/dist/components/recipes/atlas/publish.d.ts +10 -0
- package/dist/components/recipes/atlas/queries.d.ts +34 -0
- package/dist/components/recipes/atlas/requiredPaths.d.ts +9 -0
- package/dist/components/recipes/atlas/rootedForest.d.ts +4 -0
- package/dist/components/recipes/atlas/sections.d.ts +3 -0
- package/dist/components/recipes/atlas/support.d.ts +7 -0
- package/dist/components/recipes/atlas/types.d.ts +278 -0
- package/dist/components/recipes/atlas/validate.d.ts +12 -0
- package/dist/components/semiotic-atlas-core.d.ts +20 -0
- package/dist/components/semiotic-atlas.d.ts +8 -0
- package/dist/components/semiotic-recipes-core.d.ts +9 -0
- package/dist/components/server/serverChartConfigs.d.ts +3 -0
- package/dist/components/server/serverChartConfigsAtlas.d.ts +4 -0
- package/dist/components/stream/NetworkPipelineStore.d.ts +1 -0
- package/dist/components/stream/canvasSetup.d.ts +1 -2
- package/dist/components/stream/fontLoading.d.ts +4 -0
- package/dist/components/stream/networkCustomLayout.d.ts +8 -0
- package/dist/components/stream/networkCustomLayoutCache.d.ts +12 -0
- package/dist/components/stream/networkPipelineConfig.d.ts +0 -7
- package/dist/components/stream/physics/physicsSemanticUI.d.ts +2 -0
- package/dist/components/stream/physics/usePhysicsCanvasPointer.d.ts +3 -1
- package/dist/components/stream/physics/usePhysicsSemanticNavigation.d.ts +2 -0
- package/dist/components/stream/shallowEqual.d.ts +2 -0
- package/dist/components/stream/useEnsureCustomXYRenderers.d.ts +4 -2
- package/dist/geo.min.js +1 -1
- package/dist/geo.module.min.js +1 -1
- package/dist/network.module.min.js +1 -1
- package/dist/ordinal.module.min.js +1 -1
- package/dist/physics.module.min.js +1 -1
- package/dist/rough.module.min.js +1 -1
- package/dist/semiotic-access.module.min.js +1 -1
- package/dist/semiotic-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai.module.min.js +1 -1
- package/dist/semiotic-artifact.min.js +1 -1
- package/dist/semiotic-artifact.module.min.js +1 -1
- package/dist/semiotic-atlas-core.d.ts +20 -0
- package/dist/semiotic-atlas-core.min.js +1 -0
- package/dist/semiotic-atlas-core.module.min.js +1 -0
- package/dist/semiotic-atlas-selection.module.min.js +2 -0
- package/dist/semiotic-atlas.d.ts +8 -0
- package/dist/semiotic-atlas.min.js +2 -0
- package/dist/semiotic-atlas.module.min.js +2 -0
- package/dist/semiotic-client-cjs-shared.min.js +1 -1
- package/dist/semiotic-evidence.min.js +1 -1
- package/dist/semiotic-evidence.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +1 -1
- package/dist/semiotic-experimental-react-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-vacp.min.js +1 -1
- package/dist/semiotic-experimental-vacp.module.min.js +1 -1
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +1 -1
- package/dist/semiotic-recipes-core.d.ts +9 -0
- package/dist/semiotic-recipes-core.module.min.js +1 -1
- package/dist/semiotic-server-edge-node.module.min.js +1 -1
- package/dist/semiotic-server-edge.min.js +1 -1
- package/dist/semiotic-server-edge.module.min.js +1 -1
- package/dist/semiotic-server-node.min.js +1 -1
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-text.min.js +1 -1
- package/dist/semiotic-text.module.min.js +1 -1
- package/dist/semiotic-utils-core.min.js +1 -1
- package/dist/semiotic-utils-core.module.min.js +1 -1
- package/dist/semiotic.module.min.js +1 -1
- package/dist/server.min.js +1 -1
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +16 -1
- package/dist/c-447VIMRO.min.js +0 -1
- package/dist/c-553QUDKA.min.js +0 -1
- package/dist/c-7HP7MB2I.min.js +0 -1
- package/dist/c-7NBU5ZKS.min.js +0 -1
- package/dist/c-CCTGN5CK.min.js +0 -1
- package/dist/c-GSZRZRD6.min.js +0 -1
- package/dist/c-GWX7JGMF.min.js +0 -1
- package/dist/c-ITKX3RC5.min.js +0 -1
- package/dist/c-JG2JCQLP.min.js +0 -1
- package/dist/c-LYVKDBQJ.min.js +0 -1
- package/dist/c-NG7BLZTR.min.js +0 -1
- package/dist/c-PYNW54D2.min.js +0 -1
- package/dist/c-TIXX5CAU.min.js +0 -1
- /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;
|
|
@@ -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
|
-
|
|
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>>;
|
|
@@ -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
|
|
18
|
+
export declare function useEnsureXYPlugins(chartType: StreamChartType, customLayout: unknown, dirtyRef: MutableRefObject<boolean>, scheduleRender: () => void, storeRef: RefObject<{
|
|
19
|
+
markStylePaintPending(): void;
|
|
20
|
+
} | null>): void;
|