# lynstack/class-recipe architecture

> Architecture diagram of the GitHub repository lynstack/class-recipe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lynstack/class-recipe
- Repository: https://github.com/lynstack/class-recipe

## Overview

lynstack recipe is a TypeScript runtime for defining type-safe, cached functions that map variant selections to class names, React Native styles, or arbitrary values. Component authors define variants, defaults, compositions, and optionally slots; calling a recipe produces the selected result. The shared `@lynstack/recipe` engine handles variant compilation, configuration checks, composition, selection, and caching, while the class and native packages provide specialized outputs. The README documents themed native recipes as a further capability. Some implementation details are unsampled, so only documented or indexed relationships are connected.

Main entry points: [`packages/recipe/src/recipe-kind.ts`](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/recipe-kind.ts) (Recipe-kind orchestration), [`packages/recipe/src/slot-recipe-kind.ts`](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts) (Slot-kind orchestration), [`packages/native-recipe/src/style-recipe.ts`](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/style-recipe.ts) (Native style recipes), [`packages/recipe/src/variants.ts`](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/variants.ts) (Variant compilation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_engine["Shared recipe engine"]
  node_kind["Recipe-kind orchestration<br/>[recipe-kind.ts]"]
  node_slotkind["Slot-kind orchestration"]
  node_config["Config validation<br/>[check-config.ts]"]
  node_variantcompile["Variant compilation<br/>[variants.ts]"]
  node_composition["Recipe composition<br/>[composition.ts]"]
  node_layermerge["Layer merging<br/>[compose.ts]"]
  node_recipebuild["Value-layer building<br/>[build-recipe.ts]"]
  node_selector["Selection and cache<br/>[selector.ts]"]
  node_slotbuild["Slot result building<br/>[slots.ts]"]
  node_kindselect["Kind selection<br/>[kind-selection.ts]"]
end

subgraph group_classes["Class recipes"]
  node_classrecipe["Class recipe API<br/>[recipe.ts]"]
  node_classcompile["Class recipe compiler<br/>[compile-recipe.ts]"]
  node_classslots["Class slot recipes<br/>[slot-recipe.ts]"]
  node_classslotcompile["Class slot compiler"]
  node_classoptions["Class join options<br/>[build-options.ts]"]
  node_classcx["Class joining<br/>[cx.ts]"]
end

subgraph group_native["Native recipes"]
  node_nativerecipe["Native style recipes<br/>[style-recipe.ts]"]
  node_nativecompile["Native style compiler"]
  node_nativeslots["Native slot recipes"]
  node_nativeslotcompile["Native slot compiler"]
  node_themed["Themed recipes<br/>[themed-recipes.ts]"]
end

node_author(("Component author"))
node_selection["Variant selection"]
node_output["Recipe result"]

node_author -->|"defines variants"| node_classrecipe
node_author -->|"defines variants"| node_nativerecipe
node_author -->|"defines value recipes"| node_kind
node_classrecipe -->|"compiles recipe"| node_classcompile
node_classslots -->|"compiles slots"| node_classslotcompile
node_classcompile -->|"uses engine"| node_kind
node_classslotcompile -->|"uses engine"| node_slotkind
node_classcompile -->|"uses options"| node_classoptions
node_classslotcompile -->|"uses options"| node_classoptions
node_classoptions -->|"configures joining"| node_classcx
node_author -->|"defines slots"| node_nativeslots
node_author -->|"defines theme recipes"| node_themed
node_nativerecipe -->|"compiles recipe"| node_nativecompile
node_nativeslots -->|"compiles slots"| node_nativeslotcompile
node_nativecompile -->|"uses engine"| node_kind
node_nativeslotcompile -->|"uses engine"| node_slotkind
node_themed -.->|"creates recipes"| node_nativerecipe
node_kind -->|"checks config"| node_config
node_kind -->|"merges layers"| node_layermerge
node_kind -->|"builds values"| node_recipebuild
node_kind -->|"creates selector"| node_selector
node_kind -->|"compiles variants"| node_variantcompile
node_slotkind -->|"checks config"| node_config
node_slotkind -->|"merges layers"| node_layermerge
node_slotkind -->|"builds slot values"| node_slotbuild
node_slotkind -->|"compiles variants"| node_variantcompile
node_kind -->|"uses composition types"| node_composition
node_slotkind -->|"uses composition types"| node_composition
node_layermerge -->|"uses variants"| node_variantcompile
node_selector -->|"uses variant data"| node_variantcompile
node_classrecipe -->|"accepts selection"| node_selection
node_nativerecipe -->|"accepts selection"| node_selection
node_kind -->|"accepts selection"| node_selection
node_selection -->|"returns result"| node_output

click node_kind "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/recipe-kind.ts"
click node_slotkind "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts"
click node_config "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/check-config.ts"
click node_variantcompile "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/variants.ts"
click node_composition "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/composition.ts"
click node_layermerge "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/compose.ts"
click node_recipebuild "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/build-recipe.ts"
click node_selector "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/selector.ts"
click node_slotbuild "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/slots.ts"
click node_kindselect "https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/kind-selection.ts"
click node_classrecipe "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/recipe.ts"
click node_classcompile "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/compile-recipe.ts"
click node_classslots "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/slot-recipe.ts"
click node_classslotcompile "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/compile-slot-recipe.ts"
click node_classoptions "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/build-options.ts"
click node_classcx "https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/cx.ts"
click node_nativerecipe "https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/style-recipe.ts"
click node_nativecompile "https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/compile-style-recipe.ts"
click node_nativeslots "https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/slot-style-recipe.ts"
click node_nativeslotcompile "https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/compile-slot-style-recipe.ts"
click node_themed "https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/themed-recipes.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_kind,node_slotkind,node_config,node_variantcompile,node_composition,node_layermerge,node_recipebuild,node_selector,node_slotbuild,node_kindselect toneBlue
class node_classrecipe,node_classcompile,node_classslots,node_classslotcompile,node_classoptions,node_classcx toneAmber
class node_nativerecipe,node_nativecompile,node_nativeslots,node_nativeslotcompile,node_themed toneMint
class node_author,node_selection,node_output toneIndigo
```

## Components

### Shared recipe engine

- [Recipe-kind orchestration](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/recipe-kind.ts): `packages/recipe/src/recipe-kind.ts`
- [Slot-kind orchestration](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/slot-recipe-kind.ts): `packages/recipe/src/slot-recipe-kind.ts`
- [Config validation](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/check-config.ts): `packages/recipe/src/check-config.ts`
- [Variant compilation](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/variants.ts): `packages/recipe/src/variants.ts`
- [Recipe composition](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/composition.ts): `packages/recipe/src/composition.ts`
- [Layer merging](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/compose.ts): `packages/recipe/src/compose.ts`
- [Value-layer building](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/build-recipe.ts): `packages/recipe/src/build-recipe.ts`
- [Selection and cache](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/selector.ts): `packages/recipe/src/selector.ts`
- [Slot result building](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/slots.ts): `packages/recipe/src/slots.ts`
- [Kind selection](https://github.com/lynstack/class-recipe/blob/main/packages/recipe/src/kind-selection.ts): `packages/recipe/src/kind-selection.ts`

### Class recipes

- [Class recipe API](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/recipe.ts): `packages/class-recipe/src/recipe.ts`
- [Class recipe compiler](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/compile-recipe.ts): `packages/class-recipe/src/compile-recipe.ts`
- [Class slot recipes](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/slot-recipe.ts): `packages/class-recipe/src/slot-recipe.ts`
- [Class slot compiler](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/compile-slot-recipe.ts): `packages/class-recipe/src/compile-slot-recipe.ts`
- [Class join options](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/build-options.ts): `packages/class-recipe/src/build-options.ts`
- [Class joining](https://github.com/lynstack/class-recipe/blob/main/packages/class-recipe/src/cx.ts): `packages/class-recipe/src/cx.ts`

### Native recipes

- [Native style recipes](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/style-recipe.ts): `packages/native-recipe/src/style-recipe.ts`
- [Native style compiler](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/compile-style-recipe.ts): `packages/native-recipe/src/compile-style-recipe.ts`
- [Native slot recipes](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/slot-style-recipe.ts): `packages/native-recipe/src/slot-style-recipe.ts`
- [Native slot compiler](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/compile-slot-style-recipe.ts): `packages/native-recipe/src/compile-slot-style-recipe.ts`
- [Themed recipes](https://github.com/lynstack/class-recipe/blob/main/packages/native-recipe/src/themed-recipes.ts): `packages/native-recipe/src/themed-recipes.ts`

### Other components

- **Component author**
- **Variant selection**
- **Recipe result**

## Connections

- Component author → Class recipe API: defines variants (evidence: `README.md`)
- Component author → Native style recipes: defines variants (evidence: `README.md`)
- Component author → Recipe-kind orchestration: defines value recipes (evidence: `README.md`)
- Class recipe API → Class recipe compiler: compiles recipe (evidence: `packages/class-recipe/src/recipe.ts`)
- Class slot recipes → Class slot compiler: compiles slots (evidence: `packages/class-recipe/src/slot-recipe.ts`)
- Class recipe compiler → Recipe-kind orchestration: uses engine
- Class slot compiler → Slot-kind orchestration: uses engine (evidence: `packages/class-recipe/src/compile-slot-recipe.ts`)
- Class recipe compiler → Class join options: uses options
- Class slot compiler → Class join options: uses options (evidence: `packages/class-recipe/src/compile-slot-recipe.ts`)
- Class join options → Class joining: configures joining (evidence: `packages/class-recipe/src/build-options.ts`)
- Component author → Native slot recipes: defines slots (evidence: `README.md`)
- Component author → Themed recipes: defines theme recipes (evidence: `README.md`)
- Native style recipes → Native style compiler: compiles recipe (evidence: `packages/native-recipe/src/style-recipe.ts`)
- Native slot recipes → Native slot compiler: compiles slots (evidence: `packages/native-recipe/src/slot-style-recipe.ts`)
- Native style compiler → Recipe-kind orchestration: uses engine
- Native slot compiler → Slot-kind orchestration: uses engine
- Themed recipes → Native style recipes: creates recipes
- Recipe-kind orchestration → Config validation: checks config (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe-kind orchestration → Layer merging: merges layers (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe-kind orchestration → Value-layer building: builds values (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe-kind orchestration → Selection and cache: creates selector (evidence: `packages/recipe/src/recipe-kind.ts`)
- Recipe-kind orchestration → Variant compilation: compiles variants (evidence: `packages/recipe/src/recipe-kind.ts`)
- Slot-kind orchestration → Config validation: checks config (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot-kind orchestration → Layer merging: merges layers (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot-kind orchestration → Slot result building: builds slot values (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Slot-kind orchestration → Variant compilation: compiles variants (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Recipe-kind orchestration → Recipe composition: uses composition types (evidence: `packages/recipe/src/recipe-kind.ts`)
- Slot-kind orchestration → Recipe composition: uses composition types (evidence: `packages/recipe/src/slot-recipe-kind.ts`)
- Layer merging → Variant compilation: uses variants (evidence: `packages/recipe/src/compose.ts`)
- Selection and cache → Variant compilation: uses variant data (evidence: `packages/recipe/src/selector.ts`)
- Class recipe API → Variant selection: accepts selection (evidence: `README.md`)
- Native style recipes → Variant selection: accepts selection (evidence: `README.md`)
- Recipe-kind orchestration → Variant selection: accepts selection (evidence: `README.md`)
- Variant selection → Recipe result: returns result (evidence: `README.md`)
