Skip to content
On this page

API - v4.1.5 ​

Table of contents ​

Hex Enumerations ​

Traverser Enumerations ​

Grid Enumerations ​

Classes ​

Coordinates Interfaces ​

Hex Interfaces ​

Traverser Interfaces ​

Grid Interfaces ​

Other Interfaces ​

Coordinates Type Aliases ​

Hex Type Aliases ​

Traverser Type Aliases ​

Hex Variables ​

Coordinates Functions ​

Hex Functions ​

Traverser Functions ​

Other Functions ​

Coordinates Type Aliases ​

HexCoordinates ​

HexCoordinates: PartialCubeCoordinates | OffsetCoordinates | TupleCoordinates

Defined in ​

hex/types.ts:61


PartialCubeCoordinates ​

PartialCubeCoordinates: { q?: number ; r: number ; s: number } | { q: number ; r?: number ; s: number } | { q: number ; r: number ; s?: number }

Defined in ​

hex/types.ts:48


TupleCoordinates ​

TupleCoordinates: [q: number, r: number, s?: number]

Defined in ​

hex/types.ts:56


Hex Type Aliases ​

HexConstructor ​

HexConstructor<T>: (coordinates?: HexCoordinates) => T

Type parameters ​

NameType
Textends Hex

Type declaration ​

(coordinates?)

Parameters ​
NameType
coordinates?HexCoordinates

Defined in ​

hex/types.ts:119


HexOffset ​

HexOffset: 1 | -1

Defined in ​

hex/types.ts:76


Traverser Type Aliases ​

Traverser ​

Traverser<T, R>: (createHex: (coordinates?: HexCoordinates) => T, cursor?: HexCoordinates) => R

Type parameters ​

NameType
Textends Hex
Rextends Iterable<T> = T[]

Type declaration ​

(createHex, cursor?): R

Parameters ​
NameType
createHex(coordinates?: HexCoordinates) => T
cursor?HexCoordinates
Returns ​

R

Defined in ​

grid/types.ts:6

Hex Variables ​

defaultHexSettings ​

Const defaultHexSettings: HexSettings

Defined in ​

hex/hex.ts:133

Coordinates Functions ​

completeCube ​

completeCube(«destructured»): CubeCoordinates

Parameters ​

NameType
«destructured»PartialCubeCoordinates

Returns ​

CubeCoordinates

Defined in ​

hex/functions/completeCube.ts:7


isAxial ​

isAxial(value): value is AxialCoordinates

Parameters ​

NameType
valueunknown

Returns ​

value is AxialCoordinates

Defined in ​

utils/isAxial.ts:8


isOffset ​

isOffset(value): value is OffsetCoordinates

Parameters ​

NameType
valueunknown

Returns ​

value is OffsetCoordinates

Defined in ​

utils/isOffset.ts:8


isTuple ​

isTuple(value): value is TupleCoordinates

Parameters ​

NameType
valueunknown

Returns ​

value is TupleCoordinates

Defined in ​

utils/isTuple.ts:7


toCube ​

toCube(hexSettings, coordinates): CubeCoordinates

Util for converting offset/axial/cube/tuple coordinates to cube coordinates.

Parameters ​

NameType
hexSettingsPick<HexSettings, "orientation" | "offset">
coordinatesHexCoordinates

Returns ​

CubeCoordinates

Defined in ​

hex/functions/toCube.ts:12


tupleToCube ​

tupleToCube(«destructured»): Object

Parameters ​

NameType
«destructured»TupleCoordinates

Returns ​

Object

NameType
qnumber
rnumber
snumber

Defined in ​

utils/tupleToCube.ts:6


Hex Functions ​

createHexDimensions ​

createHexDimensions(radius): Ellipse

Parameters ​

NameType
radiusnumber

Returns ​

Ellipse

Defined in ​

hex/functions/createHexDimensions.ts:7

createHexDimensions(boundingBox, orientation): Ellipse

Parameters ​

NameType
boundingBoxBoundingBox
orientationOrientation

Returns ​

Ellipse

Defined in ​

hex/functions/createHexDimensions.ts:8

createHexDimensions(ellipse): Ellipse

Parameters ​

NameType
ellipseEllipse

Returns ​

Ellipse

Defined in ​

hex/functions/createHexDimensions.ts:9


createHexOrigin ​

createHexOrigin(input, boundingBox): Point

Parameters ​

NameType
input"topLeft"
boundingBoxBoundingBox

Returns ​

Point

Defined in ​

hex/functions/createHexOrigin.ts:7

createHexOrigin(input): Point

Parameters ​

NameType
inputPoint

Returns ​

Point

Defined in ​

hex/functions/createHexOrigin.ts:8


defineHex ​

defineHex(hexOptions?): typeof Hex

Parameters ​

NameType
hexOptions?Partial<HexOptions>

Returns ​

typeof Hex

Defined in ​

hex/functions/defineHex.ts:9


equals ​

equals(a, b): boolean

Parameters ​

NameType
aTupleCoordinates | PartialCubeCoordinates
bTupleCoordinates | PartialCubeCoordinates

Returns ​

boolean

Defined in ​

hex/functions/equals.ts:7

equals(a, b): boolean

Parameters ​

NameType
aOffsetCoordinates
bOffsetCoordinates

Returns ​

boolean

Defined in ​

hex/functions/equals.ts:11


hexToOffset ​

hexToOffset(«destructured»): OffsetCoordinates

Parameters ​

NameType
«destructured»Pick<Hex, "q" | "r" | "offset" | "isPointy">

Returns ​

OffsetCoordinates

Defined in ​

hex/functions/hexToOffset.ts:18


hexToPoint ​

hexToPoint(«destructured»): Point

Parameters ​

NameType
«destructured»Hex

Returns ​

Point

Defined in ​

hex/functions/hexToPoint.ts:7


offsetToCube ​

offsetToCube(«destructured», «destructured»): CubeCoordinates

Parameters ​

NameType
«destructured»Pick<HexSettings, "orientation" | "offset">
«destructured»OffsetCoordinates

Returns ​

CubeCoordinates

Defined in ​

hex/functions/offsetToCube.ts:27


pointToCube ​

pointToCube(«destructured», «destructured»): CubeCoordinates

Parameters ​

NameType
«destructured»Pick<HexSettings, "dimensions" | "orientation" | "origin">
«destructured»Point

Returns ​

CubeCoordinates

Defined in ​

hex/functions/pointToCube.ts:10


round ​

round(coordinates): CubeCoordinates

Parameters ​

NameType
coordinatesPartialCubeCoordinates

Returns ​

CubeCoordinates

Defined in ​

hex/functions/round.ts:7


translate ​

translate<T>(hex, delta): T

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
hexT
deltaPartialCubeCoordinates

Returns ​

T

Defined in ​

hex/functions/translate.ts:8

translate(coordinates, delta): CubeCoordinates

Parameters ​

NameType
coordinatesPartialCubeCoordinates
deltaPartialCubeCoordinates

Returns ​

CubeCoordinates

Defined in ​

hex/functions/translate.ts:9


Traverser Functions ​

concat ​

concat<T>(traversers): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
traversersTraverser<T> | Traverser<T>[]

Returns ​

Traverser<T>

Defined in ​

grid/traversers/concat.ts:7


fromCoordinates ​

fromCoordinates<T>(...coordinates): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
...coordinatesHexCoordinates[]

Returns ​

Traverser<T>

Defined in ​

grid/traversers/fromCoordinates.ts:8


line ​

line<T>(options): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
optionsLineAsVectorOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/line.ts:8

line<T>(options): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
optionsLineBetweenOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/line.ts:9


move ​

move<T>(direction): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
directionDirection

Returns ​

Traverser<T>

Defined in ​

grid/traversers/move.ts:9


rectangle ​

rectangle<T>(options): Traverser<T>

Remarks

The rectangle will only have 90° corners for the directions North, East, South and West.

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
optionsRectangleOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/rectangle.ts:14

rectangle<T>(cornerA, cornerB): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
cornerAHexCoordinates
cornerBHexCoordinates

Returns ​

Traverser<T>

Defined in ​

grid/traversers/rectangle.ts:15


repeat ​

repeat<T>(times, traversers): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
timesnumber
traversersTraverser<T> | Traverser<T>[]

Returns ​

Traverser<T>

Defined in ​

grid/traversers/repeat.ts:8


repeatWith ​

repeatWith<T>(sources, branches, «destructured»?): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
sourcesTraverser<T> | Traverser<T>[]
branchesTraverser<T> | Traverser<T>[]
«destructured»Object
› includeSourceundefined | boolean

Returns ​

Traverser<T>

Defined in ​

grid/traversers/repeatWith.ts:8


ring ​

ring<T>(options): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
optionsRingOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/ring.ts:9

ring<T>(options): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
optionsRingFromRadiusOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/ring.ts:10


spiral ​

spiral<T>(«destructured»): Traverser<T>

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
«destructured»SpiralOptions

Returns ​

Traverser<T>

Defined in ​

grid/traversers/spiral.ts:10


Other Functions ​

distance ​

distance(hexSettings, from, to): number

Parameters ​

NameType
hexSettingsPick<HexSettings, "orientation" | "offset">
fromHexCoordinates
toHexCoordinates

Returns ​

number

Defined in ​

grid/functions/distance.ts:3


isPoint ​

isPoint(value): value is Point

Parameters ​

NameType
valueunknown

Returns ​

value is Point

Defined in ​

utils/isPoint.ts:5


neighborOf ​

neighborOf<T>(hex, direction): T

Type parameters ​

NameType
Textends Hex

Parameters ​

NameType
hexT
directionDirection

Returns ​

T

Defined in ​

grid/functions/neighborOf.ts:47


offsetFromZero ​

offsetFromZero(offset, distance): number

Parameters ​

NameType
offsetHexOffset
distancenumber

Returns ​

number

Defined in ​

utils/offsetFromZero.ts:6

Released under the MIT License.