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,144 @@
1
+ import type { PreparedNetworkAtlas, MotifMatch, EvidenceStatus } from "./types";
2
+ export type CircuitUnit = "records" | "roots" | "attempts";
3
+ export type CircuitMode = "observed-snapshot" | "observed-replay" | "modeled-scenario";
4
+ export type CircuitModuleKind = "stage" | "distributor" | "queue" | "retry" | "join-all" | "selector" | "dependency" | "junction";
5
+ export interface CircuitNodeSemantics {
6
+ nodeId: string;
7
+ label: string;
8
+ unit: CircuitUnit;
9
+ routing?: string;
10
+ queueDiscipline?: "fifo";
11
+ retryPolicy?: string;
12
+ join?: {
13
+ kind: "all" | "first-success";
14
+ memberNodeIds: string[];
15
+ };
16
+ dependencyNodeIds?: string[];
17
+ }
18
+ /** Null is unmeasured. A zero is an admitted observation, never a fallback. */
19
+ export interface CircuitNodeReading {
20
+ arrivals: number | null;
21
+ completions: number | null;
22
+ capacity: number | null;
23
+ queued: number | null;
24
+ status: EvidenceStatus;
25
+ }
26
+ export interface CircuitFlow {
27
+ edgeId: string;
28
+ perSecond: number | null;
29
+ unit: CircuitUnit;
30
+ }
31
+ export interface CircuitTotals {
32
+ arrivals: number | null;
33
+ completions: number | null;
34
+ capacity: number | null;
35
+ queued: number | null;
36
+ roots: number | null;
37
+ attempts: number | null;
38
+ retries: number | null;
39
+ successes: number | null;
40
+ errors: number | null;
41
+ }
42
+ /** An aggregate observation event. No individual service times are implied. */
43
+ export interface CircuitTapeEntry {
44
+ id: string;
45
+ at: number;
46
+ nodes: Record<string, CircuitNodeReading>;
47
+ flows: CircuitFlow[];
48
+ totals: CircuitTotals;
49
+ }
50
+ export interface CircuitEdition {
51
+ id: string;
52
+ synthetic: boolean;
53
+ sourceRevision: string;
54
+ analysisRevision: string;
55
+ kind: "observed" | "modeled";
56
+ label: string;
57
+ unit: CircuitUnit;
58
+ timing: "aggregate-intervals" | "incomplete";
59
+ individualTimings: "unavailable";
60
+ entries: CircuitTapeEntry[];
61
+ assumptions: string[];
62
+ evidenceRefs: string[];
63
+ model?: {
64
+ id: string;
65
+ observedEditionId: string;
66
+ assumptions: Record<string, number | string>;
67
+ guardrails: {
68
+ label: string;
69
+ status: "pass" | "fail" | "unverified";
70
+ detail: string;
71
+ }[];
72
+ };
73
+ }
74
+ export interface CircuitModule {
75
+ id: string;
76
+ nodeId: string;
77
+ kind: CircuitModuleKind;
78
+ semantics: CircuitNodeSemantics;
79
+ /** Capsules own their role node; neighbors remain canonical port references. */
80
+ selectedMatchId?: string;
81
+ relatedMatchIds: string[];
82
+ roles: MotifMatch["roles"];
83
+ ports: {
84
+ edgeId: string;
85
+ direction: "in" | "out";
86
+ endpointId: string;
87
+ }[];
88
+ }
89
+ export interface FlowCircuitProjection {
90
+ atlas: PreparedNetworkAtlas;
91
+ overlapPolicy: "role-priority:id-asc";
92
+ modules: CircuitModule[];
93
+ matches: MotifMatch[];
94
+ order: string[];
95
+ backboneEdgeIds: string[];
96
+ residualEdgeIds: string[];
97
+ }
98
+ export interface CircuitSelection {
99
+ analysisRevision: string;
100
+ nodeId: string;
101
+ relationScopeId: "directed-admitted";
102
+ }
103
+ export interface CircuitReading {
104
+ editionId: string;
105
+ kind: CircuitEdition["kind"];
106
+ mode: CircuitMode;
107
+ requestedTime: number;
108
+ observedAt: number;
109
+ entry: CircuitTapeEntry;
110
+ status: "exact" | "incomplete";
111
+ }
112
+ export interface CircuitBox {
113
+ x: number;
114
+ y: number;
115
+ width: number;
116
+ height: number;
117
+ }
118
+ export interface CircuitModuleRegion extends CircuitBox {
119
+ module: CircuitModule;
120
+ queue: CircuitBox;
121
+ sensor: CircuitBox;
122
+ }
123
+ export interface CircuitRoute {
124
+ edgeId: string;
125
+ source: string;
126
+ target: string;
127
+ residual: boolean;
128
+ points: {
129
+ x: number;
130
+ y: number;
131
+ }[];
132
+ pathD: string;
133
+ }
134
+ export interface CircuitGeometry {
135
+ width: number;
136
+ height: number;
137
+ sections: {
138
+ id: string;
139
+ x: number;
140
+ }[];
141
+ modules: CircuitModuleRegion[];
142
+ routes: CircuitRoute[];
143
+ history: CircuitBox;
144
+ }
@@ -0,0 +1,11 @@
1
+ import type { DisplayForest, NetworkAtlasSource, NetworkAtlasSpec, OriginalEdgeIndex } from "./types";
2
+ export type ForestClassification = {
3
+ forest: DisplayForest;
4
+ residual: OriginalEdgeIndex;
5
+ };
6
+ /**
7
+ * Rooted display backbone. Residual means not chosen for this drawing,
8
+ * not unimportant. Motifs must already have been detected on the full graph.
9
+ */
10
+ export declare function classifyForest(spec: NetworkAtlasSpec, source: NetworkAtlasSource): ForestClassification;
11
+ export declare function assertEdgeCoverage(residual: OriginalEdgeIndex, forest: DisplayForest): void;
@@ -0,0 +1,6 @@
1
+ /** Prototype-safe dictionaries so author ids such as `__proto__` stay data. */
2
+ export declare function hasOwn(record: object, key: string): boolean;
3
+ export declare function ownValue<T>(record: Record<string, T>, key: string): T | undefined;
4
+ export declare function setOwnValue<T>(record: Record<string, T>, key: string, value: T): void;
5
+ export declare function idDictionary<T>(): Record<string, T>;
6
+ export declare function prefixIdFor(path: readonly string[], depth: number): string;
@@ -0,0 +1,26 @@
1
+ export { NETWORK_ATLAS_SCHEMA_VERSION, MOTIF_CATALOG_TEMPLATES, PHASE1_MOTIF_MATCHERS, PHASE2_MOTIF_MATCHERS } from "./types";
2
+ export type { NetworkAtlasSpec, NetworkAtlasSource, PreparedNetworkAtlas, MotifTemplate, QueryResult, PrefixForest } from "./types";
3
+ export { validateAtlas, measuresAreComparable } from "./validate";
4
+ export { buildSections } from "./sections";
5
+ export { buildLedger, ledgerValue } from "./ledger";
6
+ export { matchMotifs } from "./motifs";
7
+ export { classifyForest, assertEdgeCoverage } from "./forests";
8
+ export { buildPrefixForest } from "./prefixForest";
9
+ export { selectCapsules } from "./capsules";
10
+ export { buildComparison, assignedDenominator, signedDifferenceBps } from "./compare";
11
+ export { buildMotifProfile } from "./profile";
12
+ export { prepareNetworkAtlas } from "./prepare";
13
+ export { prepareNetworkAtlasAsync } from "./prepareAsync";
14
+ export type { PrepareResult, PrepareOptions } from "./prepare";
15
+ export { getSectionMeasures, getMotifPrevalence, getMotifWitness, followSupportedRoute, getResidualConnections, uniqueEntityCount } from "./queries";
16
+ export { publishPreparedAtlas } from "./publish";
17
+ export type { AtlasPublicationStore } from "./publish";
18
+ export { prepareMotifBraid, ribbonSupportsRoute } from "./braid";
19
+ export type { MotifBraidProjection, TrajectoryGroup, BraidRibbon, SignedReadout } from "./braid";
20
+ export { motifBraidLayout } from "./motifBraidLayout";
21
+ export type { MotifBraidLayoutConfig } from "./motifBraidLayout";
22
+ export { prepareDependencyForest, dependencyMatrix, getBranchResidualConnections } from "./dependencyForest";
23
+ export { getRequiredPaths, getBypassWitness, getDependencyExclusion } from "./dependencyQueries";
24
+ export { dependencyForestLayout } from "./dependencyForestLayout";
25
+ export type { DependencyForestProjection } from "./dependencyForest";
26
+ export type { DependencySelection, DominatorResult, RequiredPathsSpec } from "./dependencyTypes";
@@ -0,0 +1,7 @@
1
+ import type { LedgerEntry, MeasureLedger, NetworkAtlasSource, NetworkAtlasSpec, SectionIndex } from "./types";
2
+ /**
3
+ * Independent measure ledger. Does not call ProcessSankey inventoryAtTime
4
+ * and does not require inbound mass to equal outbound mass.
5
+ */
6
+ export declare function buildLedger(spec: NetworkAtlasSpec, source: NetworkAtlasSource, sections: SectionIndex): MeasureLedger;
7
+ export declare function ledgerValue(ledger: MeasureLedger, measureId: string, subjectId: string): LedgerEntry | undefined;
@@ -0,0 +1,51 @@
1
+ import type { NetworkCustomChartProps } from "../../charts/custom/NetworkCustomChart";
2
+ import { type AtlasChartOptions } from "./atlasChartOptions";
3
+ import type { PreparedNetworkAtlas } from "./types";
4
+ export type MotifBraidChartProps = AtlasChartOptions & {
5
+ atlas: PreparedNetworkAtlas;
6
+ width?: number;
7
+ height?: number;
8
+ colorScheme?: NetworkCustomChartProps["colorScheme"];
9
+ selection?: NetworkCustomChartProps["selection"];
10
+ onClick?: NetworkCustomChartProps["onClick"];
11
+ annotations?: NetworkCustomChartProps["annotations"];
12
+ frameProps?: NetworkCustomChartProps["frameProps"];
13
+ };
14
+ /** Shared client/static reader contract; atlas analysis precedes rendering. */
15
+ export declare function motifBraidChartProps({ atlas, linkedHover, ...props }: MotifBraidChartProps, braid?: import("./braid").MotifBraidProjection): {
16
+ linkedHover: string | false | {
17
+ name?: string;
18
+ fields: string[];
19
+ mode?: "field" | "x-position" | "series";
20
+ xField?: string;
21
+ seriesField?: string;
22
+ } | undefined;
23
+ title: string;
24
+ description: string;
25
+ summary: string;
26
+ accessibleTable: import("../../stream/accessibleTableTypes").AccessibleTableProp;
27
+ nodes: {
28
+ id: string;
29
+ partition?: string;
30
+ signature?: string;
31
+ }[];
32
+ edges: {
33
+ id: string;
34
+ source: string;
35
+ target: string;
36
+ }[];
37
+ layout: import("../../semiotic-network").NetworkCustomLayout<import("./motifBraidLayout").MotifBraidLayoutConfig>;
38
+ layoutConfig: {
39
+ braid: import("./braid").MotifBraidProjection;
40
+ };
41
+ chartId?: string | undefined;
42
+ onObservation?: import("../../semiotic-ai-observations").OnObservationCallback | undefined;
43
+ className?: string | undefined;
44
+ width?: number;
45
+ height?: number;
46
+ colorScheme?: NetworkCustomChartProps["colorScheme"];
47
+ selection?: NetworkCustomChartProps["selection"];
48
+ onClick?: NetworkCustomChartProps["onClick"];
49
+ annotations?: NetworkCustomChartProps["annotations"];
50
+ frameProps?: NetworkCustomChartProps["frameProps"];
51
+ };
@@ -0,0 +1,5 @@
1
+ import { type TransitDiagramPoint as Point } from "../transitDiagramGeometry";
2
+ /** A filled outline whose width interpolates along the rounded centerline. */
3
+ export declare function taperedBraidPath(points: readonly Point[], startWidth: number, endWidth: number): string;
4
+ /** Allocate stable lanes from peak widths so loss alone never bends a strand. */
5
+ export declare function packBraidLanes(widths: number[]): number[];
@@ -0,0 +1,11 @@
1
+ import type { NetworkCustomLayout } from "../../stream/networkCustomLayout";
2
+ import type { MotifBraidProjection } from "./braid";
3
+ export type MotifBraidLayoutConfig = {
4
+ braid: MotifBraidProjection;
5
+ };
6
+ /**
7
+ * Depth-aligned prefix steps with one labeled square per vertex visit. Each
8
+ * journey keeps its own lane through shared steps and splits only when its
9
+ * prefix diverges. Width interpolates between the two supplied step counts.
10
+ */
11
+ export declare const motifBraidLayout: NetworkCustomLayout<MotifBraidLayoutConfig>;
@@ -0,0 +1,3 @@
1
+ import { type MotifMatch, type MotifMatchIndex, type NetworkAtlasSource, type NetworkAtlasSpec } from "./types";
2
+ export declare function matchMotifs(spec: NetworkAtlasSpec, source: NetworkAtlasSource): MotifMatchIndex;
3
+ export declare function operationalLabel(_match: MotifMatch): undefined;
@@ -0,0 +1,9 @@
1
+ import type { AtlasOccurrence, PrefixForest } from "./types";
2
+ /**
3
+ * Observed prefix forest from admitted journeys. Identifiers are full prefixes,
4
+ * so two groups that share a state name with different histories stay distinct.
5
+ */
6
+ export declare function buildPrefixForest(occurrences: readonly AtlasOccurrence[], options?: {
7
+ referencePartition?: string;
8
+ }): PrefixForest;
9
+ export { prefixIdFor } from "./ids";
@@ -0,0 +1,14 @@
1
+ import type { AtlasIssue, NetworkAtlasSource, NetworkAtlasSpec, PreparedNetworkAtlas } from "./types";
2
+ export type PrepareOptions = {
3
+ generation?: number;
4
+ };
5
+ export type PrepareResult = {
6
+ ok: true;
7
+ atlas: PreparedNetworkAtlas;
8
+ issues: AtlasIssue[];
9
+ } | {
10
+ ok: false;
11
+ atlas?: undefined;
12
+ issues: AtlasIssue[];
13
+ };
14
+ export declare function prepareNetworkAtlas(spec: NetworkAtlasSpec, source: NetworkAtlasSource, options?: PrepareOptions): PrepareResult;
@@ -0,0 +1,7 @@
1
+ import type { MotifBraidProjection } from "./braid";
2
+ import type { NetworkAtlasSource, NetworkAtlasSpec, PreparedNetworkAtlas } from "./types";
3
+ import type { PrepareOptions, PrepareResult } from "./prepare";
4
+ /** Load the atlas analysis kernel on demand before projecting a Motif Braid. */
5
+ export declare function prepareNetworkAtlasAsync(spec: NetworkAtlasSpec, source: NetworkAtlasSource, options?: PrepareOptions): Promise<PrepareResult>;
6
+ /** Load braid analysis on demand; the resulting projection feeds the synchronous layout. */
7
+ export declare function prepareMotifBraid(atlas: PreparedNetworkAtlas): Promise<MotifBraidProjection>;
@@ -0,0 +1,19 @@
1
+ import type { EvidenceStatus, MotifTemplate, PreparedNetworkAtlas } from "./types";
2
+ export type MotifProfileCell = {
3
+ template: MotifTemplate;
4
+ sectionId: string;
5
+ partition?: string;
6
+ completionCount: number;
7
+ intersectionCount: number;
8
+ denominator: number;
9
+ status: EvidenceStatus;
10
+ };
11
+ export type MotifProfileStrip = {
12
+ templates: MotifTemplate[];
13
+ sections: string[];
14
+ cells: MotifProfileCell[];
15
+ };
16
+ export declare function buildMotifProfile(atlas: PreparedNetworkAtlas, options?: {
17
+ templates?: MotifTemplate[];
18
+ partition?: string;
19
+ }): MotifProfileStrip;
@@ -0,0 +1,10 @@
1
+ import type { PreparedNetworkAtlas } from "./types";
2
+ export type AtlasPublicationStore = Map<string, PreparedNetworkAtlas>;
3
+ /**
4
+ * Revision-keyed publisher. An obsolete prepare result cannot overwrite a newer one.
5
+ * This is the data-level contract a later worker must honor.
6
+ */
7
+ export declare function publishPreparedAtlas(store: AtlasPublicationStore, atlas: PreparedNetworkAtlas): {
8
+ published: boolean;
9
+ reason?: string;
10
+ };
@@ -0,0 +1,34 @@
1
+ import type { MotifMatch, MotifTemplate, PreparedNetworkAtlas, QueryResult } from "./types";
2
+ export declare function getSectionMeasures(atlas: PreparedNetworkAtlas, sectionId: string, countingPolicy: {
3
+ measureId: string;
4
+ }): QueryResult<number>;
5
+ export type PrevalenceWindow = {
6
+ kind: "completion";
7
+ sectionId: string;
8
+ } | {
9
+ kind: "intersection";
10
+ sectionId: string;
11
+ };
12
+ export declare function getMotifPrevalence(atlas: PreparedNetworkAtlas, query: {
13
+ template: MotifTemplate;
14
+ window?: PrevalenceWindow;
15
+ }): QueryResult<{
16
+ matchCount: number;
17
+ entityCount: number;
18
+ }>;
19
+ export declare function getMotifWitness(atlas: PreparedNetworkAtlas, matchId: string): QueryResult<MotifMatch>;
20
+ export declare function followSupportedRoute(atlas: PreparedNetworkAtlas, selection: {
21
+ fromNode?: string;
22
+ viaNode?: string;
23
+ route?: string[];
24
+ }): QueryResult<{
25
+ nextNodes: string[];
26
+ supported: boolean;
27
+ graphWalkExists: boolean;
28
+ }>;
29
+ export declare function getResidualConnections(atlas: PreparedNetworkAtlas, nodeId: string): QueryResult<Array<{
30
+ edgeId: string;
31
+ source: string;
32
+ target: string;
33
+ }>>;
34
+ export declare function uniqueEntityCount(atlas: PreparedNetworkAtlas): number;
@@ -0,0 +1,9 @@
1
+ import type { DominatorResult, RequiredPathsSpec } from "./dependencyTypes";
2
+ import type { NetworkAtlasSource } from "./types";
3
+ /**
4
+ * Original-graph immediate dominators, using iterative reverse-postorder
5
+ * intersection (Cooper, Harvey and Kennedy). Multiple declared roots connect
6
+ * to a private numeric sentinel; it is never a canonical node or factual edge.
7
+ * Algorithm reference: https://hdl.handle.net/1911/96345
8
+ */
9
+ export declare function buildRequiredPaths(source: NetworkAtlasSource, spec: RequiredPathsSpec): DominatorResult;
@@ -0,0 +1,4 @@
1
+ import type { NetworkAtlasSource } from "./types";
2
+ import type { ForestClassification } from "./forests";
3
+ /** Select actual edges by root-aware traversal, retaining every other edge. */
4
+ export declare function buildRootedForest(source: NetworkAtlasSource, roots: readonly string[], rankingPolicyId?: string): ForestClassification;
@@ -0,0 +1,3 @@
1
+ import type { NetworkAtlasSource, NetworkAtlasSpec, SectionIndex } from "./types";
2
+ /** Disjoint ordinal bands from declared stages. Membership is data, not a lens. */
3
+ export declare function buildSections(spec: NetworkAtlasSpec, source: NetworkAtlasSource): SectionIndex;
@@ -0,0 +1,7 @@
1
+ import type { NetworkAtlasSource, RouteSupportIndex } from "./types";
2
+ /** Whether an observed path contains every route hop consecutively. */
3
+ export declare function containsRoute(path: readonly string[], route: readonly string[]): boolean;
4
+ export declare function buildRouteSupportIndex(source: NetworkAtlasSource): RouteSupportIndex;
5
+ export declare function graphWalkExists(source: NetworkAtlasSource, route: readonly string[]): boolean;
6
+ export declare function isSupportedRoute(source: NetworkAtlasSource, route: readonly string[]): boolean;
7
+ export declare function nextSupportedNodes(source: NetworkAtlasSource, fromNode: string, viaNode?: string): string[];