@rynt/sdk 0.9.53

package/src/host/extensions-init.ts

@@ -0,0 +1,194 @@
+import { clearExtensionExposes, clearExtensionExpose, setExtensionExpose } from '../extensions/extension-expose';
+import {
+  ensureCoreExtensionRegistries,
+  popExtensionScope,
+  pushExtensionScope,
+  resetExtensionRegistries,
+  unregisterRegistryEntriesForExtension,
+} from '../extensions/registries';
+import { createRyntExtensionContext } from '../extensions/context';
+import type { RyntExtensionManifestParsed } from '../extensions/manifest-types';
+import type {
+  RyntExtensionDefinition,
+  RyntExtensionHostApis,
+  RyntExtensionSetupResult,
+} from '../extensions/plugin-types';
+import { resolveExtensionsForLoad } from '../extensions/resolve-extensions';
+import { checkExtensionApi, EXTENSION_API_VERSION } from '../extensions/version';
+
+export interface RyntDiscoveredExtension {
+  rootDir: string;
+  manifest: RyntExtensionManifestParsed;
+}
+
+export interface RyntExtensionHostOptions {
+  extensions: RyntDiscoveredExtension[];
+  launcherVersion: string;
+  importExtension: (absoluteEntryPath: string) => Promise<unknown>;
+  extensionHostApis?: RyntExtensionHostApis;
+  registerBuiltinRegistryEntries?: () => void;
+  /** Блокировать расширения с extensionApi > host. */
+  strictExtensionApi?: boolean;
+  /**
+   * Частичная перезагрузка (dev-hub): только эти id — setup и реестры.
+   * Без полного `resetExtensionRegistries` / `clearExtensionExposes`.
+   */
+  reloadExtensionIds?: string[];
+}
+
+function joinPaths(root: string, rel: string): string {
+  const a = root.replace(/[/\\]+$/u, '');
+  const b = rel.replace(/^[/\\]+/u, '').replace(/\\/gu, '/');
+  return `${a}/${b}`;
+}
+
+export async function initializeRyntExtensions(
+  options: RyntExtensionHostOptions,
+): Promise<Record<string, string>> {
+  const errors: Record<string, string> = {};
+  const partialReloadIds =
+    options.reloadExtensionIds && options.reloadExtensionIds.length > 0
+      ? new Set(options.reloadExtensionIds)
+      : null;
+
+  if (partialReloadIds) {
+    for (const id of partialReloadIds) {
+      unregisterRegistryEntriesForExtension(id);
+      clearExtensionExpose(id);
+    }
+  } else {
+    resetExtensionRegistries();
+    clearExtensionExposes();
+    ensureCoreExtensionRegistries();
+    options.registerBuiltinRegistryEntries?.();
+  }
+
+  ensureCoreExtensionRegistries();
+
+  const byId = new Map<string, RyntDiscoveredExtension>();
+  for (const item of options.extensions) {
+    if (byId.has(item.manifest.id)) {
+      console.warn(
+        `[rynt/extensions] Дубликат id «${item.manifest.id}», запись пропущена`,
+      );
+      errors[item.manifest.id] = 'Duplicate extension id';
+      continue;
+    }
+    byId.set(item.manifest.id, item);
+  }
+
+  const resolved = resolveExtensionsForLoad([...byId.values()], {
+    launcherVersion: options.launcherVersion,
+    strictExtensionApi: options.strictExtensionApi,
+  });
+
+  if (!resolved.ok) {
+    console.error(
+      `[rynt/extensions] Dependency resolution failed: ${resolved.error}`,
+    );
+    return { __graph__: resolved.error };
+  }
+
+  Object.assign(errors, resolved.errors);
+
+  const skipIds = new Set<string>();
+  for (const id of resolved.order) {
+    const apiCheck = checkExtensionApi(byId.get(id)?.manifest ?? {}, {
+      strict: options.strictExtensionApi,
+    });
+    if (!apiCheck.ok && apiCheck.blocking) {
+      skipIds.add(id);
+    }
+    if (
+      resolved.errors[id]?.includes('extensionDependencies') ||
+      resolved.errors[id]?.includes('engines.rynt')
+    ) {
+      skipIds.add(id);
+    }
+  }
+
+  if (resolved.order.length > 0) {
+    console.info(
+      `[rynt/extensions] К активации: ${resolved.order.length} расшир. (порядок по зависимостям)`,
+    );
+  }
+
+  for (const id of resolved.order) {
+    if (skipIds.has(id)) {
+      continue;
+    }
+    if (partialReloadIds && !partialReloadIds.has(id)) {
+      continue;
+    }
+    const item = byId.get(id);
+    if (!item) continue;
+
+    const apiCheck = checkExtensionApi(item.manifest, {
+      strict: options.strictExtensionApi,
+    });
+    if (!apiCheck.ok && apiCheck.blocking) {
+      continue;
+    }
+
+    const entryPath = joinPaths(item.rootDir, item.manifest.main);
+
+    try {
+      console.info(
+        `[rynt/extensions] Загрузка «${id}» (${item.manifest.name} v${item.manifest.version}) → ${entryPath}`,
+      );
+      const mod = (await options.importExtension(entryPath)) as {
+        default?: unknown;
+      };
+      const def = mod?.default;
+      if (
+        !def ||
+        typeof def !== 'object' ||
+        !('setup' in def) ||
+        typeof (def as RyntExtensionDefinition).setup !== 'function'
+      ) {
+        console.warn(
+          `[rynt/extensions] «${id}»: некорректный default export (ожидался результат defineRyntExtension)`,
+        );
+        errors[id] =
+          errors[id] ??
+          'Invalid default export (expected defineRyntExtension result)';
+        continue;
+      }
+      const ctx = createRyntExtensionContext(
+        item.manifest.id,
+        options.extensionHostApis,
+      );
+      const prevScope = pushExtensionScope(item.manifest.id);
+      try {
+        const raw = await Promise.resolve(
+          (def as RyntExtensionDefinition).setup(ctx),
+        );
+        const ret = raw as RyntExtensionSetupResult | undefined;
+        if (
+          ret !== undefined &&
+          ret !== null &&
+          typeof ret === 'object' &&
+          'expose' in ret &&
+          (ret as { expose?: unknown }).expose !== undefined
+        ) {
+          setExtensionExpose(
+            item.manifest.id,
+            (ret as { expose: unknown }).expose,
+          );
+        }
+      } finally {
+        popExtensionScope(prevScope);
+      }
+      console.info(`[rynt/extensions] «${id}»: setup выполнен`);
+    } catch (e) {
+      const msg = e instanceof Error ? e.message : String(e);
+      errors[id] = errors[id] ? `${errors[id]}; ${msg}` : msg;
+      console.error(`[rynt/extensions] Extension "${id}" failed:`, e);
+    }
+  }
+
+  return errors;
+}
+
+export { EXTENSION_API_VERSION } from '../extensions/version';
+export { checkExtensionApi, parseExtensionApiMajor } from '../extensions/version';

package/src/host/index.ts

@@ -0,0 +1,11 @@
+export {
+  initializeRyntExtensions,
+  type RyntDiscoveredExtension,
+  type RyntExtensionHostOptions,
+} from './extensions-init';
+export { useRyntExtensionLoader } from './extensions-composables';
+export { registerModel, clearLauncherModelRegistry } from './launcher-models';
+export {
+  registerLauncherEntity,
+  clearLauncherEntityRegistry,
+} from '../extensions/launcher-entities/registry';

package/src/host/launcher-models/index.ts

@@ -0,0 +1,4 @@
+export { registerModel, clearLauncherModelRegistry } from '../../extensions/launcher-models/registry-core';
+export type { LauncherModelApis } from '../../extensions/launcher-models/apis/launcher-model-apis';
+export type { RyntLauncherModelKey } from '../../extensions/launcher-models/keys';
+export { RYNT_LAUNCHER_MODEL_KEYS } from '../../extensions/launcher-models/keys';

package/src/index.ts

@@ -0,0 +1,229 @@
+import './shared/styles/index.css';
+
+// ===== UI =====
+export * from './shared/ui';
+
+// ===== Composables =====
+export * from './shared/composables';
+
+// ===== Types =====
+export type * from './shared/minecraft-types/build-manifest';
+export type * from './shared/minecraft-types/launcher-versions';
+export type { ModMarketplaceProvider } from './shared/mods/mod-marketplace-types';
+export { MARKETPLACE_SEARCH_PAGE_SIZE } from './shared/mods/types';
+export type {
+  InstallContext,
+  LoaderId,
+  MarketplaceItem,
+  MarketplaceSearchContext,
+  MarketplaceSearchResult,
+  MarketplaceInstallVersion,
+  ModsProviderId,
+  ProjectDetails,
+  ProjectType,
+} from './shared/mods/types';
+export {
+  mergeMarketplaceItems,
+  normalizeMarketplaceSearchResult,
+  runMarketplaceSearch,
+} from './shared/mods/marketplace-search-utils';
+export type { ModsProviderLoaderIds } from './minecraft-loader/base-loader';
+export type {
+  EntityBuild,
+  EntityBuildBase,
+  EntityBuildLocal,
+  EntityMap,
+  EntityMapBase,
+  EntityInviteType,
+  EntityUser,
+} from './shared/types/entities';
+export type {
+  InviteLauncherConfigPayload,
+  InvitePayloadBuild,
+  InvitePayloadInviteServer,
+  InvitePayloadLocalBuild,
+  InvitePayloadLocalGame,
+  InvitePayloadRequestJoinLocal,
+} from './shared/types/invite-payloads';
+export type {
+  ThemeDefinition,
+  ThemeTokens,
+  ThemeVariant,
+  ThemeRadiusScale,
+  ThemeRadius,
+} from './shared/themes/types';
+
+// ===== Marketplace providers =====
+export {
+  curseforgeModMarketplaceProvider,
+  modrinthModMarketplaceProvider,
+} from './shared/mods/providers';
+export {
+  getCurseForgeMarketplaceLoaderId,
+  getMarketplaceLoaderIds,
+  resolveModsProviderLoaderIds,
+} from './shared/mods/resolve-mods-provider-loader-ids';
+export {
+  getModMarketplaceProvider,
+  listModMarketplaceProviders,
+  markModMarketplaceProvider,
+  registerModMarketplaceProvider,
+  resetModMarketplaceRegistry,
+  unregisterModMarketplaceProvidersForExtension,
+} from './shared/mods/mod-marketplace-registry';
+
+// ===== Builtins & Registries (re-exported for convenience) =====
+export {
+  useAccountProviderRegistry,
+  useLoaderRegistry,
+  useThemeRegistry,
+  useExtensionNavRegistry,
+  useExtensionPageRegistry,
+  useExtensionShellRegistry,
+  useExtensionSidebarRegistry,
+  useExtensionUserStripRegistry,
+  useAppTopbarLeftWidgetsRegistry,
+  useAppTopbarRightWidgetsRegistry,
+  useAppTopbarStatusWidgetsRegistry,
+  useBuildCardActionsRegistry,
+  useBuildCardAfterMetaRegistry,
+  useBuildCardBeforeMediaRegistry,
+  useBuildCardBeforeMetaRegistry,
+  useBuildCardFooterActionsRegistry,
+  useBuildDetailAfterContentRegistry,
+  useBuildDetailBeforeContentRegistry,
+  useBuildDetailBeforeHeroRegistry,
+  useBuildDetailHeaderActionsRegistry,
+  useBuildDetailModRowActionsRegistry,
+  useBuildDetailResourcepackRowActionsRegistry,
+  useBuildDetailRightColumnBottomRegistry,
+  useBuildDetailRightColumnTopRegistry,
+  useDialogFooterActionsRegistry,
+  useFeedAfterContentRegistry,
+  useFeedBeforeContentRegistry,
+  useFriendsAfterListRegistry,
+  useFriendsBeforeListRegistry,
+  useInviteHandlerRegistry,
+  useLibraryAfterContentRegistry,
+  useLibraryBeforeContentRegistry,
+  useMapCardActionsRegistry,
+  useMapCardAfterMetaRegistry,
+  useMapCardBeforeMetaRegistry,
+  useMapCardFooterActionsRegistry,
+  useMapDetailAfterContentRegistry,
+  useMapDetailBeforeContentRegistry,
+  useMapDetailHeaderActionsRegistry,
+  useMarkdownEditorToolbarActionsRegistry,
+  useMarkdownEditorTiptapExtensionsRegistry,
+  useModDetailsFooterActionsRegistry,
+  useMarkdownRendererAfterContentRegistry,
+  useMarkdownRendererBeforeContentRegistry,
+  useModManageActionsRegistry,
+  useModProviderRegistry,
+  useResourcepackManageActionsRegistry,
+  useShaderpackManageActionsRegistry,
+  useProjectsAfterContentRegistry,
+  useProjectsBeforeContentRegistry,
+  useSettingsAfterSectionsRegistry,
+  useSettingsBeforeSectionsRegistry,
+  useSettingsSectionWidgetsRegistry,
+  useSidebarFooterWidgetsRegistry,
+  useSidebarHeaderWidgetsRegistry,
+  useServerCardActionsRegistry,
+  useServerCardAfterMetaRegistry,
+  useServerCardBeforeMetaRegistry,
+  useServerCardFooterActionsRegistry,
+  useServerDetailAfterContentRegistry,
+  useServerDetailBeforeContentRegistry,
+  useServerDetailHeaderActionsRegistry,
+  useSidebarAfterContentRegistry,
+  useSidebarBeforeContentRegistry,
+  useFileEditorRegistry,
+  useUserMenuActionsRegistry,
+  useUserMenuAfterActionsRegistry,
+  useUserMenuBeforeActionsRegistry,
+  useUserCardAfterMetaRegistry,
+  useUserCardBeforeMetaRegistry,
+} from './extensions/registries/builtins';
+export {
+  extensionExposeRevision,
+  getExtensionExpose,
+  useExtensionExpose,
+} from './extensions/extension-expose';
+export {
+  defineExtensionRegistry,
+  getExtensionRegistry,
+} from './extensions/registries/define-extension-registry';
+export {
+  extensionRegistriesRevision,
+  getRegistry,
+  getRegistryItem,
+  setRegistryItem,
+  deleteRegistryItem,
+  hasRegistryItem,
+  listRegistryKeys,
+  listRegistryEntries,
+  listRegistryValuesSorted,
+  getRegistryEntryMeta,
+  getCurrentExtensionId,
+  HOST_EXTENSION_ID,
+  listRegistryKeys as listModProviderRegistry,
+} from './extensions/registries';
+export type {
+  RegistryEntry,
+  RegistryEntryMeta,
+  RegistryRow,
+  UseExtensionRegistry,
+} from './extensions/registries';
+export { extensionRouteSlug, resolvedNavigationPath } from './extensions/slug';
+export { defineStore, defineRyntExtension } from './extensions/plugin';
+export { useRyntExtensionLoader } from './host/extensions-composables';
+export { parseRyntManifestJson } from './extensions/manifest';
+export type { RyntExtensionManifestParsed } from './extensions/manifest-types';
+export { applyValidatedRyntContributesToManifest } from './extensions/registries';
+export { topoSortExtensions } from './extensions/graph';
+export {
+  checkExtensionApi,
+  EXTENSION_API_VERSION,
+  normalizeExtensionApiInManifest,
+  parseExtensionApiMajor,
+} from './extensions/version';
+export {
+  RYNT_EXTENSION_DISABLED_DIR_SUFFIX,
+  isRyntExtensionBundleDirDisabled,
+  ryntExtensionBundleDirBaseLabel,
+  ryntExtensionBundleDisabledFolderName,
+} from './extensions/disabled-folder';
+export {
+  initializeRyntExtensions,
+  type RyntDiscoveredExtension,
+  type RyntExtensionHostOptions,
+} from './host/extensions-init';
+
+// ===== Themes =====
+export {
+  THEME_BASE_DEFINITION,
+  THEME_PINK_DEFINITION,
+  THEME_BLACK_DEFINITION,
+  THEME_CLASSIC_DEFINITION,
+} from './shared/themes';
+
+export type * from './shared/types/index';
+
+// ===== Mocks =====
+export * from './shared/mocks';
+
+// ===== Api =====
+export * from './shared/api';
+
+// ===== Definitions =====
+export * from './shared/definitions';
+
+// ===== Minecraft types =====
+export type * from './shared/minecraft-types/index';
+
+// ===== Utils =====
+export * from './shared/utils';
+
+// Explicit re-export overrides the conflicting wildcard from utils
+export { getCurrentUserServerRole } from './shared/api/serverMembers';

package/src/minecraft-loader/base-loader.ts

@@ -0,0 +1,102 @@
+import type { Library } from '../shared/minecraft-types/build-manifest';
+import type {
+  LoaderGameVersion,
+  LoaderVersionSummary,
+  MinecraftVersionDetails,
+} from '../shared/minecraft-types/minecraft-launcher-types';
+
+/**
+ * Id загрузчика в маркетплейсе модов (имена Modrinth/CurseForge и т.д.).
+ * Строка или массив — для всех провайдеров; объект — по ключу `provider.id`.
+ */
+export type ModsProviderLoaderIds =
+  | string
+  | readonly string[]
+  | Readonly<Partial<Record<string, string | readonly string[]>>>;
+
+/**
+ * Информация о версии загрузчика (профиль / merged manifest).
+ */
+export interface LoaderVersionInfo {
+  manifestUrl: string;
+  inheritsFrom?: string;
+  libraries?: Library[];
+  mainClass?: string;
+  jvmArguments?: string[];
+  gameArguments?: string[];
+  fullManifest?: MinecraftVersionDetails;
+}
+
+/**
+ * Базовый класс загрузчика Minecraft: пакет `@rynt/minecraft-launcher` и расширения
+ * наследуют его; расширения импортируют только из `@rynt/sdk/minecraft-loader`.
+ */
+export abstract class BaseLoader {
+  abstract readonly id: string;
+  abstract readonly name: string;
+  abstract readonly apiUrl: string;
+
+  /**
+   * Как представлять этот лоадер в маркетплейсах модов.
+   * По умолчанию используется `id` лоадера.
+   */
+  readonly modsProviderLoaderIds?: ModsProviderLoaderIds;
+
+  abstract getManifestUrl(gameVersion: string, loaderVersion?: string): string;
+
+  abstract getVersionInfo(
+    manifestUrl: string,
+    options?: unknown,
+  ): Promise<LoaderVersionInfo>;
+
+  async getGameVersions(): Promise<LoaderGameVersion[]> {
+    return [];
+  }
+
+  async getLoaderVersions(_gameVersion: string): Promise<LoaderVersionSummary[]> {
+    return [];
+  }
+
+  mergeLibraries(vanillaLibraries: Library[], loaderLibraries: Library[]): Library[] {
+    return [...vanillaLibraries, ...loaderLibraries];
+  }
+
+  getMainClass(vanillaMainClass: string, loaderMainClass?: string): string {
+    return loaderMainClass || vanillaMainClass;
+  }
+
+  processVersionDetails(
+    versionDetails: MinecraftVersionDetails,
+    loaderInfo: LoaderVersionInfo,
+  ): MinecraftVersionDetails {
+    const mergedLibraries = this.mergeLibraries(
+      versionDetails.libraries,
+      loaderInfo.libraries || [],
+    );
+
+    const mainClass = this.getMainClass(
+      versionDetails.mainClass,
+      loaderInfo.mainClass,
+    );
+
+    const jvmArgs = versionDetails.arguments?.jvm || [];
+    const mergedJvmArgs = loaderInfo.jvmArguments
+      ? [...jvmArgs, ...loaderInfo.jvmArguments]
+      : jvmArgs;
+
+    const gameArgs = versionDetails.arguments?.game || [];
+    const mergedGameArgs = loaderInfo.gameArguments
+      ? [...gameArgs, ...loaderInfo.gameArguments]
+      : gameArgs;
+
+    return {
+      ...versionDetails,
+      mainClass,
+      libraries: mergedLibraries,
+      arguments: {
+        jvm: mergedJvmArgs,
+        game: mergedGameArgs,
+      },
+    };
+  }
+}

package/src/minecraft-loader/index.ts

@@ -0,0 +1,11 @@
+export {
+  BaseLoader,
+  type LoaderVersionInfo,
+  type ModsProviderLoaderIds,
+} from './base-loader';
+export {
+  BUILTIN_MINECRAFT_LOADER_IDS,
+  isBuiltinMinecraftLoaderId,
+  loaderRegistry,
+  unregisterExtensionMinecraftLoaders,
+} from './loader-registry';

package/src/minecraft-loader/loader-registry.ts

@@ -0,0 +1,72 @@
+import {
+  deleteRegistryItem,
+  getRegistryEntryMeta,
+  getRegistryItem,
+  HOST_EXTENSION_ID,
+  listRegistryEntries,
+} from '../extensions/registries';
+import { useLoaderRegistry } from '../extensions/registries/builtins/loader';
+
+import type { BaseLoader } from './base-loader';
+
+const RID = 'core.loader';
+
+class LoaderRegistry {
+  /**
+   * `extensionId` определяется автоматически через scope (см. `extension-scope.ts`):
+   * - в коде расширения шим подставляет id из `manifest.json`;
+   * - в коде лаунчера scope = `rynt`.
+   */
+  register(loader: BaseLoader): void {
+    useLoaderRegistry().register(loader.id, loader);
+  }
+
+  unregister(loaderId: string): void {
+    useLoaderRegistry().delete(loaderId);
+  }
+
+  get(loaderId: string): BaseLoader | undefined {
+    return getRegistryItem<BaseLoader>(RID, loaderId);
+  }
+
+  getAll(): BaseLoader[] {
+    return useLoaderRegistry().getAll();
+  }
+
+  has(loaderId: string): boolean {
+    return useLoaderRegistry().has(loaderId);
+  }
+
+  getDefault(): BaseLoader {
+    const v = this.get('vanilla');
+    if (!v) {
+      throw new Error(
+        '[rynt/sdk] loaderRegistry: vanilla is not registered. Ensure the host registers built-in loaders before using the registry.',
+      );
+    }
+    return v;
+  }
+}
+
+export const loaderRegistry = new LoaderRegistry();
+
+export const BUILTIN_MINECRAFT_LOADER_IDS = new Set([
+  'vanilla',
+  'fabric',
+  'neoforge',
+  'forge',
+]);
+
+/** Снять записи лоадеров от всех расширений (хост-записи под `rynt` остаются). */
+export function unregisterExtensionMinecraftLoaders(): void {
+  for (const [key] of listRegistryEntries<BaseLoader>(RID)) {
+    const meta = getRegistryEntryMeta(RID, key);
+    if (meta && meta.extensionId !== HOST_EXTENSION_ID) {
+      deleteRegistryItem(RID, key);
+    }
+  }
+}
+
+export function isBuiltinMinecraftLoaderId(loaderId: string): boolean {
+  return BUILTIN_MINECRAFT_LOADER_IDS.has(loaderId);
+}