cratis-specifications-typescript

Cratis TypeScript specifications

Specifications describe behavior, not implementation. The given() helper and its context class are the TypeScript counterpart of the C# Specification base: setup is separated from the action, and each it() verifies one outcome.

Verified product sources

This skill is verified against the frameworks these specifications run on:

Framework	Role
Vitest	Test runner (yarn test from the package root)
Mocha-style structure	describe, it, beforeEach, afterEach
Chai	Assertions, always through the .should fluent interface
Sinon	Stubbing and call verification

The given() helper is supplied by the Cratis TypeScript package under specification and is imported from that package root. Reverify the helper's location and signature against the owning repository before relying on a different import path.

Route near misses

• The specification is C#: use cratis-specifications-csharp instead.
• The subject is an application view model or React component rather than a Cratis TypeScript package: the plain describe/beforeEach frontend style applies, not the given() helper in this skill.
• The question is what the code under specification should do: resolve the behavior first; this skill only specifies already decided behavior.

Step 1 — Create the folder structure

Specifications live alongside the source they describe:

for_<ClassName>/
├── given/
│   └── a_<system_under_test>.ts   ← reusable context class
├── when_<behavior>/               ← a behavior with multiple outcomes
│   ├── with_<condition>.ts
│   ├── without_<condition>.ts
│   └── and_<condition>.ts
└── when_<simple_behavior>.ts      ← a single outcome is a single file

Paths read as English sentences. Allowed outcome prefixes are and_, with_, without_, having_, and given_.

when belongs only in a when_<behavior> folder name. A specification file or non-when_ folder must never contain the word when. Fold the context into the when_ folder name and use preposition files for the outcomes. Add a sub-folder under when_ only when that condition has its own multiple outcomes.