semiotic 3.12.0 → 3.12.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 +50 -46
- package/ai/artifact-surface-inventory.json +1 -1
- package/ai/behaviorContracts.cjs +1 -1
- package/ai/dist/diagnose-operation.js +3 -3
- package/ai/dist/mcp-server.js +1 -1
- package/ai/reference.md +15 -3
- package/ai/schema.json +908 -96
- package/ai/surface-manifest.json +1 -1
- package/ai/task-packets/compare-category-totals.json +5 -5
- package/ai/task-packets/compare-category-totals.md +2 -2
- package/ai/task-packets/correct-published-chart.json +5 -5
- package/ai/task-packets/correct-published-chart.md +2 -2
- package/ai/task-packets/index.json +6 -6
- package/ai/task-packets/update-live-chart.json +5 -5
- package/ai/task-packets/update-live-chart.md +2 -2
- package/dist/c-27DCB5T6.min.js +7 -7
- package/dist/c-2CKIGFD2.min.js +1 -1
- package/dist/c-3FATLOH4.min.js +1 -0
- package/dist/{c-STVM6CBI.min.js → c-4SCJKAWZ.min.js} +200 -200
- package/dist/c-5FUOKMH6.min.js +7 -0
- package/dist/c-AAIPWVQ5.min.js +6 -6
- package/dist/{c-2RG4WOVX.min.js → c-ALLF3Y77.min.js} +1 -1
- package/dist/{c-QMKQVCCZ.min.js → c-C5GXUHUO.min.js} +6 -6
- package/dist/c-C67QDKTU.min.js +34 -0
- package/dist/c-F76M77YC.min.js +1 -0
- package/dist/c-FEVXPKQH.min.js +1 -1
- package/dist/c-G42WVQO2.min.js +1 -0
- package/dist/c-G5A3YWTN.min.js +66 -0
- package/dist/c-H4HVKBU3.min.js +1 -0
- package/dist/c-HU3ASFKT.min.js +1 -0
- package/dist/c-I4FYCVJB.min.js +391 -0
- package/dist/{c-5L7JGWQW.min.js → c-IATPZOL7.min.js} +28 -28
- package/dist/c-IE5EBBP6.min.js +110 -0
- package/dist/c-IGONIKZL.min.js +1 -0
- package/dist/c-IKPM53JH.min.js +1 -0
- package/dist/c-IU4QZ7Y5.min.js +1 -1
- package/dist/{c-2ACLVPKF.min.js → c-K5VE57OI.min.js} +1 -1
- package/dist/c-KWJIBJ4R.min.js +1 -0
- package/dist/c-LIMFU6RD.min.js +1 -0
- package/dist/c-M4T43G76.min.js +1 -0
- package/dist/c-M7QUZZCE.min.js +1 -1
- package/dist/c-NVSINXE5.min.js +1 -0
- package/dist/{c-FAF6EV4E.min.js → c-NWRYV6ZF.min.js} +1 -1
- package/dist/c-O5GU2R5W.min.js +1 -0
- package/dist/c-OC7GNXGZ.min.js +1 -0
- package/dist/c-OV5F3DQP.min.js +1 -0
- package/dist/{c-5TAXHW7I.min.js → c-PJ5CAYAW.min.js} +1 -1
- package/dist/c-Q5LZRQGD.min.js +1 -0
- package/dist/c-QP3PXK3N.min.js +1 -0
- package/dist/c-SGZ7ZD2I.min.js +51 -0
- package/dist/c-SSKV5JPW.min.js +1 -1
- package/dist/c-THWTHWXU.min.js +37 -0
- package/dist/c-TRMNDRC4.min.js +41 -0
- package/dist/c-UP656CST.min.js +1 -1
- package/dist/c-USYOK5OX.min.js +1 -0
- package/dist/c-VI753KBO.min.js +1 -0
- package/dist/{c-TT4CTEBR.min.js → c-VLAAAFST.min.js} +1 -1
- package/dist/c-VSOQPII4.min.js +5 -5
- package/dist/c-WGDM4ZRP.min.js +26 -0
- package/dist/c-XCV7VUU3.min.js +87 -0
- package/dist/c-XGDZPYBI.min.js +1 -0
- package/dist/c-XI6CLZII.min.js +1 -0
- package/dist/{c-L4Q2YMXO.min.js → c-XLC7PKM7.min.js} +1 -1
- package/dist/{c-3YAGKCPU.min.js → c-YEB6Z35F.min.js} +1 -1
- package/dist/c-YWZBFG63.min.js +1 -0
- package/dist/c-ZMYO3NZU.min.js +2 -0
- package/dist/c-ZO36H5VH.min.js +48 -0
- package/dist/components/LinkedCharts.d.ts +6 -1
- package/dist/components/Tooltip/Tooltip.d.ts +11 -1
- package/dist/components/Tooltip/tooltipChrome.d.ts +8 -2
- package/dist/components/bundling/semioticVite.d.ts +24 -0
- package/dist/components/charts/physics/cruciblePhysics.d.ts +2 -2
- package/dist/components/charts/physics/gauntletPhysics.d.ts +2 -6
- package/dist/components/charts/physics/physicsHocUtils.d.ts +8 -1
- package/dist/components/charts/realtime/RealtimeHistogram.d.ts +2 -0
- package/dist/components/charts/shared/chartSize.d.ts +58 -0
- package/dist/components/charts/shared/chartSizeDefaults.d.ts +189 -0
- package/dist/components/charts/shared/chartSizeDefaultsAtlas.d.ts +9 -0
- package/dist/components/charts/shared/chartSizeDefaultsNetwork.d.ts +29 -0
- package/dist/components/charts/shared/chartSizeDefaultsOrdinal.d.ts +13 -0
- package/dist/components/charts/shared/chartSizeDefaultsPhysics.d.ts +41 -0
- package/dist/components/charts/shared/chartSizeDefaultsValue.d.ts +19 -0
- package/dist/components/charts/shared/chartSizeDefaultsXY.d.ts +10 -0
- package/dist/components/charts/shared/networkPerspectiveWireSchema.d.ts +3 -0
- package/dist/components/charts/shared/useChartSetup.d.ts +3 -0
- package/dist/components/charts/shared/useCustomChartSetup.d.ts +4 -0
- package/dist/components/charts/shared/useNetworkChartSetup.d.ts +2 -0
- package/dist/components/charts/shared/withChartWrapper.d.ts +6 -2
- package/dist/components/charts/value/BigNumber.d.ts +0 -8
- package/dist/components/charts/xy/minimapLayout.d.ts +10 -0
- package/dist/components/realtime/BinAccumulator.d.ts +5 -2
- package/dist/components/recipes/atlas/dependencyForestChartProps.d.ts +4 -4
- package/dist/components/recipes/atlas/flowCircuitChartProps.d.ts +177 -1
- package/dist/components/recipes/atlas/flowCircuitLayout.d.ts +3 -0
- package/dist/components/recipes/atlas/motifBraidChartProps.d.ts +2 -0
- package/dist/components/recipes/atlas/resolution/BoundaryLoomChart.d.ts +3 -0
- package/dist/components/recipes/atlas/resolution/ComponentCutaway.d.ts +16 -0
- package/dist/components/recipes/atlas/resolution/ResolutionAtlasChart.d.ts +3 -0
- package/dist/components/recipes/atlas/resolution/ResolutionGlyphs.d.ts +15 -0
- package/dist/components/recipes/atlas/resolution/ResolutionReader.d.ts +5 -0
- package/dist/components/recipes/atlas/resolution/appearance.d.ts +58 -0
- package/dist/components/recipes/atlas/resolution/boundaryLoomLayout.d.ts +4 -0
- package/dist/components/recipes/atlas/resolution/chartProps.d.ts +75 -0
- package/dist/components/recipes/atlas/resolution/componentCutawayLayout.d.ts +12 -0
- package/dist/components/recipes/atlas/resolution/cutawayContext.d.ts +23 -0
- package/dist/components/recipes/atlas/resolution/cutawayGraph.d.ts +4 -0
- package/dist/components/recipes/atlas/resolution/cycles.d.ts +7 -0
- package/dist/components/recipes/atlas/resolution/evidence.d.ts +43 -0
- package/dist/components/recipes/atlas/resolution/glyphs.d.ts +40 -0
- package/dist/components/recipes/atlas/resolution/identity.d.ts +4 -0
- package/dist/components/recipes/atlas/resolution/indexGraph.d.ts +32 -0
- package/dist/components/recipes/atlas/resolution/ownership.d.ts +25 -0
- package/dist/components/recipes/atlas/resolution/plan.d.ts +12 -0
- package/dist/components/recipes/atlas/resolution/ports.d.ts +44 -0
- package/dist/components/recipes/atlas/resolution/prepare.d.ts +4 -0
- package/dist/components/recipes/atlas/resolution/project.d.ts +70 -0
- package/dist/components/recipes/atlas/resolution/queries.d.ts +23 -0
- package/dist/components/recipes/atlas/resolution/resolutionAtlasLayout.d.ts +9 -0
- package/dist/components/recipes/atlas/resolution/rules.d.ts +14 -0
- package/dist/components/recipes/atlas/resolution/scene.d.ts +52 -0
- package/dist/components/recipes/atlas/resolution/selection.d.ts +3 -0
- package/dist/components/recipes/atlas/resolution/sets.d.ts +10 -0
- package/dist/components/recipes/atlas/resolution/types.d.ts +401 -0
- package/dist/components/recipes/atlas/resolution/validate.d.ts +4 -0
- package/dist/components/recipes/atlas/resolution/witnesses.d.ts +18 -0
- package/dist/components/recipes/atlas/resolution/worker.d.ts +34 -0
- package/dist/components/recipes/lineageDag.d.ts +4 -0
- package/dist/components/recipes/recipeUtils.d.ts +2 -0
- package/dist/components/recipes/transitDiagram.d.ts +2 -61
- package/dist/components/recipes/transitDiagramTypes.d.ts +65 -0
- package/dist/components/semiotic-ai.d.ts +2 -0
- package/dist/components/semiotic-experimental-network-resolution-react.d.ts +12 -0
- package/dist/components/semiotic-experimental-network-resolution.d.ts +13 -0
- package/dist/components/semiotic-geo.d.ts +1 -1
- package/dist/components/semiotic-network-perspective-core.d.ts +6 -0
- package/dist/components/semiotic-network.d.ts +1 -1
- package/dist/components/semiotic-ordinal.d.ts +1 -1
- package/dist/components/semiotic-physics.d.ts +1 -1
- package/dist/components/semiotic-realtime-core.d.ts +1 -1
- package/dist/components/semiotic-realtime-react.d.ts +2 -0
- package/dist/components/semiotic-utils-core.d.ts +3 -1
- package/dist/components/semiotic-vite.d.ts +2 -0
- package/dist/components/semiotic-xy.d.ts +3 -1
- package/dist/components/semiotic.d.ts +3 -1
- package/dist/components/server/renderToStaticSVG.d.ts +2 -1
- package/dist/components/server/serverChartConfigShared.d.ts +2 -0
- package/dist/components/store/LinkedCrosshairStore.d.ts +43 -11
- package/dist/components/store/themeCore.d.ts +2 -0
- package/dist/components/stream/frameKeyboardNavigation.d.ts +3 -1
- package/dist/components/stream/hoverUtils.d.ts +5 -0
- package/dist/components/stream/networkCustomLayout.d.ts +3 -0
- package/dist/components/stream/networkPerspective.d.ts +2 -0
- package/dist/components/stream/networkPerspectiveFit.d.ts +12 -1
- package/dist/components/stream/networkPerspectiveSolid.d.ts +1 -1
- package/dist/components/stream/networkSceneTypes.d.ts +4 -0
- package/dist/components/stream/networkTypes.d.ts +2 -0
- package/dist/components/stream/pipelineConfig.d.ts +2 -0
- package/dist/components/stream/pipelineDomainResolution.d.ts +4 -1
- package/dist/components/stream/types.d.ts +2 -0
- package/dist/components/stream/useFrame.d.ts +2 -0
- package/dist/components/stream/xySceneBuilders/types.d.ts +2 -0
- package/dist/controls.module.min.js +31 -31
- package/dist/geo.min.js +150 -150
- package/dist/geo.module.min.js +31 -31
- 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-ai-core.min.js +1 -1
- package/dist/semiotic-ai-core.module.min.js +1 -1
- package/dist/semiotic-ai.d.ts +2 -0
- package/dist/semiotic-ai.module.min.js +13 -13
- package/dist/semiotic-artifact-react.module.min.js +4 -4
- package/dist/semiotic-artifact.min.js +1 -1
- package/dist/semiotic-artifact.module.min.js +1 -1
- package/dist/semiotic-atlas-selection.module.min.js +1 -1
- package/dist/semiotic-atlas.module.min.js +10 -12
- package/dist/semiotic-client-cjs-shared.min.js +1078 -925
- package/dist/semiotic-client-glyph.module.min.js +2 -2
- package/dist/semiotic-client-shared.module.min.js +1 -1
- package/dist/semiotic-experimental-auxiliary.module.min.js +8 -9
- package/dist/semiotic-experimental-network-resolution-react.d.ts +12 -0
- package/dist/semiotic-experimental-network-resolution-react.min.js +2 -0
- package/dist/semiotic-experimental-network-resolution-react.module.min.js +89 -0
- package/dist/semiotic-experimental-network-resolution.d.ts +13 -0
- package/dist/semiotic-experimental-network-resolution.min.js +2 -0
- package/dist/semiotic-experimental-network-resolution.module.min.js +2 -0
- package/dist/semiotic-experimental-node-auxiliary.module.min.js +9 -10
- package/dist/semiotic-geo.d.ts +1 -1
- package/dist/semiotic-line.module.min.js +1 -1
- package/dist/semiotic-network-perspective-core.d.ts +6 -0
- package/dist/semiotic-network-perspective-core.min.js +1 -0
- package/dist/semiotic-network-perspective-core.module.min.js +1 -0
- package/dist/semiotic-network-perspective.module.min.js +1 -1
- package/dist/semiotic-network-placement.min.js +4 -0
- package/dist/semiotic-network-placement.module.min.js +4 -0
- package/dist/semiotic-network-zoom.module.min.js +1 -1
- package/dist/semiotic-network.d.ts +1 -1
- package/dist/semiotic-ordinal.d.ts +1 -1
- package/dist/semiotic-physics.d.ts +1 -1
- package/dist/semiotic-realtime-core.d.ts +1 -1
- package/dist/semiotic-realtime-core.module.min.js +1 -1
- package/dist/semiotic-realtime-react.d.ts +2 -0
- package/dist/semiotic-realtime-react.module.min.js +1 -1
- package/dist/semiotic-recipes-core-cjs-base.min.js +101 -106
- package/dist/semiotic-recipes-core.module.min.js +75 -76
- package/dist/semiotic-server-edge-node.module.min.js +391 -392
- package/dist/semiotic-server-edge.min.js +387 -388
- package/dist/semiotic-server-edge.module.min.js +371 -371
- package/dist/semiotic-server-node.min.js +387 -388
- package/dist/semiotic-server-node.module.min.js +1 -1
- package/dist/semiotic-utils-core.d.ts +3 -1
- package/dist/semiotic-utils-core.min.js +12 -11
- package/dist/semiotic-utils-core.module.min.js +12 -11
- package/dist/semiotic-value.module.min.js +4 -4
- package/dist/semiotic-vite.d.ts +2 -0
- package/dist/semiotic-vite.min.js +1 -0
- package/dist/semiotic-vite.module.min.js +1 -0
- package/dist/semiotic-xy.d.ts +3 -1
- package/dist/semiotic.d.ts +3 -1
- package/dist/semiotic.module.min.js +12 -12
- package/dist/server.min.js +387 -388
- package/dist/server.module.min.js +1 -1
- package/dist/xy.module.min.js +1 -1
- package/package.json +42 -13
- package/dist/c-2AB65V3L.min.js +0 -1
- package/dist/c-2U5JMOPN.min.js +0 -88
- package/dist/c-3DCTIRW4.min.js +0 -1
- package/dist/c-3OKFRTYM.min.js +0 -1
- package/dist/c-3VZHOPFW.min.js +0 -1
- package/dist/c-4ZSQIBC7.min.js +0 -1
- package/dist/c-5M4RUS7V.min.js +0 -34
- package/dist/c-6O5WWP7F.min.js +0 -1
- package/dist/c-73TOIYIW.min.js +0 -48
- package/dist/c-AE4M7BWH.min.js +0 -1
- package/dist/c-AEIK2NFW.min.js +0 -30
- package/dist/c-AFQSEIZ4.min.js +0 -4
- package/dist/c-BBX7DVVB.min.js +0 -51
- package/dist/c-CNYFCSG4.min.js +0 -5
- package/dist/c-E6QH2WYE.min.js +0 -1
- package/dist/c-GOMQWQJR.min.js +0 -1
- package/dist/c-GTYG4PDT.min.js +0 -1
- package/dist/c-H23GIKTK.min.js +0 -1
- package/dist/c-HQLUUSRJ.min.js +0 -1
- package/dist/c-HXUOFDSD.min.js +0 -64
- package/dist/c-L3LKYOLK.min.js +0 -1
- package/dist/c-MIKDFGKH.min.js +0 -1
- package/dist/c-OYSPTIAG.min.js +0 -1
- package/dist/c-PWPJNYQP.min.js +0 -1
- package/dist/c-QZ5SWKHC.min.js +0 -392
- package/dist/c-RXJH4IRX.min.js +0 -41
- package/dist/c-SN2D6QMH.min.js +0 -1
- package/dist/c-U5YGK6HL.min.js +0 -1
- package/dist/c-VIN5ASK2.min.js +0 -37
- package/dist/c-XZ3GASUJ.min.js +0 -1
- package/dist/c-ZLZZTH4I.min.js +0 -118
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { PortPathQuery, PortPathResult, PreparedNetworkResolution } from "./types";
|
|
2
|
+
/** Query real component endpoints. Quotient adjacency is never used as path evidence. */
|
|
3
|
+
export declare function traceComponentPort(resolution: PreparedNetworkResolution, query: PortPathQuery): PortPathResult;
|
|
4
|
+
/** Lazy, bounded exact cells; a blank/unqueried cell is explicitly unknown. */
|
|
5
|
+
export declare function projectComponentCutaway(resolution: PreparedNetworkResolution, pageId: string, groupId: string, options?: {
|
|
6
|
+
basis?: "structural" | "observed";
|
|
7
|
+
continuation?: "inside-only" | "boundary-context";
|
|
8
|
+
/** Zero-based matrix tile, traversing egress pages before ingress pages. */
|
|
9
|
+
offset?: number;
|
|
10
|
+
limit?: number;
|
|
11
|
+
query?: boolean;
|
|
12
|
+
}): import("./types").QueryEnvelope<{
|
|
13
|
+
context: {
|
|
14
|
+
label: string;
|
|
15
|
+
nodeCount: number;
|
|
16
|
+
internalCycleRank: number;
|
|
17
|
+
nodes: {
|
|
18
|
+
id: string;
|
|
19
|
+
sourceSet: import("./types").SetRef;
|
|
20
|
+
inside: boolean;
|
|
21
|
+
entry: boolean;
|
|
22
|
+
exit: boolean;
|
|
23
|
+
}[];
|
|
24
|
+
edges: {
|
|
25
|
+
id: string;
|
|
26
|
+
sourceSet: import("./types").SetRef;
|
|
27
|
+
source: string;
|
|
28
|
+
target: string;
|
|
29
|
+
internal: boolean;
|
|
30
|
+
}[];
|
|
31
|
+
totalNodes: number;
|
|
32
|
+
totalEdges: number;
|
|
33
|
+
};
|
|
34
|
+
ingress: import("./types").BoundaryPort[];
|
|
35
|
+
egress: import("./types").BoundaryPort[];
|
|
36
|
+
cells: {
|
|
37
|
+
query: PortPathQuery;
|
|
38
|
+
result: PortPathResult;
|
|
39
|
+
}[];
|
|
40
|
+
totalPairs: number;
|
|
41
|
+
pageCount: number;
|
|
42
|
+
queriedPairs: number;
|
|
43
|
+
supportedPairs: number;
|
|
44
|
+
}>;
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { PreparedNetworkAtlas } from "../types";
|
|
2
|
+
import type { PrepareResult, ResolutionBindings, ResolutionSpec } from "./types";
|
|
3
|
+
/** Prepare a coherent, serializable sidecar without changing the atlas or doing layout. */
|
|
4
|
+
export declare function prepareNetworkResolution(atlas: PreparedNetworkAtlas, spec: ResolutionSpec, bindings?: ResolutionBindings): PrepareResult;
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
import type { CanonicalSelection, EdgeHistory, PreparedNetworkResolution, ResolutionPage, ResolutionViewSpec, SemanticTarget } from "./types";
|
|
2
|
+
export interface ResolutionMark {
|
|
3
|
+
/** Ownership on the page represented by this mark, when applicable. */
|
|
4
|
+
connectionType?: "internal" | "boundary";
|
|
5
|
+
id: string;
|
|
6
|
+
target: SemanticTarget;
|
|
7
|
+
description: string;
|
|
8
|
+
label: string;
|
|
9
|
+
nodeIds: string[];
|
|
10
|
+
edgeIds: string[];
|
|
11
|
+
selection: CanonicalSelection;
|
|
12
|
+
}
|
|
13
|
+
export interface ProjectedGroup extends ResolutionMark {
|
|
14
|
+
pageId: string;
|
|
15
|
+
groupId: string;
|
|
16
|
+
rows: number[];
|
|
17
|
+
internalEdges: number;
|
|
18
|
+
boundaryEdges: number;
|
|
19
|
+
kind: string;
|
|
20
|
+
labelPortals: string[];
|
|
21
|
+
}
|
|
22
|
+
export interface ProjectedEdge extends ResolutionMark {
|
|
23
|
+
source: string;
|
|
24
|
+
targetNode: string;
|
|
25
|
+
history: EdgeHistory;
|
|
26
|
+
subdued: boolean;
|
|
27
|
+
subduedPageIds: string[];
|
|
28
|
+
}
|
|
29
|
+
export interface ResolutionProjection {
|
|
30
|
+
/** Full analysis domain, retained when only some generations are displayed. */
|
|
31
|
+
generationCount: number;
|
|
32
|
+
analysisRevision: string;
|
|
33
|
+
revision: PreparedNetworkResolution["revision"];
|
|
34
|
+
mode: ResolutionViewSpec["mode"];
|
|
35
|
+
view: ResolutionViewSpec;
|
|
36
|
+
pages: ResolutionPage[];
|
|
37
|
+
rowOrder: string[];
|
|
38
|
+
sections: {
|
|
39
|
+
nodeId: string;
|
|
40
|
+
sectionId: string;
|
|
41
|
+
}[];
|
|
42
|
+
groups: ProjectedGroup[];
|
|
43
|
+
edges: ProjectedEdge[];
|
|
44
|
+
memberships: (ResolutionMark & {
|
|
45
|
+
fromPageId: string;
|
|
46
|
+
toPageId: string;
|
|
47
|
+
fromGroupId: string;
|
|
48
|
+
toGroupId: string;
|
|
49
|
+
})[];
|
|
50
|
+
disclosure: {
|
|
51
|
+
totalGroups: number;
|
|
52
|
+
displayedGroups: number;
|
|
53
|
+
totalEdges: number;
|
|
54
|
+
displayedEdges: number;
|
|
55
|
+
totalRails: number;
|
|
56
|
+
displayedRails: number;
|
|
57
|
+
};
|
|
58
|
+
caption: string;
|
|
59
|
+
edgeCoverageByPage: {
|
|
60
|
+
pageId: string;
|
|
61
|
+
literalEdgeIds: string[];
|
|
62
|
+
componentEdgeIds: string[];
|
|
63
|
+
omittedEdgeIds: string[];
|
|
64
|
+
}[];
|
|
65
|
+
}
|
|
66
|
+
/** One reference leaf order for the whole sequence. Section order remains ordinal. */
|
|
67
|
+
export declare function resolutionRowOrder(resolution: PreparedNetworkResolution): string[];
|
|
68
|
+
export declare function defaultResolutionView(resolution: PreparedNetworkResolution, mode: ResolutionViewSpec["mode"]): ResolutionViewSpec;
|
|
69
|
+
/** Display budgets limit projection only. Prepared pages, source counts and queries remain intact. */
|
|
70
|
+
export declare function projectResolutionView(resolution: PreparedNetworkResolution, view: ResolutionViewSpec): ResolutionProjection;
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import type { EdgeHistory, PreparedNetworkResolution, QueryEnvelope, SetRef } from "./types";
|
|
2
|
+
export declare function envelope<T>(resolution: PreparedNetworkResolution, value: T): QueryEnvelope<T>;
|
|
3
|
+
export declare function expandSourceSet(resolution: PreparedNetworkResolution, ref: SetRef, cursor?: number, limit?: number): QueryEnvelope<{
|
|
4
|
+
ids: string[];
|
|
5
|
+
total: number;
|
|
6
|
+
nextCursor: number | null;
|
|
7
|
+
}>;
|
|
8
|
+
export declare function getEdgeHistory(resolution: PreparedNetworkResolution, edgeId: string): QueryEnvelope<EdgeHistory>;
|
|
9
|
+
export declare function getCycleLedger(resolution: PreparedNetworkResolution, pageId: string): QueryEnvelope<import("./types").CycleLedger>;
|
|
10
|
+
export declare function explainGroup(resolution: PreparedNetworkResolution, pageId: string, groupId: string): QueryEnvelope<{
|
|
11
|
+
group: import("./types").ResolutionGroup;
|
|
12
|
+
events: import("./types").ResolutionEvent[];
|
|
13
|
+
ports: import("./types").BoundaryPort[];
|
|
14
|
+
}>;
|
|
15
|
+
export declare function listBoundaryEdges(resolution: PreparedNetworkResolution, pageId: string, groupId: string, cursor?: number, limit?: number): QueryEnvelope<{
|
|
16
|
+
edges: {
|
|
17
|
+
id: string;
|
|
18
|
+
source: string;
|
|
19
|
+
target: string;
|
|
20
|
+
}[];
|
|
21
|
+
total: number;
|
|
22
|
+
nextCursor: number | null;
|
|
23
|
+
}>;
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type { NetworkCustomLayout } from "../../../stream/networkCustomLayout";
|
|
2
|
+
import type { ResolutionAppearance } from "./appearance";
|
|
3
|
+
import type { ResolutionProjection } from "./project";
|
|
4
|
+
export interface ResolutionLayoutConfig {
|
|
5
|
+
projection: ResolutionProjection;
|
|
6
|
+
appearance?: ResolutionAppearance;
|
|
7
|
+
}
|
|
8
|
+
/** Fixed source rows, within-page graph edges, separate membership gutters and cycle accounts. */
|
|
9
|
+
export declare const resolutionAtlasLayout: NetworkCustomLayout<ResolutionLayoutConfig>;
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { GraphIndex } from "./indexGraph";
|
|
2
|
+
import type { ResolutionBindings, ResolutionGroup, ResolutionSpec, RuleSpec } from "./types";
|
|
3
|
+
export interface Candidate {
|
|
4
|
+
key: string;
|
|
5
|
+
kind: Exclude<ResolutionGroup["kind"], "singleton">;
|
|
6
|
+
label: string;
|
|
7
|
+
members: string[];
|
|
8
|
+
roles: Record<string, string[]>;
|
|
9
|
+
supplied: boolean;
|
|
10
|
+
authoredId?: string;
|
|
11
|
+
}
|
|
12
|
+
/** Source features are independent of the current partition and capsule packing. */
|
|
13
|
+
export declare function ruleCandidateBatches(graph: GraphIndex, rule: RuleSpec, spec: ResolutionSpec, bindings: ResolutionBindings): Candidate[][];
|
|
14
|
+
export declare function authoredSignature(node: string, spec: ResolutionSpec, bindings: ResolutionBindings): string;
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
import type { NetworkLayoutContext, NetworkLayoutResult } from "../../../stream/networkCustomLayout";
|
|
2
|
+
import type { NetworkSceneNode, NetworkSceneEdge, NetworkLabel } from "../../../stream/networkTypes";
|
|
3
|
+
import type { ResolutionMark } from "./project";
|
|
4
|
+
import { type ResolutionAppearance, type ResolutionMarkRole } from "./appearance";
|
|
5
|
+
import type { Style } from "../../../stream/types";
|
|
6
|
+
export declare function markDatum(mark: ResolutionMark): {
|
|
7
|
+
sourceRevision: string;
|
|
8
|
+
analysisRevision: string;
|
|
9
|
+
nodeId?: string | undefined;
|
|
10
|
+
connectionType?: "boundary" | "internal" | undefined;
|
|
11
|
+
id: string;
|
|
12
|
+
semanticTarget: import("./types").SemanticTarget;
|
|
13
|
+
canonicalSelection: import("./types").CanonicalSelection;
|
|
14
|
+
description: string;
|
|
15
|
+
label: string;
|
|
16
|
+
nodeIds: string[];
|
|
17
|
+
edgeIds: string[];
|
|
18
|
+
kind: "annotation" | "group" | "membership" | "bundle" | "original-node" | "original-edge" | "port" | "support-cell";
|
|
19
|
+
};
|
|
20
|
+
export declare function sceneBuilder(theme: NetworkLayoutContext["theme"], appearance?: ResolutionAppearance, generationCount?: number): {
|
|
21
|
+
sceneNodes: NetworkSceneNode[];
|
|
22
|
+
sceneEdges: NetworkSceneEdge[];
|
|
23
|
+
labels: NetworkLabel[];
|
|
24
|
+
rect(mark: ResolutionMark, x: number, y: number, w: number, h: number, fill?: string | undefined, stroke?: string | undefined, role?: ResolutionMarkRole, generation?: number, strokeWidth?: number): void;
|
|
25
|
+
circle(mark: ResolutionMark, x: number, y: number, r?: number, fill?: string | undefined): void;
|
|
26
|
+
path(mark: ResolutionMark, pathD: string, color?: string | undefined, width?: number, opacity?: number, role?: ResolutionMarkRole): void;
|
|
27
|
+
label(x: number, y: number, text: string, anchor?: "start" | "middle" | "end", size?: number, onComponent?: boolean): void;
|
|
28
|
+
result(): NetworkLayoutResult;
|
|
29
|
+
colors: {
|
|
30
|
+
primary?: string;
|
|
31
|
+
secondary?: string;
|
|
32
|
+
success?: string;
|
|
33
|
+
danger?: string;
|
|
34
|
+
warning?: string;
|
|
35
|
+
error?: string;
|
|
36
|
+
info?: string;
|
|
37
|
+
text?: string;
|
|
38
|
+
textSecondary?: string;
|
|
39
|
+
border?: string;
|
|
40
|
+
grid?: string;
|
|
41
|
+
surface?: string;
|
|
42
|
+
};
|
|
43
|
+
edgeColors: {
|
|
44
|
+
internal: string;
|
|
45
|
+
boundary: string;
|
|
46
|
+
};
|
|
47
|
+
generationColor: (generation: number) => string;
|
|
48
|
+
style: (context: Omit<import("./appearance").ResolutionStyleContext, "theme">, base: Style) => Style;
|
|
49
|
+
labelStyle: Partial<Pick<NetworkLabel, "fill" | "stroke" | "fontSize" | "strokeWidth" | "fontWeight" | "paintOrder">> | undefined;
|
|
50
|
+
dimmedOpacity: number;
|
|
51
|
+
};
|
|
52
|
+
export declare function shortLabel(text: string, max?: number): string;
|
|
@@ -0,0 +1,3 @@
|
|
|
1
|
+
import type { CanonicalSelection, PreparedNetworkResolution } from "./types";
|
|
2
|
+
/** Explicit adapter to the existing atlas selection store; stale identities never broaden. */
|
|
3
|
+
export declare function resolutionSelectionFields(resolution: PreparedNetworkResolution, selection: CanonicalSelection): Record<string, string[]> | null;
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
import type { Domain, SetRef, SourceSet } from "./types";
|
|
2
|
+
/** Deduplicated JSON set store. Ancestors reference children instead of copying leaves. */
|
|
3
|
+
export declare class SourceSetStore {
|
|
4
|
+
private sets;
|
|
5
|
+
add(domain: Domain, ids: Iterable<string>): SetRef;
|
|
6
|
+
union(domain: Domain, inputs: SetRef[]): SetRef;
|
|
7
|
+
values(): SourceSet[];
|
|
8
|
+
}
|
|
9
|
+
/** Expand a validated store iteratively; reject malformed codecs, cycles and domain aliases. */
|
|
10
|
+
export declare function sourceSetValues(sets: readonly SourceSet[], ref: SetRef): string[];
|
|
@@ -0,0 +1,401 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Experimental Network Resolution sidecar, schema 0.1.
|
|
3
|
+
* NR0–NR4 contracts, available through the opt-in experimental entry point.
|
|
4
|
+
* JSON-facing fields contain no functions, class instances, Maps, or Sets.
|
|
5
|
+
*/
|
|
6
|
+
import type { AtlasOccurrence } from "../types";
|
|
7
|
+
export type Id = string;
|
|
8
|
+
export type PageId = Id;
|
|
9
|
+
export type GroupId = Id;
|
|
10
|
+
export type EdgeId = Id;
|
|
11
|
+
export type NodeId = Id;
|
|
12
|
+
export type Json = null | boolean | number | string | Json[] | {
|
|
13
|
+
[key: string]: Json;
|
|
14
|
+
};
|
|
15
|
+
export type Domain = "node" | "edge" | "occurrence" | "feature";
|
|
16
|
+
export type Basis = "structural" | "observed";
|
|
17
|
+
export interface SetRef {
|
|
18
|
+
id: Id;
|
|
19
|
+
domain: Domain;
|
|
20
|
+
}
|
|
21
|
+
export type SourceSet = {
|
|
22
|
+
ref: SetRef;
|
|
23
|
+
codec: "sorted-string-ids/v1";
|
|
24
|
+
values: Id[];
|
|
25
|
+
} | {
|
|
26
|
+
ref: SetRef;
|
|
27
|
+
codec: "set-union/v1";
|
|
28
|
+
refs: SetRef[];
|
|
29
|
+
};
|
|
30
|
+
export interface RevisionRef {
|
|
31
|
+
graphRef: string;
|
|
32
|
+
sourceRevision: string;
|
|
33
|
+
atlasAnalysisRevision: string;
|
|
34
|
+
evidencePolicyId: string;
|
|
35
|
+
}
|
|
36
|
+
export interface Issue {
|
|
37
|
+
code: string;
|
|
38
|
+
severity: "fatal" | "warning" | "info";
|
|
39
|
+
message: string;
|
|
40
|
+
subjectIds: Id[];
|
|
41
|
+
}
|
|
42
|
+
export interface Coverage {
|
|
43
|
+
status: "complete" | "incomplete" | "truncated" | "unknown" | "unsupported";
|
|
44
|
+
reason?: string;
|
|
45
|
+
/** Counts are present only if actually known. */
|
|
46
|
+
examined?: number;
|
|
47
|
+
total?: number;
|
|
48
|
+
}
|
|
49
|
+
export interface Limits {
|
|
50
|
+
maxPages: number;
|
|
51
|
+
maxCandidates: number;
|
|
52
|
+
maxWitnessEdges: number;
|
|
53
|
+
maxExploredEdges?: number;
|
|
54
|
+
}
|
|
55
|
+
export interface Pin {
|
|
56
|
+
nodeId: NodeId;
|
|
57
|
+
kind: "keep-visible" | "keep-label";
|
|
58
|
+
}
|
|
59
|
+
export type RuleSpec = {
|
|
60
|
+
kind: "fold-serial-interiors";
|
|
61
|
+
version: "1";
|
|
62
|
+
} | {
|
|
63
|
+
kind: "fold-pendant-fans";
|
|
64
|
+
version: "1";
|
|
65
|
+
minLeaves: number;
|
|
66
|
+
} | {
|
|
67
|
+
kind: "contain-scc";
|
|
68
|
+
version: "1";
|
|
69
|
+
} | {
|
|
70
|
+
kind: "group-authored";
|
|
71
|
+
version: "1";
|
|
72
|
+
hierarchyRef: string;
|
|
73
|
+
} | {
|
|
74
|
+
kind: "annotate-dag-transitivity";
|
|
75
|
+
version: "1";
|
|
76
|
+
semanticPolicyId: string;
|
|
77
|
+
};
|
|
78
|
+
export interface ResolutionSpec {
|
|
79
|
+
schemaVersion: "0.1";
|
|
80
|
+
id: Id;
|
|
81
|
+
relationScopeId: string;
|
|
82
|
+
rules: RuleSpec[];
|
|
83
|
+
/** Optional consecutive rule batches, summing to rules.length. Default: one rule per page. */
|
|
84
|
+
pageRuleCounts?: number[];
|
|
85
|
+
pins: Pin[];
|
|
86
|
+
limits: Limits;
|
|
87
|
+
}
|
|
88
|
+
/** Supplied separately from the current atlas's minimal edge shape. */
|
|
89
|
+
export interface EdgeSemantics {
|
|
90
|
+
edgeId: EdgeId;
|
|
91
|
+
relationClass: string;
|
|
92
|
+
/** Reference to a declared meaning, not a generic 'weight' field. */
|
|
93
|
+
measurePolicyId?: string;
|
|
94
|
+
reachabilitySubduingAllowed: boolean;
|
|
95
|
+
}
|
|
96
|
+
export interface AuthoredGroup {
|
|
97
|
+
id: Id;
|
|
98
|
+
label: string;
|
|
99
|
+
sourceNodeIds: NodeId[];
|
|
100
|
+
parentId?: Id;
|
|
101
|
+
}
|
|
102
|
+
export interface ResolutionBindings {
|
|
103
|
+
edgeSemantics: EdgeSemantics[];
|
|
104
|
+
authoredHierarchies: {
|
|
105
|
+
id: string;
|
|
106
|
+
groups: AuthoredGroup[];
|
|
107
|
+
}[];
|
|
108
|
+
}
|
|
109
|
+
export interface SourceFeature {
|
|
110
|
+
id: Id;
|
|
111
|
+
kind: "chain" | "pendant-fan" | "scc" | "authored-group" | "motif" | "cut";
|
|
112
|
+
nodes: SetRef;
|
|
113
|
+
edges: SetRef;
|
|
114
|
+
roles: {
|
|
115
|
+
[role: string]: Id[];
|
|
116
|
+
};
|
|
117
|
+
discovery: "exact-structural" | "supplied" | "heuristic";
|
|
118
|
+
coverage: Coverage;
|
|
119
|
+
scopeId: string;
|
|
120
|
+
}
|
|
121
|
+
export interface BoundaryPort {
|
|
122
|
+
id: Id;
|
|
123
|
+
groupId: GroupId;
|
|
124
|
+
direction: "in" | "out";
|
|
125
|
+
/** An exact endpoint. A displayed multi-endpoint port is an alias set. */
|
|
126
|
+
internalNodeId: NodeId;
|
|
127
|
+
incidentEdges: SetRef;
|
|
128
|
+
}
|
|
129
|
+
export interface ResolutionGroup {
|
|
130
|
+
id: GroupId;
|
|
131
|
+
label: string;
|
|
132
|
+
kind: "singleton" | "chain" | "pendant-fan" | "scc" | "authored-group";
|
|
133
|
+
sourceNodes: SetRef;
|
|
134
|
+
internalEdges: SetRef;
|
|
135
|
+
/** Children at creation. Reusing this group on a later page adds no self-child. */
|
|
136
|
+
childGroupIds: GroupId[];
|
|
137
|
+
weaklyConnected: true;
|
|
138
|
+
portIds: Id[];
|
|
139
|
+
explanationEventIds: Id[];
|
|
140
|
+
internalCycleRank: number;
|
|
141
|
+
}
|
|
142
|
+
export interface EndpointPair {
|
|
143
|
+
sourceNodeId: NodeId;
|
|
144
|
+
targetNodeId: NodeId;
|
|
145
|
+
originalEdges: SetRef;
|
|
146
|
+
}
|
|
147
|
+
export interface BoundaryBundle {
|
|
148
|
+
id: Id;
|
|
149
|
+
sourceGroupId: GroupId;
|
|
150
|
+
targetGroupId: GroupId;
|
|
151
|
+
relationKey: string;
|
|
152
|
+
originalEdges: SetRef;
|
|
153
|
+
/** Actual observed graph endpoint pairs; never an implicit Cartesian product. */
|
|
154
|
+
endpointPairs: EndpointPair[];
|
|
155
|
+
}
|
|
156
|
+
export interface CycleLedger {
|
|
157
|
+
convention: "undirected-multigraph-keep-edge-ids/v1";
|
|
158
|
+
sourceRank: number;
|
|
159
|
+
internalRank: number;
|
|
160
|
+
boundaryRank: number;
|
|
161
|
+
identityChecked: boolean;
|
|
162
|
+
}
|
|
163
|
+
export interface ResolutionPage {
|
|
164
|
+
id: PageId;
|
|
165
|
+
ordinal: number;
|
|
166
|
+
label: string;
|
|
167
|
+
groupIds: GroupId[];
|
|
168
|
+
bundleIds: Id[];
|
|
169
|
+
/** For the straightforward MVP. A codec-backed mapping may replace this later. */
|
|
170
|
+
nodeOwner: {
|
|
171
|
+
[originalNodeId: string]: GroupId;
|
|
172
|
+
};
|
|
173
|
+
internalEdgeCount: number;
|
|
174
|
+
boundaryEdgeCount: number;
|
|
175
|
+
originalNodeCount: number;
|
|
176
|
+
originalEdgeCount: number;
|
|
177
|
+
cycles: CycleLedger;
|
|
178
|
+
annotationIds: Id[];
|
|
179
|
+
presentation: EdgePresentation[];
|
|
180
|
+
coverage: Coverage;
|
|
181
|
+
}
|
|
182
|
+
export interface StructuralWitness {
|
|
183
|
+
kind: "structural-path";
|
|
184
|
+
nodeIds: NodeId[];
|
|
185
|
+
edgeIds: EdgeId[];
|
|
186
|
+
scopeId: string;
|
|
187
|
+
}
|
|
188
|
+
export interface ObservedWitness {
|
|
189
|
+
kind: "observed-segment";
|
|
190
|
+
occurrenceId: Id;
|
|
191
|
+
startOffset: number;
|
|
192
|
+
/** Inclusive node-path offset, not an inferred wall-clock timestamp. */
|
|
193
|
+
endOffset: number;
|
|
194
|
+
nodeIds: NodeId[];
|
|
195
|
+
/** Omit if the occurrence cannot identify particular parallel edges. */
|
|
196
|
+
edgeIds?: EdgeId[];
|
|
197
|
+
edgeIdentity: "resolved" | "ambiguous";
|
|
198
|
+
}
|
|
199
|
+
export type Witness = StructuralWitness | ObservedWitness;
|
|
200
|
+
export interface PreservationClaim {
|
|
201
|
+
property: "source-ownership" | "weak-connectivity" | "cycle-account" | "scoped-reachability" | "source-path-recovery";
|
|
202
|
+
scopeId: string;
|
|
203
|
+
status: "checked" | "not-checked" | "failed";
|
|
204
|
+
witnessIds: Id[];
|
|
205
|
+
limitations: string[];
|
|
206
|
+
}
|
|
207
|
+
export interface ResolutionEvent {
|
|
208
|
+
id: Id;
|
|
209
|
+
fromPageId: PageId;
|
|
210
|
+
toPageId: PageId;
|
|
211
|
+
action: "grouped" | "annotated" | "subdued" | "rejected";
|
|
212
|
+
rule: RuleSpec;
|
|
213
|
+
featureIds: Id[];
|
|
214
|
+
beforeGroupIds: GroupId[];
|
|
215
|
+
afterGroupIds: GroupId[];
|
|
216
|
+
affectedEdges: SetRef;
|
|
217
|
+
reason: string;
|
|
218
|
+
claims: PreservationClaim[];
|
|
219
|
+
}
|
|
220
|
+
export interface Transition {
|
|
221
|
+
fromPageId: PageId;
|
|
222
|
+
toPageId: PageId;
|
|
223
|
+
/** Each old group maps to exactly one new group; identity is permitted. */
|
|
224
|
+
groupMap: {
|
|
225
|
+
[oldGroupId: string]: GroupId;
|
|
226
|
+
};
|
|
227
|
+
eventIds: Id[];
|
|
228
|
+
}
|
|
229
|
+
export interface EdgePresentation {
|
|
230
|
+
edges: SetRef;
|
|
231
|
+
representation: "literal" | "bundle" | "component-internal";
|
|
232
|
+
protected: boolean;
|
|
233
|
+
subduedForReachability: boolean;
|
|
234
|
+
witnessIds: Id[];
|
|
235
|
+
/** Visual coverage is not analysis coverage. */
|
|
236
|
+
viewport: "displayed" | "not-in-current-view";
|
|
237
|
+
}
|
|
238
|
+
export interface EdgeHistory {
|
|
239
|
+
originalEdgeId: EdgeId;
|
|
240
|
+
/** null = still boundary at configured stop; never an infinity/importance score. */
|
|
241
|
+
firstInternalPage: number | null;
|
|
242
|
+
owners: {
|
|
243
|
+
pageId: PageId;
|
|
244
|
+
sourceOwner: GroupId;
|
|
245
|
+
targetOwner: GroupId;
|
|
246
|
+
}[];
|
|
247
|
+
}
|
|
248
|
+
export interface PreparedNetworkResolution {
|
|
249
|
+
schemaVersion: "0.1";
|
|
250
|
+
id: Id;
|
|
251
|
+
revision: RevisionRef;
|
|
252
|
+
analysisRevision: string;
|
|
253
|
+
sourceFingerprint: string;
|
|
254
|
+
/** Admitted topology needed for source recovery; independent of layout and source mutations. */
|
|
255
|
+
source: {
|
|
256
|
+
nodes: {
|
|
257
|
+
id: string;
|
|
258
|
+
sectionId?: string;
|
|
259
|
+
}[];
|
|
260
|
+
edges: {
|
|
261
|
+
id: string;
|
|
262
|
+
source: string;
|
|
263
|
+
target: string;
|
|
264
|
+
}[];
|
|
265
|
+
occurrences?: AtlasOccurrence[];
|
|
266
|
+
};
|
|
267
|
+
traceCoverage: Coverage;
|
|
268
|
+
edgeSemantics: EdgeSemantics[];
|
|
269
|
+
sectionOrder: string[];
|
|
270
|
+
spec: ResolutionSpec;
|
|
271
|
+
pages: ResolutionPage[];
|
|
272
|
+
groups: ResolutionGroup[];
|
|
273
|
+
bundles: BoundaryBundle[];
|
|
274
|
+
ports: BoundaryPort[];
|
|
275
|
+
features: SourceFeature[];
|
|
276
|
+
events: ResolutionEvent[];
|
|
277
|
+
transitions: Transition[];
|
|
278
|
+
sets: SourceSet[];
|
|
279
|
+
witnesses: {
|
|
280
|
+
id: Id;
|
|
281
|
+
value: Witness;
|
|
282
|
+
}[];
|
|
283
|
+
issues: Issue[];
|
|
284
|
+
stoppedBecause: "configured-end" | "fixed-point" | "resource-limit";
|
|
285
|
+
}
|
|
286
|
+
export type PrepareResult = {
|
|
287
|
+
ok: true;
|
|
288
|
+
value: PreparedNetworkResolution;
|
|
289
|
+
issues: Issue[];
|
|
290
|
+
} | {
|
|
291
|
+
ok: false;
|
|
292
|
+
issues: Issue[];
|
|
293
|
+
};
|
|
294
|
+
export interface PortPathQuery {
|
|
295
|
+
pageId: PageId;
|
|
296
|
+
groupId: GroupId;
|
|
297
|
+
ingressId: Id;
|
|
298
|
+
egressId: Id;
|
|
299
|
+
basis: Basis;
|
|
300
|
+
/** Internal connectivity alone never certifies an observed continuation. */
|
|
301
|
+
continuation: "inside-only" | "boundary-context";
|
|
302
|
+
/** Domain must be edge; restrict to selected incoming/outgoing source records.
|
|
303
|
+
* Omit to query all incidence admitted at that port, with existential semantics.
|
|
304
|
+
* boundary-context includes the exterior predecessor/successor in one segment.
|
|
305
|
+
*/
|
|
306
|
+
ingressEdges?: SetRef;
|
|
307
|
+
egressEdges?: SetRef;
|
|
308
|
+
scopeId: string;
|
|
309
|
+
}
|
|
310
|
+
export interface PortPathEnvelope {
|
|
311
|
+
revision: RevisionRef;
|
|
312
|
+
analysisRevision: string;
|
|
313
|
+
query: PortPathQuery;
|
|
314
|
+
coverage: Coverage;
|
|
315
|
+
limitations: string[];
|
|
316
|
+
}
|
|
317
|
+
/** Positive claims carry a witness; negative claims name an exhausted scope. */
|
|
318
|
+
export type PortPathResult = PortPathEnvelope & ({
|
|
319
|
+
verdict: "yes";
|
|
320
|
+
witness: Witness;
|
|
321
|
+
exhaustedScopeRef?: never;
|
|
322
|
+
} | {
|
|
323
|
+
verdict: "no";
|
|
324
|
+
witness?: never;
|
|
325
|
+
exhaustedScopeRef: string;
|
|
326
|
+
} | {
|
|
327
|
+
verdict: "unknown";
|
|
328
|
+
witness?: never;
|
|
329
|
+
exhaustedScopeRef?: never;
|
|
330
|
+
});
|
|
331
|
+
export interface CanonicalSelection {
|
|
332
|
+
revision: RevisionRef;
|
|
333
|
+
analysisRevision: string;
|
|
334
|
+
target: {
|
|
335
|
+
kind: "source-set";
|
|
336
|
+
set: SetRef;
|
|
337
|
+
} | {
|
|
338
|
+
kind: "port-path";
|
|
339
|
+
query: PortPathQuery;
|
|
340
|
+
} | {
|
|
341
|
+
kind: "witness";
|
|
342
|
+
witnessId: Id;
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
export type SemanticTarget = {
|
|
346
|
+
kind: "original-node";
|
|
347
|
+
nodeId: NodeId;
|
|
348
|
+
} | {
|
|
349
|
+
kind: "group";
|
|
350
|
+
pageId: PageId;
|
|
351
|
+
groupId: GroupId;
|
|
352
|
+
} | {
|
|
353
|
+
kind: "original-edge";
|
|
354
|
+
edgeId: EdgeId;
|
|
355
|
+
} | {
|
|
356
|
+
kind: "bundle";
|
|
357
|
+
pageId: PageId;
|
|
358
|
+
bundleId: Id;
|
|
359
|
+
} | {
|
|
360
|
+
kind: "port";
|
|
361
|
+
portId: Id;
|
|
362
|
+
} | {
|
|
363
|
+
kind: "support-cell";
|
|
364
|
+
query: PortPathQuery;
|
|
365
|
+
} | {
|
|
366
|
+
kind: "membership";
|
|
367
|
+
transitionEventId: Id;
|
|
368
|
+
} | {
|
|
369
|
+
kind: "annotation";
|
|
370
|
+
featureId: Id;
|
|
371
|
+
};
|
|
372
|
+
export interface ViewBudget {
|
|
373
|
+
/** Total group marks shared across visible pages; newer pages receive remainder slots. */
|
|
374
|
+
maxGroups: number;
|
|
375
|
+
maxLiteralEdges: number;
|
|
376
|
+
maxRails: number;
|
|
377
|
+
maxColumns: number;
|
|
378
|
+
}
|
|
379
|
+
export interface ResolutionViewSpec {
|
|
380
|
+
mode: "resolution-atlas" | "boundary-loom" | "component-cutaway";
|
|
381
|
+
pageIds: PageId[];
|
|
382
|
+
selectedGroupId?: GroupId;
|
|
383
|
+
referenceOrderId: Id;
|
|
384
|
+
budget: ViewBudget;
|
|
385
|
+
edgeOffset?: number;
|
|
386
|
+
railOffset?: number;
|
|
387
|
+
collapseGroups?: boolean;
|
|
388
|
+
}
|
|
389
|
+
export interface QueryEnvelope<T> {
|
|
390
|
+
revision: RevisionRef;
|
|
391
|
+
analysisRevision: string;
|
|
392
|
+
scopeId: string;
|
|
393
|
+
coverage: Coverage;
|
|
394
|
+
limitations: string[];
|
|
395
|
+
value: T;
|
|
396
|
+
}
|
|
397
|
+
export interface EdgeAlternative {
|
|
398
|
+
verdict: "yes" | "no" | "unknown";
|
|
399
|
+
originalEdgeId: string;
|
|
400
|
+
witness?: StructuralWitness;
|
|
401
|
+
}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { PreparedNetworkAtlas } from "../types";
|
|
2
|
+
import type { Issue, ResolutionBindings, ResolutionSpec } from "./types";
|
|
3
|
+
/** Validate the JSON boundary before any graph indexing or derived publication. */
|
|
4
|
+
export declare function validateResolution(atlas: PreparedNetworkAtlas, spec: ResolutionSpec, bindings: ResolutionBindings): Issue[];
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
import { type GraphIndex } from "./indexGraph";
|
|
2
|
+
import type { OwnershipBuilder } from "./ownership";
|
|
3
|
+
import type { Coverage, EdgeAlternative, PreparedNetworkResolution, QueryEnvelope, ResolutionPage, RuleSpec, StructuralWitness } from "./types";
|
|
4
|
+
export interface PathSearch {
|
|
5
|
+
verdict: "yes" | "no" | "unknown";
|
|
6
|
+
witness?: StructuralWitness;
|
|
7
|
+
coverage: Coverage;
|
|
8
|
+
}
|
|
9
|
+
/** Bounded BFS. Output limits and unfinished exploration never produce negative claims. */
|
|
10
|
+
export declare function searchPath(graph: GraphIndex, start: string, end: string, scopeId: string, limits: {
|
|
11
|
+
maxWitnessEdges: number;
|
|
12
|
+
maxExploredEdges?: number;
|
|
13
|
+
}, admits?: (edgeId: string, source: string, target: string) => boolean): PathSearch;
|
|
14
|
+
export declare function getEdgeAlternative(resolution: PreparedNetworkResolution, edgeId: string): QueryEnvelope<EdgeAlternative>;
|
|
15
|
+
/** Remove relations on the whole simple SCC DAG, then certify against the retained reading. */
|
|
16
|
+
export declare function applyTransitiveReading(value: PreparedNetworkResolution, builder: OwnershipBuilder, page: ResolutionPage, fromPageId: string, rule: Extract<RuleSpec, {
|
|
17
|
+
kind: "annotate-dag-transitivity";
|
|
18
|
+
}>): void;
|