"Variant Unavailable" could offer more helpful explanation

[nathanacurtis]

Problem

Users don't understand why "Variant unavailable" occurs for some outputs.

Solutions

Improve the error message?
Link the message to an online explanation of what it is and how to adjust for best results.

Feedback to recent user

This is a result of a failed .setProperties call, such that the plugin is trying to change the props of the reference it started from, and the combination of properties doesn't exist.

For each prop, it cycles through all options of that prop with all other props held constant.

For example, imagine a component set with three variants:
Prop 1=A, Prop 2 = A
Prop 1=A, Prop 2 = B
Prop 1=B, Prop 2 = A
If you start from #2 (Prop 1=A, Prop 2 = B), the component will produce Variant unavailable when it tries to produce a row with Prop 1=B, Prop 2=B.

This should only be happening when you have "missing variant combinations". When that happens, consider running the plugin by selecting a different starter variant to produce different results.