2D physics types

Read as Markdown

Import these contracts with type from @pibbl/core/physics/2d. The pure geometry subset is also available from @pibbl/core/physics/2d/geometry. For composition recipes, see the 2D physics guide.

Geometry

`PibblPhysicsVector2`

Readonly [x, y] coordinates.

`PibblPhysicsPose2D`

A position and Canvas-compatible rotationDegrees; transform is the pose alias used by pure shape transformation.

`PibblPhysicsTransform2D`

Alias of PibblPhysicsPose2D used by transformShape2D.

`PibblPhysicsAabb2D`

Readonly minimum and maximum vector bounds.

`PibblPhysicsRay2D`

Origin, non-zero direction, and non-negative maximum distance.

`PibblPhysicsShape2D`

Nominal immutable descriptor made by a public shape factory. Its structure is opaque; do not create one with an object literal.

`PibblPhysicsMassProperties2D`

Area, centroid, mass, and rotational inertia for a shape and density.

`PibblPhysicsDistance2D`

Signed separation, closest points, and a normal from the second shape toward the first.

`PibblPhysicsContactPoint2D`

Witness points with separation, and an overlap manifold with a second-to-first normal and one or more points.

`PibblPhysicsShapeContact2D`

The overlap manifold returned by pure contact queries: a normal and readonly contact points.

`PibblPhysicsShapeHit2D`

Ray or shape-cast point, normal, distance, and normalized time of impact.

World, descriptors, and handles

`PibblPhysicsWorld2DProps`

Signal-aware PhysicsWorld2D input: creation-only coordinate space, gravity, fixed step, catch-up cap, interpolation, sleeping, solver settings, sleep and wake handlers, error handler, and children. space is "root" or creation-only "local".

`PibblPhysicsSolverOptions`

Reactive 1-through-32 iteration counts. Legacy public velocityIterations maps to Rapier numSolverIterations; positionIterations maps to numInternalPgsIterations.

`PibblPhysicsWorldHandle2D`

Nominal pibblPhysicsWorld2D() result with a readonly revision signal.

`PibblPhysicsAttachment2D`

Nominal values accepted by a Pibbl physics prop. Create them with descriptor functions, never object literals.

`PibblPhysicsBodyAttachment2D`

Nominal body attachment made by dynamicBody2D, staticBody2D, or kinematicBody2D.

`PibblPhysicsColliderAttachment2D`

Nominal collider attachment made by collider2D.

`PibblPhysicsDynamicBody2DOptions`

Dynamic configuration: enabled state, supplied handle, initial velocities, damping, gravity scale, automatic or explicit mass, fixed rotation, sleep, CCD, re-enable velocity mode, and optional inline collider.

`PibblPhysicsStaticBody2DOptions`

Static enabled state, supplied handle, and optional inline collider.

`PibblPhysicsKinematicBody2DOptions`

Kinematic configuration with optional position and rotation signals. Targets are sampled by Pibbl’s shared scheduler.

`PibblPhysicsKinematicTarget2D`

Optional readonly position and rotation signal targets for a kinematic body.

`PibblPhysicsColliderConfiguration2D`

Supplied or inferred shape, local offset and rotation, density, friction, restitution, sensor flag, mass contribution, filtering, tag, and event callbacks.

`PibblPhysicsCollisionFilter`

Category, mask, and group values that determine eligible interactions and queries.

`PibblPhysicsBodyHandle2D`

Stable endpoint with readonly signals for pose, linear and angular velocity, sleeping, enabled state, and generation.

`PibblPhysicsColliderHandle2D`

Nominal identity used in query filtering and returned records.

Query and event contracts

`PibblPhysicsQueryOptions2D`

Sensor, collision-filter, and body/collider-exclusion input for a world query.

`PibblPhysicsQueryHit2D`

Committed-world records with body and collider handles, generations, and the arbitrary collider tag. A hit also carries cast geometry.

`PibblPhysicsQueryMatch2D`

Committed overlap or point-query record with endpoint handles, generations, and original tag.

`PibblPhysicsCollisionEvent2D`

Solid-contact callback data: both endpoints, second-to-self normal, contact points, total normal impulse, tick, and tags.

`PibblPhysicsCollisionHandler2D`

Callback accepting a PibblPhysicsCollisionEvent2D.

`PibblPhysicsOverlapEvent2D`

Sensor-overlap callback data: both endpoints, tick, and tags.

`PibblPhysicsOverlapHandler2D`

Callback accepting a PibblPhysicsOverlapEvent2D.

`PibblPhysicsHitHandler2D`

Collision-event callback for contact impacts.

`PibblPhysicsBodyStateEvent2D`

Sleep or wake notification with body, sleeping state, and simulation tick.

`PibblPhysicsBodyStateHandler2D`

Callback accepting a PibblPhysicsBodyStateEvent2D.

Inspection and debug drawing

`PibblPhysicsInspection2D`

Immutable JSON-safe world observation: engine identity, coordinate space, revision, tick, advance/failure state, bodies, colliders, and contacts. It is not a serialization or restore format.

`PibblPhysicsBodyInspection2D`

Body identity, generation, type, enabled and sleeping state, simulation and presentation poses, center of mass, velocities, and applicable mass.

`PibblPhysicsColliderInspection2D`

Collider and owner identities, sensor state, serializable string label, shape kinds, and committed bounds.

`PibblPhysicsContactInspection2D`

Collider identities, sensor state, second-to-first normal, points, and normal impulse.

`PibblPhysicsDebug2DProps`

Input for PhysicsDebug2D: required world handle and optional Canvas color. The overlay is read-only and has no pointer target.

Canvas shape inputs

`PibblPhysicsPrimitiveProps2D`

Shared event, keyboard, and physics props for physics-aware primitives.

`PhysicsShape2DProps`

Props and style for a supplied shape. Style requires shape, supports normal Canvas system, paint, cursor, box, and layout fields, plus interaction width.

`PhysicsShape2DStyle`

The specified style input for PhysicsShape2D.

`Capsule2DProps`

Props and style for start, end, and positive radius.

`Capsule2DStyle`

Specified Canvas and capsule geometry style for Capsule2D.

`Segment2DProps`

Props and stroked segment style with endpoints and interaction width; no fill.

`Segment2DStyle`

Specified stroked Canvas style and endpoint geometry for Segment2D.

`Chain2DProps`

Props and style for points, optional closure, non-negative radius, and interaction width.

`Chain2DStyle`

Specified Canvas and chain geometry style for Chain2D.

API details from source

PibblPhysicsCollisionFilter

Category, mask, and group values controlling eligible collision pairs.

interface PibblPhysicsCollisionFilter

Related API: PibblPhysicsCollisionFilter.

Properties and methods

category (optional)

readonly category?: number | undefined

Category bits identifying this collider for collision filtering. See PibblPhysicsCollisionFilter.

View source — packages/core/src/features/physics/lib/2d/types.ts:34

mask (optional)

readonly mask?: number | undefined

Category bits this collider is permitted to collide with. See PibblPhysicsCollisionFilter.

View source — packages/core/src/features/physics/lib/2d/types.ts:36

group (optional)

readonly group?: number | undefined

Signed group override used when filtering a collider pair. See PibblPhysicsCollisionFilter.

View source — packages/core/src/features/physics/lib/2d/types.ts:38

PibblPhysicsCollisionHandler2D

Receives a collision-start or collision-end event for a collider.

type PibblPhysicsCollisionHandler2D = (
  event: PibblPhysicsCollisionEvent2D,
) => void

Parameters

event — Collision pair and contact information for this notification. See PibblPhysicsCollisionEvent2D .

PibblPhysicsHitHandler2D

Receives contact impulse information for a collider hit.

type PibblPhysicsHitHandler2D = (
  event: PibblPhysicsCollisionEvent2D,
) => void

Parameters

event — Collision pair and contact information for this notification. See PibblPhysicsCollisionEvent2D .

PibblPhysicsOverlapHandler2D

Receives sensor overlap-start or overlap-end notifications.

type PibblPhysicsOverlapHandler2D = (
  event: PibblPhysicsOverlapEvent2D,
) => void

Parameters

event — Sensor overlap pair and overlap lifecycle information. See PibblPhysicsOverlapEvent2D .

PibblPhysicsBodyStateHandler2D

Receives body sleeping-state changes at a simulation tick.

type PibblPhysicsBodyStateHandler2D = (
  event: PibblPhysicsBodyStateEvent2D,
) => void

Parameters

event — Body state change notification. See PibblPhysicsBodyStateEvent2D.

PibblPhysicsColliderConfiguration2D

Shape, material, mass contribution, filtering, tags, and callbacks for a collider attachment.

interface PibblPhysicsColliderConfiguration2D

Properties and methods

shape (optional)

readonly shape?: "self" | PibblPhysicsShape2D | undefined

Related API: PibblPhysicsShape2D.

Immutable collision geometry or particle spawn shape. See PibblPhysicsShape2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:100

offset (optional)

readonly offset?: PibblPhysicsVector2 | undefined

Related API: PibblPhysicsVector2.

Collider displacement relative to its owning body. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:102

rotationDegrees (optional)

readonly rotationDegrees?: number | undefined

Rotation in degrees. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:104

density (optional)

readonly density?: number | undefined

Mass per unit area used to derive automatic mass properties. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:109

friction (optional)

readonly friction?: number | undefined

Contact friction coefficient. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:111

restitution (optional)

readonly restitution?: number | undefined

Contact restitution coefficient controlling bounce. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:116

sensor (optional)

readonly sensor?: boolean | undefined

Whether the collider reports overlaps instead of producing contact response. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:121

contributesToMass (optional)

readonly contributesToMass?: boolean | undefined

Whether this collider contributes to its body’s automatic mass properties. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:126

collisionFilter (optional)

readonly collisionFilter?: PibblPhysicsCollisionFilter | undefined

Related API: PibblPhysicsCollisionFilter.

Category, mask, and group filtering for collision or query participation. See PibblPhysicsCollisionFilter.

View source — packages/core/src/features/physics/lib/2d/types.ts:131

tag (optional)

readonly tag?: unknown

Application payload carried through physics queries and events. See PibblPhysicsColliderConfiguration2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:136

onCollisionStart (optional)

readonly onCollisionStart?: PibblPhysicsCollisionHandler2D | undefined

Related API: PibblPhysicsCollisionHandler2D.

Receives the start of a contact pair involving this collider. See PibblPhysicsCollisionHandler2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:141

onCollisionEnd (optional)

readonly onCollisionEnd?: PibblPhysicsCollisionHandler2D | undefined

Related API: PibblPhysicsCollisionHandler2D.

Receives the end of a contact pair involving this collider. See PibblPhysicsCollisionHandler2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:146

onHit (optional)

readonly onHit?: PibblPhysicsHitHandler2D | undefined

Related API: PibblPhysicsHitHandler2D.

Receives contact impulse information for this collider. See PibblPhysicsHitHandler2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:148

onOverlapStart (optional)

readonly onOverlapStart?: PibblPhysicsOverlapHandler2D | undefined

Related API: PibblPhysicsOverlapHandler2D.

Receives the start of a sensor overlap involving this collider. See PibblPhysicsOverlapHandler2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:153

onOverlapEnd (optional)

readonly onOverlapEnd?: PibblPhysicsOverlapHandler2D | undefined

Related API: PibblPhysicsOverlapHandler2D.

Receives the end of a sensor overlap involving this collider. See PibblPhysicsOverlapHandler2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:158

PibblPhysicsDynamicBody2DOptions

Initial motion, mass, damping, gravity, sleeping, and collider configuration of a dynamic body.

interface PibblPhysicsDynamicBody2DOptions

Related API: PibblPhysicsDynamicBody2DOptions.

Properties and methods

enabled (optional)

readonly enabled?: boolean | undefined

Whether this operation or resource participates in updates. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:175

handle (optional)

readonly handle?: PibblPhysicsBodyHandle2D | undefined

Related API: PibblPhysicsBodyHandle2D.

Handle identity associated with the operation or body. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:177

linearVelocity (optional)

readonly linearVelocity?: PibblPhysicsVector2 | undefined

Related API: PibblPhysicsVector2.

Linear velocity in the simulation coordinate system per second. See PibblPhysicsVector2 .

View source — packages/core/src/features/physics/lib/2d/types.ts:182

angularVelocityDegreesPerSecond (optional)

readonly angularVelocityDegreesPerSecond?: number | undefined

Angular velocity in degrees per second. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:184

linearDamping (optional)

readonly linearDamping?: number | undefined

Damping applied to linear motion. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:186

angularDamping (optional)

readonly angularDamping?: number | undefined

Damping applied to angular motion. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:188

gravityScale (optional)

readonly gravityScale?: number | undefined

Multiplier applied to world gravity for this body. See PibblPhysicsDynamicBody2DOptions .

View source — packages/core/src/features/physics/lib/2d/types.ts:193

mass (optional)

readonly mass?: number | "auto" | undefined

Mass used by the spring or physics calculation. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:195

fixedRotation (optional)

readonly fixedRotation?: boolean | undefined

Whether angular motion is locked. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:197

allowSleep (optional)

readonly allowSleep?: boolean | undefined

Whether the body may enter the sleeping state. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:199

ccd (optional)

readonly ccd?: boolean | undefined

Whether continuous collision detection is enabled for the body. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:204

reenableVelocity (optional)

readonly reenableVelocity?: "preserve" | "zero" | undefined

Whether re-enabling restores or clears the body’s velocity. See PibblPhysicsDynamicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:209

collider (optional)

readonly collider?: false | PibblPhysicsColliderConfiguration2D | PibblPhysicsShape2D | undefined

Collider configuration or identity associated with this body or query. See PibblPhysicsColliderConfiguration2D, PibblPhysicsShape2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:214

PibblPhysicsStaticBody2DOptions

Enablement, handle, and collider configuration of a static body.

interface PibblPhysicsStaticBody2DOptions

Related API: PibblPhysicsStaticBody2DOptions.

Properties and methods

enabled (optional)

readonly enabled?: boolean | undefined

Whether this operation or resource participates in updates. See PibblPhysicsStaticBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:230

handle (optional)

readonly handle?: PibblPhysicsBodyHandle2D | undefined

Related API: PibblPhysicsBodyHandle2D.

Handle identity associated with the operation or body. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:232

collider (optional)

readonly collider?: false | PibblPhysicsColliderConfiguration2D | PibblPhysicsShape2D | undefined

Collider configuration or identity associated with this body or query. See PibblPhysicsColliderConfiguration2D, PibblPhysicsShape2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:237

PibblPhysicsKinematicTarget2D

Reactive position and rotation targets for a kinematic body.

interface PibblPhysicsKinematicTarget2D

Related API: PibblPhysicsKinematicTarget2D.

Properties and methods

position (optional)

readonly position?: Signal<PibblPhysicsVector2> | undefined

Related API: Signal, PibblPhysicsVector2.

Position of the geometry, source, or selected resize handle. See Signal, PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:252

rotationDegrees (optional)

readonly rotationDegrees?: Signal<number> | undefined

Related API: Signal.

Rotation in degrees. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:254

PibblPhysicsKinematicBody2DOptions

Target signals, handle, enablement, and collider configuration of a kinematic body.

interface PibblPhysicsKinematicBody2DOptions

Properties and methods

enabled (optional)

readonly enabled?: boolean | undefined

Whether this operation or resource participates in updates. See PibblPhysicsKinematicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:271

handle (optional)

readonly handle?: PibblPhysicsBodyHandle2D | undefined

Related API: PibblPhysicsBodyHandle2D.

Handle identity associated with the operation or body. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:273

target (optional)

readonly target?: PibblPhysicsKinematicTarget2D | undefined

Related API: PibblPhysicsKinematicTarget2D.

The selected logical target or target configuration. See PibblPhysicsKinematicTarget2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:277

allowSleep (optional)

readonly allowSleep?: boolean | undefined

Whether the body may enter the sleeping state. See PibblPhysicsKinematicBody2DOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:281

collider (optional)

readonly collider?: false | PibblPhysicsColliderConfiguration2D | PibblPhysicsShape2D | undefined

Collider configuration or identity associated with this body or query. See PibblPhysicsColliderConfiguration2D, PibblPhysicsShape2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:286

PibblPhysicsBodyAttachment2D

A branded body descriptor attached to supported Canvas primitives.

interface PibblPhysicsBodyAttachment2D

Related API: PibblPhysicsBodyAttachment2D.

PibblPhysicsColliderAttachment2D

A branded collider descriptor attached under a physics body.

interface PibblPhysicsColliderAttachment2D

Related API: PibblPhysicsColliderAttachment2D.

PibblPhysicsAttachment2D

A body or collider descriptor accepted by a physics-aware primitive.

type PibblPhysicsAttachment2D = PibblPhysicsBodyAttachment2D | PibblPhysicsColliderAttachment2D

PibblPhysicsSolverOptions

Iteration budgets controlling the 2D solver’s velocity and position work.

interface PibblPhysicsSolverOptions

Related API: PibblPhysicsSolverOptions.

Properties and methods

velocityIterations (optional)

readonly velocityIterations?: number | undefined

Solver iteration budget for velocity constraints. See PibblPhysicsSolverOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:332

positionIterations (optional)

readonly positionIterations?: number | undefined

Solver iteration budget for position constraints. See PibblPhysicsSolverOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:334

PibblPhysicsWorld2DProps

World configuration with signal-capable values and ordinary Pibbl children.

type PibblPhysicsWorld2DProps = {
  readonly [K in keyof PibblPhysicsWorld2DValues]: K extends "children"
    ? PibblPhysicsWorld2DValues[K]
    : SignalValue<PibblPhysicsWorld2DValues[K]>;
}

Related API: PibblPhysicsWorld2DProps, SignalValue.

Properties and methods

space (optional)

readonly space?: SignalValue<"local" | "root" | undefined>

Related API: SignalValue.

Local space follows the world component viewport; root preserves root-logical coordinates. Creation-only.

View source — packages/core/src/features/physics/lib/2d/types.ts:342

gravity (optional)

readonly gravity?: SignalValue<PibblPhysicsVector2 | undefined>

Related API: SignalValue, PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:343

fixedStepMilliseconds (optional)

readonly fixedStepMilliseconds?: SignalValue<number | undefined>

Related API: SignalValue.

View source — packages/core/src/features/physics/lib/2d/types.ts:344

maxCatchUpSteps (optional)

readonly maxCatchUpSteps?: SignalValue<number | undefined>

Related API: SignalValue.

View source — packages/core/src/features/physics/lib/2d/types.ts:345

interpolation (optional)

readonly interpolation?: SignalValue<"linear" | "none" | undefined>

Related API: SignalValue.

View source — packages/core/src/features/physics/lib/2d/types.ts:346

sleeping (optional)

readonly sleeping?: SignalValue<boolean | undefined>

Related API: SignalValue.

View source — packages/core/src/features/physics/lib/2d/types.ts:347

solver (optional)

readonly solver?: SignalValue<PibblPhysicsSolverOptions | undefined>

Related API: SignalValue, PibblPhysicsSolverOptions.

View source — packages/core/src/features/physics/lib/2d/types.ts:348

onSleep (optional)

readonly onSleep?: SignalValue<PibblPhysicsBodyStateHandler2D | undefined>

View source — packages/core/src/features/physics/lib/2d/types.ts:349

onWake (optional)

readonly onWake?: SignalValue<PibblPhysicsBodyStateHandler2D | undefined>

View source — packages/core/src/features/physics/lib/2d/types.ts:350

onError (optional)

readonly onError?: SignalValue<((error: unknown) => void) | undefined>

Related API: SignalValue.

View source — packages/core/src/features/physics/lib/2d/types.ts:351

children (optional)

readonly children?: PibblNodeInput

Related API: PibblNodeInput.

View source — packages/core/src/features/physics/lib/2d/types.ts:352

PibblPhysicsPrimitiveProps2D

Interaction and physics attachment props shared by physics-aware primitives.

interface PibblPhysicsPrimitiveProps2D extends PibblEventHandlers, PibblEventParticipationOptions

Properties and methods

keyboardFocusable (optional)

readonly keyboardFocusable?: boolean | undefined

Whether the target may receive keyboard focus. See PibblPhysicsPrimitiveProps2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:381

keyboardNavigationBounds (optional)

readonly keyboardNavigationBounds?: Readonly<LayoutBox> | undefined

Related API: LayoutBox.

Logical rectangle used for directional keyboard navigation. See LayoutBox.

View source — packages/core/src/features/physics/lib/2d/types.ts:383

physics (optional)

readonly physics?: PibblPhysicsAttachment2D | undefined

Related API: PibblPhysicsAttachment2D.

Declarative body or collider attachment for this primitive. See PibblPhysicsAttachment2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:388

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

PhysicsShape2DProps

Authored inputs for PhysicsShape2D, including the declared data and presentation options.

interface PhysicsShape2DProps extends PibblPhysicsPrimitiveProps2D

Properties and methods

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

keyboardFocusable (optional)

readonly keyboardFocusable?: boolean | undefined

Whether the target may receive keyboard focus. See PibblPhysicsPrimitiveProps2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:381

keyboardNavigationBounds (optional)

readonly keyboardNavigationBounds?: Readonly<LayoutBox> | undefined

Related API: LayoutBox.

Logical rectangle used for directional keyboard navigation. See LayoutBox.

View source — packages/core/src/features/physics/lib/2d/types.ts:383

physics (optional)

readonly physics?: PibblPhysicsAttachment2D | undefined

Related API: PibblPhysicsAttachment2D.

Declarative body or collider attachment for this primitive. See PibblPhysicsAttachment2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:388

PhysicsShape2DStyle

Supported geometry and presentation properties for PhysicsShape2D.

interface PhysicsShape2DStyle extends SystemStyle, PaintStyle, CursorStyle, BoxStyle, LayoutItemStyle

Properties and methods

shape

readonly shape: PibblPhysicsShape2D

Related API: PibblPhysicsShape2D.

Immutable collision geometry or particle spawn shape. See PibblPhysicsShape2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:412

lineInteractionWidth (optional)

readonly lineInteractionWidth?: number | undefined

Width used for line hit testing independently of the visible stroke width. See PhysicsShape2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:417

left (optional)

left?: number | `${number}%` | undefined

Left edge coordinate or inset. See Length.

View source — packages/core/src/lib/style/positioning.ts:127

top (optional)

top?: number | `${number}%` | undefined

Top edge value or top envelope guide. See Length.

View source — packages/core/src/lib/style/positioning.ts:129

width (optional)

width?: Length | undefined

Related API: Length.

Horizontal extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:81

height (optional)

height?: Length | undefined

Related API: Length.

Vertical extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:83

minWidth (optional)

minWidth?: number | `${number}%` | undefined

Minimum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:85

maxWidth (optional)

maxWidth?: number | `${number}%` | undefined

Maximum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:87

minHeight (optional)

minHeight?: number | `${number}%` | undefined

Minimum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:89

maxHeight (optional)

maxHeight?: number | `${number}%` | undefined

Maximum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:91

padding (optional)

padding?: EdgeValues | undefined

Related API: EdgeValues.

Insets between the border box and content box. See EdgeValues.

View source — packages/core/src/lib/style/types.ts:93

overflow (optional)

overflow?: "clip" | "visible" | undefined

Selects "visible", "clip" for overflow. See BoxStyle.

View source — packages/core/src/lib/style/types.ts:95

alignSelf (optional)

alignSelf?: "auto" | "center" | "end" | "flex-end" | "flex-start" | "start" | "stretch" | undefined

This child’s cross-axis or block-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:121

justifySelf (optional)

justifySelf?: "auto" | "center" | "end" | "start" | "stretch" | undefined

This child’s inline-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:123

flexBasis (optional)

flexBasis?: Length | undefined

Related API: Length.

Initial main-axis size before flex growth or shrinkage. See Length.

View source — packages/core/src/lib/style/types.ts:125

flexGrow (optional)

flexGrow?: number | undefined

Relative share of positive free space assigned to this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:127

flexShrink (optional)

flexShrink?: number | undefined

Relative factor used when reducing main-axis size. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:129

gridColumnStart (optional)

gridColumnStart?: number | undefined

Explicit starting grid column. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:131

gridColumnSpan (optional)

gridColumnSpan?: number | undefined

Number of columns occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:133

gridRowStart (optional)

gridRowStart?: number | undefined

Explicit starting grid row. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:135

gridRowSpan (optional)

gridRowSpan?: number | undefined

Number of rows occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:137

fill (optional)

fill?: FillStyle | undefined

Related API: FillStyle.

Paint used for the interior. See FillStyle.

View source — packages/core/src/lib/style/types.ts:193

stroke (optional)

stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/lib/style/types.ts:195

strokeWidth (optional)

strokeWidth?: number | undefined

Width of the painted outline. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:197

opacity (optional)

opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:199

cursor (optional)

cursor?: string | undefined

Cursor shown while this target owns pointer presentation. See CursorStyle.

View source — packages/core/src/lib/style/types.ts:212

transition (optional)

transition?: PibblTransitionBinding | undefined

Related API: PibblTransitionBinding.

Visibility-transition binding applied to this primitive and its captured descendants. See SystemStyle.

View source — packages/core/src/lib/types.ts:69

custom (optional)

custom?: unknown

Application-defined style payload passed through the runtime. See SystemStyle.

View source — packages/core/src/lib/types.ts:71

filter (optional)

filter?: PibblFilter | readonly PibblFilter[] | undefined

Related API: PibblFilter.

Ordered pixel-only filters applied to the receiving primitive and its descendants. See PibblFilter.

View source — packages/core/src/lib/types.ts:76

Capsule2DProps

Authored inputs for Capsule2D, including the declared data and presentation options.

interface Capsule2DProps extends PibblPhysicsPrimitiveProps2D

Properties and methods

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

keyboardFocusable (optional)

readonly keyboardFocusable?: boolean | undefined

Whether the target may receive keyboard focus. See PibblPhysicsPrimitiveProps2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:381

keyboardNavigationBounds (optional)

readonly keyboardNavigationBounds?: Readonly<LayoutBox> | undefined

Related API: LayoutBox.

Logical rectangle used for directional keyboard navigation. See LayoutBox.

View source — packages/core/src/features/physics/lib/2d/types.ts:383

physics (optional)

readonly physics?: PibblPhysicsAttachment2D | undefined

Related API: PibblPhysicsAttachment2D.

Declarative body or collider attachment for this primitive. See PibblPhysicsAttachment2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:388

Capsule2DStyle

Supported geometry and presentation properties for Capsule2D.

interface Capsule2DStyle extends SystemStyle, PaintStyle, CursorStyle, BoxStyle, LayoutItemStyle

Properties and methods

start

readonly start: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

First endpoint of the shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:441

end

readonly end: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Last endpoint of the shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:443

radius

readonly radius: number

Radius in the coordinate system of this geometry or effect. See Capsule2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:445

lineInteractionWidth (optional)

readonly lineInteractionWidth?: number | undefined

Width used for line hit testing independently of the visible stroke width. See Capsule2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:450

left (optional)

left?: number | `${number}%` | undefined

Left edge coordinate or inset. See Length.

View source — packages/core/src/lib/style/positioning.ts:127

top (optional)

top?: number | `${number}%` | undefined

Top edge value or top envelope guide. See Length.

View source — packages/core/src/lib/style/positioning.ts:129

width (optional)

width?: Length | undefined

Related API: Length.

Horizontal extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:81

height (optional)

height?: Length | undefined

Related API: Length.

Vertical extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:83

minWidth (optional)

minWidth?: number | `${number}%` | undefined

Minimum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:85

maxWidth (optional)

maxWidth?: number | `${number}%` | undefined

Maximum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:87

minHeight (optional)

minHeight?: number | `${number}%` | undefined

Minimum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:89

maxHeight (optional)

maxHeight?: number | `${number}%` | undefined

Maximum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:91

padding (optional)

padding?: EdgeValues | undefined

Related API: EdgeValues.

Insets between the border box and content box. See EdgeValues.

View source — packages/core/src/lib/style/types.ts:93

overflow (optional)

overflow?: "clip" | "visible" | undefined

Selects "visible", "clip" for overflow. See BoxStyle.

View source — packages/core/src/lib/style/types.ts:95

alignSelf (optional)

alignSelf?: "auto" | "center" | "end" | "flex-end" | "flex-start" | "start" | "stretch" | undefined

This child’s cross-axis or block-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:121

justifySelf (optional)

justifySelf?: "auto" | "center" | "end" | "start" | "stretch" | undefined

This child’s inline-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:123

flexBasis (optional)

flexBasis?: Length | undefined

Related API: Length.

Initial main-axis size before flex growth or shrinkage. See Length.

View source — packages/core/src/lib/style/types.ts:125

flexGrow (optional)

flexGrow?: number | undefined

Relative share of positive free space assigned to this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:127

flexShrink (optional)

flexShrink?: number | undefined

Relative factor used when reducing main-axis size. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:129

gridColumnStart (optional)

gridColumnStart?: number | undefined

Explicit starting grid column. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:131

gridColumnSpan (optional)

gridColumnSpan?: number | undefined

Number of columns occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:133

gridRowStart (optional)

gridRowStart?: number | undefined

Explicit starting grid row. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:135

gridRowSpan (optional)

gridRowSpan?: number | undefined

Number of rows occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:137

fill (optional)

fill?: FillStyle | undefined

Related API: FillStyle.

Paint used for the interior. See FillStyle.

View source — packages/core/src/lib/style/types.ts:193

stroke (optional)

stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/lib/style/types.ts:195

strokeWidth (optional)

strokeWidth?: number | undefined

Width of the painted outline. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:197

opacity (optional)

opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:199

cursor (optional)

cursor?: string | undefined

Cursor shown while this target owns pointer presentation. See CursorStyle.

View source — packages/core/src/lib/style/types.ts:212

transition (optional)

transition?: PibblTransitionBinding | undefined

Related API: PibblTransitionBinding.

Visibility-transition binding applied to this primitive and its captured descendants. See SystemStyle.

View source — packages/core/src/lib/types.ts:69

custom (optional)

custom?: unknown

Application-defined style payload passed through the runtime. See SystemStyle.

View source — packages/core/src/lib/types.ts:71

filter (optional)

filter?: PibblFilter | readonly PibblFilter[] | undefined

Related API: PibblFilter.

Ordered pixel-only filters applied to the receiving primitive and its descendants. See PibblFilter.

View source — packages/core/src/lib/types.ts:76

Segment2DProps

Authored inputs for Segment2D, including the declared data and presentation options.

interface Segment2DProps extends PibblPhysicsPrimitiveProps2D

Properties and methods

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

keyboardFocusable (optional)

readonly keyboardFocusable?: boolean | undefined

Whether the target may receive keyboard focus. See PibblPhysicsPrimitiveProps2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:381

keyboardNavigationBounds (optional)

readonly keyboardNavigationBounds?: Readonly<LayoutBox> | undefined

Related API: LayoutBox.

Logical rectangle used for directional keyboard navigation. See LayoutBox.

View source — packages/core/src/features/physics/lib/2d/types.ts:383

physics (optional)

readonly physics?: PibblPhysicsAttachment2D | undefined

Related API: PibblPhysicsAttachment2D.

Declarative body or collider attachment for this primitive. See PibblPhysicsAttachment2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:388

Segment2DStyle

Supported geometry and presentation properties for Segment2D.

interface Segment2DStyle extends SystemStyle, Omit<PaintStyle, "fill">, CursorStyle, BoxStyle, LayoutItemStyle

Properties and methods

start

readonly start: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

First endpoint of the shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:474

end

readonly end: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Last endpoint of the shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:476

lineInteractionWidth (optional)

readonly lineInteractionWidth?: number | undefined

Width used for line hit testing independently of the visible stroke width. See Segment2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:481

left (optional)

left?: number | `${number}%` | undefined

Left edge coordinate or inset. See Length.

View source — packages/core/src/lib/style/positioning.ts:127

top (optional)

top?: number | `${number}%` | undefined

Top edge value or top envelope guide. See Length.

View source — packages/core/src/lib/style/positioning.ts:129

width (optional)

width?: Length | undefined

Related API: Length.

Horizontal extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:81

height (optional)

height?: Length | undefined

Related API: Length.

Vertical extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:83

minWidth (optional)

minWidth?: number | `${number}%` | undefined

Minimum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:85

maxWidth (optional)

maxWidth?: number | `${number}%` | undefined

Maximum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:87

minHeight (optional)

minHeight?: number | `${number}%` | undefined

Minimum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:89

maxHeight (optional)

maxHeight?: number | `${number}%` | undefined

Maximum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:91

padding (optional)

padding?: EdgeValues | undefined

Related API: EdgeValues.

Insets between the border box and content box. See EdgeValues.

View source — packages/core/src/lib/style/types.ts:93

overflow (optional)

overflow?: "clip" | "visible" | undefined

Selects "visible", "clip" for overflow. See BoxStyle.

View source — packages/core/src/lib/style/types.ts:95

alignSelf (optional)

alignSelf?: "auto" | "center" | "end" | "flex-end" | "flex-start" | "start" | "stretch" | undefined

This child’s cross-axis or block-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:121

justifySelf (optional)

justifySelf?: "auto" | "center" | "end" | "start" | "stretch" | undefined

This child’s inline-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:123

flexBasis (optional)

flexBasis?: Length | undefined

Related API: Length.

Initial main-axis size before flex growth or shrinkage. See Length.

View source — packages/core/src/lib/style/types.ts:125

flexGrow (optional)

flexGrow?: number | undefined

Relative share of positive free space assigned to this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:127

flexShrink (optional)

flexShrink?: number | undefined

Relative factor used when reducing main-axis size. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:129

gridColumnStart (optional)

gridColumnStart?: number | undefined

Explicit starting grid column. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:131

gridColumnSpan (optional)

gridColumnSpan?: number | undefined

Number of columns occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:133

gridRowStart (optional)

gridRowStart?: number | undefined

Explicit starting grid row. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:135

gridRowSpan (optional)

gridRowSpan?: number | undefined

Number of rows occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:137

stroke (optional)

stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/lib/style/types.ts:195

strokeWidth (optional)

strokeWidth?: number | undefined

Width of the painted outline. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:197

opacity (optional)

opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:199

cursor (optional)

cursor?: string | undefined

Cursor shown while this target owns pointer presentation. See CursorStyle.

View source — packages/core/src/lib/style/types.ts:212

transition (optional)

transition?: PibblTransitionBinding | undefined

Related API: PibblTransitionBinding.

Visibility-transition binding applied to this primitive and its captured descendants. See SystemStyle.

View source — packages/core/src/lib/types.ts:69

custom (optional)

custom?: unknown

Application-defined style payload passed through the runtime. See SystemStyle.

View source — packages/core/src/lib/types.ts:71

filter (optional)

filter?: PibblFilter | readonly PibblFilter[] | undefined

Related API: PibblFilter.

Ordered pixel-only filters applied to the receiving primitive and its descendants. See PibblFilter.

View source — packages/core/src/lib/types.ts:76

Chain2DProps

Authored inputs for Chain2D, including the declared data and presentation options.

interface Chain2DProps extends PibblPhysicsPrimitiveProps2D

Properties and methods

pointerEvents (optional)

readonly pointerEvents?: PibblPointerEvents | undefined

Related API: PibblPointerEvents.

Whether this content participates in pointer targeting. See PibblPointerEvents.

View source — packages/core/src/lib/events/types.ts:126

keyboardFocusable (optional)

readonly keyboardFocusable?: boolean | undefined

Whether the target may receive keyboard focus. See PibblPhysicsPrimitiveProps2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:381

keyboardNavigationBounds (optional)

readonly keyboardNavigationBounds?: Readonly<LayoutBox> | undefined

Related API: LayoutBox.

Logical rectangle used for directional keyboard navigation. See LayoutBox.

View source — packages/core/src/features/physics/lib/2d/types.ts:383

physics (optional)

readonly physics?: PibblPhysicsAttachment2D | undefined

Related API: PibblPhysicsAttachment2D.

Declarative body or collider attachment for this primitive. See PibblPhysicsAttachment2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:388

Chain2DStyle

Supported geometry and presentation properties for Chain2D.

interface Chain2DStyle extends SystemStyle, PaintStyle, CursorStyle, BoxStyle, LayoutItemStyle

Properties and methods

points

readonly points: readonly PibblPhysicsVector2[]

Related API: PibblPhysicsVector2.

Points defining the geometry or reported by the contact query. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:507

closed (optional)

readonly closed?: boolean | undefined

Whether the point chain connects its last point back to its first. See Chain2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:511

radius (optional)

readonly radius?: number | undefined

Radius in the coordinate system of this geometry or effect. See Chain2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:513

lineInteractionWidth (optional)

readonly lineInteractionWidth?: number | undefined

Width used for line hit testing independently of the visible stroke width. See Chain2DStyle.

View source — packages/core/src/features/physics/lib/2d/types.ts:518

left (optional)

left?: number | `${number}%` | undefined

Left edge coordinate or inset. See Length.

View source — packages/core/src/lib/style/positioning.ts:127

top (optional)

top?: number | `${number}%` | undefined

Top edge value or top envelope guide. See Length.

View source — packages/core/src/lib/style/positioning.ts:129

width (optional)

width?: Length | undefined

Related API: Length.

Horizontal extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:81

height (optional)

height?: Length | undefined

Related API: Length.

Vertical extent in the units of the containing geometry or surface. See Length.

View source — packages/core/src/lib/style/types.ts:83

minWidth (optional)

minWidth?: number | `${number}%` | undefined

Minimum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:85

maxWidth (optional)

maxWidth?: number | `${number}%` | undefined

Maximum permitted width. See Length.

View source — packages/core/src/lib/style/types.ts:87

minHeight (optional)

minHeight?: number | `${number}%` | undefined

Minimum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:89

maxHeight (optional)

maxHeight?: number | `${number}%` | undefined

Maximum permitted height. See Length.

View source — packages/core/src/lib/style/types.ts:91

padding (optional)

padding?: EdgeValues | undefined

Related API: EdgeValues.

Insets between the border box and content box. See EdgeValues.

View source — packages/core/src/lib/style/types.ts:93

overflow (optional)

overflow?: "clip" | "visible" | undefined

Selects "visible", "clip" for overflow. See BoxStyle.

View source — packages/core/src/lib/style/types.ts:95

alignSelf (optional)

alignSelf?: "auto" | "center" | "end" | "flex-end" | "flex-start" | "start" | "stretch" | undefined

This child’s cross-axis or block-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:121

justifySelf (optional)

justifySelf?: "auto" | "center" | "end" | "start" | "stretch" | undefined

This child’s inline-axis alignment override. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:123

flexBasis (optional)

flexBasis?: Length | undefined

Related API: Length.

Initial main-axis size before flex growth or shrinkage. See Length.

View source — packages/core/src/lib/style/types.ts:125

flexGrow (optional)

flexGrow?: number | undefined

Relative share of positive free space assigned to this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:127

flexShrink (optional)

flexShrink?: number | undefined

Relative factor used when reducing main-axis size. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:129

gridColumnStart (optional)

gridColumnStart?: number | undefined

Explicit starting grid column. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:131

gridColumnSpan (optional)

gridColumnSpan?: number | undefined

Number of columns occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:133

gridRowStart (optional)

gridRowStart?: number | undefined

Explicit starting grid row. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:135

gridRowSpan (optional)

gridRowSpan?: number | undefined

Number of rows occupied by this child. See LayoutItemStyle.

View source — packages/core/src/lib/style/types.ts:137

fill (optional)

fill?: FillStyle | undefined

Related API: FillStyle.

Paint used for the interior. See FillStyle.

View source — packages/core/src/lib/style/types.ts:193

stroke (optional)

stroke?: StrokeStyle | undefined

Related API: StrokeStyle.

Paint used for the outline. See StrokeStyle.

View source — packages/core/src/lib/style/types.ts:195

strokeWidth (optional)

strokeWidth?: number | undefined

Width of the painted outline. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:197

opacity (optional)

opacity?: number | undefined

Related API: opacity.

Opacity of the painted result. See PaintStyle.

View source — packages/core/src/lib/style/types.ts:199

cursor (optional)

cursor?: string | undefined

Cursor shown while this target owns pointer presentation. See CursorStyle.

View source — packages/core/src/lib/style/types.ts:212

transition (optional)

transition?: PibblTransitionBinding | undefined

Related API: PibblTransitionBinding.

Visibility-transition binding applied to this primitive and its captured descendants. See SystemStyle.

View source — packages/core/src/lib/types.ts:69

custom (optional)

custom?: unknown

Application-defined style payload passed through the runtime. See SystemStyle.

View source — packages/core/src/lib/types.ts:71

filter (optional)

filter?: PibblFilter | readonly PibblFilter[] | undefined

Related API: PibblFilter.

Ordered pixel-only filters applied to the receiving primitive and its descendants. See PibblFilter.

View source — packages/core/src/lib/types.ts:76

PibblPhysicsBodyHandle2D

Stable body identity with committed reactive pose, velocity, sleeping, enablement, and generation.

interface PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Properties and methods

position

readonly position: Signal<PibblPhysicsVector2>

Related API: Signal, PibblPhysicsVector2.

Position of the geometry, source, or selected resize handle. See Signal, PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:537

rotationDegrees

readonly rotationDegrees: Signal<number>

Related API: Signal.

Rotation in degrees. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:539

linearVelocity

readonly linearVelocity: Signal<PibblPhysicsVector2>

Related API: Signal, PibblPhysicsVector2.

Linear velocity in the simulation coordinate system per second. See Signal, PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/types.ts:544

angularVelocityDegreesPerSecond

readonly angularVelocityDegreesPerSecond: Signal<number>

Related API: Signal.

Angular velocity in degrees per second. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:546

sleeping

readonly sleeping: Signal<boolean>

Related API: Signal.

Whether the body is currently sleeping. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:548

enabled

readonly enabled: Signal<boolean>

Related API: Signal.

Whether this operation or resource participates in updates. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:550

generation

readonly generation: Signal<number>

Related API: Signal.

Generation counter distinguishing successive bindings of a stable identity. See Signal .

View source — packages/core/src/features/physics/lib/2d/types.ts:555

PibblPhysicsColliderHandle2D

Stable opaque collider identity for filtering and query results.

interface PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

PibblPhysicsWorldHandle2D

Stable world identity with a reactive committed-state revision.

interface PibblPhysicsWorldHandle2D

Related API: PibblPhysicsWorldHandle2D.

Properties and methods

revision

readonly revision: Signal<number>

Related API: Signal.

Revision used to detect changes to the underlying state or geometry. See Signal.

View source — packages/core/src/features/physics/lib/2d/types.ts:582

PibblPhysicsQueryOptions2D

Sensor policy, collision filtering, and body/collider exclusions for world queries.

interface PibblPhysicsQueryOptions2D

Related API: PibblPhysicsQueryOptions2D.

Properties and methods

sensors (optional)

readonly sensors?: "exclude" | "include" | "only" | undefined

Selects "include" , "exclude" , "only" for sensors. See PibblPhysicsQueryOptions2D .

View source — packages/core/src/features/physics/lib/2d/types.ts:597

collisionFilter (optional)

readonly collisionFilter?: PibblPhysicsCollisionFilter | undefined

Related API: PibblPhysicsCollisionFilter.

Category, mask, and group filtering for collision or query participation. See PibblPhysicsCollisionFilter.

View source — packages/core/src/features/physics/lib/2d/types.ts:602

excludeBody (optional)

readonly excludeBody?: PibblPhysicsBodyHandle2D | undefined

Related API: PibblPhysicsBodyHandle2D.

Body identity omitted from query candidates. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:604

excludeCollider (optional)

readonly excludeCollider?: PibblPhysicsColliderHandle2D | undefined

Related API: PibblPhysicsColliderHandle2D.

Collider identity omitted from query candidates. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:606

PibblPhysicsQueryHit2D

Cast geometry plus matched body/collider identities, generations, and application tag.

interface PibblPhysicsQueryHit2D extends PibblPhysicsShapeHit2D

Properties and methods

body

readonly body: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Body identity associated with this event or result. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:619

collider

readonly collider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

Collider configuration or identity associated with this body or query. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:624

bodyGeneration

readonly bodyGeneration: number

Committed generation of the matched body identity. See PibblPhysicsQueryHit2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:626

colliderGeneration

readonly colliderGeneration: number

Committed generation of the matched collider identity. See PibblPhysicsQueryHit2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:628

tag

readonly tag: unknown

Application payload carried through physics queries and events. See PibblPhysicsQueryHit2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:633

point

readonly point: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

A point in the operation’s coordinate system. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:157

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Contact or surface normal returned by this query. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:159

distance

readonly distance: number

Distance measured in this query or guide’s coordinate system. See PibblPhysicsShapeHit2D .

View source — packages/core/src/features/physics/2d-geometry.ts:164

timeOfImpact

readonly timeOfImpact: number

Position along the cast at which contact first occurs. See PibblPhysicsShapeHit2D.

View source — packages/core/src/features/physics/2d-geometry.ts:166

PibblPhysicsQueryMatch2D

Matched body/collider identities, generations, and tag for an overlap query.

interface PibblPhysicsQueryMatch2D

Related API: PibblPhysicsQueryMatch2D.

Properties and methods

body

readonly body: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Body identity associated with this event or result. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:646

collider

readonly collider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

Collider configuration or identity associated with this body or query. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:651

bodyGeneration

readonly bodyGeneration: number

Committed generation of the matched body identity. See PibblPhysicsQueryMatch2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:653

colliderGeneration

readonly colliderGeneration: number

Committed generation of the matched collider identity. See PibblPhysicsQueryMatch2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:655

tag

readonly tag: unknown

Application payload carried through physics queries and events. See PibblPhysicsQueryMatch2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:660

PibblPhysicsCollisionEvent2D

Bodies, colliders, contact geometry, impulse, tags, and tick for a collision event.

interface PibblPhysicsCollisionEvent2D

Related API: PibblPhysicsCollisionEvent2D.

Properties and methods

selfBody

readonly selfBody: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Body receiving the collision or overlap notification. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:675

selfCollider

readonly selfCollider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

Collider receiving the collision or overlap notification. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:680

otherBody

readonly otherBody: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

The other body in the collision or overlap pair. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:682

otherCollider

readonly otherCollider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

The other collider in the collision or overlap pair. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:686

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Direction from other toward self.

View source — packages/core/src/features/physics/lib/2d/types.ts:688

points

readonly points: readonly PibblPhysicsContactPoint2D[]

Related API: PibblPhysicsContactPoint2D.

Points defining the geometry or reported by the contact query. See PibblPhysicsContactPoint2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:693

totalNormalImpulse

readonly totalNormalImpulse: number

Total normal contact impulse reported for the pair. See PibblPhysicsCollisionEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:695

tick

readonly tick: number

Simulation tick associated with this observation. See PibblPhysicsCollisionEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:697

selfTag

readonly selfTag: unknown

Application tag attached to the receiving collider. See PibblPhysicsCollisionEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:699

otherTag

readonly otherTag: unknown

Application tag attached to the other collider. See PibblPhysicsCollisionEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:701

PibblPhysicsOverlapEvent2D

Bodies, colliders, tags, and tick for a sensor-overlap event.

interface PibblPhysicsOverlapEvent2D

Related API: PibblPhysicsOverlapEvent2D.

Properties and methods

selfBody

readonly selfBody: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Body receiving the collision or overlap notification. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:713

selfCollider

readonly selfCollider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

Collider receiving the collision or overlap notification. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:718

otherBody

readonly otherBody: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

The other body in the collision or overlap pair. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:720

otherCollider

readonly otherCollider: PibblPhysicsColliderHandle2D

Related API: PibblPhysicsColliderHandle2D.

The other collider in the collision or overlap pair. See PibblPhysicsColliderHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:724

tick

readonly tick: number

Simulation tick associated with this observation. See PibblPhysicsOverlapEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:726

selfTag

readonly selfTag: unknown

Application tag attached to the receiving collider. See PibblPhysicsOverlapEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:728

otherTag

readonly otherTag: unknown

Application tag attached to the other collider. See PibblPhysicsOverlapEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:730

PibblPhysicsBodyStateEvent2D

Body identity and sleeping state at the reported simulation tick.

interface PibblPhysicsBodyStateEvent2D

Related API: PibblPhysicsBodyStateEvent2D.

Properties and methods

body

readonly body: PibblPhysicsBodyHandle2D

Related API: PibblPhysicsBodyHandle2D.

Body identity associated with this event or result. See PibblPhysicsBodyHandle2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:741

sleeping

readonly sleeping: boolean

Whether the body is currently sleeping. See PibblPhysicsBodyStateEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:743

tick

readonly tick: number

Simulation tick associated with this observation. See PibblPhysicsBodyStateEvent2D.

View source — packages/core/src/features/physics/lib/2d/types.ts:745

PibblPhysicsVector2

An x/y pair in the 2D physics coordinate system.

type PibblPhysicsVector2 = readonly [x: number, y: number]

Related API: PibblPhysicsVector2.

PibblPhysicsPose2D

Position and rotation in degrees for a 2D shape or body.

interface PibblPhysicsPose2D

Related API: PibblPhysicsPose2D.

Properties and methods

position

readonly position: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Position of the geometry, source, or selected resize handle. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:24

rotationDegrees

readonly rotationDegrees: number

Rotation in degrees. See PibblPhysicsPose2D.

View source — packages/core/src/features/physics/2d-geometry.ts:26

PibblPhysicsTransform2D

A rigid 2D transform expressed as position and rotation in degrees.

type PibblPhysicsTransform2D = PibblPhysicsPose2D

Properties and methods

position

readonly position: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Position of the geometry, source, or selected resize handle. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:24

rotationDegrees

readonly rotationDegrees: number

Rotation in degrees. See PibblPhysicsPose2D.

View source — packages/core/src/features/physics/2d-geometry.ts:26

PibblPhysicsAabb2D

Axis-aligned bounds expressed as minimum and maximum coordinates.

interface PibblPhysicsAabb2D

Related API: PibblPhysicsAabb2D.

Properties and methods

min

readonly min: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Lower bound of the coordinate or sampling interval. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:46

max

readonly max: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Upper bound of the coordinate or sampling interval. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:48

PibblPhysicsRay2D

Origin, direction, and maximum travel distance of a 2D query ray.

interface PibblPhysicsRay2D

Related API: PibblPhysicsRay2D.

Properties and methods

origin

readonly origin: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Origin of the transform or geometric query. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:60

direction

readonly direction: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Direction in which this operation proceeds. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:62

maxDistance

readonly maxDistance: number

Maximum distance accepted by the query. See PibblPhysicsRay2D.

View source — packages/core/src/features/physics/2d-geometry.ts:64

PibblPhysicsShape2D

An immutable branded shape created by the public 2D geometry constructors.

interface PibblPhysicsShape2D

Related API: PibblPhysicsShape2D.

PibblPhysicsMassProperties2D

Area, centroid, mass, and rotational inertia derived from a shape and density.

interface PibblPhysicsMassProperties2D

Related API: PibblPhysicsMassProperties2D.

Properties and methods

area

readonly area: number

Area enclosed by the shape. See PibblPhysicsMassProperties2D.

View source — packages/core/src/features/physics/2d-geometry.ts:87

centroid

readonly centroid: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Area-weighted center of the shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:89

mass

readonly mass: number

Mass used by the spring or physics calculation. See PibblPhysicsMassProperties2D.

View source — packages/core/src/features/physics/2d-geometry.ts:91

rotationalInertia

readonly rotationalInertia: number

Moment of inertia about the shape’s center of mass. See PibblPhysicsMassProperties2D.

View source — packages/core/src/features/physics/2d-geometry.ts:93

PibblPhysicsDistance2D

Signed separation, witness points, and normal between two posed shapes.

interface PibblPhysicsDistance2D

Related API: PibblPhysicsDistance2D.

Properties and methods

separation

readonly separation: number

Signed distance between the witness points. See PibblPhysicsDistance2D.

View source — packages/core/src/features/physics/2d-geometry.ts:104

pointOnFirst

readonly pointOnFirst: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Witness point on the first shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:106

pointOnSecond

readonly pointOnSecond: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Witness point on the second shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:108

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Direction from the second shape toward the first.

View source — packages/core/src/features/physics/2d-geometry.ts:110

PibblPhysicsContactPoint2D

A pair of contact witness points and their signed separation.

interface PibblPhysicsContactPoint2D

Related API: PibblPhysicsContactPoint2D.

Properties and methods

pointOnFirst

readonly pointOnFirst: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Witness point on the first shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:123

pointOnSecond

readonly pointOnSecond: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Witness point on the second shape. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:125

separation

readonly separation: number

Signed distance between the witness points. See PibblPhysicsContactPoint2D.

View source — packages/core/src/features/physics/2d-geometry.ts:127

PibblPhysicsShapeContact2D

Contact normal and witness-point pairs for two overlapping or touching shapes.

interface PibblPhysicsShapeContact2D

Related API: PibblPhysicsShapeContact2D.

Properties and methods

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Direction from the second shape toward the first.

View source — packages/core/src/features/physics/2d-geometry.ts:139

points

readonly points: readonly PibblPhysicsContactPoint2D[]

Related API: PibblPhysicsContactPoint2D.

Points defining the geometry or reported by the contact query. See PibblPhysicsContactPoint2D.

View source — packages/core/src/features/physics/2d-geometry.ts:144

PibblPhysicsShapeHit2D

Point, normal, distance, and time of impact returned by a geometry cast.

interface PibblPhysicsShapeHit2D

Related API: PibblPhysicsShapeHit2D.

Properties and methods

point

readonly point: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

A point in the operation’s coordinate system. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:157

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Contact or surface normal returned by this query. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/2d-geometry.ts:159

distance

readonly distance: number

Distance measured in this query or guide’s coordinate system. See PibblPhysicsShapeHit2D .

View source — packages/core/src/features/physics/2d-geometry.ts:164

timeOfImpact

readonly timeOfImpact: number

Position along the cast at which contact first occurs. See PibblPhysicsShapeHit2D.

View source — packages/core/src/features/physics/2d-geometry.ts:166

PibblPhysicsInspection2D

Read-only observations, not an engine serialization/restore format.

interface PibblPhysicsInspection2D

Related API: PibblPhysicsInspection2D.

Properties and methods

engine

readonly engine: "rapier-2d@0.21.0"

The literal “rapier-2d@0.21.0” identifying this variant. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:128

space

readonly space: "local" | "root"

Selects "root", "local" for space. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:130

revision

readonly revision: number

Revision used to detect changes to the underlying state or geometry. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:135

tick

readonly tick: number

Simulation tick associated with this observation. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:137

advancing

readonly advancing: boolean

Whether the inspected world is actively advancing simulation. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:142

failedFrames

readonly failedFrames: number

Number of scheduler frames in which this world failed to advance. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:147

lastFailure

readonly lastFailure: string | null

Diagnostic information about the most recent simulation failure. See PibblPhysicsInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:152

bodies

readonly bodies: readonly PibblPhysicsBodyInspection2D[]

Related API: PibblPhysicsBodyInspection2D.

Committed body snapshots in the inspected world. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:154

colliders

readonly colliders: readonly PibblPhysicsColliderInspection2D[]

Related API: PibblPhysicsColliderInspection2D.

Committed collider snapshots in the inspected world. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:159

contacts

readonly contacts: readonly PibblPhysicsContactInspection2D[]

Related API: PibblPhysicsContactInspection2D.

Committed contact snapshots in the inspected world. See PibblPhysicsContactInspection2D .

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:164

PibblPhysicsBodyInspection2D

Diagnostic body identity, committed and presented poses, motion, sleeping state, and mass.

interface PibblPhysicsBodyInspection2D

Related API: PibblPhysicsBodyInspection2D.

Properties and methods

readonly id: number

Stable identifier of this resource or connection. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:17

generation

readonly generation: number

Generation counter distinguishing successive bindings of a stable identity. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:22

type

readonly type: "dynamic" | "kinematic" | "static"

Selects "dynamic" , "kinematic" , "static" for type. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:27

enabled

readonly enabled: boolean

Whether this operation or resource participates in updates. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:32

sleeping

readonly sleeping: boolean

Whether the body is currently sleeping. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:34

pose

readonly pose: PibblPhysicsPose2D

Related API: PibblPhysicsPose2D.

Committed physical position and rotation. See PibblPhysicsPose2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:36

presentationPose

readonly presentationPose: PibblPhysicsPose2D

Related API: PibblPhysicsPose2D.

Interpolated pose currently used for drawing. See PibblPhysicsPose2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:38

centerOfMass

readonly centerOfMass: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Center of mass in the reported physics coordinate system. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:40

linearVelocity

readonly linearVelocity: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Linear velocity in the simulation coordinate system per second. See PibblPhysicsVector2 .

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:45

angularVelocityDegreesPerSecond

readonly angularVelocityDegreesPerSecond: number

Angular velocity in degrees per second. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:47

mass

readonly mass: number | null

Mass used by the spring or physics calculation. See PibblPhysicsBodyInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:49

PibblPhysicsColliderInspection2D

Serializable collider identity, shape kinds, bounds, sensor state, and string label.

interface PibblPhysicsColliderInspection2D

Related API: PibblPhysicsColliderInspection2D.

Properties and methods

readonly id: number

Stable identifier of this resource or connection. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:61

generation

readonly generation: number

Generation counter distinguishing successive bindings of a stable identity. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:66

bodyId

readonly bodyId: number

Identifier of the collider’s owning body. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:68

sensor

readonly sensor: boolean

Whether the collider reports overlaps instead of producing contact response. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:73

label

readonly label: string | null

String tags only. Arbitrary application objects are never serialized.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:75

shapeKinds

readonly shapeKinds: readonly string[]

Kinds of shape geometry represented by the collider. See PibblPhysicsColliderInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:80

bounds

readonly bounds: PibblPhysicsAabb2D

Related API: PibblPhysicsAabb2D.

Logical region constraining the content or query. See PibblPhysicsAabb2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:82

PibblPhysicsContactInspection2D

Diagnostic contact geometry and impulse between two collider identities.

interface PibblPhysicsContactInspection2D

Related API: PibblPhysicsContactInspection2D.

Properties and methods

firstColliderId

readonly firstColliderId: number

Identifier of the first collider in the contact pair. See PibblPhysicsContactInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:96

secondColliderId

readonly secondColliderId: number

Identifier of the second collider in the contact pair. See PibblPhysicsContactInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:101

sensor

readonly sensor: boolean

Whether the collider reports overlaps instead of producing contact response. See PibblPhysicsContactInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:106

normal

readonly normal: PibblPhysicsVector2

Related API: PibblPhysicsVector2.

Contact or surface normal returned by this query. See PibblPhysicsVector2.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:108

points

readonly points: readonly PibblPhysicsContactPoint2D[]

Related API: PibblPhysicsContactPoint2D.

Points defining the geometry or reported by the contact query. See PibblPhysicsContactPoint2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:113

normalImpulse

readonly normalImpulse: number

Normal contact impulse reported by the solver. See PibblPhysicsContactInspection2D.

View source — packages/core/src/features/physics/lib/2d/inspection-types.ts:115

PibblPhysicsDebug2DProps

Authored inputs for PhysicsDebug2D, including the declared data and presentation options.

interface PibblPhysicsDebug2DProps

Related API: PibblPhysicsDebug2DProps.

Properties and methods

world

readonly world: PibblPhysicsWorldHandle2D

Related API: PibblPhysicsWorldHandle2D.

World identity whose state is queried or drawn. See PibblPhysicsWorldHandle2D.

View source — packages/core/src/features/physics/lib/2d/canvas/debug.ts:14

color (optional)

readonly color?: string | undefined

Color used by the mark or effect. See PibblPhysicsDebug2DProps.

View source — packages/core/src/features/physics/lib/2d/canvas/debug.ts:16

Implementation guidance for agents

Read the Physics and geometry companion for ownership, adaptation, failure modes, and verification. Agent start provides the version-selection workflow.

Complete minimal examples

Shape measurements: Compare bounds, area, and mass for four common 2D shapes. Plain source
Physics drawing components: Draw four physics shapes and move a custom kinematic collider. Plain source
Live physics world: Mount a falling ball, inspect it, and control its body with buttons. Plain source
Physics events: Record collisions, sensor overlap, body sleep, and contact inspection. Plain source
World queries: Query a static collider by ray, moving shape, overlap, point, and bounds. Plain source
Geometry queries: Check point containment, separation, overlap, contact, and casts. Plain source
Path-like shapes: Create curved, stroked, and polygonal shapes and transform them. Plain source

Documentation version

Documentation built with @pibbl/core 0.0.2, revision 272a94a. ALPHA — NOT FOR PRODUCTION USE.

2D physics types

Geometry

PibblPhysicsVector2

PibblPhysicsPose2D

PibblPhysicsTransform2D

PibblPhysicsAabb2D

PibblPhysicsRay2D

PibblPhysicsShape2D

PibblPhysicsMassProperties2D

PibblPhysicsDistance2D

PibblPhysicsContactPoint2D

PibblPhysicsShapeContact2D

PibblPhysicsShapeHit2D

World, descriptors, and handles

PibblPhysicsWorld2DProps

PibblPhysicsSolverOptions

PibblPhysicsWorldHandle2D

PibblPhysicsAttachment2D

PibblPhysicsBodyAttachment2D

PibblPhysicsColliderAttachment2D

PibblPhysicsDynamicBody2DOptions

PibblPhysicsStaticBody2DOptions

PibblPhysicsKinematicBody2DOptions

PibblPhysicsKinematicTarget2D

PibblPhysicsColliderConfiguration2D

PibblPhysicsCollisionFilter

PibblPhysicsBodyHandle2D

PibblPhysicsColliderHandle2D

Query and event contracts

PibblPhysicsQueryOptions2D

PibblPhysicsQueryHit2D

PibblPhysicsQueryMatch2D

PibblPhysicsCollisionEvent2D

PibblPhysicsCollisionHandler2D

PibblPhysicsOverlapEvent2D

PibblPhysicsOverlapHandler2D

PibblPhysicsHitHandler2D

PibblPhysicsBodyStateEvent2D

PibblPhysicsBodyStateHandler2D

Inspection and debug drawing

PibblPhysicsInspection2D

PibblPhysicsBodyInspection2D

PibblPhysicsColliderInspection2D

PibblPhysicsContactInspection2D

PibblPhysicsDebug2DProps

Canvas shape inputs

PibblPhysicsPrimitiveProps2D

PhysicsShape2DProps

PhysicsShape2DStyle

Capsule2DProps

Capsule2DStyle

Segment2DProps

Segment2DStyle

Chain2DProps

Chain2DStyle

API details from source

PibblPhysicsCollisionFilter

See also

Properties and methods

PibblPhysicsCollisionHandler2D

Parameters

See also

PibblPhysicsHitHandler2D

Parameters

See also

PibblPhysicsOverlapHandler2D

Parameters

See also

PibblPhysicsBodyStateHandler2D

Parameters

See also

PibblPhysicsColliderConfiguration2D

See also

Properties and methods

PibblPhysicsDynamicBody2DOptions

See also

Properties and methods

PibblPhysicsStaticBody2DOptions

See also

Properties and methods

`PibblPhysicsVector2`

`PibblPhysicsPose2D`

`PibblPhysicsTransform2D`

`PibblPhysicsAabb2D`

`PibblPhysicsRay2D`

`PibblPhysicsShape2D`

`PibblPhysicsMassProperties2D`

`PibblPhysicsDistance2D`

`PibblPhysicsContactPoint2D`

`PibblPhysicsShapeContact2D`

`PibblPhysicsShapeHit2D`

`PibblPhysicsWorld2DProps`

`PibblPhysicsSolverOptions`

`PibblPhysicsWorldHandle2D`

`PibblPhysicsAttachment2D`

`PibblPhysicsBodyAttachment2D`

`PibblPhysicsColliderAttachment2D`

`PibblPhysicsDynamicBody2DOptions`

`PibblPhysicsStaticBody2DOptions`

`PibblPhysicsKinematicBody2DOptions`

`PibblPhysicsKinematicTarget2D`

`PibblPhysicsColliderConfiguration2D`

`PibblPhysicsCollisionFilter`

`PibblPhysicsBodyHandle2D`

`PibblPhysicsColliderHandle2D`

`PibblPhysicsQueryOptions2D`

`PibblPhysicsQueryHit2D`

`PibblPhysicsQueryMatch2D`

`PibblPhysicsCollisionEvent2D`

`PibblPhysicsCollisionHandler2D`

`PibblPhysicsOverlapEvent2D`

`PibblPhysicsOverlapHandler2D`

`PibblPhysicsHitHandler2D`

`PibblPhysicsBodyStateEvent2D`

`PibblPhysicsBodyStateHandler2D`

`PibblPhysicsInspection2D`

`PibblPhysicsBodyInspection2D`

`PibblPhysicsColliderInspection2D`

`PibblPhysicsContactInspection2D`

`PibblPhysicsDebug2DProps`

`PibblPhysicsPrimitiveProps2D`

`PhysicsShape2DProps`

`PhysicsShape2DStyle`

`Capsule2DProps`

`Capsule2DStyle`

`Segment2DProps`

`Segment2DStyle`

`Chain2DProps`

`Chain2DStyle`