@ankhorage/dependency-graph 1.3.1 → 1.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +4 -1
- package/dist/dependencyGraph.d.ts +7 -0
- package/dist/dependencyGraph.d.ts.map +1 -1
- package/dist/dependencyGraph.js +6 -0
- package/dist/dependencyGraph.js.map +1 -1
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromInspections.d.ts.map +1 -1
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromInspections.js +1 -1
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromInspections.js.map +1 -1
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromProjectAnalysisSnapshots.d.ts +6 -0
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromProjectAnalysisSnapshots.d.ts.map +1 -0
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromProjectAnalysisSnapshots.js +35 -0
- package/dist/features/dependency-analysis/application/projectDependencyGraphFromProjectAnalysisSnapshots.js.map +1 -0
- package/dist/features/dependency-analysis/composition/createDependencyGraphFromProjectAnalysisSnapshots.d.ts +5 -0
- package/dist/features/dependency-analysis/composition/createDependencyGraphFromProjectAnalysisSnapshots.d.ts.map +1 -0
- package/dist/features/dependency-analysis/composition/createDependencyGraphFromProjectAnalysisSnapshots.js +7 -0
- package/dist/features/dependency-analysis/composition/createDependencyGraphFromProjectAnalysisSnapshots.js.map +1 -0
- package/dist/features/dependency-analysis/domain/projectDependencyGraphFromSourceGraph.d.ts +7 -2
- package/dist/features/dependency-analysis/domain/projectDependencyGraphFromSourceGraph.d.ts.map +1 -1
- package/dist/features/dependency-analysis/domain/projectDependencyGraphFromSourceGraph.js +1 -1
- package/dist/features/dependency-analysis/domain/projectDependencyGraphFromSourceGraph.js.map +1 -1
- package/dist/features/source-graph/composition/createProjectAnalysisSnapshotAsync.d.ts +6 -0
- package/dist/features/source-graph/composition/createProjectAnalysisSnapshotAsync.d.ts.map +1 -0
- package/dist/features/source-graph/composition/createProjectAnalysisSnapshotAsync.js +143 -0
- package/dist/features/source-graph/composition/createProjectAnalysisSnapshotAsync.js.map +1 -0
- package/dist/features/source-graph/composition/createSourceGraphFromInspectionsAsync.d.ts.map +1 -1
- package/dist/features/source-graph/composition/createSourceGraphFromInspectionsAsync.js +8 -117
- package/dist/features/source-graph/composition/createSourceGraphFromInspectionsAsync.js.map +1 -1
- package/dist/features/source-graph/composition/createSourceGraphFromProjectAnalysisSnapshots.d.ts +5 -0
- package/dist/features/source-graph/composition/createSourceGraphFromProjectAnalysisSnapshots.d.ts.map +1 -0
- package/dist/features/source-graph/composition/createSourceGraphFromProjectAnalysisSnapshots.js +31 -0
- package/dist/features/source-graph/composition/createSourceGraphFromProjectAnalysisSnapshots.js.map +1 -0
- package/dist/features/source-graph/domain/createSourceStructureDraft.d.ts +2 -7
- package/dist/features/source-graph/domain/createSourceStructureDraft.d.ts.map +1 -1
- package/dist/features/source-graph/domain/createSourceStructureDraft.js +26 -66
- package/dist/features/source-graph/domain/createSourceStructureDraft.js.map +1 -1
- package/dist/features/source-graph/domain/deserializeProjectAnalysisSnapshot.d.ts +4 -0
- package/dist/features/source-graph/domain/deserializeProjectAnalysisSnapshot.d.ts.map +1 -0
- package/dist/features/source-graph/domain/deserializeProjectAnalysisSnapshot.js +8 -0
- package/dist/features/source-graph/domain/deserializeProjectAnalysisSnapshot.js.map +1 -0
- package/dist/features/source-graph/domain/projectAnalysisSnapshot.d.ts +4 -0
- package/dist/features/source-graph/domain/projectAnalysisSnapshot.d.ts.map +1 -0
- package/dist/features/source-graph/domain/projectAnalysisSnapshot.js +175 -0
- package/dist/features/source-graph/domain/projectAnalysisSnapshot.js.map +1 -0
- package/dist/features/source-graph/domain/serializeProjectAnalysisSnapshot.d.ts +4 -0
- package/dist/features/source-graph/domain/serializeProjectAnalysisSnapshot.d.ts.map +1 -0
- package/dist/features/source-graph/domain/serializeProjectAnalysisSnapshot.js +7 -0
- package/dist/features/source-graph/domain/serializeProjectAnalysisSnapshot.js.map +1 -0
- package/dist/features/source-graph/domain/sourceAnalyzerCapabilities.d.ts +6 -0
- package/dist/features/source-graph/domain/sourceAnalyzerCapabilities.d.ts.map +1 -0
- package/dist/features/source-graph/domain/sourceAnalyzerCapabilities.js +47 -0
- package/dist/features/source-graph/domain/sourceAnalyzerCapabilities.js.map +1 -0
- package/dist/types/projectAnalysisSnapshot.d.ts +44 -0
- package/dist/types/projectAnalysisSnapshot.d.ts.map +1 -0
- package/dist/types/projectAnalysisSnapshot.js +2 -0
- package/dist/types/projectAnalysisSnapshot.js.map +1 -0
- package/package.json +1 -1
|
@@ -0,0 +1,175 @@
|
|
|
1
|
+
import { normalizePortablePath } from '@ankhorage/utility/node/path';
|
|
2
|
+
import { isRecord } from '@ankhorage/utility/object';
|
|
3
|
+
import { isSourceAnalyzerId, sourceAnalyzerCapabilities } from './sourceAnalyzerCapabilities.js';
|
|
4
|
+
/*** Reject unsupported or malformed snapshot contracts before canonical graph construction. */
|
|
5
|
+
export function assertProjectAnalysisSnapshot(value) {
|
|
6
|
+
if (!isProjectAnalysisSnapshot(value))
|
|
7
|
+
throw new Error('Invalid project analysis snapshot.');
|
|
8
|
+
}
|
|
9
|
+
/*** Check the complete JSON-safe public snapshot envelope and its recursively analyzed facts. */
|
|
10
|
+
function isProjectAnalysisSnapshot(value) {
|
|
11
|
+
if (!isSnapshotEnvelope(value))
|
|
12
|
+
return false;
|
|
13
|
+
return hasSnapshotContents(value.directories, value.files, value.packages, value.workspaces, value.analyzers, value.analyzedFiles);
|
|
14
|
+
}
|
|
15
|
+
/*** Check the versioned identity fields that distinguish one public snapshot. */
|
|
16
|
+
function isSnapshotEnvelope(value) {
|
|
17
|
+
return isRecord(value) && value.version === 1 && isProjectId(value.projectId);
|
|
18
|
+
}
|
|
19
|
+
/*** Check all collection entries and the identities that canonical graph construction consumes. */
|
|
20
|
+
function hasSnapshotContents(directories, files, packages, workspaces, analyzers, analyzedFiles) {
|
|
21
|
+
if (!isProjectRelativePathArray(directories, true))
|
|
22
|
+
return false;
|
|
23
|
+
if (!isProjectRelativePathArray(files))
|
|
24
|
+
return false;
|
|
25
|
+
if (!Array.isArray(packages) || !packages.every(isPackage))
|
|
26
|
+
return false;
|
|
27
|
+
if (!Array.isArray(workspaces) || !workspaces.every(isWorkspace))
|
|
28
|
+
return false;
|
|
29
|
+
if (!Array.isArray(analyzers) || !analyzers.every(isAnalyzer))
|
|
30
|
+
return false;
|
|
31
|
+
if (!Array.isArray(analyzedFiles) || !analyzedFiles.every(isAnalyzedFile))
|
|
32
|
+
return false;
|
|
33
|
+
return hasUniqueSnapshotIdentities(packages, workspaces, analyzers, analyzedFiles, files);
|
|
34
|
+
}
|
|
35
|
+
/*** Reject identities that would otherwise collapse or conflict during recomposition. */
|
|
36
|
+
function hasUniqueSnapshotIdentities(packages, workspaces, analyzers, analyzedFiles, files) {
|
|
37
|
+
return (hasUniqueValues(packages.map(({ rootPath }) => rootPath)) &&
|
|
38
|
+
hasUniqueValues(packages.flatMap(({ name }) => (name === undefined ? [] : [name]))) &&
|
|
39
|
+
hasUniqueValues(workspaces.map(({ rootPath }) => rootPath)) &&
|
|
40
|
+
hasUniqueValues(analyzers.map(({ id }) => id)) &&
|
|
41
|
+
hasUniqueValues(analyzedFiles.map(({ path }) => path)) &&
|
|
42
|
+
analyzedFiles.every(({ analyzerId, path }) => analyzers.some(({ id }) => id === analyzerId) && files.includes(path)));
|
|
43
|
+
}
|
|
44
|
+
/*** Check project-relative package metadata. */
|
|
45
|
+
function isPackage(value) {
|
|
46
|
+
return (isRecord(value) &&
|
|
47
|
+
isProjectRelativePath(value.rootPath, true) &&
|
|
48
|
+
(value.name === undefined || isText(value.name)));
|
|
49
|
+
}
|
|
50
|
+
/*** Check workspace membership without accepting absolute or executable values. */
|
|
51
|
+
function isWorkspace(value) {
|
|
52
|
+
return (isRecord(value) &&
|
|
53
|
+
isProjectRelativePath(value.rootPath, true) &&
|
|
54
|
+
isProjectRelativePathArray(value.packagePaths, true));
|
|
55
|
+
}
|
|
56
|
+
/*** Check analyzer provenance and its explicit capability list. */
|
|
57
|
+
function isAnalyzer(value) {
|
|
58
|
+
if (!isRecord(value) || !isText(value.id) || !isTextArray(value.capabilities))
|
|
59
|
+
return false;
|
|
60
|
+
const supported = sourceAnalyzerCapabilities(value.id);
|
|
61
|
+
return isSourceAnalyzerId(value.id) && hasSameValues(value.capabilities, supported);
|
|
62
|
+
}
|
|
63
|
+
/*** Check portable parser output without retaining ASTs, paths, or arbitrary runtime values. */
|
|
64
|
+
function isAnalyzedFile(value) {
|
|
65
|
+
return (isRecord(value) &&
|
|
66
|
+
isText(value.analyzerId) &&
|
|
67
|
+
isProjectRelativePath(value.path) &&
|
|
68
|
+
isSourceFacts(value.facts) &&
|
|
69
|
+
(value.declaredDependencies === undefined ||
|
|
70
|
+
isDependencyDeclarations(value.declaredDependencies)));
|
|
71
|
+
}
|
|
72
|
+
/*** Check the serializable language-neutral facts used by canonical relation resolution. */
|
|
73
|
+
function isSourceFacts(value) {
|
|
74
|
+
return (isRecord(value) &&
|
|
75
|
+
Array.isArray(value.declarations) &&
|
|
76
|
+
value.declarations.every(isSourceDeclaration) &&
|
|
77
|
+
Array.isArray(value.imports) &&
|
|
78
|
+
value.imports.every(isSourceImport) &&
|
|
79
|
+
(value.packageName === undefined || isText(value.packageName)));
|
|
80
|
+
}
|
|
81
|
+
/*** Check dependency evidence maps before projecting package-level graph edges. */
|
|
82
|
+
function isDependencyDeclarations(value) {
|
|
83
|
+
return (isRecord(value) &&
|
|
84
|
+
Object.values(value).every((entries) => Array.isArray(entries) &&
|
|
85
|
+
entries.every((entry) => isRecord(entry) &&
|
|
86
|
+
['dependency', 'devDependency', 'optionalDependency', 'peerDependency'].includes(entry.kind) &&
|
|
87
|
+
isText(entry.range))));
|
|
88
|
+
}
|
|
89
|
+
/*** Check a recursive declaration fact before it becomes a semantic graph node. */
|
|
90
|
+
function isSourceDeclaration(value) {
|
|
91
|
+
if (!isRecord(value))
|
|
92
|
+
return false;
|
|
93
|
+
return hasSourceDeclarationStructure(value) && hasSourceDeclarationMetadata(value);
|
|
94
|
+
}
|
|
95
|
+
/*** Check recursive declaration structure before graph-node construction. */
|
|
96
|
+
function hasSourceDeclarationStructure(value) {
|
|
97
|
+
return (Array.isArray(value.children) &&
|
|
98
|
+
value.children.every(isSourceDeclaration) &&
|
|
99
|
+
isTextArray(value.extends) &&
|
|
100
|
+
isTextArray(value.implements) &&
|
|
101
|
+
isSourceLocation(value.location) &&
|
|
102
|
+
isTextArray(value.modifiers));
|
|
103
|
+
}
|
|
104
|
+
/*** Check declaration attributes that establish its stable source identity. */
|
|
105
|
+
function hasSourceDeclarationMetadata(value) {
|
|
106
|
+
return ((value.documentation === undefined || isSourceDocumentation(value.documentation)) &&
|
|
107
|
+
(value.exported === undefined || typeof value.exported === 'boolean') &&
|
|
108
|
+
(value.typeOnly === undefined || typeof value.typeOnly === 'boolean') &&
|
|
109
|
+
['class', 'constant', 'enum', 'function', 'interface', 'method', 'type', 'variable'].includes(value.kind) &&
|
|
110
|
+
isText(value.name) &&
|
|
111
|
+
(value.signature === undefined || isText(value.signature)) &&
|
|
112
|
+
['package', 'private', 'protected', 'public'].includes(value.visibility));
|
|
113
|
+
}
|
|
114
|
+
/*** Check one portable import fact without admitting host paths into recomposition. */
|
|
115
|
+
function isSourceImport(value) {
|
|
116
|
+
return (isRecord(value) &&
|
|
117
|
+
(value.kind === undefined || value.kind === 'import' || value.kind === 'reexport') &&
|
|
118
|
+
(value.local === undefined || typeof value.local === 'boolean') &&
|
|
119
|
+
(value.location === undefined || isSourceLocation(value.location)) &&
|
|
120
|
+
isText(value.specifier) &&
|
|
121
|
+
(value.resolvedPath === undefined || isProjectRelativePath(value.resolvedPath)) &&
|
|
122
|
+
(value.typeOnly === undefined || typeof value.typeOnly === 'boolean'));
|
|
123
|
+
}
|
|
124
|
+
/*** Check serializable documentation facts without retaining parser-owned values. */
|
|
125
|
+
function isSourceDocumentation(value) {
|
|
126
|
+
return (isRecord(value) &&
|
|
127
|
+
isText(value.text) &&
|
|
128
|
+
isRecord(value.tags) &&
|
|
129
|
+
Object.values(value.tags).every(isTextArray));
|
|
130
|
+
}
|
|
131
|
+
/*** Check one finite, one-based source span. */
|
|
132
|
+
function isSourceLocation(value) {
|
|
133
|
+
return (isRecord(value) &&
|
|
134
|
+
[value.line, value.column, value.endLine, value.endColumn].every((part) => typeof part === 'number' && Number.isSafeInteger(part) && part > 0) &&
|
|
135
|
+
value.endLine >= value.line &&
|
|
136
|
+
(value.endLine !== value.line ||
|
|
137
|
+
value.endColumn >= value.column));
|
|
138
|
+
}
|
|
139
|
+
/*** Accept a canonical portable path that cannot escape its project snapshot. */
|
|
140
|
+
function isProjectRelativePath(value, allowRoot = false) {
|
|
141
|
+
return (isText(value) &&
|
|
142
|
+
(allowRoot || value !== '.') &&
|
|
143
|
+
!value.includes('\\') &&
|
|
144
|
+
!value.startsWith('/') &&
|
|
145
|
+
!/^[a-z]:\//iu.test(value) &&
|
|
146
|
+
!value.split('/').some((segment) => segment === '..') &&
|
|
147
|
+
normalizePortablePath(value) === value);
|
|
148
|
+
}
|
|
149
|
+
/*** Check a duplicate-free list of canonical project-relative paths. */
|
|
150
|
+
function isProjectRelativePathArray(value, allowRoot = false) {
|
|
151
|
+
return (Array.isArray(value) &&
|
|
152
|
+
value.every((item) => isProjectRelativePath(item, allowRoot)) &&
|
|
153
|
+
hasUniqueValues(value));
|
|
154
|
+
}
|
|
155
|
+
/*** Compare one analyzer declaration with its canonical capability contract. */
|
|
156
|
+
function hasSameValues(actual, expected) {
|
|
157
|
+
return actual.join('\u0000') === expected.join('\u0000');
|
|
158
|
+
}
|
|
159
|
+
/*** Reject duplicate identities before they collapse into one canonical graph node. */
|
|
160
|
+
function hasUniqueValues(values) {
|
|
161
|
+
return new Set(values).size === values.length;
|
|
162
|
+
}
|
|
163
|
+
/*** Check a project identity without rejecting valid empty optional analyzer facts. */
|
|
164
|
+
function isProjectId(value) {
|
|
165
|
+
return isText(value) && value.trim() !== '';
|
|
166
|
+
}
|
|
167
|
+
/*** Distinguish portable text fields from arbitrary values. */
|
|
168
|
+
function isText(value) {
|
|
169
|
+
return typeof value === 'string';
|
|
170
|
+
}
|
|
171
|
+
/*** Check a JSON-safe list of portable identifiers. */
|
|
172
|
+
function isTextArray(value) {
|
|
173
|
+
return Array.isArray(value) && value.every(isText);
|
|
174
|
+
}
|
|
175
|
+
//# sourceMappingURL=projectAnalysisSnapshot.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projectAnalysisSnapshot.js","sourceRoot":"","sources":["../../../../src/features/source-graph/domain/projectAnalysisSnapshot.ts"],"names":[],"mappings":"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","sourcesContent":["import { normalizePortablePath } from '@ankhorage/utility/node/path';\nimport { isRecord } from '@ankhorage/utility/object';\n\nimport type {\n ProjectAnalysisAnalyzer,\n ProjectAnalysisPackage,\n ProjectAnalysisSnapshot,\n ProjectAnalysisSourceFile,\n ProjectAnalysisWorkspace,\n} from '../../../types/projectAnalysisSnapshot.js';\nimport { isSourceAnalyzerId, sourceAnalyzerCapabilities } from './sourceAnalyzerCapabilities.js';\n\n/*** Reject unsupported or malformed snapshot contracts before canonical graph construction. */\nexport function assertProjectAnalysisSnapshot(\n value: unknown,\n): asserts value is ProjectAnalysisSnapshot {\n if (!isProjectAnalysisSnapshot(value)) throw new Error('Invalid project analysis snapshot.');\n}\n\n/*** Check the complete JSON-safe public snapshot envelope and its recursively analyzed facts. */\nfunction isProjectAnalysisSnapshot(value: unknown): value is ProjectAnalysisSnapshot {\n if (!isSnapshotEnvelope(value)) return false;\n return hasSnapshotContents(\n value.directories,\n value.files,\n value.packages,\n value.workspaces,\n value.analyzers,\n value.analyzedFiles,\n );\n}\n\n/*** Check the versioned identity fields that distinguish one public snapshot. */\nfunction isSnapshotEnvelope(value: unknown): value is Record<string, unknown> {\n return isRecord(value) && value.version === 1 && isProjectId(value.projectId);\n}\n\n/*** Check all collection entries and the identities that canonical graph construction consumes. */\nfunction hasSnapshotContents(\n directories: unknown,\n files: unknown,\n packages: unknown,\n workspaces: unknown,\n analyzers: unknown,\n analyzedFiles: unknown,\n): boolean {\n if (!isProjectRelativePathArray(directories, true)) return false;\n if (!isProjectRelativePathArray(files)) return false;\n if (!Array.isArray(packages) || !packages.every(isPackage)) return false;\n if (!Array.isArray(workspaces) || !workspaces.every(isWorkspace)) return false;\n if (!Array.isArray(analyzers) || !analyzers.every(isAnalyzer)) return false;\n if (!Array.isArray(analyzedFiles) || !analyzedFiles.every(isAnalyzedFile)) return false;\n return hasUniqueSnapshotIdentities(packages, workspaces, analyzers, analyzedFiles, files);\n}\n\n/*** Reject identities that would otherwise collapse or conflict during recomposition. */\nfunction hasUniqueSnapshotIdentities(\n packages: readonly ProjectAnalysisPackage[],\n workspaces: readonly ProjectAnalysisWorkspace[],\n analyzers: readonly ProjectAnalysisAnalyzer[],\n analyzedFiles: readonly ProjectAnalysisSourceFile[],\n files: readonly string[],\n): boolean {\n return (\n hasUniqueValues(packages.map(({ rootPath }) => rootPath)) &&\n hasUniqueValues(packages.flatMap(({ name }) => (name === undefined ? [] : [name]))) &&\n hasUniqueValues(workspaces.map(({ rootPath }) => rootPath)) &&\n hasUniqueValues(analyzers.map(({ id }) => id)) &&\n hasUniqueValues(analyzedFiles.map(({ path }) => path)) &&\n analyzedFiles.every(\n ({ analyzerId, path }) =>\n analyzers.some(({ id }) => id === analyzerId) && files.includes(path),\n )\n );\n}\n\n/*** Check project-relative package metadata. */\nfunction isPackage(value: unknown): value is ProjectAnalysisPackage {\n return (\n isRecord(value) &&\n isProjectRelativePath(value.rootPath, true) &&\n (value.name === undefined || isText(value.name))\n );\n}\n\n/*** Check workspace membership without accepting absolute or executable values. */\nfunction isWorkspace(value: unknown): value is ProjectAnalysisWorkspace {\n return (\n isRecord(value) &&\n isProjectRelativePath(value.rootPath, true) &&\n isProjectRelativePathArray(value.packagePaths, true)\n );\n}\n\n/*** Check analyzer provenance and its explicit capability list. */\nfunction isAnalyzer(value: unknown): value is ProjectAnalysisAnalyzer {\n if (!isRecord(value) || !isText(value.id) || !isTextArray(value.capabilities)) return false;\n const supported = sourceAnalyzerCapabilities(value.id);\n return isSourceAnalyzerId(value.id) && hasSameValues(value.capabilities, supported);\n}\n\n/*** Check portable parser output without retaining ASTs, paths, or arbitrary runtime values. */\nfunction isAnalyzedFile(value: unknown): value is ProjectAnalysisSourceFile {\n return (\n isRecord(value) &&\n isText(value.analyzerId) &&\n isProjectRelativePath(value.path) &&\n isSourceFacts(value.facts) &&\n (value.declaredDependencies === undefined ||\n isDependencyDeclarations(value.declaredDependencies))\n );\n}\n\n/*** Check the serializable language-neutral facts used by canonical relation resolution. */\nfunction isSourceFacts(value: unknown): boolean {\n return (\n isRecord(value) &&\n Array.isArray(value.declarations) &&\n value.declarations.every(isSourceDeclaration) &&\n Array.isArray(value.imports) &&\n value.imports.every(isSourceImport) &&\n (value.packageName === undefined || isText(value.packageName))\n );\n}\n\n/*** Check dependency evidence maps before projecting package-level graph edges. */\nfunction isDependencyDeclarations(value: unknown): boolean {\n return (\n isRecord(value) &&\n Object.values(value).every(\n (entries) =>\n Array.isArray(entries) &&\n entries.every(\n (entry) =>\n isRecord(entry) &&\n ['dependency', 'devDependency', 'optionalDependency', 'peerDependency'].includes(\n entry.kind as string,\n ) &&\n isText(entry.range),\n ),\n )\n );\n}\n\n/*** Check a recursive declaration fact before it becomes a semantic graph node. */\nfunction isSourceDeclaration(value: unknown): boolean {\n if (!isRecord(value)) return false;\n return hasSourceDeclarationStructure(value) && hasSourceDeclarationMetadata(value);\n}\n\n/*** Check recursive declaration structure before graph-node construction. */\nfunction hasSourceDeclarationStructure(value: Record<string, unknown>): boolean {\n return (\n Array.isArray(value.children) &&\n value.children.every(isSourceDeclaration) &&\n isTextArray(value.extends) &&\n isTextArray(value.implements) &&\n isSourceLocation(value.location) &&\n isTextArray(value.modifiers)\n );\n}\n\n/*** Check declaration attributes that establish its stable source identity. */\nfunction hasSourceDeclarationMetadata(value: Record<string, unknown>): boolean {\n return (\n (value.documentation === undefined || isSourceDocumentation(value.documentation)) &&\n (value.exported === undefined || typeof value.exported === 'boolean') &&\n (value.typeOnly === undefined || typeof value.typeOnly === 'boolean') &&\n ['class', 'constant', 'enum', 'function', 'interface', 'method', 'type', 'variable'].includes(\n value.kind as string,\n ) &&\n isText(value.name) &&\n (value.signature === undefined || isText(value.signature)) &&\n ['package', 'private', 'protected', 'public'].includes(value.visibility as string)\n );\n}\n\n/*** Check one portable import fact without admitting host paths into recomposition. */\nfunction isSourceImport(value: unknown): boolean {\n return (\n isRecord(value) &&\n (value.kind === undefined || value.kind === 'import' || value.kind === 'reexport') &&\n (value.local === undefined || typeof value.local === 'boolean') &&\n (value.location === undefined || isSourceLocation(value.location)) &&\n isText(value.specifier) &&\n (value.resolvedPath === undefined || isProjectRelativePath(value.resolvedPath)) &&\n (value.typeOnly === undefined || typeof value.typeOnly === 'boolean')\n );\n}\n\n/*** Check serializable documentation facts without retaining parser-owned values. */\nfunction isSourceDocumentation(value: unknown): boolean {\n return (\n isRecord(value) &&\n isText(value.text) &&\n isRecord(value.tags) &&\n Object.values(value.tags).every(isTextArray)\n );\n}\n\n/*** Check one finite, one-based source span. */\nfunction isSourceLocation(value: unknown): boolean {\n return (\n isRecord(value) &&\n [value.line, value.column, value.endLine, value.endColumn].every(\n (part) => typeof part === 'number' && Number.isSafeInteger(part) && part > 0,\n ) &&\n (value.endLine as number) >= (value.line as number) &&\n ((value.endLine as number) !== (value.line as number) ||\n (value.endColumn as number) >= (value.column as number))\n );\n}\n\n/*** Accept a canonical portable path that cannot escape its project snapshot. */\nfunction isProjectRelativePath(value: unknown, allowRoot = false): value is string {\n return (\n isText(value) &&\n (allowRoot || value !== '.') &&\n !value.includes('\\\\') &&\n !value.startsWith('/') &&\n !/^[a-z]:\\//iu.test(value) &&\n !value.split('/').some((segment) => segment === '..') &&\n normalizePortablePath(value) === value\n );\n}\n\n/*** Check a duplicate-free list of canonical project-relative paths. */\nfunction isProjectRelativePathArray(value: unknown, allowRoot = false): value is readonly string[] {\n return (\n Array.isArray(value) &&\n value.every((item) => isProjectRelativePath(item, allowRoot)) &&\n hasUniqueValues(value)\n );\n}\n\n/*** Compare one analyzer declaration with its canonical capability contract. */\nfunction hasSameValues(actual: readonly string[], expected: readonly string[]): boolean {\n return actual.join('\\u0000') === expected.join('\\u0000');\n}\n\n/*** Reject duplicate identities before they collapse into one canonical graph node. */\nfunction hasUniqueValues(values: readonly string[]): boolean {\n return new Set(values).size === values.length;\n}\n\n/*** Check a project identity without rejecting valid empty optional analyzer facts. */\nfunction isProjectId(value: unknown): value is string {\n return isText(value) && value.trim() !== '';\n}\n\n/*** Distinguish portable text fields from arbitrary values. */\nfunction isText(value: unknown): value is string {\n return typeof value === 'string';\n}\n\n/*** Check a JSON-safe list of portable identifiers. */\nfunction isTextArray(value: unknown): value is readonly string[] {\n return Array.isArray(value) && value.every(isText);\n}\n"]}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type { ProjectAnalysisSnapshot } from '../../../types/projectAnalysisSnapshot.js';
|
|
2
|
+
/*** Serialize a validated portable project analysis snapshot for cache storage or transfer. */
|
|
3
|
+
export declare function serializeProjectAnalysisSnapshot(snapshot: ProjectAnalysisSnapshot): string;
|
|
4
|
+
//# sourceMappingURL=serializeProjectAnalysisSnapshot.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serializeProjectAnalysisSnapshot.d.ts","sourceRoot":"","sources":["../../../../src/features/source-graph/domain/serializeProjectAnalysisSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAGzF,+FAA+F;AAC/F,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAG1F"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
import { assertProjectAnalysisSnapshot } from './projectAnalysisSnapshot.js';
|
|
2
|
+
/*** Serialize a validated portable project analysis snapshot for cache storage or transfer. */
|
|
3
|
+
export function serializeProjectAnalysisSnapshot(snapshot) {
|
|
4
|
+
assertProjectAnalysisSnapshot(snapshot);
|
|
5
|
+
return JSON.stringify(snapshot);
|
|
6
|
+
}
|
|
7
|
+
//# sourceMappingURL=serializeProjectAnalysisSnapshot.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serializeProjectAnalysisSnapshot.js","sourceRoot":"","sources":["../../../../src/features/source-graph/domain/serializeProjectAnalysisSnapshot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,6BAA6B,EAAE,MAAM,8BAA8B,CAAC;AAE7E,+FAA+F;AAC/F,MAAM,UAAU,gCAAgC,CAAC,QAAiC;IAChF,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;AAClC,CAAC","sourcesContent":["import type { ProjectAnalysisSnapshot } from '../../../types/projectAnalysisSnapshot.js';\nimport { assertProjectAnalysisSnapshot } from './projectAnalysisSnapshot.js';\n\n/*** Serialize a validated portable project analysis snapshot for cache storage or transfer. */\nexport function serializeProjectAnalysisSnapshot(snapshot: ProjectAnalysisSnapshot): string {\n assertProjectAnalysisSnapshot(snapshot);\n return JSON.stringify(snapshot);\n}\n"]}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { SourceCapability } from '../../../types/sourceGraph.js';
|
|
2
|
+
/*** Check whether an analyzer identity belongs to the portable snapshot contract. */
|
|
3
|
+
export declare function isSourceAnalyzerId(value: string): boolean;
|
|
4
|
+
/*** Declare the factual capabilities each supported analyzer contract can emit. */
|
|
5
|
+
export declare function sourceAnalyzerCapabilities(analyzerId: string): readonly SourceCapability[];
|
|
6
|
+
//# sourceMappingURL=sourceAnalyzerCapabilities.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourceAnalyzerCapabilities.d.ts","sourceRoot":"","sources":["../../../../src/features/source-graph/domain/sourceAnalyzerCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAWzD;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CA6B1F"}
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
/*** Check whether an analyzer identity belongs to the portable snapshot contract. */
|
|
2
|
+
export function isSourceAnalyzerId(value) {
|
|
3
|
+
return [
|
|
4
|
+
'cpp',
|
|
5
|
+
'delphi',
|
|
6
|
+
'java',
|
|
7
|
+
'javascript',
|
|
8
|
+
'kotlin',
|
|
9
|
+
'project-detector',
|
|
10
|
+
'python',
|
|
11
|
+
'typescript',
|
|
12
|
+
].includes(value);
|
|
13
|
+
}
|
|
14
|
+
/*** Declare the factual capabilities each supported analyzer contract can emit. */
|
|
15
|
+
export function sourceAnalyzerCapabilities(analyzerId) {
|
|
16
|
+
if (analyzerId === 'project-detector')
|
|
17
|
+
return ['containment'];
|
|
18
|
+
if (analyzerId === 'java')
|
|
19
|
+
return [
|
|
20
|
+
'containment',
|
|
21
|
+
'declarations',
|
|
22
|
+
'documentation',
|
|
23
|
+
'extends',
|
|
24
|
+
'implements',
|
|
25
|
+
'imports',
|
|
26
|
+
'signatures',
|
|
27
|
+
'source-locations',
|
|
28
|
+
'visibility',
|
|
29
|
+
];
|
|
30
|
+
if (analyzerId === 'typescript')
|
|
31
|
+
return [
|
|
32
|
+
'containment',
|
|
33
|
+
'declarations',
|
|
34
|
+
'documentation',
|
|
35
|
+
'exports',
|
|
36
|
+
'extends',
|
|
37
|
+
'implements',
|
|
38
|
+
'imports',
|
|
39
|
+
'signatures',
|
|
40
|
+
'source-locations',
|
|
41
|
+
'visibility',
|
|
42
|
+
];
|
|
43
|
+
if (['cpp', 'delphi', 'kotlin', 'python'].includes(analyzerId))
|
|
44
|
+
return ['imports'];
|
|
45
|
+
return [];
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=sourceAnalyzerCapabilities.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sourceAnalyzerCapabilities.js","sourceRoot":"","sources":["../../../../src/features/source-graph/domain/sourceAnalyzerCapabilities.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,OAAO;QACL,KAAK;QACL,QAAQ;QACR,MAAM;QACN,YAAY;QACZ,QAAQ;QACR,kBAAkB;QAClB,QAAQ;QACR,YAAY;KACb,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpB,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC3D,IAAI,UAAU,KAAK,kBAAkB;QAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC9D,IAAI,UAAU,KAAK,MAAM;QACvB,OAAO;YACL,aAAa;YACb,cAAc;YACd,eAAe;YACf,SAAS;YACT,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,kBAAkB;YAClB,YAAY;SACb,CAAC;IACJ,IAAI,UAAU,KAAK,YAAY;QAC7B,OAAO;YACL,aAAa;YACb,cAAc;YACd,eAAe;YACf,SAAS;YACT,SAAS;YACT,YAAY;YACZ,SAAS;YACT,YAAY;YACZ,kBAAkB;YAClB,YAAY;SACb,CAAC;IACJ,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACnF,OAAO,EAAE,CAAC;AACZ,CAAC","sourcesContent":["import type { SourceCapability } from '../../../types/sourceGraph.js';\n\n/*** Check whether an analyzer identity belongs to the portable snapshot contract. */\nexport function isSourceAnalyzerId(value: string): boolean {\n return [\n 'cpp',\n 'delphi',\n 'java',\n 'javascript',\n 'kotlin',\n 'project-detector',\n 'python',\n 'typescript',\n ].includes(value);\n}\n\n/*** Declare the factual capabilities each supported analyzer contract can emit. */\nexport function sourceAnalyzerCapabilities(analyzerId: string): readonly SourceCapability[] {\n if (analyzerId === 'project-detector') return ['containment'];\n if (analyzerId === 'java')\n return [\n 'containment',\n 'declarations',\n 'documentation',\n 'extends',\n 'implements',\n 'imports',\n 'signatures',\n 'source-locations',\n 'visibility',\n ];\n if (analyzerId === 'typescript')\n return [\n 'containment',\n 'declarations',\n 'documentation',\n 'exports',\n 'extends',\n 'implements',\n 'imports',\n 'signatures',\n 'source-locations',\n 'visibility',\n ];\n if (['cpp', 'delphi', 'kotlin', 'python'].includes(analyzerId)) return ['imports'];\n return [];\n}\n"]}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ProjectInspection } from '@ankhorage/project-detector/types';
|
|
2
|
+
import type { SourceAnalyzedFile, SourceCapability, SourceFileFacts } from './sourceGraph.js';
|
|
3
|
+
/*** Versioned, filesystem-independent facts required to recompose one analyzed project. */
|
|
4
|
+
export interface ProjectAnalysisSnapshot {
|
|
5
|
+
readonly version: 1;
|
|
6
|
+
readonly projectId: string;
|
|
7
|
+
readonly directories: readonly string[];
|
|
8
|
+
readonly files: readonly string[];
|
|
9
|
+
readonly packages: readonly ProjectAnalysisPackage[];
|
|
10
|
+
readonly workspaces: readonly ProjectAnalysisWorkspace[];
|
|
11
|
+
readonly analyzers: readonly ProjectAnalysisAnalyzer[];
|
|
12
|
+
readonly analyzedFiles: readonly ProjectAnalysisSourceFile[];
|
|
13
|
+
}
|
|
14
|
+
/*** One detected package expressed only with project-relative identity. */
|
|
15
|
+
export interface ProjectAnalysisPackage {
|
|
16
|
+
readonly rootPath: string;
|
|
17
|
+
readonly name?: string;
|
|
18
|
+
}
|
|
19
|
+
/*** Workspace membership required to retain the established focus-package selection. */
|
|
20
|
+
export interface ProjectAnalysisWorkspace {
|
|
21
|
+
readonly rootPath: string;
|
|
22
|
+
readonly packagePaths: readonly string[];
|
|
23
|
+
}
|
|
24
|
+
/*** Analyzer provenance and available factual capabilities captured at analysis time. */
|
|
25
|
+
export interface ProjectAnalysisAnalyzer {
|
|
26
|
+
readonly id: string;
|
|
27
|
+
readonly capabilities: readonly SourceCapability[];
|
|
28
|
+
}
|
|
29
|
+
/*** One project-relative source file and its language-neutral analyzer output. */
|
|
30
|
+
export interface ProjectAnalysisSourceFile {
|
|
31
|
+
readonly analyzerId: string;
|
|
32
|
+
readonly facts: SourceFileFacts;
|
|
33
|
+
readonly path: string;
|
|
34
|
+
readonly declaredDependencies?: SourceAnalyzedFile['declaredDependencies'];
|
|
35
|
+
}
|
|
36
|
+
/*** A project root or its already-bounded inspection may create a portable analysis snapshot. */
|
|
37
|
+
export type CreateProjectAnalysisSnapshotInput = {
|
|
38
|
+
readonly id: string;
|
|
39
|
+
readonly rootPath: string;
|
|
40
|
+
} | {
|
|
41
|
+
readonly id: string;
|
|
42
|
+
readonly inspection: ProjectInspection;
|
|
43
|
+
};
|
|
44
|
+
//# sourceMappingURL=projectAnalysisSnapshot.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projectAnalysisSnapshot.d.ts","sourceRoot":"","sources":["../../src/types/projectAnalysisSnapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE9F,2FAA2F;AAC3F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,SAAS,wBAAwB,EAAE,CAAC;IACzD,QAAQ,CAAC,SAAS,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACvD,QAAQ,CAAC,aAAa,EAAE,SAAS,yBAAyB,EAAE,CAAC;CAC9D;AAED,2EAA2E;AAC3E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wFAAwF;AACxF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAED,yFAAyF;AACzF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACpD;AAED,kFAAkF;AAClF,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,oBAAoB,CAAC,EAAE,kBAAkB,CAAC,sBAAsB,CAAC,CAAC;CAC5E;AAED,iGAAiG;AACjG,MAAM,MAAM,kCAAkC,GAC1C;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAClD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;CACxC,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"projectAnalysisSnapshot.js","sourceRoot":"","sources":["../../src/types/projectAnalysisSnapshot.ts"],"names":[],"mappings":"","sourcesContent":["import type { ProjectInspection } from '@ankhorage/project-detector/types';\n\nimport type { SourceAnalyzedFile, SourceCapability, SourceFileFacts } from './sourceGraph.js';\n\n/*** Versioned, filesystem-independent facts required to recompose one analyzed project. */\nexport interface ProjectAnalysisSnapshot {\n readonly version: 1;\n readonly projectId: string;\n readonly directories: readonly string[];\n readonly files: readonly string[];\n readonly packages: readonly ProjectAnalysisPackage[];\n readonly workspaces: readonly ProjectAnalysisWorkspace[];\n readonly analyzers: readonly ProjectAnalysisAnalyzer[];\n readonly analyzedFiles: readonly ProjectAnalysisSourceFile[];\n}\n\n/*** One detected package expressed only with project-relative identity. */\nexport interface ProjectAnalysisPackage {\n readonly rootPath: string;\n readonly name?: string;\n}\n\n/*** Workspace membership required to retain the established focus-package selection. */\nexport interface ProjectAnalysisWorkspace {\n readonly rootPath: string;\n readonly packagePaths: readonly string[];\n}\n\n/*** Analyzer provenance and available factual capabilities captured at analysis time. */\nexport interface ProjectAnalysisAnalyzer {\n readonly id: string;\n readonly capabilities: readonly SourceCapability[];\n}\n\n/*** One project-relative source file and its language-neutral analyzer output. */\nexport interface ProjectAnalysisSourceFile {\n readonly analyzerId: string;\n readonly facts: SourceFileFacts;\n readonly path: string;\n readonly declaredDependencies?: SourceAnalyzedFile['declaredDependencies'];\n}\n\n/*** A project root or its already-bounded inspection may create a portable analysis snapshot. */\nexport type CreateProjectAnalysisSnapshotInput =\n | { readonly id: string; readonly rootPath: string }\n | {\n readonly id: string;\n readonly inspection: ProjectInspection;\n };\n"]}
|