[Yutsa]

Why

Players choose their alt arts in the ownership service (AlteredOwnership), in one of two modes:

• « Global »: the service rewrites every deck with the player's preferences, on the site and on Board Game Arena (AltArtService.ApplyToDeckAsync). A deck cannot keep prints of its own.
• « Par deck »: each deck plays its own prints. Before this PR, the settings page only offered tokens in this mode, and a card added to a deck took the plain print.

Players want to set their alt arts once, as defaults, and still change them deck by deck. Players in « Global » must keep what they see on BGA until they choose otherwise.

How

The two modes

The two modes stay. The preferences keep their storage in the service (slotReferences), and the mode only changes from the settings page, after a confirmation.

	« Par deck »	« Global »
Settings page « Arts alternatifs par défaut »	Every card and token. The 1st, 2nd and 3rd card of each card get their illustration: the defaults	Same page, same defaults
Card added in Re:Builder	Takes the default of its copy	Takes the defaults, like the whole deck
Per-deck override	The brush, card by card, for this deck only	None: no brush, no « Arts par défaut »
What BGA plays	The deck's prints (the base art for copies not owned)	The defaults, written by the service, unchanged

In « Global », Re:Builder writes the defaults in the deck when it opens and after each change, so the site's list matches what BGA plays. Preprod already did this; the PR now also falls back to the base art past the owned copies, as the service does.

Switching modes

• To « Global »: the mode is set after a confirmation, as before.
• Leaving « Global » (api/alt-art-leave-global.php, includes/func.alt-arts.php): the page lists the player's decks and writes in each one what BGA showed of it (altArtApplyToDeck, while still in « Global »), four at a time with a progress bar. Then it sets the mode.
  • This is best effort: a deck that cannot be written is skipped, and so is a deck list that cannot be read. The mode changes all the same.
  • A written deck drops its brush choices.
  • The endpoint refuses to write a deck outside « Global » (409).

Re:Builder

The logic is in core/alt-art-defaults.ts (pure, unit tested) and features/editor/editor-alt-arts.ts.

• Adding a card from the search: it takes the default alt art of its copy, within the copies owned. The search shows each card once, its plain print standing for all its prints.
• The brush (features/editor/alt-art-picker/) chooses the illustration of the 1st, 2nd and 3rd card of a card, for this deck only.
  • Three keys above each illustration. A pressed key means that card takes the illustration. A key that the owned copies rule out is disabled.
  • « Ce que le deck utilise » shows the deck's copies.
  • The decks API stores neither the order of the copies nor anything past them, so the site keeps the brush's choices: table rebuilder_deck_alt_arts (sql/migration_009, endpoint papi/rebuilder/deck-alt-arts).
    • One row per player, deck and card family.
    • No row when the three cards take the plain print.
    • The rows go when the deck is deleted, through the services relay (api/v1/services/proxy.php) or the site's deck pages (cacDeckApiDelete).
• « Arts par défaut » applies the defaults to the whole deck after a confirmation, and drops the deck's brush choices.
• The defaults also apply to an Equinox import, a copy of someone else's deck, and a hero picked without « Alt arts ». A copy of one's own deck keeps its prints.
• « Regrouper les illustrations » (deck board, on by default, remembered in localStorage): a card's prints share one pile, copy 1 in front.
• « Illustrations des jetons » shows each token large, with its illustrations.
• Deck board: a card brought to 0 leaves the board.
• Removed: the old « Global » code paths (card zoom widget and tilt, applyAltArtSlots) and alt-art-slots.
• Merged with preprod's loading states: skeletons hold the place of « Illustrations des jetons » and « Arts par défaut » while the deck's owner and the mode are unknown.

Settings page « Arts alternatifs par défaut »

Files: plugins/ownership/pages/alt-arts.php, js/alt-arts.js, js/alt-art-widget.js.

• One row per card: its name, type, faction and rarity on top.
  • On the left, its illustrations under their keys, on one line that scrolls sideways.
  • On the right, what decks take (its cards fanned out).
• A token has one « Choisir / Choisie » key per illustration.
• A card of the fan or an illustration opens large in core-altered-cards' card lightbox.
• The card modals that embed the same widget get the keys too.

Keys, a design system component

ac-keys / ac-key (design-system/css/components/key.css, docs/components/key.md, /pages/design-system): raised when off, pressed and filled when on. Used by the brush and by the settings page.

Not changed

The legacy deck builder (no defaults when a card is added in « par deck »), altered.json, the decks API.

Release

One new table (migration_009, CREATE TABLE IF NOT EXISTS), applied by the deploy's « Bootstrap & migrate DB » step. No data to migrate, and no change for players in « Global ».

Local stack

docker-compose.ownership.yml runs the real AlteredOwnership (pinned commit) with Postgres and Redis. docker/stack/ownership-real/ seeds owned alt arts, defaults, alice in « Global » and two demo decks. CI keeps the mock, which now numbers slots from 1 and lists every card type in the alt-art search, as the service does.

Files to review first

• includes/func.alt-arts.php, plugins/ownership/api/alt-art-leave-global.php, plugins/ownership/pages/alt-arts.php
• plugins/rebuilder/papi/deck-alt-arts.php
• plugins/rebuilder/app/src/app/core/alt-art-defaults.ts, features/editor/editor-alt-arts.ts, features/editor/alt-art-picker/
• design-system/css/components/key.css, plugins/ownership/js/alt-art-widget.js

Outcomes

The settings page screenshots come from the local stack with the real ownership service: bob is in « par deck », alice in « Global ». The Re:Builder screenshots come from the e2e scenarios (ownership mock).

Settings page, « par deck »: the mode and what it does, above the search.

The defaults: one row per card. Keys above each illustration on the left, what a card added to a deck takes on the right.

Keys and owned copies: Fée Clochette's MUSUBI print is owned once, so its 2nd and 3rd card keys are disabled. Scarabot, a token, has one key per illustration.

A card large: a card of the fan or an illustration opens in the cards pages' lightbox.

To « Global »: the illustrations chosen deck by deck will be replaced.

« Global »: the defaults apply to every deck, on the site and on BGA.

Back to « par deck »: the defaults are written in every deck first (best effort).

Adding a card in Re:Builder: Élémentaire de Kélon, once in the search, takes the default alt art of each copy.

The brush: Élémentaire de Kélon, 2 copies. The 1st card's key is pressed on the alt art, the 2nd and 3rd on the plain print, and the deck uses the 1st and 2nd cards.

Keys of the brush: the alt art is on the 1st and 3rd cards. Its 2 owned copies are used, so its 2nd card key is disabled.

« Arts par défaut »: applied to the whole deck after a confirmation.

« Illustrations des jetons »: one illustration per token, for every deck.

Tests

• npm run lint (ESLint, i18n all translated), npm test (57 files, 367 tests, including alt-art-defaults.spec.ts and editor-alt-arts.spec.ts), npm run build
• php tests/run.php: 116 passed
• Playwright, the whole suite on the local stack (ownership mock), after merging preprod: 157 passed, 36 skipped. 1 failed outside this change: community decks « Légaux uniquement » on mobile, whose first public page depends on the decks earlier local runs left. Alt-art scenarios:
  • « Global »: the deck opened in Re:Builder takes the defaults, without brush or « Arts par défaut »;
  • leaving « Global »: every deck gets what apply-to-deck showed, then the mode is « par deck »;
  • leaving « Global » when every deck write fails: the mode is « par deck » all the same;
  • settings page (plugins/ownership/e2e/alt-arts.spec.ts): a key gives an illustration to a card and saves it, the fan follows, the owned copies disable keys, a token's key; a refused choice (409) puts the keys and the fan back and shows why;
  • the brush: the 1st and 3rd cards, the 2nd disabled once the owned copies are used, the choices kept after a reload, an added copy taking the 3rd card's illustration, the defaults untouched, the rows gone once the deck is deleted;
  • « Mon deck » on a phone: nothing moves while the owner and the mode arrive.
• Settings page tried on the local stack with the real service (docker-compose.ownership.yml, README § Full stack)

🤖 Generated with Claude Code

[github-actions]

⚠️ Loading: CLS over budget

Not a failure: the CLS of a screen varies from one CI run to the next. Each screenshot is the settled page, the boxes that moved drawn on it (dashed: before, solid: after). Frame by frame: npm run loading:timeline -- <screen> in tests/e2e. Run: https://github.com/Altered-Community/alteredcore-website/actions/runs/39771314329

desktop · editor, Main, second visit at 1280 px: skeleton until the first screen, styled, no layout shift

CLS 0.2019 (budget 0.01)

Shifts

1448 ms  0.0001
  x937 y343 38×38 → x937 y308 38×38 (path < svg.ac-icon < ac-icon)
  x137 y98 75×16 → x137 y93 75×16 (a.back < div.text < div.identity)
1633 ms  0.0006
  x623 y111 217×24 → x545 y111 217×24 (img < ac-badge.ac-badge < ac-rarity-limits)
  x856 y111 87×24 → x778 y111 165×24 (ac-badge.ac-badge.ac-badge--orange < button.legality < app-deck-bar.reduced)
  x606 y97 1×52 → x528 y97 1×52 (span.sep < app-deck-bar.reduced < div.top)
1749 ms  0.2012
  x24 y306 908×466 → x0 y0 0×0
  x157 y242 147×40 → x181 y242 171×40 (button.ac-button.ac-button--secondary < div.toolbar < app-test-hand)
  x24 y796 908×4 → x0 y0 0×0