@xnlc/skins: домен скинов Minecraft

createSkinSystem({ library, accounts, disk?, locale?, client? })
  ├── catalog: LabyCatalog      ← каталог Laby
  ├── library: SkinLibrary      ← «Избранное»
  ├── minecraft: MinecraftSkins ← активный скин
  └── reset(): void             ← сброс кэша и пулов

import { createSkinSystem } from "@xnlc/skins";

const skinSystem = createSkinSystem({
  library: myLibraryStore,  // SkinLibraryStore
  accounts: myAccountPort,  // SkinAccountPort
  disk: myDiskCache,        // SkinDiskCache (опционально)
  locale: "ru",             // язык подписей тегов
});

const { catalog, library, minecraft } = skinSystem;

const page = await catalog.page({
  page: 0,              // номер страницы
  size: 25,             // элементов на странице (6..100)
  order: "most_used",   // сортировка
  tags: ["Girl"],       // фильтр по тегам
  query: null,          // текстовый поиск
});

const tags = await catalog.tags("ru");
// LabyTag[]: id, name, useCount, previewUrl

const player = await catalog.player("Notch");
// LabyPlayer | null: uuid, username, headUrl, skins[], capesCount

const texture = await catalog.texture("a1b2c3d4...");
// Uint8Array | null: PNG-текстура скина

const similar = await catalog.similar({
  hash: "a1b2c3d4...",
  tags: ["Girl"],
  slim: true,
});
// LabySkin[]: подборка из загруженных пулов

import { SkinLibrary } from "@xnlc/skins";

// Импорт из каталога
await library.importFromCatalog({ hash: "a1b2c3d4", name: "MySkin", variant: "slim" });

// Удалить
await library.remove(skinId);

// Получить список
const skins = await library.list();

import { MinecraftSkins } from "@xnlc/skins";

const mcSkins = new MinecraftSkins(accountPort);

// Надеть скин
await mcSkins.equip(skin, accountUuid);

// Сбросить на стандартный
await mcSkins.reset(accountUuid);

// Установить плащ
await mcSkins.setCape(capeId, accountUuid);

// Получить профиль
const profile = await mcSkins.getProfile(accountUuid);

import { SkinCache, BoundedMap } from "@xnlc/skins";

const cache = new SkinCache(diskCache);
await cache.binary("key", () => fetchTexture());
await cache.json("key", { ttl: 300_000 }, () => fetchData());

import {
  isValidTexture,      // проверить PNG-данные
  normalizeVariant,    // "slim" | "classic"
  sanitizeSkinName,    // очистить имя скина
  MAX_TEXTURE_BYTES,   // максимальный размер текстуры
} from "@xnlc/skins";

import {
  LABY_API_BASE,           // https://laby.net/api/v3
  LABY_TEXTURE_BASE,       // texture.laby.net/{hash}.png
  labyUniqueIdUrl,         // /user/{nick}/uniqueId
  labyUserTexturesUrl,     // /user/{uuid}/textures
  labyTagSkinsUrl,         // /tag/{id}
  labyTagsUrl,             // /tags
  labyHeadUrl,             // аватар по UUID
  labyRenderUrl,           // рендер скина
  isLabyHash,              // валидация хэша
  isLabyUsername,          // валидация ника
  sanitizeLabyUsername,    // очистка ника
} from "@xnlc/skins";

import {
  mapLabySkin,
  mapLabyTag,
  mapLabyTagSkin,
  mapLabyPlayerSkins,
  parseLabyTags,
} from "@xnlc/skins";

import {
  dedupeSkins,           // убрать дубликаты
  labyFilterSkins,       // фильтр по тегам и тексту
  labySimilarSkins,      // подборка похожих
  labySimilarityScore,   // числовая оценка схожести
  formatUseCount,        // форматирование метрики использования
} from "@xnlc/skins";

import { labySourceId, labyHashFromSourceId, LABY_SOURCE_PREFIX } from "@xnlc/skins";

const sourceId = labySourceId("a1b2c3d4");        // "laby:a1b2c3d4"
const hash = labyHashFromSourceId("laby:a1b2..."); // "a1b2..."

import type {
  SkinLibraryStore,    // CRUD «Избранного»
  SkinAccountPort,     // доступ к аккаунтам и токенам
  SkinDiskCache,       // дисковый кэш
  ResolvedSkinAccount, // разрешенный аккаунт со скином
} from "@xnlc/skins";

skinSystem.reset(); // очистить кэш и пулы каталога