> For the complete documentation index, see [llms.txt](https://swu-forge.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards/suspended-cards.md).

# Suspended Cards

Some cards are suspended from Star Wars: Unlimited Organized Play in one format but legal in another. SWU Forge surfaces these in two ways.

## The suspended list

The list is maintained manually in `src/lib/suspendedCards.ts`:

```ts
export const SUSPENDED_CARDS: Record<SuspendedFormat, string[]> = {
  premier: [],
  eternal: ['JTL_140', 'JTL_170']  // IG-2000, War Juggernaut
};
```

Keys use the `${expansion.code}_${cardNumber}` convention produced by `cardKey()` in `src/lib/types.ts`. Twin Suns has no OP scene and therefore no suspensions.

## Format-aware stamps

A red **SUSPENDED** stamp is drawn on card tiles when — and only when — the deck or search format matches the format the card is suspended in. For example, War Juggernaut shows the stamp on an Eternal deck but renders clean on a Premier deck.

The stamp is rendered by `src/lib/components/SuspendedStamp.svelte` and is applied in:

* `CardTile.svelte` (search results, expanded view)
* `CardCondensedTile.svelte` (search results, condensed view — rendered as an inline chip)
* `DeckCardTile.svelte` (main deck cards in the workshop and in view-deck mode)
* `DeckBuilder.svelte` — `lbTile` (leader/base) and `sbTile` (sideboard) snippets
* `DeckPreview.svelte` — leader, base, and sideboard tiles in view-deck mode

Each of those components accepts a `format?: DeckFormat` prop. `CardGrid.svelte` threads the prop from its callers; `DeckBuilder` passes its `formatProp` down to its snippets; `DeckPreview` passes its `format` prop to `DeckCardTile` and to `isSuspended` checks on its inline tiles.

## Searching for suspended cards

You can search for suspended cards using plain language queries like:

* `"suspended cards in eternal"` — shows cards currently suspended in Eternal format
* `"banned cards"` or `"what's suspended"` — shows suspended cards in the active format

The search uses the `suspended` filter in the FilterSpec, which checks against the `SUSPENDED_CARDS` list for the given format. Setting `suspended: true` returns only suspended cards; `suspended: false` excludes them.

## Adding or removing suspended cards

1. Edit `SUSPENDED_CARDS` in `src/lib/suspendedCards.ts`.
2. Update `src/lib/suspendedCards.test.ts` if the asserted titles change.
3. No data migration or schema change is needed — the list is consulted at render time.

## Tests

* Unit: `src/lib/suspendedCards.test.ts` covers the `isSuspended()` format-match rules and confirms Twin Suns is never treated as suspended.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://swu-forge.gitbook.io/docs/cards-and-search/searching-cards/suspended-cards.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
