@connectorvol/shared 2.1.1 → 4.0.0

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export { Square } from "./square.js";
 export { type PieceSet } from "./pieceSet.js";
 export { type Move } from "./move.js";
 export { calculatePly } from "./calculatePly.js";
+export { MOVE_EVALUATION_NAG_IDS, NOVELTY_NAG_ID, PUZZLE_BRANCH_CORRECT_NAG_ID, PUZZLE_BRANCH_NAG_IDS, PUZZLE_BRANCH_WRONG_NAG_ID, type TNagMoveBoardGlyph, type TSplitMoveEvaluationNagsForBoard, isMoveEvaluationNag, isPuzzleBranchNag, moveEvaluationNagBoardGlyph, nagBadgeBackground, pickFirstMoveEvaluationNag, splitMoveEvaluationNagsForBoard, transformNag, } from "./nagGlyphs.js";

package/dist/index.js

@@ -6,3 +6,4 @@ export { Square } from "./square.js";
 export {} from "./pieceSet.js";
 export {} from "./move.js";
 export { calculatePly } from "./calculatePly.js";
+export { MOVE_EVALUATION_NAG_IDS, NOVELTY_NAG_ID, PUZZLE_BRANCH_CORRECT_NAG_ID, PUZZLE_BRANCH_NAG_IDS, PUZZLE_BRANCH_WRONG_NAG_ID, isMoveEvaluationNag, isPuzzleBranchNag, moveEvaluationNagBoardGlyph, nagBadgeBackground, pickFirstMoveEvaluationNag, splitMoveEvaluationNagsForBoard, transformNag, } from "./nagGlyphs.js";

package/dist/nagGlyphs.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Представляет NAG группы «Оценка хода» (Lichess / PGN) для бейджа на клетке назначения.
+ */
+export declare const MOVE_EVALUATION_NAG_IDS: readonly [1, 2, 3, 4, 5, 6, 146];
+/** Представляет NAG новизны (новинка) в группе «Оценка хода». */
+export declare const NOVELTY_NAG_ID: 146;
+/** Представляет NAG метки «верная ветка решения задачи» (развилка со стороны решателя). */
+export declare const PUZZLE_BRANCH_CORRECT_NAG_ID: 147;
+/** Представляет NAG метки «неверная ветка решения задачи». */
+export declare const PUZZLE_BRANCH_WRONG_NAG_ID: 148;
+/** Представляет пару NAG для обязательной разметки альтернатив на шаге задачи. */
+export declare const PUZZLE_BRANCH_NAG_IDS: readonly [147, 148];
+/** Представляет проверку: NAG относится к паре «верно / неверно» для ветки задачи. */
+export declare function isPuzzleBranchNag(nag: number): boolean;
+/** Представляет результат разбиения NAG группы «Оценка хода» для отображения на доске. */
+export interface TSplitMoveEvaluationNagsForBoard {
+    /** Возвращает номер NAG новизны (146), если он присутствует в списке. */
+    noveltyNag?: number;
+    /** Возвращает первый остальной NAG из той же группы (не новизна). */
+    secondaryNag?: number;
+}
+/** Представляет стиль круглого бейджа NAG на доске (фон и подпись). */
+export type TNagMoveBoardGlyph = {
+    /** Возвращает CSS `background` (градиент). */
+    background: string;
+    /** Возвращает короткий символ глифа. */
+    label: string;
+};
+/** Представляет проверку: NAG относится к группе «Оценка хода». */
+export declare function isMoveEvaluationNag(nag: number): boolean;
+/** Представляет первый NAG из списка, входящий в группу «Оценка хода». */
+export declare function pickFirstMoveEvaluationNag(nags: readonly number[] | undefined): number | undefined;
+/** Представляет выделение NAG новизны и одной дополнительной оценки хода для двух углов клетки. */
+export declare function splitMoveEvaluationNagsForBoard(nags: readonly number[] | undefined): TSplitMoveEvaluationNagsForBoard;
+/** Представляет CSS `background` для бейджа NAG. */
+export declare function nagBadgeBackground(nag: number): string;
+/** Представляет преобразование номера NAG в строку для UI (как в меню Lichess). */
+export declare function transformNag(nag: number | undefined): string;
+/** Представляет глиф и фон для бейджа оценки хода на клетке `to` или null, если NAG не из этой группы. */
+export declare function moveEvaluationNagBoardGlyph(nag: number): TNagMoveBoardGlyph | null;

package/dist/nagGlyphs.js

@@ -0,0 +1,137 @@
+/**
+ * Представляет NAG группы «Оценка хода» (Lichess / PGN) для бейджа на клетке назначения.
+ */
+export const MOVE_EVALUATION_NAG_IDS = [1, 2, 3, 4, 5, 6, 146];
+const MOVE_EVAL_SET = new Set(MOVE_EVALUATION_NAG_IDS);
+/** Представляет NAG новизны (новинка) в группе «Оценка хода». */
+export const NOVELTY_NAG_ID = 146;
+/** Представляет NAG метки «верная ветка решения задачи» (развилка со стороны решателя). */
+export const PUZZLE_BRANCH_CORRECT_NAG_ID = 147;
+/** Представляет NAG метки «неверная ветка решения задачи». */
+export const PUZZLE_BRANCH_WRONG_NAG_ID = 148;
+/** Представляет пару NAG для обязательной разметки альтернатив на шаге задачи. */
+export const PUZZLE_BRANCH_NAG_IDS = [
+    PUZZLE_BRANCH_CORRECT_NAG_ID,
+    PUZZLE_BRANCH_WRONG_NAG_ID,
+];
+const PUZZLE_BRANCH_SET = new Set(PUZZLE_BRANCH_NAG_IDS);
+/** Представляет проверку: NAG относится к паре «верно / неверно» для ветки задачи. */
+export function isPuzzleBranchNag(nag) {
+    return PUZZLE_BRANCH_SET.has(nag);
+}
+const NAG_SYMBOLS = {
+    1: "!",
+    2: "?",
+    3: "!!",
+    4: "??",
+    5: "!?",
+    6: "?!",
+    7: "□",
+    22: "⨀",
+    10: "=",
+    13: "∞",
+    14: "⩲",
+    15: "⩱",
+    16: "±",
+    17: "∓",
+    18: "+\u2212",
+    19: "-+",
+    146: "N",
+    147: "✓",
+    148: "✗",
+    32: "↑↑",
+    36: "↑",
+    40: "→",
+    132: "⇆",
+    138: "⊕",
+    44: "=∞",
+    140: "\u2206",
+};
+const NAG_BADGE_GRADIENTS = {
+    1: "linear-gradient(145deg, #15803d 0%, #22c55e 100%)",
+    2: "linear-gradient(145deg, #991b1b 0%, #ef4444 100%)",
+    3: "linear-gradient(145deg, #a16207 0%, #facc15 55%, #fde047 100%)",
+    4: "linear-gradient(145deg, #450a0a 0%, #7f1d1d 65%, #b91c1c 100%)",
+    5: "linear-gradient(145deg, #0f766e 0%, #14b8a6 55%, #5eead4 100%)",
+    6: "linear-gradient(145deg, #c2410c 0%, #f97316 100%)",
+    7: "linear-gradient(145deg, #4b5563 0%, #9ca3af 100%)",
+    22: "linear-gradient(145deg, #581c87 0%, #a855f7 55%, #c084fc 100%)",
+    10: "linear-gradient(145deg, #475569 0%, #94a3b8 100%)",
+    13: "linear-gradient(145deg, #5b21b6 0%, #8b5cf6 50%, #a78bfa 100%)",
+    14: "linear-gradient(145deg, #1d4ed8 0%, #3b82f6 55%, #60a5fa 100%)",
+    15: "linear-gradient(145deg, #713f12 0%, #b45309 50%, #d97706 100%)",
+    16: "linear-gradient(145deg, #1e3a8a 0%, #2563eb 55%, #3b82f6 100%)",
+    17: "linear-gradient(145deg, #78350f 0%, #b45309 70%, #ea580c 100%)",
+    18: "linear-gradient(145deg, #172554 0%, #1e40af 45%, #2563eb 100%)",
+    19: "linear-gradient(145deg, #292524 0%, #44403c 40%, #7c2d12 100%)",
+    146: "linear-gradient(145deg, #9d174d 0%, #ec4899 55%, #f472b6 100%)",
+    147: "linear-gradient(145deg, #166534 0%, #22c55e 55%, #4ade80 100%)",
+    148: "linear-gradient(145deg, #991b1b 0%, #dc2626 55%, #f87171 100%)",
+    32: "linear-gradient(145deg, #166534 0%, #22c55e 50%, #86efac 100%)",
+    36: "linear-gradient(145deg, #b45309 0%, #f59e0b 55%, #fbbf24 100%)",
+    40: "linear-gradient(145deg, #b91c1c 0%, #ef4444 45%, #fb7185 100%)",
+    132: "linear-gradient(145deg, #0e7490 0%, #06b6d4 50%, #22d3ee 100%)",
+    138: "linear-gradient(145deg, #881337 0%, #e11d48 50%, #fb7185 100%)",
+    44: "linear-gradient(145deg, #115e59 0%, #0d9488 50%, #2dd4bf 100%)",
+    140: "linear-gradient(145deg, #312e81 0%, #4f46e5 50%, #818cf8 100%)",
+};
+/** Представляет проверку: NAG относится к группе «Оценка хода». */
+export function isMoveEvaluationNag(nag) {
+    return MOVE_EVAL_SET.has(nag);
+}
+/** Представляет первый NAG из списка, входящий в группу «Оценка хода». */
+export function pickFirstMoveEvaluationNag(nags) {
+    if (!nags?.length)
+        return undefined;
+    for (const n of nags) {
+        if (MOVE_EVAL_SET.has(n))
+            return n;
+    }
+    return undefined;
+}
+/** Представляет выделение NAG новизны и одной дополнительной оценки хода для двух углов клетки. */
+export function splitMoveEvaluationNagsForBoard(nags) {
+    if (!nags?.length)
+        return {};
+    let noveltyNag;
+    let secondaryNag;
+    for (const n of nags) {
+        if (!MOVE_EVAL_SET.has(n))
+            continue;
+        if (n === NOVELTY_NAG_ID) {
+            if (noveltyNag === undefined)
+                noveltyNag = n;
+            continue;
+        }
+        if (secondaryNag === undefined)
+            secondaryNag = n;
+    }
+    return { noveltyNag, secondaryNag };
+}
+/** Представляет CSS `background` для бейджа NAG. */
+export function nagBadgeBackground(nag) {
+    const preset = NAG_BADGE_GRADIENTS[nag];
+    if (preset)
+        return preset;
+    const h = (((nag * 137.508) % 360) + 360) % 360;
+    const h2 = (h + 48) % 360;
+    return `linear-gradient(145deg, hsl(${h} 62% 38%) 0%, hsl(${h2} 58% 28%) 100%)`;
+}
+/** Представляет преобразование номера NAG в строку для UI (как в меню Lichess). */
+export function transformNag(nag) {
+    if (nag === undefined || Number.isNaN(nag))
+        return "";
+    const symbol = NAG_SYMBOLS[nag];
+    if (symbol !== undefined)
+        return symbol;
+    return `$${nag}`;
+}
+/** Представляет глиф и фон для бейджа оценки хода на клетке `to` или null, если NAG не из этой группы. */
+export function moveEvaluationNagBoardGlyph(nag) {
+    if (!isMoveEvaluationNag(nag))
+        return null;
+    return {
+        background: nagBadgeBackground(nag),
+        label: transformNag(nag) || `$${nag}`,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@connectorvol/shared",
-  "version": "2.1.1",
+  "version": "4.0.0",
   "files": [
     "dist",
     "!dist/**/*.test.*",