Interaction of empty arrays and `satisfies` is unsatisfying

Suggestion

🔍 Search Terms

List of keywords you searched for before creating this issue. Write them down here so that others can find this suggestion more easily and help provide feedback.

✅ Viability Checklist

My suggestion meets these guidelines:

• This wouldn’t be a breaking change in existing TypeScript/JavaScript code
• This wouldn’t change the runtime behavior of existing JavaScript code
• This could be implemented without emitting different JS based on the types of the expressions
• This isn’t a runtime feature (e.g. library functionality, non-ECMAScript syntax with JavaScript output, new syntax sugar for JS, etc.)
• This feature would agree with the rest of TypeScript’s Design Goals.

⭐ Suggestion

when we use satisfies keywords, infer empty array to typed array by satisfies target array instead of never array

📃 Motivating Example

interface TreeNode {
  children: TreeNode[];
}

const a = {
  children: [],
} satisfies TreeNode;

// expect: TreeNode[]
// accept: never[]
a.children
// ^?

https://www.typescriptlang.org/play?#code/JYOwLgpgTgZghgYwgAgCpQhAcgewCYoDeAUMsggBbAA2eGIAXGhtvhANoC6A3MQL7FiCHCADOYZHGQBeZCTKUadCI2RcANP2Si4YYKJjAIo5plwFexAPRXkEAB4AHCAjBN0Ztl2JwAdItp6a1sAPQB+YiA

💻 Use Cases

infer a.children to TreeNode[]

[RyanCavanaugh]

Why is the default inference for [] (in the absence of a conditional type) not unknown[]? It feels weird to infer never[] …

Good question and a lot to unpack here. I’ll speak only in terms of today’s behavior for clarity. Empty arrays are (again, currently) not affected by contextual typing except that they can form 0-length tuples in the presence of a tuple-like contextual type. So if you look at a call like

declare function doSomething(blah: number[]): void
doSomething([]);

Here the expression [] has type never[] and the call succeeds. Had [] had type unknown[], the call would have failed.

For types given to inferred variables, the situation is much tricker due to evolving arrays. But object properties don’t qualify for evolving arrays, so the situation is analogous:

const obj = { a: [] }
declare function doSomething(blah: { a: readonly number[] }): void
doSomething(obj);

This call is processed the same way: obj.a is never[]. This one is probably the most important to get right since there is no contextual typing to “fix” the type of [] in this example.

likely intends to push stuff into it afterwards

Sometimes yes, sometimes no. There are a lot of APIs like

sendEmail(subject, body, /*attachments*/ []);

where it makes sense to just give someone a fresh empty array literal that doesn’t have any bindings pointing to it. The “sometimes yes” case is indeed why we went to the trouble to make evolving arrays (those whose type is inferred via CFA looking for calls to push/etc), since in the case where you start with a variable initialized with [], almost certainly it’s not going to stay empty.

TL;DR handling both covariant and contravariant inference is hard

[jcalz]

The functionality of satisfies, as implemented in #46827, was discussed in #7481 and then #47920, and it was decided that the “safe upcast” functionality couldn’t really be directly supported while also supporting all the other use cases. In this comment it was shown that to get a safe upcast you could write x satisfies T as T which, while annoying, is at least possible:

const a = {
  children: [],
} satisfies TreeNode as TreeNode; // safe upcast

But if you’re already assigning to a variable you might as well annotate:

const a: TreeNode = { // annotate
  children: [],
};

Or, depending on what you’re trying to do:

const a = {
  children: [] satisfies TreeNode[] as TreeNode[] // safe upcast here
} satisfies TreeNode;

I think it would be wonderful to have a specific operator for safe upcasting (shorten x satisfies T as T to x satisfiesas T / x satisfas T / x sassafras T / x sass T / x ass T), like an in-line type annotation. (Is there an open issue for this?) But I don’t think satisfies alone will ever do this for you.

(Note: for empty arrays in particular it would lovely if nothing were ever inferred as never[], but I don’t know that they’d want to special case how empty arrays behave with satisfies.)