@rynt/sdk 0.9.53

package/src/extensions/index.ts

@@ -0,0 +1,251 @@
+export { defineRyntExtension, defineStore } from '../extensions/plugin';
+export type {
+  RyntExtensionContext,
+  RyntExtensionDefinition,
+  RyntExtensionHostApis,
+  RyntExtensionNativeNotificationInput,
+  RyntExtensionSetupFn,
+  RyntExtensionSetupResult,
+} from '../extensions/plugin-types';
+
+export type { ExtensionExposeMap } from '@rynt/sdk/extension-expose-map';
+export type { ExtensionRegistryPayloadMap } from '@rynt/sdk/extension-registry-payload-map';
+export {
+  extensionExposeRevision,
+  getExtensionExpose,
+  useExtensionExpose,
+} from '../extensions/extension-expose';
+
+export type {
+  CoreNavItem,
+  CorePageItem,
+  CoreSidebarItem,
+} from '../extensions/registries/builtins';
+
+export type {
+  InviteHandlerAcceptContext,
+  InviteHandlerRegistration,
+} from '../extensions/invite-handler/types';
+
+export type { RyntExtensionManifestParsed } from '../extensions/manifest-types';
+export { parseRyntManifestJson } from '../extensions/manifest';
+export { topoSortExtensions } from '../extensions/graph';
+export {
+  buildExtensionManifestIndex,
+  resolveExtensionsForLoad,
+  validateExtensionDependencyVersions,
+  type ExtensionManifestIndex,
+  type ResolveExtensionsLoadResult,
+} from '../extensions/resolve-extensions';
+export {
+  checkExtensionApi,
+  EXTENSION_API_VERSION,
+  normalizeExtensionApiInManifest,
+  parseExtensionApiMajor,
+  type CheckExtensionApiOptions,
+  type CheckExtensionApiResult,
+  type NormalizeExtensionApiOptions,
+} from '../extensions/version';
+export {
+  RYNT_EXTENSION_MARKETPLACE_OPEN,
+  RYNT_EXTENSION_MARKETPLACE_SLOT_RESOLVE,
+  RYNT_EXTENSION_MARKETPLACE_INSTALL,
+  type ExtensionMarketplaceOpenFn,
+  type ExtensionMarketplaceSlotOpenOptions,
+} from '../extensions/marketplace-open-key';
+
+export {
+  RYNT_EXTENSION_DISABLED_DIR_SUFFIX,
+  isRyntExtensionBundleDirDisabled,
+  ryntExtensionBundleDirBaseLabel,
+  ryntExtensionBundleDisabledFolderName,
+} from '../extensions/disabled-folder';
+
+export {
+  applyValidatedRyntContributesToManifest,
+  clearExtensionUiRegistries,
+  clearRegistryBucket,
+  defineExtensionRegistry,
+  deleteRegistryItem,
+  ensureCoreExtensionRegistries,
+  extensionRegistriesRevision,
+  getCurrentExtensionId,
+  getExtensionRegistry,
+  getRegistry,
+  getRegistryEntryMeta,
+  getRegistryItem,
+  hasRegistryItem,
+  HOST_EXTENSION_ID,
+  listRegistryEntries,
+  listRegistryKeys,
+  listRegistryValuesSorted,
+  popExtensionScope,
+  pushExtensionScope,
+  resetExtensionRegistries,
+  setRegistryItem,
+  unregisterRegistryEntriesForExtension,
+  useExtensionNavRegistry,
+  useExtensionPageRegistry,
+  useExtensionShellRegistry,
+  useExtensionSidebarRegistry,
+  useExtensionUserStripRegistry,
+  useAccountProviderRegistry,
+  useAppTopbarLeftWidgetsRegistry,
+  useAppTopbarRightWidgetsRegistry,
+  useAppTopbarStatusWidgetsRegistry,
+  useBuildCardActionsRegistry,
+  useBuildCardAfterMetaRegistry,
+  useBuildCardBeforeMediaRegistry,
+  useBuildCardBeforeMetaRegistry,
+  useBuildCardFooterActionsRegistry,
+  useBuildDetailAfterContentRegistry,
+  useBuildDetailBeforeContentRegistry,
+  useBuildDetailBeforeHeroRegistry,
+  useBuildDetailHeaderActionsRegistry,
+  useBuildDetailModRowActionsRegistry,
+  useBuildDetailResourcepackRowActionsRegistry,
+  useBuildDetailRightColumnBottomRegistry,
+  useBuildDetailRightColumnTopRegistry,
+  useDialogFooterActionsRegistry,
+  useFeedAfterContentRegistry,
+  useFeedBeforeContentRegistry,
+  useFriendsAfterListRegistry,
+  useInviteHandlerRegistry,
+  useFriendsBeforeListRegistry,
+  useLibraryAfterContentRegistry,
+  useLibraryBeforeContentRegistry,
+  useMapCardActionsRegistry,
+  useMapCardAfterMetaRegistry,
+  useMapCardBeforeMetaRegistry,
+  useMapCardFooterActionsRegistry,
+  useMapDetailAfterContentRegistry,
+  useMapDetailBeforeContentRegistry,
+  useMapDetailHeaderActionsRegistry,
+  useMarkdownEditorToolbarActionsRegistry,
+  useMarkdownEditorTiptapExtensionsRegistry,
+  useModDetailsFooterActionsRegistry,
+  useMarkdownRendererAfterContentRegistry,
+  useMarkdownRendererBeforeContentRegistry,
+  useLoaderRegistry,
+  useModManageActionsRegistry,
+  useModProviderRegistry,
+  useResourcepackManageActionsRegistry,
+  useShaderpackManageActionsRegistry,
+  useProjectsAfterContentRegistry,
+  useProjectsBeforeContentRegistry,
+  useSettingsAfterSectionsRegistry,
+  useSettingsBeforeSectionsRegistry,
+  useSettingsSectionWidgetsRegistry,
+  useSidebarFooterWidgetsRegistry,
+  useSidebarHeaderWidgetsRegistry,
+  useServerCardActionsRegistry,
+  useServerCardAfterMetaRegistry,
+  useServerCardBeforeMetaRegistry,
+  useServerCardFooterActionsRegistry,
+  useServerDetailAfterContentRegistry,
+  useServerDetailBeforeContentRegistry,
+  useServerDetailHeaderActionsRegistry,
+  useSidebarAfterContentRegistry,
+  useSidebarBeforeContentRegistry,
+  useThemeRegistry,
+  useUserMenuActionsRegistry,
+  useUserMenuAfterActionsRegistry,
+  useUserMenuBeforeActionsRegistry,
+  useUserCardAfterMetaRegistry,
+  useUserCardBeforeMetaRegistry,
+  flattenExtendsRegistries,
+  getRyntContributesFromManifest,
+  getRegistryEntryRow,
+  hasRegistryEntry,
+  resolveRegistrySlot,
+  validateRyntManifestContributes,
+  withExtensionScope,
+  KNOWN_CORE_REGISTRY_IDS,
+} from '../extensions/registries';
+export type {
+  BuiltinRegistryId,
+  BuiltinRegistryValueMap,
+  ExtensionRegistryApi,
+  ExtensionRegistryHandle,
+  KnownBuiltinRegistryId,
+  ParsedRyntManifestContributes,
+  RegistryDeclaration,
+  RegistryEntry,
+  RegistryEntryMeta,
+  RegistryExtensionContribution,
+  RegistryRow,
+  RegistrySlotRef,
+  RegistrySlotResolveResult,
+  UseExtensionRegistry,
+} from '../extensions/registries';
+
+export { extensionRouteSlug, resolvedNavigationPath } from '../extensions/slug';
+
+export {
+  registerLauncherEntity,
+  clearLauncherEntityRegistry,
+} from '../extensions/launcher-entities/registry';
+export {
+  RYNT_LAUNCHER_ENTITY_KEYS,
+  type LauncherEntityRegistryKey,
+} from '../extensions/launcher-entities/keys';
+export {
+  EntityBuildCard,
+  EntityModItem,
+  EntityModListItem,
+  EntityModManageItem,
+  EntityAccountAvatar,
+  EntityAccountCard,
+  EntityAccountItem,
+  EntityAccountItemMin,
+  EntityAccountListItem,
+  EntityAuthProviderItem,
+  EntityBuildListItem,
+  EntityEventCard,
+  EntityEventListItem,
+  EntityPostCard,
+  EntityPostCardMin,
+  EntityResourcepackItem,
+  EntityResourcepackListItem,
+  EntityResourcepackManageItem,
+  EntityServerCard,
+  EntityServerMemberItem,
+  EntityServerMemberManageItem,
+  EntityUserAvatar,
+  EntityUserCurrent,
+  EntityUserItem,
+  EntityUserItemMin,
+  EntityUserListItem,
+  EntityUserStatusDisplay,
+  EntityVersionListItem,
+  EntityVersionListItemMin,
+} from '../extensions/launcher-entities/launcher-entity-components';
+export type {
+  EntityUserAvatarProps,
+} from '../extensions/launcher-entities/props-map';
+
+export type { LauncherModelApis } from '../extensions/launcher-models/apis/launcher-model-apis';
+
+// ===== Router Bridge (for host use) =====
+export {
+  attachExtensionRoutes,
+  attachExtensionRoutesForExtensions,
+  detachExtensionRoutes,
+  detachExtensionRoutesForExtensions,
+  syncExtensionRoutes,
+  syncExtensionRoutesForExtensions,
+  EXTENSION_ROUTE_NAME_PREFIX,
+  isExtensionRouteName,
+  routeHasExtensionMeta,
+} from '../extensions/router-bridge';
+
+// ===== Minecraft Loader =====
+export { BaseLoader } from '../minecraft-loader/base-loader';
+export { loaderRegistry } from '../minecraft-loader/loader-registry';
+export type {
+  LoaderVersionInfo,
+  ModsProviderLoaderIds,
+} from '../minecraft-loader/base-loader';
+export { resolveModsProviderLoaderIds } from '../shared/mods/resolve-mods-provider-loader-ids';
+export { useModel } from '../extensions/launcher-models/public';
+export { RYNT_LAUNCHER_MODEL_KEYS, type RyntLauncherModelKey } from '../extensions/launcher-models/keys';

package/src/extensions/invite-handler/types.ts

@@ -0,0 +1,20 @@
+import type { EntityInvite } from '../../shared/types/entities';
+
+/** Контекст accept-flow, который хост передаёт обработчику инвайта. */
+export interface InviteHandlerAcceptContext {
+  acceptInvite: (inviteId: string) => Promise<void>;
+  rejectInvite: (inviteId: string) => Promise<void>;
+  loadAllInvites: () => Promise<void>;
+  routerPush: (path: string) => Promise<void | boolean>;
+}
+
+/** Обработчик UI/accept для конкретного `invite.type` (паттерн A). */
+export interface InviteHandlerRegistration {
+  subtitle?: (invite: EntityInvite) => string;
+  outgoingLabel?: (invite: EntityInvite) => string;
+  primaryActionLabel?: (invite: EntityInvite) => string;
+  onAccept?: (
+    invite: EntityInvite,
+    ctx: InviteHandlerAcceptContext,
+  ) => Promise<void>;
+}

package/src/extensions/launcher-entities/create-launcher-entity.ts

@@ -0,0 +1,25 @@
+import { defineComponent, h } from 'vue';
+import type { Component } from 'vue';
+
+import type { LauncherEntityRegistryKey } from './keys';
+import { resolveLauncherEntity } from './registry';
+
+/**
+ * Обёртка с фиксированным именем экспорта: на рендере подтягивает конкретный `.vue` из реестра.
+ */
+export function createLauncherEntity<Key extends LauncherEntityRegistryKey>(options: {
+  key: Key;
+  exportName: string;
+}): Component {
+  const { key, exportName } = options;
+
+  return defineComponent({
+    name: exportName,
+    inheritAttrs: false,
+
+    setup(_, { attrs, slots }) {
+      return () =>
+        h(resolveLauncherEntity(key) as Component, attrs, slots as never);
+    },
+  });
+}

package/src/extensions/launcher-entities/keys.ts

@@ -0,0 +1,46 @@
+/**
+ * Ключи виджетов лаунчера, пробрасываемых расширениям через `@rynt/sdk/ui`.
+ * Реальные `.vue`-реализации регистрирует только хост (`@rynt/sdk/ui/host`).
+ *
+ * При добавлении ключа синхронизировать: `props-map.ts`, `launcher-entity-components.ts`,
+ * `register-launcher-entities.ts` (client), `extension-build/shims/rynt-sdk-ui.host-shim.js`.
+ *
+ * Публичные имена экспортов имеют префикс `Entity` (напр. `EntityBuildCard`).
+ */
+export const RYNT_LAUNCHER_ENTITY_KEYS = [
+  'account_avatar',
+  'account_card',
+  'account_item',
+  'account_item_min',
+  'account_list_item',
+  'auth_provider_item',
+  'build_card',
+  'build_list_item',
+
+  'entity_user_avatar',
+  'event_card',
+  'event_list_item',
+  'mod_item',
+  'mod_list_item',
+  'mod_manage_item',
+  'post_card',
+  'post_card_min',
+  'resourcepack_item',
+  'resourcepack_list_item',
+  'resourcepack_manage_item',
+  'shaderpack_item',
+  'shaderpack_list_item',
+  'shaderpack_manage_item',
+  'server_card',
+  'server_member_item',
+  'server_member_manage_item',
+  'user_current',
+  'user_item',
+  'user_item_min',
+  'user_list_item',
+  'user_status_display',
+  'version_list_item',
+  'version_list_item_min',
+] as const;
+
+export type LauncherEntityRegistryKey = (typeof RYNT_LAUNCHER_ENTITY_KEYS)[number];

package/src/extensions/launcher-entities/launcher-entity-components.ts

@@ -0,0 +1,177 @@
+import type { DefineComponent } from 'vue';
+
+import type { LauncherEntityPublicPropsMap } from './props-map';
+import type { LauncherEntityRegistryKey } from './keys';
+import { createLauncherEntity } from './create-launcher-entity';
+
+function launcherEntity<
+  Key extends LauncherEntityRegistryKey,
+>(options: {
+  key: Key;
+  exportName: string;
+}): DefineComponent<LauncherEntityPublicPropsMap[Key]> {
+  return createLauncherEntity(options) as DefineComponent<
+    LauncherEntityPublicPropsMap[Key]
+  >;
+}
+
+export const EntityAccountAvatar = launcherEntity({
+  key: 'account_avatar',
+  exportName: 'RyntLauncherEntityAccountAvatar',
+});
+
+export const EntityAccountCard = launcherEntity({
+  key: 'account_card',
+  exportName: 'RyntLauncherEntityAccountCard',
+});
+
+export const EntityAccountItem = launcherEntity({
+  key: 'account_item',
+  exportName: 'RyntLauncherEntityAccountItem',
+});
+
+export const EntityAccountItemMin = launcherEntity({
+  key: 'account_item_min',
+  exportName: 'RyntLauncherEntityAccountItemMin',
+});
+
+export const EntityAccountListItem = launcherEntity({
+  key: 'account_list_item',
+  exportName: 'RyntLauncherEntityAccountListItem',
+});
+
+export const EntityAuthProviderItem = launcherEntity({
+  key: 'auth_provider_item',
+  exportName: 'RyntLauncherEntityAuthProviderItem',
+});
+
+export const EntityBuildCard = launcherEntity({
+  key: 'build_card',
+  exportName: 'RyntLauncherEntityBuildCard',
+});
+
+export const EntityBuildListItem = launcherEntity({
+  key: 'build_list_item',
+  exportName: 'RyntLauncherEntityBuildListItem',
+});
+
+
+export const EntityEventCard = launcherEntity({
+  key: 'event_card',
+  exportName: 'RyntLauncherEntityEventCard',
+});
+
+export const EntityEventListItem = launcherEntity({
+  key: 'event_list_item',
+  exportName: 'RyntLauncherEntityEventListItem',
+});
+
+export const EntityModItem = launcherEntity({
+  key: 'mod_item',
+  exportName: 'RyntLauncherEntityModItem',
+});
+
+export const EntityModListItem = launcherEntity({
+  key: 'mod_list_item',
+  exportName: 'RyntLauncherEntityModListItem',
+});
+
+export const EntityModManageItem = launcherEntity({
+  key: 'mod_manage_item',
+  exportName: 'RyntLauncherEntityModManageItem',
+});
+
+export const EntityPostCard = launcherEntity({
+  key: 'post_card',
+  exportName: 'RyntLauncherEntityPostCard',
+});
+
+export const EntityPostCardMin = launcherEntity({
+  key: 'post_card_min',
+  exportName: 'RyntLauncherEntityPostCardMin',
+});
+
+export const EntityResourcepackItem = launcherEntity({
+  key: 'resourcepack_item',
+  exportName: 'RyntLauncherEntityResourcepackItem',
+});
+
+export const EntityResourcepackListItem = launcherEntity({
+  key: 'resourcepack_list_item',
+  exportName: 'RyntLauncherEntityResourcepackListItem',
+});
+
+export const EntityResourcepackManageItem = launcherEntity({
+  key: 'resourcepack_manage_item',
+  exportName: 'RyntLauncherEntityResourcepackManageItem',
+});
+
+export const EntityShaderpackItem = launcherEntity({
+  key: 'shaderpack_item',
+  exportName: 'RyntLauncherEntityShaderpackItem',
+});
+
+export const EntityShaderpackListItem = launcherEntity({
+  key: 'shaderpack_list_item',
+  exportName: 'RyntLauncherEntityShaderpackListItem',
+});
+
+export const EntityShaderpackManageItem = launcherEntity({
+  key: 'shaderpack_manage_item',
+  exportName: 'RyntLauncherEntityShaderpackManageItem',
+});
+
+export const EntityServerCard = launcherEntity({
+  key: 'server_card',
+  exportName: 'RyntLauncherEntityServerCard',
+});
+
+export const EntityServerMemberItem = launcherEntity({
+  key: 'server_member_item',
+  exportName: 'RyntLauncherEntityServerMemberItem',
+});
+
+export const EntityServerMemberManageItem = launcherEntity({
+  key: 'server_member_manage_item',
+  exportName: 'RyntLauncherEntityServerMemberManageItem',
+});
+
+export const EntityUserAvatar = launcherEntity({
+  key: 'entity_user_avatar',
+  exportName: 'RyntLauncherEntityUserAvatar',
+});
+
+export const EntityUserCurrent = launcherEntity({
+  key: 'user_current',
+  exportName: 'RyntLauncherEntityUserCurrent',
+});
+
+export const EntityUserItem = launcherEntity({
+  key: 'user_item',
+  exportName: 'RyntLauncherEntityUserItem',
+});
+
+export const EntityUserItemMin = launcherEntity({
+  key: 'user_item_min',
+  exportName: 'RyntLauncherEntityUserItemMin',
+});
+
+export const EntityUserListItem = launcherEntity({
+  key: 'user_list_item',
+  exportName: 'RyntLauncherEntityUserListItem',
+});
+
+export const EntityUserStatusDisplay = launcherEntity({
+  key: 'user_status_display',
+  exportName: 'RyntLauncherEntityUserStatusDisplay',
+});
+
+export const EntityVersionListItem = launcherEntity({
+  key: 'version_list_item',
+  exportName: 'RyntLauncherEntityVersionListItem',
+});
+
+export const EntityVersionListItemMin = launcherEntity({
+  key: 'version_list_item_min',
+  exportName: 'RyntLauncherEntityVersionListItemMin',
+});

package/src/extensions/launcher-entities/props-map.ts

@@ -0,0 +1,69 @@
+import type { IAuthProvider } from '../launcher-models/apis/accounts-contracts';
+import type { Mod, ResourcePack, ShaderPack } from '../../shared/minecraft-types/build-manifest';
+import type { MarketplaceItem } from '../../shared/mods/types';
+import type { MinecraftAccount } from '../../shared/types/account';
+import type {
+  EntityBuild,
+  EntityBuildLocal,
+  EntityEvent,
+  EntityPost,
+  EntityServer,
+  EntityServerMember,
+  EntityUser,
+  EntityVersion,
+} from '../../shared/types/entities';
+import type { UserStatusDetail } from '../../shared/types/user';
+/** Пропсы `entity_user_avatar` (зеркало клиентского `user/Avatar.vue`). */
+export type EntityUserAvatarProps = {
+  user: EntityUser;
+  size?: 'sm' | 'md' | 'lg' | 'xl';
+  showStatus?: boolean;
+  angular?: boolean;
+};
+
+/**
+ * Публичные пропсы зарегистрированных entity-виджетов (для типизации обёрток).
+ */
+export type LauncherEntityPublicPropsMap = {
+  account_avatar: {
+    account: MinecraftAccount | null | undefined;
+    size?: 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+    angular?: boolean;
+  };
+  account_card: { account: MinecraftAccount; isActive?: boolean };
+  account_item: { account: MinecraftAccount; isActive?: boolean };
+  account_item_min: { account: MinecraftAccount };
+  account_list_item: { account: MinecraftAccount; isActive?: boolean };
+  auth_provider_item: { provider: IAuthProvider };
+  build_card: { build: EntityBuild | EntityBuildLocal; showPlayButton?: boolean };
+  build_list_item: { build: EntityBuild };
+  entity_user_avatar: EntityUserAvatarProps;
+  event_card: { event: EntityEvent };
+  event_list_item: { event: EntityEvent };
+  mod_item: { mod: MarketplaceItem };
+  mod_list_item: { mod: Mod };
+  mod_manage_item: { mod: Mod; isValid?: boolean };
+  post_card: { post: EntityPost };
+  post_card_min: { post: EntityPost };
+  resourcepack_item: { pack: MarketplaceItem };
+  resourcepack_list_item: { pack: ResourcePack };
+  resourcepack_manage_item: { pack: ResourcePack; isValid?: boolean };
+  shaderpack_item: { pack: MarketplaceItem };
+  shaderpack_list_item: { pack: ShaderPack };
+  shaderpack_manage_item: { pack: ShaderPack; isValid?: boolean };
+  server_card: { server: EntityServer };
+  server_member_item: { member: EntityServerMember };
+  server_member_manage_item: { member: EntityServerMember; canManage?: boolean };
+  user_current: Record<string, never>;
+  user_item: { user: EntityUser };
+  user_item_min: { user: EntityUser; showLevel?: boolean };
+  user_list_item: { user: EntityUser };
+  user_status_display: {
+    status?: 'online' | 'offline';
+    statusDetail?: UserStatusDetail | null;
+    actions?: boolean;
+    friendId?: string;
+  };
+  version_list_item: { version: EntityVersion };
+  version_list_item_min: { version: EntityVersion };
+};

package/src/extensions/launcher-entities/registry.ts

@@ -0,0 +1,32 @@
+import type { Component } from 'vue';
+
+import type { LauncherEntityRegistryKey } from './keys';
+
+const registry = new Map<LauncherEntityRegistryKey, Component>();
+
+/**
+ * Зарегистрировать реализацию виджета (только хост-лаунчер, до загрузки entry расширений).
+ */
+export function registerLauncherEntity<K extends LauncherEntityRegistryKey>(
+  key: K,
+  component: Component,
+): void {
+  registry.set(key, component);
+}
+
+export function resolveLauncherEntity<K extends LauncherEntityRegistryKey>(
+  key: K,
+): Component {
+  const c = registry.get(key);
+  if (c === undefined) {
+    throw new Error(
+      `[rynt/ui/entities] Виджет «${String(key)}» не зарегистрирован. Вызовите registerLauncherEntity('${String(key)}', Component) до рендеринга расширений.`,
+    );
+  }
+  return c;
+}
+
+/** Только тесты / горячая перезагрузка регистров. */
+export function clearLauncherEntityRegistry(): void {
+  registry.clear();
+}