dimgrid

Build a typed N-dimensional grid of objects by chaining named dimensions. Each .dim() call stores dimension metadata; the Cartesian product is computed lazily on iteration or .toArray().

See API reference for complete type signatures and edge cases.

When to use

• Writing parametrised tests and need all combinations of inputs (vitest test.each, Jest, Mocha)
• Generating a Storybook story that covers every prop combination for a component
• Running a hyperparameter grid search
• Enumerating valid configurations or states from independent axes
• Any task where the phrase "every combination of X and Y" comes up

Do not use for permutations (order matters) or when values depend on external async data — dimgrid is synchronous.

Setup

Check whether dimgrid is already installed: