feat: v0.10.0 — right Jobs & Market pane (contracts accept/dispatch, market buy/sell/refuel with live previews); catalog + economy constants exposed in /api/state; shared applySnapshot for instant action feedback

lib/openapi.ts

@@ -37,7 +37,7 @@ export const openApiSpec = {
       get: {
         summary: 'Game state snapshot',
         description:
-          'Full current game state for client polling — account, sim clock, planes and contracts. Tick-on-read: each call first advances the sim clock by (real time since last read) × timeScale (clamped per tick), so expiry/finalization/spawn are always applied before the snapshot is returned.',
+          'Full current game state for client polling — account, sim clock, planes and contracts, plus the static market reference data (catalog + economy constants) so clients can compute buy/sell/refuel previews locally. Tick-on-read: each call first advances the sim clock by (real time since last read) × timeScale (clamped per tick), so expiry/finalization/spawn are always applied before the snapshot is returned.',
         operationId: 'getState',
         responses: {
           200: {
@@ -321,8 +321,27 @@ export const openApiSpec = {
             type: 'array',
             items: { $ref: '#/components/schemas/ContractState' },
           },
+          catalog: {
+            type: 'array',
+            description: 'Aircraft catalog (v0.10.0) — static per build, one entry per plane type.',
+            items: { $ref: '#/components/schemas/CatalogEntry' },
+          },
+          fuelPricePerL: { type: 'number', description: 'Jet-A1 price in €/liter; refuel cost = (maxFuel − fuel) × this.' },
+          sellFraction: { type: 'number', description: 'Fraction of the catalog price paid out when selling a plane.' },
         },
-        required: ['account', 'simState', 'planes', 'contracts'],
+        required: ['account', 'simState', 'planes', 'contracts', 'catalog', 'fuelPricePerL', 'sellFraction'],
+      },
+      CatalogEntry: {
+        type: 'object',
+        properties: {
+          model: { type: 'string', description: 'Catalog model id (e.g. "atr72") — used by buy/dispatch.' },
+          label: { type: 'string', description: 'Display name (e.g. "ATR 72-600").' },
+          price: { type: 'number', description: 'Market price in € (buy cost; sell pays out sellFraction × this).' },
+          maxFuel: { type: 'number', description: 'Fuel capacity, liters.' },
+          burnPerKm: { type: 'number', description: 'Cruise fuel burn, liters/km.' },
+          speedKmh: { type: 'number', description: 'Cruise speed, km/h.' },
+        },
+        required: ['model', 'label', 'price', 'maxFuel', 'burnPerKm', 'speedKmh'],
       },
       AccountState: {
         type: 'object',