@vltpkg/graph 1.0.0-rc.18 → 1.0.0-rc.22

package/package.json

@@ -1,83 +1,87 @@
 {
   "name": "@vltpkg/graph",
   "description": "A library that helps understanding & expressing what happens on an install",
-  "version": "1.0.0-rc.18",
+  "version": "1.0.0-rc.22",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/vltpkg/vltpkg.git",
     "directory": "src/graph"
   },
-  "author": "vlt technology inc. <support@vlt.sh> (http://vlt.sh)",
+  "author": {
+    "name": "vlt technology inc.",
+    "email": "support@vlt.sh"
+  },
   "dependencies": {
+    "@vltpkg/cmd-shim": "1.0.0-rc.22",
+    "@vltpkg/dep-id": "1.0.0-rc.22",
+    "@vltpkg/dss-breadcrumb": "1.0.0-rc.22",
+    "@vltpkg/error-cause": "1.0.0-rc.22",
+    "@vltpkg/fast-split": "1.0.0-rc.22",
+    "@vltpkg/graph-run": "1.0.0-rc.22",
+    "@vltpkg/init": "1.0.0-rc.22",
+    "@vltpkg/output": "1.0.0-rc.22",
+    "@vltpkg/package-info": "1.0.0-rc.22",
+    "@vltpkg/package-json": "1.0.0-rc.22",
+    "@vltpkg/pick-manifest": "1.0.0-rc.22",
+    "@vltpkg/query": "1.0.0-rc.22",
+    "@vltpkg/rollback-remove": "1.0.0-rc.22",
+    "@vltpkg/run": "1.0.0-rc.22",
+    "@vltpkg/satisfies": "1.0.0-rc.22",
+    "@vltpkg/security-archive": "1.0.0-rc.22",
+    "@vltpkg/spec": "1.0.0-rc.22",
+    "@vltpkg/types": "1.0.0-rc.22",
+    "@vltpkg/vlt-json": "1.0.0-rc.22",
+    "@vltpkg/workspaces": "1.0.0-rc.22",
     "path-scurry": "^2.0.1",
-    "promise-call-limit": "^3.0.2",
-    "@vltpkg/dep-id": "1.0.0-rc.18",
-    "@vltpkg/dss-breadcrumb": "1.0.0-rc.18",
-    "@vltpkg/cmd-shim": "1.0.0-rc.18",
-    "@vltpkg/fast-split": "1.0.0-rc.18",
-    "@vltpkg/error-cause": "1.0.0-rc.18",
-    "@vltpkg/graph-run": "1.0.0-rc.18",
-    "@vltpkg/init": "1.0.0-rc.18",
-    "@vltpkg/output": "1.0.0-rc.18",
-    "@vltpkg/package-info": "1.0.0-rc.18",
-    "@vltpkg/package-json": "1.0.0-rc.18",
-    "@vltpkg/pick-manifest": "1.0.0-rc.18",
-    "@vltpkg/query": "1.0.0-rc.18",
-    "@vltpkg/rollback-remove": "1.0.0-rc.18",
-    "@vltpkg/run": "1.0.0-rc.18",
-    "@vltpkg/satisfies": "1.0.0-rc.18",
-    "@vltpkg/security-archive": "1.0.0-rc.18",
-    "@vltpkg/spec": "1.0.0-rc.18",
-    "@vltpkg/types": "1.0.0-rc.18",
-    "@vltpkg/vlt-json": "1.0.0-rc.18",
-    "@vltpkg/workspaces": "1.0.0-rc.18"
+    "promise-call-limit": "^3.0.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
     "@types/node": "^22.19.2",
+    "@vltpkg/vlt-json": "1.0.0-rc.22",
     "eslint": "^9.39.1",
     "prettier": "^3.7.4",
     "tap": "^21.5.0",
     "tar": "^7.5.2",
     "typedoc": "~0.27.9",
     "typescript": "5.7.3",
-    "typescript-eslint": "^8.49.0",
-    "@vltpkg/vlt-json": "1.0.0-rc.18"
+    "typescript-eslint": "^8.49.0"
   },
   "license": "BSD-2-Clause-Patent",
   "engines": {
-    "node": ">=22.9.0"
+    "node": ">=22.22.0"
+  },
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "prepack": "tsc -p tsconfig.publish.json && ../../scripts/update-dist-exports.ts",
+    "snap": "tap",
+    "test": "tap",
+    "posttest": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
   },
   "tap": {
     "extends": "../../tap-config.yaml"
   },
   "prettier": "../../.prettierrc.js",
-  "module": "./dist/index.js",
+  "module": "./src/index.ts",
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "import": {
-        "default": "./dist/index.js"
+        "default": "./src/index.ts"
       }
     },
     "./browser": {
       "import": {
-        "default": "./dist/browser.js"
+        "default": "./src/browser.ts"
       }
     }
   },
   "files": [
     "dist"
-  ],
-  "scripts": {
-    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
-    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
-    "lint": "eslint . --fix",
-    "lint:check": "eslint .",
-    "snap": "tap",
-    "test": "tap",
-    "posttest": "tsc --noEmit",
-    "typecheck": "tsc --noEmit"
-  }
-}
+  ]
+}

package/dist/actual/load.d.ts

@@ -1,100 +0,0 @@
-import { Spec } from '@vltpkg/spec';
-import { Graph } from '../graph.ts';
-import type { DepID } from '@vltpkg/dep-id';
-import type { PackageJson } from '@vltpkg/package-json';
-import type { SpecOptions } from '@vltpkg/spec';
-import type { NormalizedManifest } from '@vltpkg/types';
-import type { Monorepo } from '@vltpkg/workspaces';
-import type { Path, PathScurry } from 'path-scurry';
-import type { GraphModifier } from '../modifiers.ts';
-export type LoadOptions = SpecOptions & {
-    /**
-     * The project root dirname.
-     */
-    projectRoot: string;
-    /**
-     * The project root manifest.
-     */
-    mainManifest?: NormalizedManifest;
-    /**
-     * The graph modifiers helper object.
-     */
-    modifiers?: GraphModifier;
-    /**
-     * A {@link Monorepo} object, for managing workspaces
-     */
-    monorepo?: Monorepo;
-    /**
-     * A {@link PackageJson} object, for sharing manifest caches
-     */
-    packageJson: PackageJson;
-    /**
-     * A {@link PathScurry} object, for use in globs
-     */
-    scurry: PathScurry;
-    /**
-     * If set to `false`, `actual.load` will not load any `package.json`
-     * files while traversing the file system.
-     *
-     * The resulting {@link Graph} from loading with `loadManifests=false`
-     * has no information on dependency types or the specs defined and
-     * no information on missing and extraneous dependencies.
-     */
-    loadManifests?: boolean;
-    /**
-     * If set to `true`, then do not shortcut the process by reading the
-     * hidden lockfile at `node_modules/.vlt-lock.json`
-     */
-    skipHiddenLockfile?: boolean;
-    /**
-     * Load only importers into the graph if the modifiers have changed.
-     */
-    skipLoadingNodesOnModifiersChange?: boolean;
-    /**
-     * If set to `true`, fail if lockfile is missing or out of date.
-     * Used by ci command to enforce lockfile integrity.
-     */
-    expectLockfile?: boolean;
-    /**
-     * If set to `true`, fail if lockfile is missing or out of sync with package.json.
-     * Prevents any lockfile modifications and is stricter than expectLockfile.
-     */
-    frozenLockfile?: boolean;
-    /**
-     * If set to `true`, only update the lockfile without performing any node_modules
-     * operations. Skips package extraction, filesystem operations, and hidden lockfile saves.
-     */
-    lockfileOnly?: boolean;
-};
-export type ReadEntry = {
-    alias: string;
-    name: string;
-    realpath: Path;
-};
-/**
- * The configuration object type as it is saved in the `.vlt/vlt.json`
- */
-export type StoreConfigObject = {
-    modifiers: Record<string, string> | undefined;
-};
-/**
- * Checks if a given object is a {@link StoreConfigObject}.
- */
-export declare const isStoreConfigObject: (obj: unknown) => obj is StoreConfigObject;
-/**
- * Returns a {@link StoreConfigObject} from a given object.
- * Throws a TypeError if the object can't be converted.
- */
-export declare const asStoreConfigObject: (obj: unknown) => StoreConfigObject;
-/**
- * Returns a {@link DepID} for a given spec and path, if the spec is
- * path-based or a registry spec, otherwise returns `undefined`.
- */
-export declare const getPathBasedId: (spec: Spec, path: Path) => DepID | undefined;
-/**
- * Read the file system looking for `node_modules` folders and
- * returns a new {@link Graph} that represents the relationship
- * between the dependencies found.
- */
-export declare const load: (options: LoadOptions) => Graph;
-//# sourceMappingURL=load.d.ts.map

package/dist/actual/load.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/actual/load.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AAQnC,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAGnC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAC/C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAEnD,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,iBAAiB,CAAA;AAGxB,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IACtC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB;;OAEG;IACH,WAAW,EAAE,WAAW,CAAA;IACxB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAA;IAClB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;OAEG;IACH,iCAAiC,CAAC,EAAE,OAAO,CAAA;IAE3C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,IAAI,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,QACzB,OAAO,KACX,GAAG,IAAI,iBAGe,CAAA;AAEzB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACzB,OAAO,KACX,iBAKF,CAAA;AAUD;;;GAGG;AACH,eAAO,MAAM,cAAc,SACnB,IAAI,QACJ,IAAI,KACT,KAAK,GAAG,SAGQ,CAAA;AA2SnB;;;;GAIG;AACH,eAAO,MAAM,IAAI,YAAa,WAAW,KAAG,KAuG3C,CAAA"}

package/dist/actual/load.js

@@ -1,320 +0,0 @@
-import { asDepID, hydrate, joinDepIDTuple, joinExtra, splitDepID, splitExtra, } from '@vltpkg/dep-id';
-import { Spec } from '@vltpkg/spec';
-import { graphStep } from '@vltpkg/output';
-import { isObject } from '@vltpkg/types';
-import { shorten, getRawDependencies, getDependencies, } from "../dependencies.js";
-import { Graph } from "../graph.js";
-import { loadHidden } from "../lockfile/load.js";
-import { saveHidden } from "../lockfile/save.js";
-import { readFileSync } from 'node:fs';
-/**
- * Checks if a given object is a {@link StoreConfigObject}.
- */
-export const isStoreConfigObject = (obj) => isObject(obj) &&
-    Object.prototype.hasOwnProperty.call(obj, 'modifiers') &&
-    isObject(obj.modifiers);
-/**
- * Returns a {@link StoreConfigObject} from a given object.
- * Throws a TypeError if the object can't be converted.
- */
-export const asStoreConfigObject = (obj) => {
-    if (!isStoreConfigObject(obj)) {
-        throw new TypeError(`Expected a store config object, got ${obj}`);
-    }
-    return obj;
-};
-// path-based refer to the types of dependencies that are directly linked to
-// their real location in the file system and thus will not have an entry
-// in the `node_modules/.vlt` store
-const pathBasedType = new Set(['file', 'workspace']);
-const isPathBasedType = (type) => pathBasedType.has(type);
-/**
- * Returns a {@link DepID} for a given spec and path, if the spec is
- * path-based or a registry spec, otherwise returns `undefined`.
- */
-export const getPathBasedId = (spec, path) => isPathBasedType(spec.type) ?
-    joinDepIDTuple([spec.type, path.relativePosix()])
-    : findDepID(path);
-/**
- * Retrieve the {@link DepID} for a given package from its location.
- */
-const findDepID = ({ parent, name }) => parent?.name === '.vlt' ? asDepID(name)
-    : parent?.isCWD === false ? findDepID(parent)
-        : undefined;
-/**
- * Retrieves the closest `node_modules` parent {@link Path} found.
- */
-const findNodeModules = ({ parent, name, isCWD, }) => parent?.name === 'node_modules' ? parent
-    : parent && name !== '.vlt' && !isCWD ? findNodeModules(parent)
-        : undefined;
-/**
- * Retrieves the scoped-normalized package name from its {@link Path}.
- */
-const findName = ({ parent, name }) => parent?.name.startsWith('@') ? `${parent.name}/${name}` : name;
-/**
- * Helper function that gets a modified {@link Spec} when finding a modifier
- * that applies to a given dependency. Otherwise returns the original spec
- * value and no queryModifier.
- */
-const maybeApplyModifierToSpec = (spec, depName, modifierRefs) => {
-    const activeModifier = modifierRefs?.get(depName);
-    const queryModifier = activeModifier?.modifier.query;
-    const completeModifier = activeModifier &&
-        activeModifier.interactiveBreadcrumb.current ===
-            activeModifier.modifier.breadcrumb.last;
-    if (queryModifier &&
-        completeModifier &&
-        'spec' in activeModifier.modifier) {
-        const modifiedSpec = activeModifier.modifier.spec;
-        modifiedSpec.overridden = true;
-        return { spec: modifiedSpec, queryModifier };
-    }
-    return { spec, queryModifier };
-};
-/**
- * Reads the current directory defined at `currDir` and looks for folder
- * names and their realpath resolution, normalizing scoped package names
- * and removing any invalid symlinks from the list of items that should
- * be parsed through in order to build the graph.
- */
-const readDir = (scurry, currDir, fromNodeName) => {
-    const res = new Set();
-    for (const entry of scurry.readdirSync(currDir)) {
-        // ignore any hidden files / folders
-        if (entry.name.startsWith('.'))
-            continue;
-        // scope folder found, it will need to be read and iterated over
-        // in order to find any scoped packages inside
-        if (entry.name.startsWith('@')) {
-            const scopedItems = readDir(scurry, entry, fromNodeName);
-            for (const scopedItem of scopedItems) {
-                res.add(scopedItem);
-            }
-            continue;
-        }
-        // skip anything that isn't a symlink, it's not an edge
-        if (!entry.isSymbolicLink())
-            continue;
-        // we'll need to learn what is the real path for this entry in order
-        // to retrieve the `location` and `id` properties for the node, if a
-        // realpath is not found just move on to the next element
-        const realpath = entry.realpathSync();
-        if (!realpath) {
-            continue;
-        }
-        // infer both the alias and proper package names, including scopes
-        const alias = findName(entry);
-        const name = findName(realpath);
-        res.add({
-            alias,
-            name,
-            realpath,
-        });
-    }
-    return res;
-};
-/**
- * Parses the files located at `currDir` and place packages found inside
- * as dependencies of `fromNode`, building the instantiated `graph`.
- */
-const parseDir = (options, scurry, packageJson, depsFound, graph, fromNode, currDir) => {
-    const { loadManifests, modifiers } = options;
-    const dependencies = getRawDependencies(fromNode);
-    const seenDeps = new Set();
-    const readItems = readDir(scurry, currDir, fromNode.name);
-    // Get modifier references for this node's dependencies
-    const modifierRefs = modifiers?.tryDependencies(fromNode, [
-        ...getDependencies(fromNode, options).values(),
-    ]);
-    for (const { alias, name, realpath } of readItems) {
-        let node;
-        // tracks what dependencies have been seen
-        // so that we can mark missing dependencies
-        seenDeps.add(alias);
-        // places the package in the graph reading
-        // its manifest only if necessary
-        if (!loadManifests) {
-            const depId = findDepID(realpath);
-            if (depId) {
-                let h = hydrate(depId, alias, options);
-                // if the parsed registry value is using the default value, then
-                // the node should inherit the registry value from its parent node
-                if (h.type === 'registry' &&
-                    h.registry === h.options.registry &&
-                    fromNode.registry) {
-                    h.registry = fromNode.registry;
-                }
-                // Check for active modifiers and replace spec even when not loading manifests
-                const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(h, alias, modifierRefs);
-                h = modifiedSpec;
-                // graphs build with no manifest have no notion of
-                // dependency types and or spec definitions since those
-                // would have to be parsed from a manifest
-                node = graph.placePackage(fromNode, 'prod', // defaults to prod deps
-                h, // uses spec from hydrated id
-                {
-                    name,
-                }, depId, joinExtra({ modifier: queryModifier }));
-                // Update active entry after placing package
-                const activeModifier = modifierRefs?.get(alias);
-                if (activeModifier && node) {
-                    modifiers?.updateActiveEntry(node, activeModifier);
-                }
-            }
-        }
-        // retrieve references to the current folder name found in `fromNode`
-        // manifest listed dependencies, removing it from the map will leave
-        // a list of missing dependencies at the end of the iteration
-        const deps = dependencies.get(alias);
-        // in case this graph is skipping manifests, this next block might
-        // still need to execute, thus actually loading a manifest file, for
-        // edge-cases such as loading a linked node that is not going to have
-        // DepID info available in its realpath or extraneous nodes
-        if (!node) {
-            const mani = packageJson.read(realpath.fullpath());
-            // declares fallback default values for both depType and bareSpec
-            // in order to support loadManifests=false fallback for link nodes
-            const type = deps?.type || 'dependencies';
-            const bareSpec = deps?.bareSpec || '*';
-            const depType = shorten(type, alias, fromNode.manifest);
-            let spec = Spec.parse(alias, bareSpec, {
-                ...options,
-                registry: fromNode.registry,
-            });
-            // Check for active modifiers and replace spec if a modifier is complete
-            const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(spec, alias, modifierRefs);
-            spec = modifiedSpec;
-            const maybeId = getPathBasedId(spec, realpath);
-            let peerSetHash;
-            if (maybeId) {
-                // parses extra info from depID to retrieve peerSetHash
-                try {
-                    const tuple = splitDepID(maybeId);
-                    const type = tuple[0];
-                    const extra = type === 'registry' || type === 'git' ?
-                        tuple[3]
-                        : tuple[2];
-                    peerSetHash =
-                        extra ? splitExtra(extra).peerSetHash : undefined;
-                    /* c8 ignore next - impossible: getPathBasedId asserts valid dep id */
-                }
-                catch { }
-            }
-            node = graph.placePackage(fromNode, depType, spec, mani, maybeId, joinExtra({ modifier: queryModifier, peerSetHash }));
-            // Update active entry after placing package
-            const activeModifier = modifierRefs?.get(alias);
-            if (activeModifier && node) {
-                modifiers?.updateActiveEntry(node, activeModifier);
-            }
-        }
-        if (node) {
-            // If a found dependency is not declared in any of the original
-            // node dependencies, then add an edge to the graph pointing to it
-            // and mark it as extraneous.
-            //
-            // This only makes sense if full manifests are being loaded
-            // so that we have reference to dependencies info.
-            if (loadManifests && !deps) {
-                const [edge] = node.edgesIn;
-                if (edge) {
-                    graph.extraneousDependencies.add(edge);
-                }
-            }
-            // for a succesfully created node, add its location
-            // property and queue up to read its dependencies
-            node.location = `./${realpath.relativePosix()}`;
-            const node_modules = findNodeModules(realpath);
-            // queue items up to continue parsing dirs in case a node was succesfully
-            // placed in the graph and its node_modules folder was correctly found
-            if (node_modules) {
-                depsFound.set(node, node_modules);
-            }
-        }
-    }
-    // any remaining dependencies that have not been found
-    // when reading the directory should be marked as missing
-    for (const { name, type, bareSpec } of dependencies.values()) {
-        if (!seenDeps.has(name)) {
-            const depType = shorten(type, name, fromNode.manifest);
-            let spec = Spec.parse(name, bareSpec, {
-                ...options,
-                registry: fromNode.registry,
-            });
-            // Check for active modifiers and replace spec for missing dependencies
-            const { spec: modifiedSpec, queryModifier } = maybeApplyModifierToSpec(spec, name, modifierRefs);
-            spec = modifiedSpec;
-            graph.placePackage(fromNode, depType, spec, undefined, undefined, joinExtra({ modifier: queryModifier }));
-        }
-    }
-};
-/**
- * Read the file system looking for `node_modules` folders and
- * returns a new {@link Graph} that represents the relationship
- * between the dependencies found.
- */
-export const load = (options) => {
-    const done = graphStep('actual');
-    const { modifiers, monorepo, projectRoot, packageJson, scurry, skipHiddenLockfile = false, skipLoadingNodesOnModifiersChange = false, } = options;
-    const mainManifest = options.mainManifest ?? packageJson.read(projectRoot);
-    if (!skipHiddenLockfile) {
-        try {
-            // if we reach here, the hidden lockfile is valid
-            const graph = loadHidden({
-                ...options,
-                projectRoot,
-                mainManifest,
-                packageJson,
-                monorepo,
-                scurry,
-            });
-            done();
-            return graph;
-        }
-        catch {
-            // Hidden lockfile is cache-only, safe to regenerate on any error
-            // as it will fall back to filesystem traversal
-            // TODO: Warn version mismatch to @vltpkg/output for debugging
-        }
-    }
-    const graph = new Graph({ ...options, mainManifest });
-    // retrieve the configuration object from the store
-    let storeConfig = { modifiers: undefined };
-    try {
-        storeConfig = asStoreConfigObject(JSON.parse(readFileSync(scurry.resolve('node_modules/.vlt/vlt.json'), 'utf8')));
-    }
-    catch { }
-    const storeModifiers = JSON.stringify(storeConfig.modifiers ?? {});
-    const optionsModifiers = JSON.stringify(modifiers?.config);
-    const modifiersChanged = storeModifiers !== optionsModifiers;
-    const shouldLoadDependencies = !(skipLoadingNodesOnModifiersChange && modifiersChanged);
-    // will only skip loading dependencies if the
-    // skipLoadingNodesOnModifiersChange option is set to true
-    // and the current modifiers have not changed when compared
-    // to the modifiers stored in the `node_modules/.vlt/vlt.json` store config
-    if (shouldLoadDependencies) {
-        const depsFound = new Map();
-        // starts the list of initial folders to parse using the importer nodes
-        for (const importer of graph.importers) {
-            modifiers?.tryImporter(importer);
-            depsFound.set(importer, scurry.cwd.resolve(`${importer.location}/node_modules`));
-        }
-        // breadth-first traversal of the file system tree reading deps found
-        // starting from the node_modules folder of every importer in order to
-        // find the actual installed dependencies at each location
-        for (const [node, path] of depsFound.entries()) {
-            parseDir(options, scurry, packageJson, depsFound, graph, node, path);
-        }
-        // Clean up any pending modifier entries that were never completed
-        modifiers?.rollbackActiveEntries();
-        // caches the load result to the hidden lockfile when enabled
-        if (scurry.cwd.resolve('node_modules').lstatSync()?.isDirectory()) {
-            saveHidden({
-                ...options,
-                graph,
-            });
-        }
-    }
-    done();
-    return graph;
-};
-//# sourceMappingURL=load.js.map

package/dist/actual/load.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../src/actual/load.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  asDepID,\n  hydrate,\n  joinDepIDTuple,\n  joinExtra,\n  splitDepID,\n  splitExtra,\n} 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, options)\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        if (\n          h.type === 'registry' &&\n          h.registry === h.options.registry &&\n          fromNode.registry\n        ) {\n          h.registry = fromNode.registry\n        }\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          joinExtra({ modifier: 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        registry: fromNode.registry,\n      })\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      let peerSetHash: string | undefined\n      if (maybeId) {\n        // parses extra info from depID to retrieve peerSetHash\n        try {\n          const tuple = splitDepID(maybeId)\n          const type = tuple[0]\n          const extra =\n            type === 'registry' || type === 'git' ?\n              tuple[3]\n            : tuple[2]\n\n          peerSetHash =\n            extra ? splitExtra(extra).peerSetHash : undefined\n          /* c8 ignore next - impossible: getPathBasedId asserts valid dep id */\n        } catch {}\n      }\n      node = graph.placePackage(\n        fromNode,\n        depType,\n        spec,\n        mani,\n        maybeId,\n        joinExtra({ modifier: queryModifier, peerSetHash }),\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        registry: fromNode.registry,\n      })\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        joinExtra({ modifier: 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      // Hidden lockfile is cache-only, safe to regenerate on any error\n      // as it will fall back to filesystem traversal\n      // TODO: Warn version mismatch to @vltpkg/output for debugging\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    if (\n      scurry.cwd.resolve('node_modules').lstatSync()?.isDirectory()\n    ) {\n      saveHidden({\n        ...options,\n        graph,\n      })\n    }\n  }\n\n  done()\n\n  return graph\n}\n"]}

package/dist/browser.d.ts

@@ -1,15 +0,0 @@
-import { longDependencyTypes } from '@vltpkg/types';
-import { asDependencyTypeShort, shorten } from './dependencies.ts';
-import { getBooleanFlagsFromNum } from './lockfile/types.ts';
-import { stringifyNode } from './stringify-node.ts';
-export type { LoadResult, TransferData, } from './transfer-data/load.ts';
-export * from './virtual-root.ts';
-declare const lockfile: {
-    loadEdges: (graph: import("@vltpkg/types").GraphLike, edges: import("./lockfile/types.ts").LockfileData["edges"], options: import("@vltpkg/spec").SpecOptions) => void;
-    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;
-};
-declare const transfer: {
-    load: (transfered: import("./transfer-data/load.ts").TransferData) => import("./transfer-data/load.ts").LoadResult;
-};
-export { asDependencyTypeShort, getBooleanFlagsFromNum, lockfile, longDependencyTypes, shorten, stringifyNode, transfer, };
-//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -1 +0,0 @@
-{"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"}

package/dist/browser.js

@@ -1,17 +0,0 @@
-import { longDependencyTypes } from '@vltpkg/types';
-import { asDependencyTypeShort, shorten } from "./dependencies.js";
-import { getBooleanFlagsFromNum } from "./lockfile/types.js";
-import { stringifyNode } from "./stringify-node.js";
-import { loadEdges } from "./lockfile/load-edges.js";
-import { loadNodes } from "./lockfile/load-nodes.js";
-import { load } from "./transfer-data/load.js";
-export * from "./virtual-root.js";
-const lockfile = {
-    loadEdges,
-    loadNodes,
-};
-const transfer = {
-    load,
-};
-export { asDependencyTypeShort, getBooleanFlagsFromNum, lockfile, longDependencyTypes, shorten, stringifyNode, transfer, };
-//# sourceMappingURL=browser.js.map