hintForfunction

A HINT, WHICH LOOKS FIRST FOR THE CHOSEN TILE'S MATCH. With a free tile chosen, the answer is a free tile that matches it, as a pair with the chosen tile first (found: "match"), the one that leaves the stacks lowest after it; if it has none, any free pair, said so ("other"), so a page can say "no free match for that tile" before it shows another. With nothing chosen (or a chosen tile that is not free) it is any free pair as ever ("any"): the one lifting the layers highest, so a hint never digs a tile deeper than it must. With no pair at all, pair is null and found is "none".

import { hintFor } from "@johnmorrisdotca/jarajara";

function hintFor(geometry: MahjongGeometry, cells: MahjongCells, rule: MahjongBonusRule, chosen?: number | null): Hint

import { generateAwase } from "@johnmorrisdotca/jarajara/awase";
import { geometryOf, hintFor, layoutFor } from "@johnmorrisdotca/jarajara";

const deal = generateAwase(4,"easy",2026);
const layout = layoutFor(4)!;
const geometry = geometryOf(layout);
const cells = deal.givens;
console.log(hintFor(geometry,cells,"group"));

{ pair: [ 4, 7 ], found: 'any' }