@ankhorage/dependency-graph 1.5.0 → 1.5.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/CHANGELOG.md
CHANGED
|
@@ -16,7 +16,10 @@ export function projectSourceFeatures(sourceGraph) {
|
|
|
16
16
|
}
|
|
17
17
|
/*** Accept only the published one-token feature tag contract from TypeScript declarations. */
|
|
18
18
|
function featureEvidence(data, analyzerId) {
|
|
19
|
-
if (analyzerId !== 'typescript' ||
|
|
19
|
+
if (analyzerId !== 'typescript' ||
|
|
20
|
+
!isDeclaration(data.kind) ||
|
|
21
|
+
data.filePath === undefined ||
|
|
22
|
+
data.location === undefined)
|
|
20
23
|
return {};
|
|
21
24
|
const tags = data.documentation?.tags.feature ?? [];
|
|
22
25
|
if (tags.length === 0)
|
|
@@ -48,6 +51,10 @@ function featureEvidence(data, analyzerId) {
|
|
|
48
51
|
},
|
|
49
52
|
};
|
|
50
53
|
}
|
|
54
|
+
/*** Accept feature metadata only from canonical declaration nodes, never graph containers. */
|
|
55
|
+
function isDeclaration(kind) {
|
|
56
|
+
return kind !== 'project' && kind !== 'package' && kind !== 'directory' && kind !== 'file';
|
|
57
|
+
}
|
|
51
58
|
/*** Build deterministic project-scoped features without treating absent tags as negative evidence. */
|
|
52
59
|
function featuresFromMembers(members) {
|
|
53
60
|
const grouped = new Map();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"projectSourceFeatures.js","sourceRoot":"","sources":["../../../../src/features/source-graph/application/projectSourceFeatures.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n SourceFeature,\n SourceFeatureCapability,\n SourceFeatureDiagnostic,\n SourceFeatureProjection,\n SourceGraph,\n SourceNodeData,\n} from '../../../types/sourceGraph.js';\nimport { sourceSemanticPath } from '../domain/sourceSemanticPath.js';\n\n/*** Project only explicit TypeScript `@feature <name>` declaration evidence from a SourceGraph. */\nexport function projectSourceFeatures(sourceGraph: SourceGraph): SourceFeatureProjection {\n const analyzersByFile = new Map(\n sourceGraph.graph.nodes\n .filter(({ data }) => data.kind === 'file' && data.filePath !== undefined)\n .map(({ data }) => [fileKey(data.projectId, data.filePath), data.analyzerId]),\n );\n const evidence = sourceGraph.graph.nodes.flatMap(({ data }) =>\n featureEvidence(data, analyzersByFile.get(fileKey(data.projectId, data.filePath))),\n );\n const diagnostics = evidence.flatMap(({ diagnostic }) =>\n diagnostic === undefined ? [] : [diagnostic],\n );\n const members = evidence.flatMap(({ member }) => (member === undefined ? [] : [member]));\n return {\n version: 1,\n capabilities: featureCapabilities(sourceGraph),\n diagnostics: diagnostics.sort(compareDiagnostic),\n features: featuresFromMembers(members),\n };\n}\n\ninterface FeatureEvidence {\n readonly diagnostic?: SourceFeatureDiagnostic;\n readonly member?: {\n readonly featureName: string;\n readonly featureId: string;\n readonly member: SourceFeature['members'][number];\n };\n}\n\n/*** Accept only the published one-token feature tag contract from TypeScript declarations. */\nfunction featureEvidence(data: SourceNodeData, analyzerId: string | undefined): FeatureEvidence {\n if (analyzerId !== 'typescript' || data.filePath === undefined || data.location === undefined)\n return {};\n const tags = data.documentation?.tags.feature ?? [];\n if (tags.length === 0) return {};\n const names = tags.map((tag) => tag.trim());\n const [name] = names;\n if (names.length !== 1 || name === undefined || !isFeatureName(name)) {\n return {\n diagnostic: {\n analyzerId,\n projectId: data.projectId,\n filePath: data.filePath,\n location: data.location,\n semanticPath: data.semanticPath,\n message: 'A TypeScript feature declaration must have exactly one @feature <name> tag.',\n },\n };\n }\n return {\n member: {\n featureName: name,\n featureId: sourceSemanticPath('feature', data.projectId, name),\n member: {\n analyzerId,\n filePath: data.filePath,\n evidence: data.location,\n semanticPath: data.semanticPath,\n },\n },\n };\n}\n\n/*** Build deterministic project-scoped features without treating absent tags as negative evidence. */\nfunction featuresFromMembers(\n members: readonly NonNullable<FeatureEvidence['member']>[],\n): readonly SourceFeature[] {\n const grouped = new Map<\n string,\n {\n readonly id: string;\n readonly name: string;\n readonly projectId: string;\n readonly members: SourceFeature['members'][number][];\n }\n >();\n for (const item of members) {\n const existing = grouped.get(item.featureId);\n if (existing === undefined) {\n grouped.set(item.featureId, {\n id: item.featureId,\n name: item.featureName,\n projectId: projectIdFromFeatureId(item.featureId),\n members: [item.member],\n });\n } else existing.members.push(item.member);\n }\n return [...grouped.values()]\n .map(({ members: groupedMembers, ...feature }) => ({\n ...feature,\n members: [...groupedMembers].sort((left, right) =>\n compareText(left.semanticPath, right.semanticPath),\n ),\n }))\n .sort((left, right) => compareText(left.id, right.id));\n}\n\n/*** Preserve analyzer-level unavailable states instead of guessing feature support from source shape. */\nfunction featureCapabilities(sourceGraph: SourceGraph): readonly SourceFeatureCapability[] {\n return sourceGraph.capabilities\n .map(({ analyzerId, projectId, available }) => ({\n analyzerId,\n projectId,\n state:\n analyzerId === 'typescript' &&\n available.includes('declarations') &&\n available.includes('documentation') &&\n available.includes('source-locations')\n ? ('available' as const)\n : ('unavailable' as const),\n }))\n .sort((left, right) =>\n compareText(`${left.projectId}:${left.analyzerId}`, `${right.projectId}:${right.analyzerId}`),\n );\n}\n\n/*** Reject spaces and prose so a feature identity remains portable and stable. */\nfunction isFeatureName(value: string): boolean {\n return /^[A-Za-z][A-Za-z0-9._/-]*$/u.test(value);\n}\n\n/*** Recover the encoded project identity already embedded in the canonical feature semantic path. */\nfunction projectIdFromFeatureId(id: string): string {\n return decodeURIComponent(id.split(':')[1] ?? '');\n}\n\n/*** Scope an analyzed file lookup without conflating equally named project files. */\nfunction fileKey(projectId: string, filePath: string | undefined): string {\n return `${projectId}\\u0000${filePath ?? ''}`;\n}\n\n/*** Keep diagnostic order reproducible across fresh and restored source snapshots. */\nfunction compareDiagnostic(left: SourceFeatureDiagnostic, right: SourceFeatureDiagnostic): number {\n return compareText(\n `${left.semanticPath}:${left.message}`,\n `${right.semanticPath}:${right.message}`,\n );\n}\n\n/*** Compare portable identities without host locale effects. */\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n return left > right ? 1 : 0;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"projectSourceFeatures.js","sourceRoot":"","sources":["../../../../src/features/source-graph/application/projectSourceFeatures.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n SourceFeature,\n SourceFeatureCapability,\n SourceFeatureDiagnostic,\n SourceFeatureProjection,\n SourceGraph,\n SourceNodeData,\n} from '../../../types/sourceGraph.js';\nimport { sourceSemanticPath } from '../domain/sourceSemanticPath.js';\n\n/*** Project only explicit TypeScript `@feature <name>` declaration evidence from a SourceGraph. */\nexport function projectSourceFeatures(sourceGraph: SourceGraph): SourceFeatureProjection {\n const analyzersByFile = new Map(\n sourceGraph.graph.nodes\n .filter(({ data }) => data.kind === 'file' && data.filePath !== undefined)\n .map(({ data }) => [fileKey(data.projectId, data.filePath), data.analyzerId]),\n );\n const evidence = sourceGraph.graph.nodes.flatMap(({ data }) =>\n featureEvidence(data, analyzersByFile.get(fileKey(data.projectId, data.filePath))),\n );\n const diagnostics = evidence.flatMap(({ diagnostic }) =>\n diagnostic === undefined ? [] : [diagnostic],\n );\n const members = evidence.flatMap(({ member }) => (member === undefined ? [] : [member]));\n return {\n version: 1,\n capabilities: featureCapabilities(sourceGraph),\n diagnostics: diagnostics.sort(compareDiagnostic),\n features: featuresFromMembers(members),\n };\n}\n\ninterface FeatureEvidence {\n readonly diagnostic?: SourceFeatureDiagnostic;\n readonly member?: {\n readonly featureName: string;\n readonly featureId: string;\n readonly member: SourceFeature['members'][number];\n };\n}\n\n/*** Accept only the published one-token feature tag contract from TypeScript declarations. */\nfunction featureEvidence(data: SourceNodeData, analyzerId: string | undefined): FeatureEvidence {\n if (\n analyzerId !== 'typescript' ||\n !isDeclaration(data.kind) ||\n data.filePath === undefined ||\n data.location === undefined\n )\n return {};\n const tags = data.documentation?.tags.feature ?? [];\n if (tags.length === 0) return {};\n const names = tags.map((tag) => tag.trim());\n const [name] = names;\n if (names.length !== 1 || name === undefined || !isFeatureName(name)) {\n return {\n diagnostic: {\n analyzerId,\n projectId: data.projectId,\n filePath: data.filePath,\n location: data.location,\n semanticPath: data.semanticPath,\n message: 'A TypeScript feature declaration must have exactly one @feature <name> tag.',\n },\n };\n }\n return {\n member: {\n featureName: name,\n featureId: sourceSemanticPath('feature', data.projectId, name),\n member: {\n analyzerId,\n filePath: data.filePath,\n evidence: data.location,\n semanticPath: data.semanticPath,\n },\n },\n };\n}\n\n/*** Accept feature metadata only from canonical declaration nodes, never graph containers. */\nfunction isDeclaration(kind: SourceNodeData['kind']): boolean {\n return kind !== 'project' && kind !== 'package' && kind !== 'directory' && kind !== 'file';\n}\n\n/*** Build deterministic project-scoped features without treating absent tags as negative evidence. */\nfunction featuresFromMembers(\n members: readonly NonNullable<FeatureEvidence['member']>[],\n): readonly SourceFeature[] {\n const grouped = new Map<\n string,\n {\n readonly id: string;\n readonly name: string;\n readonly projectId: string;\n readonly members: SourceFeature['members'][number][];\n }\n >();\n for (const item of members) {\n const existing = grouped.get(item.featureId);\n if (existing === undefined) {\n grouped.set(item.featureId, {\n id: item.featureId,\n name: item.featureName,\n projectId: projectIdFromFeatureId(item.featureId),\n members: [item.member],\n });\n } else existing.members.push(item.member);\n }\n return [...grouped.values()]\n .map(({ members: groupedMembers, ...feature }) => ({\n ...feature,\n members: [...groupedMembers].sort((left, right) =>\n compareText(left.semanticPath, right.semanticPath),\n ),\n }))\n .sort((left, right) => compareText(left.id, right.id));\n}\n\n/*** Preserve analyzer-level unavailable states instead of guessing feature support from source shape. */\nfunction featureCapabilities(sourceGraph: SourceGraph): readonly SourceFeatureCapability[] {\n return sourceGraph.capabilities\n .map(({ analyzerId, projectId, available }) => ({\n analyzerId,\n projectId,\n state:\n analyzerId === 'typescript' &&\n available.includes('declarations') &&\n available.includes('documentation') &&\n available.includes('source-locations')\n ? ('available' as const)\n : ('unavailable' as const),\n }))\n .sort((left, right) =>\n compareText(`${left.projectId}:${left.analyzerId}`, `${right.projectId}:${right.analyzerId}`),\n );\n}\n\n/*** Reject spaces and prose so a feature identity remains portable and stable. */\nfunction isFeatureName(value: string): boolean {\n return /^[A-Za-z][A-Za-z0-9._/-]*$/u.test(value);\n}\n\n/*** Recover the encoded project identity already embedded in the canonical feature semantic path. */\nfunction projectIdFromFeatureId(id: string): string {\n return decodeURIComponent(id.split(':')[1] ?? '');\n}\n\n/*** Scope an analyzed file lookup without conflating equally named project files. */\nfunction fileKey(projectId: string, filePath: string | undefined): string {\n return `${projectId}\\u0000${filePath ?? ''}`;\n}\n\n/*** Keep diagnostic order reproducible across fresh and restored source snapshots. */\nfunction compareDiagnostic(left: SourceFeatureDiagnostic, right: SourceFeatureDiagnostic): number {\n return compareText(\n `${left.semanticPath}:${left.message}`,\n `${right.semanticPath}:${right.message}`,\n );\n}\n\n/*** Compare portable identities without host locale effects. */\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n return left > right ? 1 : 0;\n}\n"]}
|