What does $TURBO_DEFAULT$ represent exactly?

[breadadams]

Summary

Apologies if this has been asked/answered elsewhere, I've gone through issues and discussions but not been able to find an answer to this specific question.

So I understand that turborepo has the special $TURBO_DEFAULT$ string for restoring the default behaviour for inputs, and here in the docs, I see the following regarding what said default behaviour is:

Default: [], all files in the package that are checked into source control

So, question 1: Is that what the special string does, include all files checked into source control?

I ask because for a certain task I want the inputs to be just one file, lets call it foo.js, therefore I'd do the following:

{
  "tasks": {
    "build": {
      "inputs": ["foo.js"]
    }
  }
}

However I of course also want the task to re-run if an installed 3rd party dependency is updated (since foo.js could be consuming it), meaning I care about package.json too.

Question 2: For this scenario, would I either have to include package.json explicitly in the array, or is $TURBO_DEFAULT$ what I should be reaching for here? Or is package.json always evaluated?

i.e.

{
  "tasks": {
    "build": {
      "inputs": ["package.json", "foo.js"]
    }
  }
}

or this

{
  "tasks": {
    "build": {
      "inputs": ["$TURBO_DEFAULT$", "foo.js"]
    }
  }
}

Additional information

No response

Example

No response

[anthonyshew]

Answer 1: inputs is specific to file inputs. Dependencies in package.json will still be incorporated into the hash.

Answer 2: package.json is always included in the hash, even if you try to ignore it.

Made #10628 to improve the documentation. Thank you for asking!

[breadadams]

Thanks @anthonyshew, couple of things:

1. In my first question I was asking about what $TURBO_DEFAULT$ represents under the hood, not sure whether you've explicitly answered that.
2. Follow-up to the above; it be lovely if you could share a link to the source code that handles the $TURBO_DEFAULT$ string – merely for educational purposes.
3. Is the root package.json always included too?

[breadadams]

Hi @anthonyshew, could you check out my previous comment? I'm using $TURBO_DEFAULT$ again and came back to this discussion for guidance, but I think you missed my reply last time.

Thanks