@vltpkg/graph 1.0.0-rc.2 → 1.0.0-rc.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (211) hide show
  1. package/README.md +101 -22
  2. package/package.json +51 -63
  3. package/dist/esm/actual/load.d.ts +0 -100
  4. package/dist/esm/actual/load.d.ts.map +0 -1
  5. package/dist/esm/actual/load.js +0 -304
  6. package/dist/esm/actual/load.js.map +0 -1
  7. package/dist/esm/browser.d.ts +0 -15
  8. package/dist/esm/browser.d.ts.map +0 -1
  9. package/dist/esm/browser.js +0 -17
  10. package/dist/esm/browser.js.map +0 -1
  11. package/dist/esm/build.d.ts +0 -29
  12. package/dist/esm/build.d.ts.map +0 -1
  13. package/dist/esm/build.js +0 -79
  14. package/dist/esm/build.js.map +0 -1
  15. package/dist/esm/dependencies.d.ts +0 -66
  16. package/dist/esm/dependencies.d.ts.map +0 -1
  17. package/dist/esm/dependencies.js +0 -112
  18. package/dist/esm/dependencies.js.map +0 -1
  19. package/dist/esm/diff.d.ts +0 -116
  20. package/dist/esm/diff.d.ts.map +0 -1
  21. package/dist/esm/diff.js +0 -148
  22. package/dist/esm/diff.js.map +0 -1
  23. package/dist/esm/edge.d.ts +0 -46
  24. package/dist/esm/edge.d.ts.map +0 -1
  25. package/dist/esm/edge.js +0 -74
  26. package/dist/esm/edge.js.map +0 -1
  27. package/dist/esm/graph.d.ts +0 -133
  28. package/dist/esm/graph.d.ts.map +0 -1
  29. package/dist/esm/graph.js +0 -407
  30. package/dist/esm/graph.js.map +0 -1
  31. package/dist/esm/ideal/add-nodes.d.ts +0 -34
  32. package/dist/esm/ideal/add-nodes.d.ts.map +0 -1
  33. package/dist/esm/ideal/add-nodes.js +0 -39
  34. package/dist/esm/ideal/add-nodes.js.map +0 -1
  35. package/dist/esm/ideal/append-nodes.d.ts +0 -19
  36. package/dist/esm/ideal/append-nodes.d.ts.map +0 -1
  37. package/dist/esm/ideal/append-nodes.js +0 -289
  38. package/dist/esm/ideal/append-nodes.js.map +0 -1
  39. package/dist/esm/ideal/build-ideal-from-starting-graph.d.ts +0 -15
  40. package/dist/esm/ideal/build-ideal-from-starting-graph.d.ts.map +0 -1
  41. package/dist/esm/ideal/build-ideal-from-starting-graph.js +0 -55
  42. package/dist/esm/ideal/build-ideal-from-starting-graph.js.map +0 -1
  43. package/dist/esm/ideal/build.d.ts +0 -41
  44. package/dist/esm/ideal/build.d.ts.map +0 -1
  45. package/dist/esm/ideal/build.js +0 -48
  46. package/dist/esm/ideal/build.js.map +0 -1
  47. package/dist/esm/ideal/get-importer-specs.d.ts +0 -14
  48. package/dist/esm/ideal/get-importer-specs.d.ts.map +0 -1
  49. package/dist/esm/ideal/get-importer-specs.js +0 -106
  50. package/dist/esm/ideal/get-importer-specs.js.map +0 -1
  51. package/dist/esm/ideal/remove-nodes.d.ts +0 -7
  52. package/dist/esm/ideal/remove-nodes.d.ts.map +0 -1
  53. package/dist/esm/ideal/remove-nodes.js +0 -19
  54. package/dist/esm/ideal/remove-nodes.js.map +0 -1
  55. package/dist/esm/ideal/remove-satisfied-specs.d.ts +0 -8
  56. package/dist/esm/ideal/remove-satisfied-specs.d.ts.map +0 -1
  57. package/dist/esm/ideal/remove-satisfied-specs.js +0 -35
  58. package/dist/esm/ideal/remove-satisfied-specs.js.map +0 -1
  59. package/dist/esm/ideal/types.d.ts +0 -35
  60. package/dist/esm/ideal/types.d.ts.map +0 -1
  61. package/dist/esm/ideal/types.js +0 -2
  62. package/dist/esm/ideal/types.js.map +0 -1
  63. package/dist/esm/index.d.ts +0 -38
  64. package/dist/esm/index.d.ts.map +0 -1
  65. package/dist/esm/index.js +0 -32
  66. package/dist/esm/index.js.map +0 -1
  67. package/dist/esm/install.d.ts +0 -19
  68. package/dist/esm/install.d.ts.map +0 -1
  69. package/dist/esm/install.js +0 -173
  70. package/dist/esm/install.js.map +0 -1
  71. package/dist/esm/lockfile/load-edges.d.ts +0 -12
  72. package/dist/esm/lockfile/load-edges.d.ts.map +0 -1
  73. package/dist/esm/lockfile/load-edges.js +0 -105
  74. package/dist/esm/lockfile/load-edges.js.map +0 -1
  75. package/dist/esm/lockfile/load-nodes.d.ts +0 -5
  76. package/dist/esm/lockfile/load-nodes.d.ts.map +0 -1
  77. package/dist/esm/lockfile/load-nodes.js +0 -95
  78. package/dist/esm/lockfile/load-nodes.js.map +0 -1
  79. package/dist/esm/lockfile/load.d.ts +0 -50
  80. package/dist/esm/lockfile/load.d.ts.map +0 -1
  81. package/dist/esm/lockfile/load.js +0 -89
  82. package/dist/esm/lockfile/load.js.map +0 -1
  83. package/dist/esm/lockfile/save.d.ts +0 -31
  84. package/dist/esm/lockfile/save.d.ts.map +0 -1
  85. package/dist/esm/lockfile/save.js +0 -173
  86. package/dist/esm/lockfile/save.js.map +0 -1
  87. package/dist/esm/lockfile/types.d.ts +0 -89
  88. package/dist/esm/lockfile/types.d.ts.map +0 -1
  89. package/dist/esm/lockfile/types.js +0 -44
  90. package/dist/esm/lockfile/types.js.map +0 -1
  91. package/dist/esm/modifiers.d.ts +0 -189
  92. package/dist/esm/modifiers.d.ts.map +0 -1
  93. package/dist/esm/modifiers.js +0 -330
  94. package/dist/esm/modifiers.js.map +0 -1
  95. package/dist/esm/node.d.ts +0 -219
  96. package/dist/esm/node.d.ts.map +0 -1
  97. package/dist/esm/node.js +0 -368
  98. package/dist/esm/node.js.map +0 -1
  99. package/dist/esm/non-empty-list.d.ts +0 -3
  100. package/dist/esm/non-empty-list.d.ts.map +0 -1
  101. package/dist/esm/non-empty-list.js +0 -3
  102. package/dist/esm/non-empty-list.js.map +0 -1
  103. package/dist/esm/package.json +0 -3
  104. package/dist/esm/reify/add-edge.d.ts +0 -10
  105. package/dist/esm/reify/add-edge.d.ts.map +0 -1
  106. package/dist/esm/reify/add-edge.js +0 -65
  107. package/dist/esm/reify/add-edge.js.map +0 -1
  108. package/dist/esm/reify/add-edges.d.ts +0 -5
  109. package/dist/esm/reify/add-edges.d.ts.map +0 -1
  110. package/dist/esm/reify/add-edges.js +0 -12
  111. package/dist/esm/reify/add-edges.js.map +0 -1
  112. package/dist/esm/reify/add-nodes.d.ts +0 -7
  113. package/dist/esm/reify/add-nodes.d.ts.map +0 -1
  114. package/dist/esm/reify/add-nodes.js +0 -17
  115. package/dist/esm/reify/add-nodes.js.map +0 -1
  116. package/dist/esm/reify/bin-chmod.d.ts +0 -11
  117. package/dist/esm/reify/bin-chmod.d.ts.map +0 -1
  118. package/dist/esm/reify/bin-chmod.js +0 -39
  119. package/dist/esm/reify/bin-chmod.js.map +0 -1
  120. package/dist/esm/reify/build.d.ts +0 -14
  121. package/dist/esm/reify/build.d.ts.map +0 -1
  122. package/dist/esm/reify/build.js +0 -103
  123. package/dist/esm/reify/build.js.map +0 -1
  124. package/dist/esm/reify/calculate-save-value.d.ts +0 -3
  125. package/dist/esm/reify/calculate-save-value.d.ts.map +0 -1
  126. package/dist/esm/reify/calculate-save-value.js +0 -45
  127. package/dist/esm/reify/calculate-save-value.js.map +0 -1
  128. package/dist/esm/reify/check-needed-build.d.ts +0 -25
  129. package/dist/esm/reify/check-needed-build.d.ts.map +0 -1
  130. package/dist/esm/reify/check-needed-build.js +0 -50
  131. package/dist/esm/reify/check-needed-build.js.map +0 -1
  132. package/dist/esm/reify/delete-edge.d.ts +0 -5
  133. package/dist/esm/reify/delete-edge.d.ts.map +0 -1
  134. package/dist/esm/reify/delete-edge.js +0 -28
  135. package/dist/esm/reify/delete-edge.js.map +0 -1
  136. package/dist/esm/reify/delete-edges.d.ts +0 -5
  137. package/dist/esm/reify/delete-edges.d.ts.map +0 -1
  138. package/dist/esm/reify/delete-edges.js +0 -14
  139. package/dist/esm/reify/delete-edges.js.map +0 -1
  140. package/dist/esm/reify/delete-nodes.d.ts +0 -5
  141. package/dist/esm/reify/delete-nodes.d.ts.map +0 -1
  142. package/dist/esm/reify/delete-nodes.js +0 -16
  143. package/dist/esm/reify/delete-nodes.js.map +0 -1
  144. package/dist/esm/reify/extract-node.d.ts +0 -24
  145. package/dist/esm/reify/extract-node.d.ts.map +0 -1
  146. package/dist/esm/reify/extract-node.js +0 -76
  147. package/dist/esm/reify/extract-node.js.map +0 -1
  148. package/dist/esm/reify/index.d.ts +0 -34
  149. package/dist/esm/reify/index.d.ts.map +0 -1
  150. package/dist/esm/reify/index.js +0 -161
  151. package/dist/esm/reify/index.js.map +0 -1
  152. package/dist/esm/reify/internal-hoist.d.ts +0 -9
  153. package/dist/esm/reify/internal-hoist.d.ts.map +0 -1
  154. package/dist/esm/reify/internal-hoist.js +0 -134
  155. package/dist/esm/reify/internal-hoist.js.map +0 -1
  156. package/dist/esm/reify/optional-fail.d.ts +0 -16
  157. package/dist/esm/reify/optional-fail.d.ts.map +0 -1
  158. package/dist/esm/reify/optional-fail.js +0 -16
  159. package/dist/esm/reify/optional-fail.js.map +0 -1
  160. package/dist/esm/reify/rollback.d.ts +0 -5
  161. package/dist/esm/reify/rollback.d.ts.map +0 -1
  162. package/dist/esm/reify/rollback.js +0 -24
  163. package/dist/esm/reify/rollback.js.map +0 -1
  164. package/dist/esm/reify/update-importers-package-json.d.ts +0 -36
  165. package/dist/esm/reify/update-importers-package-json.d.ts.map +0 -1
  166. package/dist/esm/reify/update-importers-package-json.js +0 -120
  167. package/dist/esm/reify/update-importers-package-json.js.map +0 -1
  168. package/dist/esm/remove-optional-subgraph.d.ts +0 -34
  169. package/dist/esm/remove-optional-subgraph.d.ts.map +0 -1
  170. package/dist/esm/remove-optional-subgraph.js +0 -48
  171. package/dist/esm/remove-optional-subgraph.js.map +0 -1
  172. package/dist/esm/resolve-save-type.d.ts +0 -6
  173. package/dist/esm/resolve-save-type.d.ts.map +0 -1
  174. package/dist/esm/resolve-save-type.js +0 -5
  175. package/dist/esm/resolve-save-type.js.map +0 -1
  176. package/dist/esm/stringify-node.d.ts +0 -3
  177. package/dist/esm/stringify-node.d.ts.map +0 -1
  178. package/dist/esm/stringify-node.js +0 -24
  179. package/dist/esm/stringify-node.js.map +0 -1
  180. package/dist/esm/transfer-data/load.d.ts +0 -44
  181. package/dist/esm/transfer-data/load.d.ts.map +0 -1
  182. package/dist/esm/transfer-data/load.js +0 -176
  183. package/dist/esm/transfer-data/load.js.map +0 -1
  184. package/dist/esm/uninstall.d.ts +0 -15
  185. package/dist/esm/uninstall.d.ts.map +0 -1
  186. package/dist/esm/uninstall.js +0 -58
  187. package/dist/esm/uninstall.js.map +0 -1
  188. package/dist/esm/update.d.ts +0 -13
  189. package/dist/esm/update.d.ts.map +0 -1
  190. package/dist/esm/update.js +0 -63
  191. package/dist/esm/update.js.map +0 -1
  192. package/dist/esm/virtual-root.d.ts +0 -16
  193. package/dist/esm/virtual-root.d.ts.map +0 -1
  194. package/dist/esm/virtual-root.js +0 -79
  195. package/dist/esm/virtual-root.js.map +0 -1
  196. package/dist/esm/visualization/human-readable-output.d.ts +0 -27
  197. package/dist/esm/visualization/human-readable-output.d.ts.map +0 -1
  198. package/dist/esm/visualization/human-readable-output.js +0 -159
  199. package/dist/esm/visualization/human-readable-output.js.map +0 -1
  200. package/dist/esm/visualization/json-output.d.ts +0 -41
  201. package/dist/esm/visualization/json-output.d.ts.map +0 -1
  202. package/dist/esm/visualization/json-output.js +0 -51
  203. package/dist/esm/visualization/json-output.js.map +0 -1
  204. package/dist/esm/visualization/mermaid-output.d.ts +0 -17
  205. package/dist/esm/visualization/mermaid-output.d.ts.map +0 -1
  206. package/dist/esm/visualization/mermaid-output.js +0 -123
  207. package/dist/esm/visualization/mermaid-output.js.map +0 -1
  208. package/dist/esm/visualization/object-like-output.d.ts +0 -3
  209. package/dist/esm/visualization/object-like-output.d.ts.map +0 -1
  210. package/dist/esm/visualization/object-like-output.js +0 -48
  211. package/dist/esm/visualization/object-like-output.js.map +0 -1
@@ -1,304 +0,0 @@
1
- import { asDepID, hydrate, joinDepIDTuple } from '@vltpkg/dep-id';
2
- import { Spec } from '@vltpkg/spec';
3
- import { graphStep } from '@vltpkg/output';
4
- import { isObject } from '@vltpkg/types';
5
- import { shorten, getRawDependencies, getDependencies, } from "../dependencies.js";
6
- import { Graph } from "../graph.js";
7
- import { loadHidden } from "../lockfile/load.js";
8
- import { saveHidden } from "../lockfile/save.js";
9
- import { readFileSync } from 'node:fs';
10
- /**
11
- * Checks if a given object is a {@link StoreConfigObject}.
12
- */
13
- export const isStoreConfigObject = (obj) => isObject(obj) &&
14
- Object.prototype.hasOwnProperty.call(obj, 'modifiers') &&
15
- isObject(obj.modifiers);
16
- /**
17
- * Returns a {@link StoreConfigObject} from a given object.
18
- * Throws a TypeError if the object can't be converted.
19
- */
20
- export const asStoreConfigObject = (obj) => {
21
- if (!isStoreConfigObject(obj)) {
22
- throw new TypeError(`Expected a store config object, got ${obj}`);
23
- }
24
- return obj;
25
- };
26
- // path-based refer to the types of dependencies that are directly linked to
27
- // their real location in the file system and thus will not have an entry
28
- // in the `node_modules/.vlt` store
29
- const pathBasedType = new Set(['file', 'workspace']);
30
- const isPathBasedType = (type) => pathBasedType.has(type);
31
- /**
32
- * Returns a {@link DepID} for a given spec and path, if the spec is
33
- * path-based or a registry spec, otherwise returns `undefined`.
34
- */
35
- export const getPathBasedId = (spec, path) => isPathBasedType(spec.type) ?
36
- joinDepIDTuple([spec.type, path.relativePosix()])
37
- : findDepID(path);
38
- /**
39
- * Retrieve the {@link DepID} for a given package from its location.
40
- */
41
- const findDepID = ({ parent, name }) => parent?.name === '.vlt' ? asDepID(name)
42
- : parent?.isCWD === false ? findDepID(parent)
43
- : undefined;
44
- /**
45
- * Retrieves the closest `node_modules` parent {@link Path} found.
46
- */
47
- const findNodeModules = ({ parent, name, isCWD, }) => parent?.name === 'node_modules' ? parent
48
- : parent && name !== '.vlt' && !isCWD ? findNodeModules(parent)
49
- : undefined;
50
- /**
51
- * Retrieves the scoped-normalized package name from its {@link Path}.
52
- */
53
- const findName = ({ parent, name }) => parent?.name.startsWith('@') ? `${parent.name}/${name}` : name;
54
- /**
55
- * Helper function that gets a modified {@link Spec} when finding a modifier
56
- * that applies to a given dependency. Otherwise returns the original spec
57
- * value and no queryModifier.
58
- */
59
- const maybeApplyModifierToSpec = (spec, depName, modifierRefs) => {
60
- const activeModifier = modifierRefs?.get(depName);
61
- const queryModifier = activeModifier?.modifier.query;
62
- const completeModifier = activeModifier &&
63
- activeModifier.interactiveBreadcrumb.current ===
64
- activeModifier.modifier.breadcrumb.last;
65
- if (queryModifier &&
66
- completeModifier &&
67
- 'spec' in activeModifier.modifier) {
68
- const modifiedSpec = activeModifier.modifier.spec;
69
- modifiedSpec.overridden = true;
70
- return { spec: modifiedSpec, queryModifier };
71
- }
72
- return { spec, queryModifier };
73
- };
74
- /**
75
- * Reads the current directory defined at `currDir` and looks for folder
76
- * names and their realpath resolution, normalizing scoped package names
77
- * and removing any invalid symlinks from the list of items that should
78
- * be parsed through in order to build the graph.
79
- */
80
- const readDir = (scurry, currDir, fromNodeName) => {
81
- const res = new Set();
82
- for (const entry of scurry.readdirSync(currDir)) {
83
- // ignore any hidden files / folders
84
- if (entry.name.startsWith('.'))
85
- continue;
86
- // scope folder found, it will need to be read and iterated over
87
- // in order to find any scoped packages inside
88
- if (entry.name.startsWith('@')) {
89
- const scopedItems = readDir(scurry, entry, fromNodeName);
90
- for (const scopedItem of scopedItems) {
91
- res.add(scopedItem);
92
- }
93
- continue;
94
- }
95
- // skip anything that isn't a symlink, it's not an edge
96
- if (!entry.isSymbolicLink())
97
- continue;
98
- // we'll need to learn what is the real path for this entry in order
99
- // to retrieve the `location` and `id` properties for the node, if a
100
- // realpath is not found just move on to the next element
101
- const realpath = entry.realpathSync();
102
- if (!realpath) {
103
- continue;
104
- }
105
- // infer both the alias and proper package names, including scopes
106
- const alias = findName(entry);
107
- const name = findName(realpath);
108
- res.add({
109
- alias,
110
- name,
111
- realpath,
112
- });
113
- }
114
- return res;
115
- };
116
- /**
117
- * Parses the files located at `currDir` and place packages found inside
118
- * as dependencies of `fromNode`, building the instantiated `graph`.
119
- */
120
- const parseDir = (options, scurry, packageJson, depsFound, graph, fromNode, currDir) => {
121
- const { loadManifests, modifiers } = options;
122
- const dependencies = getRawDependencies(fromNode);
123
- const seenDeps = new Set();
124
- const readItems = readDir(scurry, currDir, fromNode.name);
125
- // Get modifier references for this node's dependencies
126
- const modifierRefs = modifiers?.tryDependencies(fromNode, [
127
- ...getDependencies(fromNode, options).values(),
128
- ]);
129
- for (const { alias, name, realpath } of readItems) {
130
- let node;
131
- // tracks what dependencies have been seen
132
- // so that we can mark missing dependencies
133
- seenDeps.add(alias);
134
- // places the package in the graph reading
135
- // its manifest only if necessary
136
- if (!loadManifests) {
137
- const depId = findDepID(realpath);
138
- if (depId) {
139
- let h = hydrate(depId, alias, {
140
- ...options,
141
- });
142
- // if the parsed registry value is using the default value, then
143
- // the node should inherit the registry value from its parent node
144
- h.inheritedRegistry = fromNode.registry;
145
- // Check for active modifiers and replace spec even when not loading manifests
146
- const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(h, alias, modifierRefs);
147
- h = modifiedSpec;
148
- // graphs build with no manifest have no notion of
149
- // dependency types and or spec definitions since those
150
- // would have to be parsed from a manifest
151
- node = graph.placePackage(fromNode, 'prod', // defaults to prod deps
152
- h, // uses spec from hydrated id
153
- {
154
- name,
155
- }, depId, queryModifier);
156
- // Update active entry after placing package
157
- const activeModifier = modifierRefs?.get(alias);
158
- if (activeModifier && node) {
159
- modifiers?.updateActiveEntry(node, activeModifier);
160
- }
161
- }
162
- }
163
- // retrieve references to the current folder name found in `fromNode`
164
- // manifest listed dependencies, removing it from the map will leave
165
- // a list of missing dependencies at the end of the iteration
166
- const deps = dependencies.get(alias);
167
- // in case this graph is skipping manifests, this next block might
168
- // still need to execute, thus actually loading a manifest file, for
169
- // edge-cases such as loading a linked node that is not going to have
170
- // DepID info available in its realpath or extraneous nodes
171
- if (!node) {
172
- const mani = packageJson.read(realpath.fullpath());
173
- // declares fallback default values for both depType and bareSpec
174
- // in order to support loadManifests=false fallback for link nodes
175
- const type = deps?.type || 'dependencies';
176
- const bareSpec = deps?.bareSpec || '*';
177
- const depType = shorten(type, alias, fromNode.manifest);
178
- let spec = Spec.parse(alias, bareSpec, {
179
- ...options,
180
- });
181
- // if the parsed registry value is using the default value, then
182
- // the node should inherit the registry value from its parent node
183
- spec.inheritedRegistry = fromNode.registry;
184
- // Check for active modifiers and replace spec if a modifier is complete
185
- const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(spec, alias, modifierRefs);
186
- spec = modifiedSpec;
187
- const maybeId = getPathBasedId(spec, realpath);
188
- node = graph.placePackage(fromNode, depType, spec, mani, maybeId, queryModifier);
189
- // Update active entry after placing package
190
- const activeModifier = modifierRefs?.get(alias);
191
- if (activeModifier && node) {
192
- modifiers?.updateActiveEntry(node, activeModifier);
193
- }
194
- }
195
- if (node) {
196
- // If a found dependency is not declared in any of the original
197
- // node dependencies, then add an edge to the graph pointing to it
198
- // and mark it as extraneous.
199
- //
200
- // This only makes sense if full manifests are being loaded
201
- // so that we have reference to dependencies info.
202
- if (loadManifests && !deps) {
203
- const [edge] = node.edgesIn;
204
- if (edge) {
205
- graph.extraneousDependencies.add(edge);
206
- }
207
- }
208
- // for a succesfully created node, add its location
209
- // property and queue up to read its dependencies
210
- node.location = `./${realpath.relativePosix()}`;
211
- const node_modules = findNodeModules(realpath);
212
- // queue items up to continue parsing dirs in case a node was succesfully
213
- // placed in the graph and its node_modules folder was correctly found
214
- if (node_modules) {
215
- depsFound.set(node, node_modules);
216
- }
217
- }
218
- }
219
- // any remaining dependencies that have not been found
220
- // when reading the directory should be marked as missing
221
- for (const { name, type, bareSpec } of dependencies.values()) {
222
- if (!seenDeps.has(name)) {
223
- const depType = shorten(type, name, fromNode.manifest);
224
- let spec = Spec.parse(name, bareSpec, {
225
- ...options,
226
- });
227
- // if the parsed registry value is using the default value, then
228
- // the node should inherit the registry value from its parent node
229
- spec.inheritedRegistry = fromNode.registry;
230
- // Check for active modifiers and replace spec for missing dependencies
231
- const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(spec, name, modifierRefs);
232
- spec = modifiedSpec;
233
- graph.placePackage(fromNode, depType, spec, undefined, undefined, queryModifier);
234
- }
235
- }
236
- };
237
- /**
238
- * Read the file system looking for `node_modules` folders and
239
- * returns a new {@link Graph} that represents the relationship
240
- * between the dependencies found.
241
- */
242
- export const load = (options) => {
243
- const done = graphStep('actual');
244
- const { modifiers, monorepo, projectRoot, packageJson, scurry, skipHiddenLockfile = false, skipLoadingNodesOnModifiersChange = false, } = options;
245
- const mainManifest = options.mainManifest ?? packageJson.read(projectRoot);
246
- if (!skipHiddenLockfile) {
247
- try {
248
- // if we reach here, the hidden lockfile is valid
249
- const graph = loadHidden({
250
- ...options,
251
- projectRoot,
252
- mainManifest,
253
- packageJson,
254
- monorepo,
255
- scurry,
256
- });
257
- done();
258
- return graph;
259
- }
260
- catch {
261
- // if validation fails or any other error occurs,
262
- // fall back to filesystem traversal
263
- }
264
- }
265
- const graph = new Graph({ ...options, mainManifest });
266
- // retrieve the configuration object from the store
267
- let storeConfig = { modifiers: undefined };
268
- try {
269
- storeConfig = asStoreConfigObject(JSON.parse(readFileSync(scurry.resolve('node_modules/.vlt/vlt.json'), 'utf8')));
270
- }
271
- catch { }
272
- const storeModifiers = JSON.stringify(storeConfig.modifiers ?? {});
273
- const optionsModifiers = JSON.stringify(modifiers?.config);
274
- const modifiersChanged = storeModifiers !== optionsModifiers;
275
- const shouldLoadDependencies = !(skipLoadingNodesOnModifiersChange && modifiersChanged);
276
- // will only skip loading dependencies if the
277
- // skipLoadingNodesOnModifiersChange option is set to true
278
- // and the current modifiers have not changed when compared
279
- // to the modifiers stored in the `node_modules/.vlt/vlt.json` store config
280
- if (shouldLoadDependencies) {
281
- const depsFound = new Map();
282
- // starts the list of initial folders to parse using the importer nodes
283
- for (const importer of graph.importers) {
284
- modifiers?.tryImporter(importer);
285
- depsFound.set(importer, scurry.cwd.resolve(`${importer.location}/node_modules`));
286
- }
287
- // breadth-first traversal of the file system tree reading deps found
288
- // starting from the node_modules folder of every importer in order to
289
- // find the actual installed dependencies at each location
290
- for (const [node, path] of depsFound.entries()) {
291
- parseDir(options, scurry, packageJson, depsFound, graph, node, path);
292
- }
293
- // Clean up any pending modifier entries that were never completed
294
- modifiers?.rollbackActiveEntries();
295
- // caches the load result to the hidden lockfile when enabled
296
- saveHidden({
297
- ...options,
298
- graph,
299
- });
300
- }
301
- done();
302
- return graph;
303
- };
304
- //# sourceMappingURL=load.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/actual/load.ts"],"names":[],"mappings":"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","sourcesContent":["import { asDepID, hydrate, joinDepIDTuple } from '@vltpkg/dep-id'\nimport { Spec } from '@vltpkg/spec'\nimport { graphStep } from '@vltpkg/output'\nimport { isObject } from '@vltpkg/types'\nimport {\n shorten,\n getRawDependencies,\n getDependencies,\n} from '../dependencies.ts'\nimport { Graph } from '../graph.ts'\nimport { loadHidden } from '../lockfile/load.ts'\nimport { saveHidden } from '../lockfile/save.ts'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { PackageJson } from '@vltpkg/package-json'\nimport type { SpecOptions } from '@vltpkg/spec'\nimport type { NormalizedManifest } from '@vltpkg/types'\nimport type { Monorepo } from '@vltpkg/workspaces'\nimport type { Path, PathScurry } from 'path-scurry'\nimport type { Node } from '../node.ts'\nimport type {\n GraphModifier,\n ModifierActiveEntry,\n} from '../modifiers.ts'\nimport { readFileSync } from 'node:fs'\n\nexport type LoadOptions = SpecOptions & {\n /**\n * The project root dirname.\n */\n projectRoot: string\n /**\n * The project root manifest.\n */\n mainManifest?: NormalizedManifest\n /**\n * The graph modifiers helper object.\n */\n modifiers?: GraphModifier\n /**\n * A {@link Monorepo} object, for managing workspaces\n */\n monorepo?: Monorepo\n /**\n * A {@link PackageJson} object, for sharing manifest caches\n */\n packageJson: PackageJson\n /**\n * A {@link PathScurry} object, for use in globs\n */\n scurry: PathScurry\n /**\n * If set to `false`, `actual.load` will not load any `package.json`\n * files while traversing the file system.\n *\n * The resulting {@link Graph} from loading with `loadManifests=false`\n * has no information on dependency types or the specs defined and\n * no information on missing and extraneous dependencies.\n */\n loadManifests?: boolean\n /**\n * If set to `true`, then do not shortcut the process by reading the\n * hidden lockfile at `node_modules/.vlt-lock.json`\n */\n skipHiddenLockfile?: boolean\n /**\n * Load only importers into the graph if the modifiers have changed.\n */\n skipLoadingNodesOnModifiersChange?: boolean\n // TODO: move the lockfile-related options to a separate type file\n /**\n * If set to `true`, fail if lockfile is missing or out of date.\n * Used by ci command to enforce lockfile integrity.\n */\n expectLockfile?: boolean\n /**\n * If set to `true`, fail if lockfile is missing or out of sync with package.json.\n * Prevents any lockfile modifications and is stricter than expectLockfile.\n */\n frozenLockfile?: boolean\n /**\n * If set to `true`, only update the lockfile without performing any node_modules\n * operations. Skips package extraction, filesystem operations, and hidden lockfile saves.\n */\n lockfileOnly?: boolean\n}\n\nexport type ReadEntry = {\n alias: string\n name: string\n realpath: Path\n}\n\n/**\n * The configuration object type as it is saved in the `.vlt/vlt.json`\n */\nexport type StoreConfigObject = {\n modifiers: Record<string, string> | undefined\n}\n\n/**\n * Checks if a given object is a {@link StoreConfigObject}.\n */\nexport const isStoreConfigObject = (\n obj: unknown,\n): obj is StoreConfigObject =>\n isObject(obj) &&\n Object.prototype.hasOwnProperty.call(obj, 'modifiers') &&\n isObject(obj.modifiers)\n\n/**\n * Returns a {@link StoreConfigObject} from a given object.\n * Throws a TypeError if the object can't be converted.\n */\nexport const asStoreConfigObject = (\n obj: unknown,\n): StoreConfigObject => {\n if (!isStoreConfigObject(obj)) {\n throw new TypeError(`Expected a store config object, got ${obj}`)\n }\n return obj\n}\n\n// path-based refer to the types of dependencies that are directly linked to\n// their real location in the file system and thus will not have an entry\n// in the `node_modules/.vlt` store\nconst pathBasedType = new Set(['file', 'workspace'])\nconst isPathBasedType = (\n type: string,\n): type is 'file' | 'workspace' => pathBasedType.has(type)\n\n/**\n * Returns a {@link DepID} for a given spec and path, if the spec is\n * path-based or a registry spec, otherwise returns `undefined`.\n */\nexport const getPathBasedId = (\n spec: Spec,\n path: Path,\n): DepID | undefined =>\n isPathBasedType(spec.type) ?\n joinDepIDTuple([spec.type, path.relativePosix()])\n : findDepID(path)\n\n/**\n * Retrieve the {@link DepID} for a given package from its location.\n */\nconst findDepID = ({ parent, name }: Path): DepID | undefined =>\n parent?.name === '.vlt' ? asDepID(name)\n : parent?.isCWD === false ? findDepID(parent)\n : undefined\n\n/**\n * Retrieves the closest `node_modules` parent {@link Path} found.\n */\nconst findNodeModules = ({\n parent,\n name,\n isCWD,\n}: Path): Path | undefined =>\n parent?.name === 'node_modules' ? parent\n : parent && name !== '.vlt' && !isCWD ? findNodeModules(parent)\n : undefined\n\n/**\n * Retrieves the scoped-normalized package name from its {@link Path}.\n */\nconst findName = ({ parent, name }: Path): string =>\n parent?.name.startsWith('@') ? `${parent.name}/${name}` : name\n\n/**\n * Helper function that gets a modified {@link Spec} when finding a modifier\n * that applies to a given dependency. Otherwise returns the original spec\n * value and no queryModifier.\n */\nconst maybeApplyModifierToSpec = (\n spec: Spec,\n depName: string,\n modifierRefs?: Map<string, ModifierActiveEntry>,\n): { spec: Spec; queryModifier?: string } => {\n const activeModifier = modifierRefs?.get(depName)\n const queryModifier = activeModifier?.modifier.query\n const completeModifier =\n activeModifier &&\n activeModifier.interactiveBreadcrumb.current ===\n activeModifier.modifier.breadcrumb.last\n\n if (\n queryModifier &&\n completeModifier &&\n 'spec' in activeModifier.modifier\n ) {\n const modifiedSpec = activeModifier.modifier.spec\n modifiedSpec.overridden = true\n return { spec: modifiedSpec, queryModifier }\n }\n\n return { spec, queryModifier }\n}\n\n/**\n * Reads the current directory defined at `currDir` and looks for folder\n * names and their realpath resolution, normalizing scoped package names\n * and removing any invalid symlinks from the list of items that should\n * be parsed through in order to build the graph.\n */\nconst readDir = (\n scurry: PathScurry,\n currDir: Path,\n fromNodeName?: string,\n) => {\n const res = new Set<ReadEntry>()\n for (const entry of scurry.readdirSync(currDir)) {\n // ignore any hidden files / folders\n if (entry.name.startsWith('.')) continue\n\n // scope folder found, it will need to be read and iterated over\n // in order to find any scoped packages inside\n if (entry.name.startsWith('@')) {\n const scopedItems = readDir(scurry, entry, fromNodeName)\n for (const scopedItem of scopedItems) {\n res.add(scopedItem)\n }\n continue\n }\n\n // skip anything that isn't a symlink, it's not an edge\n if (!entry.isSymbolicLink()) continue\n\n // we'll need to learn what is the real path for this entry in order\n // to retrieve the `location` and `id` properties for the node, if a\n // realpath is not found just move on to the next element\n const realpath = entry.realpathSync()\n if (!realpath) {\n continue\n }\n\n // infer both the alias and proper package names, including scopes\n const alias = findName(entry)\n const name = findName(realpath)\n res.add({\n alias,\n name,\n realpath,\n })\n }\n return res\n}\n\n/**\n * Parses the files located at `currDir` and place packages found inside\n * as dependencies of `fromNode`, building the instantiated `graph`.\n */\nconst parseDir = (\n options: LoadOptions,\n scurry: PathScurry,\n packageJson: PackageJson,\n depsFound: Map<Node, Path>,\n graph: Graph,\n fromNode: Node,\n currDir: Path,\n) => {\n const { loadManifests, modifiers } = options\n const dependencies = getRawDependencies(fromNode)\n const seenDeps = new Set<string>()\n const readItems: Set<ReadEntry> = readDir(\n scurry,\n currDir,\n fromNode.name,\n )\n\n // Get modifier references for this node's dependencies\n const modifierRefs = modifiers?.tryDependencies(fromNode, [\n ...getDependencies(fromNode, options).values(),\n ])\n\n for (const { alias, name, realpath } of readItems) {\n let node\n\n // tracks what dependencies have been seen\n // so that we can mark missing dependencies\n seenDeps.add(alias)\n\n // places the package in the graph reading\n // its manifest only if necessary\n if (!loadManifests) {\n const depId = findDepID(realpath)\n\n if (depId) {\n let h = hydrate(depId, alias, {\n ...options,\n })\n // if the parsed registry value is using the default value, then\n // the node should inherit the registry value from its parent node\n h.inheritedRegistry = fromNode.registry\n\n // Check for active modifiers and replace spec even when not loading manifests\n const { spec: modifiedSpec, queryModifier } =\n maybeApplyModifierToSpec(h, alias, modifierRefs)\n h = modifiedSpec\n\n // graphs build with no manifest have no notion of\n // dependency types and or spec definitions since those\n // would have to be parsed from a manifest\n node = graph.placePackage(\n fromNode,\n 'prod', // defaults to prod deps\n h, // uses spec from hydrated id\n {\n name,\n },\n depId,\n queryModifier,\n )\n\n // Update active entry after placing package\n const activeModifier = modifierRefs?.get(alias)\n if (activeModifier && node) {\n modifiers?.updateActiveEntry(node, activeModifier)\n }\n }\n }\n\n // retrieve references to the current folder name found in `fromNode`\n // manifest listed dependencies, removing it from the map will leave\n // a list of missing dependencies at the end of the iteration\n const deps = dependencies.get(alias)\n\n // in case this graph is skipping manifests, this next block might\n // still need to execute, thus actually loading a manifest file, for\n // edge-cases such as loading a linked node that is not going to have\n // DepID info available in its realpath or extraneous nodes\n if (!node) {\n const mani = packageJson.read(realpath.fullpath())\n // declares fallback default values for both depType and bareSpec\n // in order to support loadManifests=false fallback for link nodes\n const type = deps?.type || 'dependencies'\n const bareSpec = deps?.bareSpec || '*'\n\n const depType = shorten(type, alias, fromNode.manifest)\n let spec = Spec.parse(alias, bareSpec, {\n ...options,\n })\n // if the parsed registry value is using the default value, then\n // the node should inherit the registry value from its parent node\n spec.inheritedRegistry = fromNode.registry\n\n // Check for active modifiers and replace spec if a modifier is complete\n const { spec: modifiedSpec, queryModifier } =\n maybeApplyModifierToSpec(spec, alias, modifierRefs)\n spec = modifiedSpec\n\n const maybeId = getPathBasedId(spec, realpath)\n node = graph.placePackage(\n fromNode,\n depType,\n spec,\n mani,\n maybeId,\n queryModifier,\n )\n\n // Update active entry after placing package\n const activeModifier = modifierRefs?.get(alias)\n if (activeModifier && node) {\n modifiers?.updateActiveEntry(node, activeModifier)\n }\n }\n\n if (node) {\n // If a found dependency is not declared in any of the original\n // node dependencies, then add an edge to the graph pointing to it\n // and mark it as extraneous.\n //\n // This only makes sense if full manifests are being loaded\n // so that we have reference to dependencies info.\n if (loadManifests && !deps) {\n const [edge] = node.edgesIn\n if (edge) {\n graph.extraneousDependencies.add(edge)\n }\n }\n\n // for a succesfully created node, add its location\n // property and queue up to read its dependencies\n node.location = `./${realpath.relativePosix()}`\n const node_modules = findNodeModules(realpath)\n\n // queue items up to continue parsing dirs in case a node was succesfully\n // placed in the graph and its node_modules folder was correctly found\n if (node_modules) {\n depsFound.set(node, node_modules)\n }\n }\n }\n\n // any remaining dependencies that have not been found\n // when reading the directory should be marked as missing\n for (const { name, type, bareSpec } of dependencies.values()) {\n if (!seenDeps.has(name)) {\n const depType = shorten(type, name, fromNode.manifest)\n let spec = Spec.parse(name, bareSpec, {\n ...options,\n })\n // if the parsed registry value is using the default value, then\n // the node should inherit the registry value from its parent node\n spec.inheritedRegistry = fromNode.registry\n\n // Check for active modifiers and replace spec for missing dependencies\n const { spec: modifiedSpec, queryModifier } =\n maybeApplyModifierToSpec(spec, name, modifierRefs)\n spec = modifiedSpec\n\n graph.placePackage(\n fromNode,\n depType,\n spec,\n undefined,\n undefined,\n queryModifier,\n )\n }\n }\n}\n\n/**\n * Read the file system looking for `node_modules` folders and\n * returns a new {@link Graph} that represents the relationship\n * between the dependencies found.\n */\nexport const load = (options: LoadOptions): Graph => {\n const done = graphStep('actual')\n const {\n modifiers,\n monorepo,\n projectRoot,\n packageJson,\n scurry,\n skipHiddenLockfile = false,\n skipLoadingNodesOnModifiersChange = false,\n } = options\n const mainManifest =\n options.mainManifest ?? packageJson.read(projectRoot)\n\n if (!skipHiddenLockfile) {\n try {\n // if we reach here, the hidden lockfile is valid\n const graph = loadHidden({\n ...options,\n projectRoot,\n mainManifest,\n packageJson,\n monorepo,\n scurry,\n })\n done()\n return graph\n } catch {\n // if validation fails or any other error occurs,\n // fall back to filesystem traversal\n }\n }\n\n const graph = new Graph({ ...options, mainManifest })\n\n // retrieve the configuration object from the store\n let storeConfig: StoreConfigObject = { modifiers: undefined }\n try {\n storeConfig = asStoreConfigObject(\n JSON.parse(\n readFileSync(\n scurry.resolve('node_modules/.vlt/vlt.json'),\n 'utf8',\n ),\n ),\n )\n } catch {}\n const storeModifiers = JSON.stringify(storeConfig.modifiers ?? {})\n const optionsModifiers = JSON.stringify(modifiers?.config)\n const modifiersChanged = storeModifiers !== optionsModifiers\n const shouldLoadDependencies = !(\n skipLoadingNodesOnModifiersChange && modifiersChanged\n )\n\n // will only skip loading dependencies if the\n // skipLoadingNodesOnModifiersChange option is set to true\n // and the current modifiers have not changed when compared\n // to the modifiers stored in the `node_modules/.vlt/vlt.json` store config\n if (shouldLoadDependencies) {\n const depsFound = new Map<Node, Path>()\n\n // starts the list of initial folders to parse using the importer nodes\n for (const importer of graph.importers) {\n modifiers?.tryImporter(importer)\n depsFound.set(\n importer,\n scurry.cwd.resolve(`${importer.location}/node_modules`),\n )\n }\n\n // breadth-first traversal of the file system tree reading deps found\n // starting from the node_modules folder of every importer in order to\n // find the actual installed dependencies at each location\n for (const [node, path] of depsFound.entries()) {\n parseDir(\n options,\n scurry,\n packageJson,\n depsFound,\n graph,\n node,\n path,\n )\n }\n\n // Clean up any pending modifier entries that were never completed\n modifiers?.rollbackActiveEntries()\n\n // caches the load result to the hidden lockfile when enabled\n saveHidden({\n ...options,\n graph,\n })\n }\n\n done()\n\n return graph\n}\n"]}
@@ -1,15 +0,0 @@
1
- import { longDependencyTypes } from '@vltpkg/types';
2
- import { asDependencyTypeShort, shorten } from './dependencies.ts';
3
- import { getBooleanFlagsFromNum } from './lockfile/types.ts';
4
- import { stringifyNode } from './stringify-node.ts';
5
- export type { LoadResult, TransferData, } from './transfer-data/load.ts';
6
- export * from './virtual-root.ts';
7
- declare const lockfile: {
8
- loadEdges: (graph: import("@vltpkg/types").GraphLike, edges: import("./lockfile/types.ts").LockfileData["edges"], options: import("@vltpkg/spec").SpecOptions) => void;
9
- loadNodes: (graph: import("@vltpkg/types").GraphLike, nodes: import("./lockfile/types.ts").LockfileData["nodes"], options: import("@vltpkg/spec").SpecOptions, actual?: import("@vltpkg/types").GraphLike, throwOnMissingManifest?: boolean) => void;
10
- };
11
- declare const transfer: {
12
- load: (transfered: import("./transfer-data/load.ts").TransferData) => import("./transfer-data/load.ts").LoadResult;
13
- };
14
- export { asDependencyTypeShort, getBooleanFlagsFromNum, lockfile, longDependencyTypes, shorten, stringifyNode, transfer, };
15
- //# sourceMappingURL=browser.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAInD,YAAY,EACV,UAAU,EACV,YAAY,GACb,MAAM,yBAAyB,CAAA;AAEhC,cAAc,mBAAmB,CAAA;AAEjC,QAAA,MAAM,QAAQ;;;CAGb,CAAA;AAED,QAAA,MAAM,QAAQ;;CAEb,CAAA;AAED,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,QAAQ,EACR,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,QAAQ,GACT,CAAA"}
@@ -1,17 +0,0 @@
1
- import { longDependencyTypes } from '@vltpkg/types';
2
- import { asDependencyTypeShort, shorten } from "./dependencies.js";
3
- import { getBooleanFlagsFromNum } from "./lockfile/types.js";
4
- import { stringifyNode } from "./stringify-node.js";
5
- import { loadEdges } from "./lockfile/load-edges.js";
6
- import { loadNodes } from "./lockfile/load-nodes.js";
7
- import { load } from "./transfer-data/load.js";
8
- export * from "./virtual-root.js";
9
- const lockfile = {
10
- loadEdges,
11
- loadNodes,
12
- };
13
- const transfer = {
14
- load,
15
- };
16
- export { asDependencyTypeShort, getBooleanFlagsFromNum, lockfile, longDependencyTypes, shorten, stringifyNode, transfer, };
17
- //# sourceMappingURL=browser.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"browser.js","sourceRoot":"","sources":["../../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAM9C,cAAc,mBAAmB,CAAA;AAEjC,MAAM,QAAQ,GAAG;IACf,SAAS;IACT,SAAS;CACV,CAAA;AAED,MAAM,QAAQ,GAAG;IACf,IAAI;CACL,CAAA;AAED,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,QAAQ,EACR,mBAAmB,EACnB,OAAO,EACP,aAAa,EACb,QAAQ,GACT,CAAA","sourcesContent":["import { longDependencyTypes } from '@vltpkg/types'\nimport { asDependencyTypeShort, shorten } from './dependencies.ts'\nimport { getBooleanFlagsFromNum } from './lockfile/types.ts'\nimport { stringifyNode } from './stringify-node.ts'\nimport { loadEdges } from './lockfile/load-edges.ts'\nimport { loadNodes } from './lockfile/load-nodes.ts'\nimport { load } from './transfer-data/load.ts'\nexport type {\n LoadResult,\n TransferData,\n} from './transfer-data/load.ts'\n\nexport * from './virtual-root.ts'\n\nconst lockfile = {\n loadEdges,\n loadNodes,\n}\n\nconst transfer = {\n load,\n}\n\nexport {\n asDependencyTypeShort,\n getBooleanFlagsFromNum,\n lockfile,\n longDependencyTypes,\n shorten,\n stringifyNode,\n transfer,\n}\n"]}
@@ -1,29 +0,0 @@
1
- import { Monorepo } from '@vltpkg/workspaces';
2
- import type { BuildResult } from './reify/build.ts';
3
- import type { LoadOptions } from './actual/load.ts';
4
- /**
5
- * Options for the build process
6
- */
7
- export interface BuildOptions extends LoadOptions {
8
- /**
9
- * Optional monorepo configuration. If not provided, will attempt to load from project.
10
- */
11
- monorepo?: Monorepo;
12
- /**
13
- * DSS query string to filter which nodes to build.
14
- */
15
- target: string;
16
- }
17
- /**
18
- * Build the project based on actual graph state and build state from lockfile
19
- *
20
- * This function:
21
- * 1. Loads the actual graph from node_modules
22
- * 2. Loads build data from lockfile and transfers it to the actual graph
23
- * 3. Constructs a Diff object representing what needs to be built
24
- * 4. Filters nodes based on buildState === 'needed'
25
- * 5. Calls the reify build process with the constructed diff
26
- * 6. Persists build results to lockfile
27
- */
28
- export declare const build: (options: BuildOptions) => Promise<BuildResult>;
29
- //# sourceMappingURL=build.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAG7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAKnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAKnD;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;CACf;AAoCD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,YACP,YAAY,KACpB,OAAO,CAAC,WAAW,CA6DrB,CAAA"}
package/dist/esm/build.js DELETED
@@ -1,79 +0,0 @@
1
- import { Monorepo } from '@vltpkg/workspaces';
2
- import { load as loadActual } from "./actual/load.js";
3
- import { build as reifyBuild } from "./reify/build.js";
4
- import { Diff } from "./diff.js";
5
- import { Graph } from "./graph.js";
6
- import { Query } from '@vltpkg/query';
7
- import { SecurityArchive } from '@vltpkg/security-archive';
8
- import { saveHidden } from "./lockfile/save.js";
9
- /**
10
- * Filter nodes using a DSS query string
11
- */
12
- const filterNodesByQuery = async (targetQuery, graph) => {
13
- /* c8 ignore start */
14
- const securityArchive = Query.hasSecuritySelectors(targetQuery) ?
15
- await SecurityArchive.start({
16
- nodes: [...graph.nodes.values()],
17
- })
18
- : undefined;
19
- /* c8 ignore stop */
20
- const edges = graph.edges;
21
- const nodes = new Set(graph.nodes.values());
22
- const importers = graph.importers;
23
- const query = new Query({
24
- edges,
25
- nodes,
26
- importers,
27
- securityArchive,
28
- });
29
- const { nodes: resultNodes } = await query.search(targetQuery, {
30
- signal: new AbortController().signal,
31
- });
32
- return new Set(resultNodes.map(node => node.id));
33
- };
34
- /**
35
- * Build the project based on actual graph state and build state from lockfile
36
- *
37
- * This function:
38
- * 1. Loads the actual graph from node_modules
39
- * 2. Loads build data from lockfile and transfers it to the actual graph
40
- * 3. Constructs a Diff object representing what needs to be built
41
- * 4. Filters nodes based on buildState === 'needed'
42
- * 5. Calls the reify build process with the constructed diff
43
- * 6. Persists build results to lockfile
44
- */
45
- export const build = async (options) => {
46
- const { projectRoot, packageJson, monorepo = Monorepo.maybeLoad(projectRoot), scurry, mainManifest = packageJson.read(projectRoot), target, ...loadOptions } = options;
47
- // Load the actual graph from node_modules
48
- const actualGraph = loadActual({
49
- ...loadOptions,
50
- projectRoot,
51
- packageJson,
52
- monorepo,
53
- scurry,
54
- loadManifests: true,
55
- });
56
- // Filter nodes using target query provided
57
- const targetFilteredNodes = await filterNodesByQuery(target, actualGraph);
58
- // Create a total diff including the actual graph as 'to'
59
- const diff = new Diff(new Graph({
60
- ...options,
61
- projectRoot,
62
- monorepo,
63
- mainManifest,
64
- }), actualGraph);
65
- // Now tweak the diff object to only include the nodes that need to be built
66
- // Filter by buildState === 'needed' and target query
67
- diff.nodes.add = new Set([...diff.nodes.add].filter(node => node.buildState === 'needed'));
68
- // Call the reify build process with the constructed diff
69
- // this will only build the nodes that need to be built
70
- // as part of `diff.nodes.add`
71
- const buildResult = await reifyBuild(diff, packageJson, scurry, targetFilteredNodes);
72
- // Save hidden lockfile with updated buildState
73
- saveHidden({
74
- ...options,
75
- graph: actualGraph,
76
- });
77
- return buildResult;
78
- };
79
- //# sourceMappingURL=build.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/build.ts"],"names":[],"mappings":"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","sourcesContent":["import { Monorepo } from '@vltpkg/workspaces'\nimport { load as loadActual } from './actual/load.ts'\nimport { build as reifyBuild } from './reify/build.ts'\nimport type { BuildResult } from './reify/build.ts'\nimport { Diff } from './diff.ts'\nimport { Graph } from './graph.ts'\nimport { Query } from '@vltpkg/query'\nimport { SecurityArchive } from '@vltpkg/security-archive'\nimport type { LoadOptions } from './actual/load.ts'\nimport type { DepID } from '@vltpkg/dep-id'\nimport type { NodeLike } from '@vltpkg/types'\nimport { saveHidden } from './lockfile/save.ts'\n\n/**\n * Options for the build process\n */\nexport interface BuildOptions extends LoadOptions {\n /**\n * Optional monorepo configuration. If not provided, will attempt to load from project.\n */\n monorepo?: Monorepo\n /**\n * DSS query string to filter which nodes to build.\n */\n target: string\n}\n\n/**\n * Filter nodes using a DSS query string\n */\nconst filterNodesByQuery = async (\n targetQuery: string,\n graph: Graph,\n): Promise<Set<DepID>> => {\n /* c8 ignore start */\n const securityArchive =\n Query.hasSecuritySelectors(targetQuery) ?\n await SecurityArchive.start({\n nodes: [...graph.nodes.values()],\n })\n : undefined\n /* c8 ignore stop */\n\n const edges = graph.edges\n const nodes = new Set<NodeLike>(graph.nodes.values())\n const importers = graph.importers\n\n const query = new Query({\n edges,\n nodes,\n importers,\n securityArchive,\n })\n\n const { nodes: resultNodes } = await query.search(targetQuery, {\n signal: new AbortController().signal,\n })\n\n return new Set(resultNodes.map(node => node.id))\n}\n\n/**\n * Build the project based on actual graph state and build state from lockfile\n *\n * This function:\n * 1. Loads the actual graph from node_modules\n * 2. Loads build data from lockfile and transfers it to the actual graph\n * 3. Constructs a Diff object representing what needs to be built\n * 4. Filters nodes based on buildState === 'needed'\n * 5. Calls the reify build process with the constructed diff\n * 6. Persists build results to lockfile\n */\nexport const build = async (\n options: BuildOptions,\n): Promise<BuildResult> => {\n const {\n projectRoot,\n packageJson,\n monorepo = Monorepo.maybeLoad(projectRoot),\n scurry,\n mainManifest = packageJson.read(projectRoot),\n target,\n ...loadOptions\n } = options\n\n // Load the actual graph from node_modules\n const actualGraph = loadActual({\n ...loadOptions,\n projectRoot,\n packageJson,\n monorepo,\n scurry,\n loadManifests: true,\n })\n\n // Filter nodes using target query provided\n const targetFilteredNodes: Set<DepID> = await filterNodesByQuery(\n target,\n actualGraph,\n )\n\n // Create a total diff including the actual graph as 'to'\n const diff = new Diff(\n new Graph({\n ...options,\n projectRoot,\n monorepo,\n mainManifest,\n }),\n actualGraph,\n )\n\n // Now tweak the diff object to only include the nodes that need to be built\n // Filter by buildState === 'needed' and target query\n diff.nodes.add = new Set(\n [...diff.nodes.add].filter(node => node.buildState === 'needed'),\n )\n\n // Call the reify build process with the constructed diff\n // this will only build the nodes that need to be built\n // as part of `diff.nodes.add`\n const buildResult = await reifyBuild(\n diff,\n packageJson,\n scurry,\n targetFilteredNodes,\n )\n\n // Save hidden lockfile with updated buildState\n saveHidden({\n ...options,\n graph: actualGraph,\n })\n\n return buildResult\n}\n"]}
@@ -1,66 +0,0 @@
1
- import type { DepID } from '@vltpkg/dep-id';
2
- import { Spec } from '@vltpkg/spec/browser';
3
- import type { SpecOptions } from '@vltpkg/spec';
4
- import type { DependencySaveType, DependencyTypeLong, DependencyTypeShort, Manifest, NodeLike } from '@vltpkg/types';
5
- export declare const isDependencyTypeShort: (obj: unknown) => obj is DependencyTypeShort;
6
- export declare const isDependencySaveType: (obj: unknown) => obj is DependencyTypeShort;
7
- export declare const asDependencyTypeShort: (obj: unknown) => DependencyTypeShort;
8
- /**
9
- * Dependency entries info as defined in a package.json file.
10
- */
11
- export type RawDependency = {
12
- name: string;
13
- bareSpec: string;
14
- type: DependencyTypeLong;
15
- registry?: string;
16
- };
17
- /**
18
- * Parsed dependency entries info.
19
- */
20
- export type Dependency = {
21
- /**
22
- * The parsed {@link Spec} object describing the dependency requirements.
23
- */
24
- spec: Spec;
25
- /**
26
- * The {@link DependencySaveType}, describing the way this dependency should
27
- * be saved back to the manifest.
28
- */
29
- type: DependencySaveType;
30
- };
31
- /**
32
- * A `Map` in which keys are {@link DepID} linking to another `Map` in which
33
- * keys are the dependency names and values are {@link Dependency}. This
34
- * structure represents dependencies that need to be added to the importer
35
- * represented by {@link DepID}.
36
- *
37
- * The `modifiedDependencies` property can be used to indicate that there
38
- * are added dependencies to any of the importer nodes.
39
- */
40
- export type AddImportersDependenciesMap = Map<DepID, Map<string, Dependency>> & {
41
- modifiedDependencies: boolean;
42
- };
43
- /**
44
- * A `Map` object representing nodes to be removed from the ideal graph.
45
- * Each {@link DepID} key represents an importer node and the `Set` of
46
- * dependency names to be removed from its dependency list.
47
- *
48
- * The `modifiedDependencies` property can be used to indicate that there
49
- * are added dependencies to any of the importer nodes.
50
- */
51
- export type RemoveImportersDependenciesMap = Map<DepID, Set<string>> & {
52
- modifiedDependencies: boolean;
53
- };
54
- export declare const isDependency: (o: unknown) => o is Dependency;
55
- export declare const asDependency: (obj: unknown) => Dependency;
56
- /**
57
- * Get the {@link DependencyTypeShort} from a {@link DependencyTypeLong}.
58
- */
59
- export declare const shorten: (typeLong: DependencyTypeLong, name?: string, manifest?: Pick<Manifest, "peerDependenciesMeta"> | null) => DependencyTypeShort;
60
- export declare const getRawDependencies: (node: NodeLike) => Map<string, RawDependency>;
61
- /**
62
- * Retrieves a map of all dependencies, of all types, that can be inferred
63
- * from a given node manifest, including missing dependencies.
64
- */
65
- export declare const getDependencies: (node: NodeLike, options: SpecOptions) => Map<string, Dependency>;
66
- //# sourceMappingURL=dependencies.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACT,MAAM,eAAe,CAAA;AAOtB,eAAO,MAAM,qBAAqB,QAC3B,OAAO,KACX,GAAG,IAAI,mBAC4C,CAAA;AAEtD,eAAO,MAAM,oBAAoB,QAC1B,OAAO,KACX,GAAG,IAAI,mBAEU,CAAA;AAEpB,eAAO,MAAM,qBAAqB,QAC3B,OAAO,KACX,mBAQF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,kBAAkB,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB;;OAEG;IACH,IAAI,EAAE,IAAI,CAAA;IACV;;;OAGG;IACH,IAAI,EAAE,kBAAkB,CAAA;CACzB,CAAA;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,2BAA2B,GAAG,GAAG,CAC3C,KAAK,EACL,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CACxB,GAAG;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,CAAA;AAErC;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG,GAAG,CAC9C,KAAK,EACL,GAAG,CAAC,MAAM,CAAC,CACZ,GAAG;IAAE,oBAAoB,EAAE,OAAO,CAAA;CAAE,CAAA;AAMrC,eAAO,MAAM,YAAY,MAAO,OAAO,KAAG,CAAC,IAAI,UAKjB,CAAA;AAE9B,eAAO,MAAM,YAAY,QAAS,OAAO,KAAG,UAK3C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,aACR,kBAAkB,SACrB,MAAM,aACF,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,GAAG,IAAI,KACvD,mBAkBF,CAAA;AASD,eAAO,MAAM,kBAAkB,SAAU,QAAQ,+BAyChD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,SACpB,QAAQ,WACL,WAAW,KACnB,GAAG,CAAC,MAAM,EAAE,UAAU,CAexB,CAAA"}