Types

Core

Face

Defined in: packages/types/src/doc.ts:14

A named orientation of a piece (e.g. die face)

Properties

name

name: string

Defined in: packages/types/src/doc.ts:15

rotation

rotation: Vector3Tuple

Defined in: packages/types/src/doc.ts:16

---

GameState

Defined in: packages/types/src/doc.ts:187

The Automerge document shape — a digital analog of the physical game. Pieces are stacked on each other and positioned relatively.

Example

// A token, sitting on a card, sitting on a chessboard
{
  "$schema": "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json",
  "templates": {},
  "children": [
    {
      "name": "Chess Board",
      "position": [0, 0.1, 0],
      "locked": true,
      "src": "Chess_Board.glb",
      "children": [
        {
          "name": "card",
          "position": [0, 0.002, 0],
          "children": [
            { "name": "pawn", "position": [0, 0.3, 0], "children": [] }
          ]
        }
      ]
    }
  ]
}

Properties

__automergeMoves?

optional __automergeMoves: __AutomergeMoves

Defined in: packages/types/src/doc.ts:196

Tracks Automerge objectId changes when pieces are reparented.

Deprecated

Remove when Automerge adds native array move support.

$schema

$schema: "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json"

Defined in: packages/types/src/doc.ts:188

children

children: Piece[]

Defined in: packages/types/src/doc.ts:189

templates

templates: Templates

Defined in: packages/types/src/doc.ts:190

---

HashProps

Defined in: packages/types/src/hashroute.ts:31

Connection context passed to plugins via the URL hash.

Example

https://example.com/plugin#{"doc":"automerge:...","sync":["wss://..."],"delegation":"..."}

Properties

delegation?

optional delegation: string

Defined in: packages/types/src/hashroute.ts:40

Will be a base64url-encoded KeyHive/Beelay Ed25519 Signed<Delegation>.

Experimental

This API should not be used in production and may be trimmed from a public release.

doc

doc: AutomergeUrl

Defined in: packages/types/src/hashroute.ts:33

Automerge document URL

sync

sync: [string, ...string[]]

Defined in: packages/types/src/hashroute.ts:35

Sync server WebSocket URLs

---

Piece

Defined in: packages/types/src/doc.ts:64

A game piece in a manifest or document

Extends

• PieceTemplate

Properties

children?

optional children: Piece[]

Defined in: packages/types/src/doc.ts:65

color?

optional color: string | null

Defined in: packages/types/src/doc.ts:50

CSS color string, or null for no tint

Default

"#808080"

Inherited from

PieceTemplate.color

faces?

optional faces: Face[]

Defined in: packages/types/src/doc.ts:57

Named face orientations (e.g. for dice)

Inherited from

PieceTemplate.faces

locked?

optional locked: boolean

Defined in: packages/types/src/doc.ts:55

Make piece non-interactive?

Default

false

Inherited from

PieceTemplate.locked

name?

optional name: string

Defined in: packages/types/src/doc.ts:24

Inherited from

PieceTemplate.name

position?

optional position: Vector3Tuple

Defined in: packages/types/src/doc.ts:35

World position in meters.

Default

[0, 0, 0]

Inherited from

PieceTemplate.position

rotation?

optional rotation: Vector3Tuple

Defined in: packages/types/src/doc.ts:45

Euler rotation (degrees)

Default

[0, 0, 0]

Inherited from

PieceTemplate.rotation

scale?

optional scale: Vector3Tuple

Defined in: packages/types/src/doc.ts:40

Unitless multiplier applied to the model.

Default

[1, 1, 1]

Inherited from

PieceTemplate.scale

src?

optional src: string

Defined in: packages/types/src/doc.ts:26

Path to a glTF/GLB model

Inherited from

PieceTemplate.src

template?

optional template: string

Defined in: packages/types/src/doc.ts:30

Key into the sibling templates object to inherit defaults from

Inherited from

PieceTemplate.template

---

PieceTemplate

Defined in: packages/types/src/doc.ts:23

Piece template — shared fields for pieces

Extended by

• Piece

Properties

color?

optional color: string | null

Defined in: packages/types/src/doc.ts:50

CSS color string, or null for no tint

Default

"#808080"

faces?

optional faces: Face[]

Defined in: packages/types/src/doc.ts:57

Named face orientations (e.g. for dice)

locked?

optional locked: boolean

Defined in: packages/types/src/doc.ts:55

Make piece non-interactive?

Default

false

name?

optional name: string

Defined in: packages/types/src/doc.ts:24

position?

optional position: Vector3Tuple

Defined in: packages/types/src/doc.ts:35

World position in meters.

Default

[0, 0, 0]

rotation?

optional rotation: Vector3Tuple

Defined in: packages/types/src/doc.ts:45

Euler rotation (degrees)

Default

[0, 0, 0]

scale?

optional scale: Vector3Tuple

Defined in: packages/types/src/doc.ts:40

Unitless multiplier applied to the model.

Default

[1, 1, 1]

src?

optional src: string

Defined in: packages/types/src/doc.ts:26

Path to a glTF/GLB model

template?

optional template: string

Defined in: packages/types/src/doc.ts:30

Key into the sibling templates object to inherit defaults from

---

Templates

Templates = Record<string, PieceTemplate>

Defined in: packages/types/src/doc.ts:89

Reusable piece defaults, keyed by template name. Templates can inherit from other templates via the template field, and share syntax with pieces minus a children property.

Example

{
  "$schema": "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json",
  "templates": {
    "defaults": { "scale": [0.1, 0.1, 0.1] },
    "redToken": { "template": "defaults", "name": "Red token", "src": "redToken.glb" }
  },
  "children": [
    { "template": "redToken", "position": [0.0, 0, 0] },
    { "template": "redToken", "position": [0.1, 0, 0] },
    { "template": "redToken", "position": [0.2, 0, 0] }
  ]
}

Presence

FocusOp

Defined in: packages/types/src/presence.ts:31

Cursor focus (what the user is looking at) — no automerge equivalent

Properties

action

action: "focus"

Defined in: packages/types/src/presence.ts:32

path

path: AnchoredPath

Defined in: packages/types/src/presence.ts:33

---

MoveOp

Defined in: packages/types/src/presence.ts:51

Move — no automerge equivalent yet (planned feature)

Properties

action

action: "move"

Defined in: packages/types/src/presence.ts:52

path

path: AnchoredPath

Defined in: packages/types/src/presence.ts:53

to

to: AnchoredPath

Defined in: packages/types/src/presence.ts:54

---

PresenceState

Defined in: packages/types/src/presence.ts:61

Presence state broadcast between peers

Properties

client?

optional client: string

Defined in: packages/types/src/presence.ts:63

color?

optional color: string

Defined in: packages/types/src/presence.ts:62

cursors?

optional cursors: Record<string, { position?: Vector3Tuple; rotation?: Vector3Tuple; }>

Defined in: packages/types/src/presence.ts:66

Deprecated

Old presence format; use op instead.

op?

optional op: FocusOp | PutOp | MoveOp

Defined in: packages/types/src/presence.ts:64

---

PutOp

Defined in: packages/types/src/presence.ts:40

Anchored version of automerge’s PutPatch

Properties

action

action: "put"

Defined in: packages/types/src/presence.ts:41

conflict?

optional conflict: boolean

Defined in: packages/types/src/presence.ts:44

path

path: AnchoredPath

Defined in: packages/types/src/presence.ts:42

value

value: JsonValue

Defined in: packages/types/src/presence.ts:43

---

Client

Client = string

Defined in: packages/types/src/presence.ts:18

Client identifier in npm format: name@version or name#commit (e.g. "my-plugin@1.0.0", "@garbo-succus/probability-nz#c0mM1t").

---

Color

Color = string

Defined in: packages/types/src/presence.ts:11

Any valid CSS color string (e.g. "red", "#abc", "rgb(0,0,0)").

Advanced

GameManifest

Defined in: packages/types/src/doc.ts:149

Static game definition — imported to create a new GameState. Similar to a GameState but with a scenarios array on the root instead of children.

Example

// 2-4 and 4-8 player scenarios
{
  "$schema": "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json",
  "templates": { "token": { "src": "token.glb" } },
  "scenarios": [
    {
      "name": "2-4 player setup",
      "children": [
        {
          "name": "Game board",
          "src": "gameboard.glb",
          "children": [
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" }
          ]
        }
      ]
    },
    {
      "name": "4-8 player setup",
      "children": [
        {
          "name": "Game board",
          "src": "gameboard.glb",
          "children": [
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" },
            { "template": "token" }
          ]
        }
      ]
    }
  ]
}

Properties

$schema

$schema: "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json"

Defined in: packages/types/src/doc.ts:150

scenarios

scenarios: Scenario[]

Defined in: packages/types/src/doc.ts:152

templates

templates: Templates

Defined in: packages/types/src/doc.ts:151

---

Scenario

Defined in: packages/types/src/doc.ts:95

A named starting arrangement of pieces

Properties

children

children: Piece[]

Defined in: packages/types/src/doc.ts:97

name?

optional name: string

Defined in: packages/types/src/doc.ts:96

---

Vector3Tuple

Vector3Tuple = [number, number, number]

Defined in: packages/types/src/doc.ts:8

[x, y, z] — right-handed Y-up coordinate system (from Three.js).

Type Aliases

AnchoredPath

AnchoredPath = [string, ...Prop[]]

Defined in: packages/types/src/presence.ts:25

A path anchored to a specific Automerge object. First element is always an ObjID string.

Example

`["2@abc123", "children", 0, "position"]`

---

AutomergeUrl

AutomergeUrl = RepoAutomergeUrl & `automerge:${string}`

Defined in: packages/types/src/hashroute.ts:4

Automerge document URL (e.g. automerge:111111111111111111).

---

JsonValue

JsonValue = string | number | boolean | null | JsonArray | JsonObject

Defined in: packages/types/src/hashroute.ts:15

JSON-serializable value

---

Prop

Prop = string | number

Defined in: node_modules/.pnpm/@automerge+automerge@3.2.4/node_modules/@automerge/automerge/dist/wasm_types.d.ts:8

Variables

SCHEMA_URL

const SCHEMA_URL: "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json" = "https://registry.probability.nz/npm/@probability-nz/types/-/types-0.0.0.tgz/dist/analog.json"

Defined in: packages/types/src/doc.ts:1