vimp-engine 0.22.0 → 0.23.0

package/src/lib/formControls.js

@@ -0,0 +1,89 @@
+import { createRegistry } from './registry.js';
+
+// Реестр значений `control` дескриптора формы (этап 3 плана
+// plugin-forward-compat). Активных контролов четыре — все нативные элементы
+// формы, их строит client/lib/formBuilder.js. Остальные четыре выведены из
+// эксплуатации в v3, но продолжают работать вечно (И1): игра, собранная под
+// v2, написала их в манифесте, и её dist больше никто не тронет.
+//
+// `patch` — то, чем алиас доливает дескриптор: без `numeric: true` бывшее
+// числовое поле стало бы свободным текстом, и валидация пропустила бы в
+// комнату строку вместо числа.
+export const formControls = createRegistry('formControls', [
+  { value: 'select', since: 1 },
+  { value: 'text', since: 1 },
+  { value: 'checkbox', since: 1 },
+  { value: 'radio', since: 1 },
+  {
+    value: 'range',
+    since: 1,
+    alias: 'text',
+    retiredIn: 3,
+    patch: { numeric: true },
+    note: 'нативного range нет; рисуется как numeric text',
+  },
+  {
+    value: 'number',
+    since: 1,
+    alias: 'text',
+    retiredIn: 3,
+    patch: { numeric: true },
+    note: 'нативного number нет; рисуется как numeric text',
+  },
+  {
+    value: 'toggle',
+    since: 1,
+    alias: 'checkbox',
+    retiredIn: 3,
+    note: 'то же поведение, нативный checkbox',
+  },
+  {
+    value: 'segmented',
+    since: 1,
+    alias: 'radio',
+    retiredIn: 3,
+    note: 'то же поведение, группа нативных radio',
+  },
+]);
+
+/**
+ * Разрешает `descriptor.control` в контрол, который умеет строить билдер.
+ * @param {string} control - Значение `control` из дескриптора.
+ * @returns {{control: string, patch: Object}|undefined} Активный контрол и
+ *   накладка на дескриптор, либо undefined для неизвестного имени.
+ */
+export function resolveControl(control) {
+  const chain = formControls.chain(control);
+
+  if (chain.length === 0) {
+    return undefined;
+  }
+
+  // накладки копятся по всей цепочке: алиас на алиас обязан донести обе
+  return {
+    control: chain.at(-1).value,
+    patch: Object.assign({}, ...chain.map(entry => entry.patch ?? {})),
+  };
+}
+
+/**
+ * Приводит дескриптор поля к активному контролу (разрешает алиас).
+ * @param {Object} descriptor - Дескриптор поля формы.
+ * @returns {Object} Тот же объект, если контрол активен или неизвестен
+ *   (последнее скажет билдер), иначе копия с активным `control` и накладкой
+ *   алиаса под явными полями игры.
+ */
+export function resolveDescriptor(descriptor) {
+  const resolved = resolveControl(descriptor?.control);
+
+  if (!resolved || resolved.control === descriptor.control) {
+    return descriptor;
+  }
+
+  // накладка идёт ПОД дескриптором: она уточняет контрол, а не переписывает
+  // схему игры (явный numeric:false остаётся за игрой)
+  return { ...resolved.patch, ...descriptor, control: resolved.control };
+}
+
+// имена, которые вправе написать новая игра (контракт-чекер, документация)
+export const ACTIVE_FORM_CONTROLS = formControls.values();

package/src/lib/gameConfigView.js

@@ -0,0 +1,211 @@
+import hostDefaults from '../config/hostDefaults.js';
+
+// Единственная точка чтения HostPlugin.gameConfig движком (этап 2 плана
+// plugin-forward-compat). До неё движок разыменовывал конфиг игры россыпью
+// по коду, и каждое новое поле немедленно становилось обязательным —
+// прямое нарушение И2 («ничто новое не обязательно»).
+//
+// View — обычный объект (не класс): applyRoomOverrides делает по нему
+// structuredClone и spread, а те не переживают прототипы и геттеры-ловушки.
+// Поля игры, о которых движок не знает, копируются как есть — игра вправе
+// держать в gameConfig что угодно сверх контракта.
+
+// Каждая строка ниже — обещание совместимости: поле, которого нет в конфиге
+// старой игры, отдаёт умолчание, а не роняет загрузку (И2). Умолчание
+// обязано быть безопасным для игры, которая о поле не знает.
+//
+// Ключ — путь через точку, значение — { default } либо { derive(config) }.
+// Список может только РАСТИ: перенос поля отсюда в REQUIRED отверг бы уже
+// опубликованные игры.
+const FIELDS = {
+  // название в лобби; null → вызывающий берёт plugin.id
+  title: { default: null },
+
+  // карты везёт мастер (room.maps), у игры их может не быть вовсе
+  maps: { default: {} },
+  currentMap: { default: null },
+  // сколько карт попадает в голосование; 1 — минимальный осмысленный набор
+  mapsInVote: { default: 1 },
+  mapScale: { default: 1 },
+  mapSetId: { default: null },
+
+  // лимит комнаты: без него берётся движковый (hostDefaults.maxPlayers)
+  'roomDefaults.maxPlayers': { default: hostDefaults.maxPlayers },
+
+  // игра без оружия — не экзотика: @vimp-games/snakes уже такая
+  'parts.weapons': { default: {} },
+  // огонь по своим — опция игры; «нет опции» значит «выключено»
+  'parts.friendlyFire': { default: false },
+
+  // пустая панель рисуется корректно: Panel читает её через Object.keys.
+  // fields — словарь «имя → { key, value }», поэтому пусто здесь это {}
+  'panel.fields': { default: {} },
+  'panel.activeKey': { default: null },
+
+  // таблица статистики и стартовые данные участника — целиком игровые
+  stat: { default: {} },
+  scripted: { default: {} },
+  playerState: { default: {} },
+
+  soundCues: { default: {} },
+  // голосование на входе (обычно 'teamChange'); null — входим молча
+  initialVote: { default: null },
+
+  // чем игра занимает экран по Tab: движковая таблица или свой лидерборд
+  statMode: { default: 'table' },
+  // opt-in-флаги: их отсутствие всегда означало «выключено»
+  noSpectators: { default: false },
+  endlessRound: { default: false },
+
+  spectatorTeam: { derive: deriveSpectatorTeam },
+};
+
+// Все пути gameConfig, которые движок читает: объявленные игрой поля плюс
+// те, за которые он подставляет умолчание. Раздел слепка поверхности
+// (contract/surface.json → gameConfigFields): исчезнувший отсюда путь —
+// нарушение И1, потому что игра могла его написать.
+export const KNOWN_GAME_CONFIG_PATHS = Object.keys(FIELDS);
+
+// ЗАМОРОЖЕНО (И2). Этот список может только СОКРАЩАТЬСЯ.
+// Добавление сюда отвергнет все ранее опубликованные игры — вместо этого
+// заведи поле в FIELDS с умолчанием. Страж: tests/devtools/surface.test.js.
+export const REQUIRED_GAME_CONFIG_PATHS = [
+  'parts.models', // из чего состоит участник; синтезировать нечем
+  'playerKeys', // без них ядро не знает ввода
+  'snapshot', // раскладка кадра; движок её не придумывает
+  'teams', // ParticipantManager выбирает команду входа
+];
+
+// Единственный признак «команда наблюдателей», который есть в данных, —
+// её имя: teams это словарь «имя → id», флагов в нём нет. Игра, объявившая
+// наблюдателей как-то иначе, обязана назвать spectatorTeam явно.
+const SPECTATOR_TEAM_NAME = 'spectators';
+
+function deriveSpectatorTeam(config, gameId) {
+  // наблюдателей нет как концепции — связывать нечего
+  if (config.noSpectators === true) {
+    return null;
+  }
+
+  if (Object.hasOwn(config.teams ?? {}, SPECTATOR_TEAM_NAME)) {
+    return SPECTATOR_TEAM_NAME;
+  }
+
+  // null — рабочее значение (ParticipantManager заводит участника в первую
+  // команду), но почти наверняка не то, чего хотела игра: предупреждаем
+  console.warn(
+    `game "${gameId}": gameConfig.spectatorTeam is not set and teams has ` +
+      `no "${SPECTATOR_TEAM_NAME}" key — everyone joins the first team ` +
+      `(${Object.keys(config.teams ?? {})[0] ?? '—'}); declare ` +
+      'spectatorTeam or noSpectators to say what you meant',
+  );
+
+  return null;
+}
+
+function getPath(source, dottedPath) {
+  return dottedPath.split('.').reduce((value, key) => value?.[key], source);
+}
+
+// copy-on-write: умолчание вкладывается в копию ветки, объект игры не
+// правится — gameConfig принадлежит плагину и переживает перезапуск матча
+function setPath(target, dottedPath, value) {
+  const keys = dottedPath.split('.');
+  let node = target;
+
+  for (const key of keys.slice(0, -1)) {
+    node[key] =
+      node[key] === undefined || node[key] === null ? {} : { ...node[key] };
+    node = node[key];
+  }
+
+  node[keys.at(-1)] = value;
+}
+
+/**
+ * Строит представление gameConfig с умолчаниями и проверяет обязательное.
+ * @param {Object} gameConfig - HostPlugin.gameConfig игры как есть.
+ * @param {string} [gameId] - id плагина; попадает в текст ошибок.
+ * @returns {Object} Замороженный конфиг: поля игры плюс умолчания движка.
+ * @throws {Error} Если нет поля из REQUIRED_GAME_CONFIG_PATHS или конфиг
+ *   внутренне противоречив (spectatorTeam вне teams, noSpectators при двух
+ *   командах).
+ */
+export function createGameConfigView(gameConfig, gameId = 'unknown') {
+  const source = gameConfig ?? {};
+
+  // null проходил бы проверку присутствия, хотя ни одно из этих полей не
+  // бывает пустым по контракту: движок разыменовывает их сразу, и гейт,
+  // заведённый ради текста вместо TypeError, сам отвечал бы TypeError
+  const missing = REQUIRED_GAME_CONFIG_PATHS.filter(path => {
+    const value = getPath(source, path);
+
+    return value === undefined || value === null;
+  });
+
+  if (missing.length > 0) {
+    throw new Error(
+      `game "${gameId}": gameConfig is missing required field(s): ` +
+        missing.join(', '),
+    );
+  }
+
+  const view = { ...source };
+
+  for (const [path, spec] of Object.entries(FIELDS)) {
+    const value = getPath(source, path);
+
+    if (value !== undefined && value !== null) {
+      continue;
+    }
+
+    setPath(
+      view,
+      path,
+      spec.derive ? spec.derive(source, gameId) : spec.default,
+    );
+  }
+
+  assertConsistent(view, source, gameId);
+
+  return Object.freeze(view);
+}
+
+// Проверки внутренней согласованности того, что игра УЖЕ прислала. Это не
+// новые требования (И2): поле, которого нет, здесь не проверяется вовсе.
+function assertConsistent(view, source, gameId) {
+  const { teams } = view;
+
+  // noSpectators: связывать нечего — зато команда обязана быть ровно одна.
+  // Вторая играющая команда без наблюдателей означала бы вход «куда-нибудь»,
+  // а ParticipantManager выбирает команду входа однозначно
+  if (view.noSpectators === true) {
+    if (Object.keys(teams).length !== 1) {
+      throw new Error(
+        `game "${gameId}": noSpectators requires exactly one team, ` +
+          `got ${Object.keys(teams).length} (${Object.keys(teams).join(', ')})`,
+      );
+    }
+
+    return;
+  }
+
+  // spectatorTeam — имя ключа внутри teams, и опечатка даёт spectatorId ===
+  // undefined, после чего участник заходит в несуществующую команду
+  // (ParticipantManager.createHuman валится на её счётчике). Проверяем
+  // только объявленное игрой: выведенное значение уже согласовано
+  const declared = source.spectatorTeam;
+
+  if (
+    declared !== undefined &&
+    declared !== null &&
+    teams[declared] === undefined
+  ) {
+    throw new Error(
+      `game "${gameId}": spectatorTeam '${declared}' is not a ` +
+        `key of teams (${Object.keys(teams).join(', ')})`,
+    );
+  }
+}
+
+export default createGameConfigView;

package/src/lib/gamePlugin.js

@@ -1,4 +1,5 @@
-import { ENGINE_API_VERSION } from '../config/opcodes.js';
+import { ENGINE_CAPABILITIES } from './capabilities.js';
+import { createGameConfigView } from './gameConfigView.js';
 
 // Динамическая загрузка игры по GameManifest мастера (Этап 6.3): клиент
 // больше не импортирует игру статически (gameRegistry.static.js) — вместо
@@ -28,102 +29,79 @@ export async function fetchGameManifest(url) {
   return res.json();
 }
 
-// несовпадение engineApi — плагин собран под другую версию контрактов
-// движка (§3.7 PLAN.md); загружать его небезопасно
-export function assertEngineApiCompatible(manifest) {
-  if (manifest.engineApi !== ENGINE_API_VERSION) {
-    throw new Error(
-      `game "${manifest.id}" requires engine API v${manifest.engineApi}, ` +
-        `this engine build is v${ENGINE_API_VERSION}`,
-    );
+// Совместимость плагина с этой сборкой движка (этап 5 плана
+// plugin-forward-compat). Числа больше не сравниваются: `engineApi` заморожен
+// на 4 и остался меткой поколения контракта, а не гейтом. Плагин отвергается,
+// только если просит возможность, которой в этой сборке нет (то есть он
+// НОВЕЕ движка) — движок не может выдать того, чего в нём не существует.
+// Плагин любого возраста принимается: поверхность append-only (И1), и имя,
+// которое он написал, работает вечно.
+//
+// Функция возвращает вердикт, а не бросает: у четырёх входов (каталог
+// мастера, Node-загрузчик, браузерный клиент, standalone SDK) разная
+// правильная реакция — каталог помечает игру недоступной и продолжает
+// раздавать остальные, остальные три бросают.
+export function checkPluginCompatibility(manifest) {
+  const wanted = manifest.requires ?? [];
+  const missing = wanted.filter(name => !ENGINE_CAPABILITIES.has(name));
+
+  if (missing.length === 0) {
+    return { ok: true };
   }
-}
 
-// поля gameConfig, которые движок читает до какой-либо игровой логики
-// (applyRoomOverrides/coreConfig/buildClientConfig) — недостающее валится
-// непрозрачной ошибкой глубоко в onInit; проверяем контракт §HostPlugin API
-// (docs/en/plugin-api.md) сразу после import, рядом с engineApi-гейтом
-const REQUIRED_GAME_CONFIG_PATHS = [
-  'roomDefaults.maxPlayers',
-  'snapshot',
-  'parts.models',
-  'parts.weapons',
-  'parts.friendlyFire',
-  'panel.fields',
-  'playerKeys',
-  // без них HostGame разыменовывает undefined (this._teams[spectatorTeam])
-  // и игра умирает тремя разными сообщениями вместо одного контрактного
-  'teams',
-];
-
-// spectatorTeam обязателен ровно до тех пор, пока игра не объявила
-// noSpectators: там наблюдателей нет как концепции и ключа тоже нет
-const SPECTATOR_CONFIG_PATH = 'spectatorTeam';
-
-function getPath(obj, dottedPath) {
-  return dottedPath
-    .split('.')
-    .reduce((value, key) => value?.[key], obj);
+  return {
+    ok: false,
+    reason: 'engine-too-old',
+    missing,
+    // текст обязан называть сторону, которую надо обновить: это единственный
+    // оставшийся режим отказа, и он должен быть однозначным
+    text:
+      `game "${manifest.id}" needs engine capabilities this build does ` +
+      `not have: ${missing.join(', ')} — update the engine`,
+  };
 }
 
-// бросает при отсутствии обязательных полей HostPlugin.gameConfig
-export function assertGameConfigShape(hostPlugin) {
-  // null проходил бы проверку присутствия, хотя ни одно из этих полей не
-  // бывает пустым по контракту: движок разыменовывает их сразу, и гейт,
-  // заведённый ради текста вместо TypeError, сам отвечал бы TypeError
-  const noSpectators = hostPlugin.gameConfig?.noSpectators === true;
-  const required = noSpectators
-    ? REQUIRED_GAME_CONFIG_PATHS
-    : [...REQUIRED_GAME_CONFIG_PATHS, SPECTATOR_CONFIG_PATH];
-
-  const missing = required.filter(p => {
-    const value = getPath(hostPlugin.gameConfig, p);
-
-    return value === undefined || value === null;
-  });
-
-  if (missing.length > 0) {
-    throw new Error(
-      `game "${hostPlugin.id}": gameConfig is missing required field(s): ` +
-        missing.join(', '),
-    );
-  }
+// Имя, на которое ссылается существующий код и тесты (И1 действует и на
+// экспорты движка): та же проверка, но бросающая.
+export function assertEngineApiCompatible(manifest) {
+  const compat = checkPluginCompatibility(manifest);
 
-  // единственная связь между полями, которую стоит проверять здесь:
-  // spectatorTeam — имя ключа внутри teams, и опечатка даёт spectatorId ===
-  // undefined, после чего участник заходит в несуществующую команду
-  // (ParticipantManager.createHuman валится на её счётчике)
-  const { teams, spectatorTeam } = hostPlugin.gameConfig;
-
-  // noSpectators: связывать нечего — зато команда обязана быть ровно одна.
-  // Вторая играющая команда без наблюдателей означала бы вход «куда-нибудь»,
-  // а ParticipantManager выбирает команду входа однозначно
-  if (noSpectators) {
-    if (Object.keys(teams).length !== 1) {
-      throw new Error(
-        `game "${hostPlugin.id}": noSpectators requires exactly one team, ` +
-          `got ${Object.keys(teams).length} (${Object.keys(teams).join(', ')})`,
-      );
-    }
-
-    return;
+  if (!compat.ok) {
+    throw new Error(compat.text);
   }
+}
 
-  if (teams[spectatorTeam] === undefined) {
-    throw new Error(
-      `game "${hostPlugin.id}": spectatorTeam '${spectatorTeam}' is not a ` +
-        `key of teams (${Object.keys(teams).join(', ')})`,
-    );
-  }
+// Обязательные поля gameConfig и умолчания для всего остального живут в
+// lib/gameConfigView.js (этап 2 плана plugin-forward-compat) — здесь только
+// имена, на которые мог сослаться чужой код, и тонкая обёртка над view.
+export { REQUIRED_GAME_CONFIG_PATHS } from './gameConfigView.js';
+
+// spectatorTeam перестал быть обязательным (у него есть умолчание) —
+// константа остаётся именем пути, а не требованием
+export const SPECTATOR_CONFIG_PATH = 'spectatorTeam';
+
+/**
+ * Проверяет gameConfig плагина и возвращает представление с умолчаниями.
+ * Гейт стоит сразу после import — рядом с engineApi-гейтом: недостающее
+ * обязательное поле иначе валится непрозрачной ошибкой глубоко в onInit.
+ * @param {Object} hostPlugin - Загруженный HostPlugin игры.
+ * @returns {Object} Результат createGameConfigView (одна view на прогон).
+ */
+export function assertGameConfigShape(hostPlugin) {
+  return createGameConfigView(hostPlugin.gameConfig, hostPlugin.id);
 }
 
-// динамический import ClientPlugin игры (client-entry её сборки). Манифест и
-// плагин собираются одной сборкой (build-game-manifest.js читает то же
-// entries.client) и их engineApi всегда совпадает — проверяем только
-// манифест (дешевле: до сетевого import), плагин сверяем после загрузки как
-// защиту от рассинхрона сборки, а не как отдельный путь отказа
+// динамический import ClientPlugin игры (client-entry её сборки). Сначала —
+// вердикт совместимости по манифесту (дешевле: до сетевого import): игра,
+// требующая возможности, которой в этой сборке нет, не заработает и после
+// загрузки бандла. Сверка engineApi манифеста с плагином ниже — про
+// рассинхрон сборки внутри пакета, а не про версию движка
 export async function loadClientPlugin(manifest) {
-  assertEngineApiCompatible(manifest);
+  const compat = checkPluginCompatibility(manifest);
+
+  if (!compat.ok) {
+    throw new Error(compat.text);
+  }
 
   const module = await import(/* @vite-ignore */ manifest.entries.client);
   const plugin = module.default;

package/src/lib/loadGamePackage.js

@@ -1,7 +1,7 @@
 import { access, readFile } from 'node:fs/promises';
 import path from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { assertEngineApiCompatible } from './gamePlugin.js';
+import { checkPluginCompatibility } from './gamePlugin.js';
 
 // Загрузка пакета игры в Node по его собранному dist/ (Этап 4 плана
 // standalone-sdk). В браузере плагин грузится по URL из GameManifest мастера;
@@ -32,7 +32,14 @@ export async function loadGamePackage(distDir, { core = null } = {}) {
   const baseDir = path.dirname(manifestPath);
   const manifest = JSON.parse(await readFile(manifestPath, 'utf8'));
 
-  assertEngineApiCompatible(manifest);
+  // игра одна и подменить её нечем — вердикт несовместимости здесь
+  // терминальный (в отличие от каталога мастера, который помечает игру
+  // недоступной и продолжает раздавать остальные)
+  const compat = checkPluginCompatibility(manifest);
+
+  if (!compat.ok) {
+    throw new Error(`${manifestPath}: ${compat.text}`);
+  }
 
   const { assetsBase } = manifest;
   const hostPlugin = await importDefault(

package/src/lib/registry.js

@@ -0,0 +1,94 @@
+// Append-only реестр (И1 плана plugin-forward-compat, этап 3). Движок держит
+// закрытые словари, из которых игра выбирает значения: контролы формы, имена
+// клиентских сервисов. Запись НИКОГДА не удаляется: игра, собранная два года
+// назад, могла её написать, и её dist больше никто не тронет — сокращение
+// словаря отвергает такую игру молча. Вывод из эксплуатации =
+// { alias: 'новое-имя' } + запись в CHANGELOG, но не удаление строки.
+//
+// Именно так сломался v2 → v3: набор `control` урезали до четырёх нативных
+// элементов, и `range`/`number`/`toggle`/`segmented` перестали строиться.
+
+/**
+ * Создаёт append-only реестр имён плагинной поверхности.
+ * @param {string} name - Имя реестра (в тексте ошибок).
+ * @param {Array<Object>} entries - Записи `{ value, since, alias?,
+ *   retiredIn?, note?, ...полезная нагрузка }`. Запись с `alias` — выведенное
+ *   из эксплуатации имя: оно продолжает работать, разрешаясь в указанное.
+ * @returns {Object} Реестр: `has`, `get`, `resolve`, `chain`, `isRetired`,
+ *   `list`, `values`.
+ */
+export function createRegistry(name, entries) {
+  const byValue = new Map();
+
+  for (const entry of entries) {
+    if (byValue.has(entry.value)) {
+      throw new Error(`registry ${name}: duplicate entry "${entry.value}"`);
+    }
+
+    byValue.set(entry.value, Object.freeze({ ...entry }));
+  }
+
+  // цепочка алиасов от имени к активной записи; пустая, если имени нет
+  const chain = value => {
+    const trail = [];
+    const seen = new Set();
+    let current = byValue.get(value);
+
+    while (current !== undefined) {
+      if (seen.has(current.value)) {
+        throw new Error(
+          `registry ${name}: alias cycle at "${current.value}" — ` +
+            'a retired name must resolve to an active one',
+        );
+      }
+
+      seen.add(current.value);
+      trail.push(current);
+
+      if (current.alias === undefined) {
+        return trail;
+      }
+
+      const next = byValue.get(current.alias);
+
+      if (next === undefined) {
+        throw new Error(
+          `registry ${name}: "${current.value}" is aliased to unknown ` +
+            `"${current.alias}"`,
+        );
+      }
+
+      current = next;
+    }
+
+    return trail;
+  };
+
+  // битый реестр — дефект движка, а не плагина: пусть падает на загрузке
+  // модуля, а не на первой игре, которая напишет выведенное имя
+  for (const value of byValue.keys()) {
+    chain(value);
+  }
+
+  return Object.freeze({
+    name,
+    has: value => byValue.has(value),
+    get: value => byValue.get(value),
+    // разрешает имя в активное (проходит цепочку алиасов). undefined — имя
+    // неизвестно; это ВСЕГДА ошибка плагина (он попросил будущее), никогда
+    // не ошибка движка за то, что у него список длиннее
+    resolve: value => chain(value).at(-1)?.value,
+    chain,
+    isRetired: value => byValue.get(value)?.alias !== undefined,
+    // все записи, включая выведенные: слепок поверхности (этап 1) не считает
+    // вывод из эксплуатации удалением
+    list: () => [...byValue.values()],
+    // только активные имена — то, что вправе написать НОВАЯ игра
+    values: () =>
+      [...byValue.values()]
+        .filter(e => e.alias === undefined)
+        .map(e => e.value),
+  });
+}
+
+export default createRegistry;