@marble.fun/track-catalog 3.0.0

package/src/pages/track-lab/flipper-bank-layout.ts

@@ -0,0 +1 @@
+export * from '@marble.fun/physics-engine/flipper-bank-layout'

package/src/pages/track-lab/flipper-component.ts

@@ -0,0 +1,127 @@
+import * as THREE from 'three'
+
+import { VisualCylinderGeometry, VisualExtrudeGeometry } from '../../three/visual-geometry'
+import {
+  CANONICAL_FLIPPER_DIMENSIONS,
+  flipperCapOffset,
+  type FlipperComponentDimensions,
+} from '@marble.fun/physics-engine/browser'
+
+export {
+  CANONICAL_FLIPPER_DIMENSIONS,
+  CANONICAL_FLIPPER_SWEEP_RADIANS,
+  FLIPPER_COMPONENT_FRICTION,
+  FLIPPER_COMPONENT_RESTITUTION,
+  FLIPPER_MINIMUM_ONE_WAY_SWEEP_SECONDS,
+  flipperBarLength,
+  flipperCapOffset,
+  flipperStrikeArcTipSpeed,
+  flipperStrikeProgress,
+  type FlipperComponentDimensions,
+} from '@marble.fun/physics-engine/browser'
+
+/**
+ * The one visual/physical silhouette used by every flipper-shaped mechanism.
+ * Timing belongs to the owning mechanism; the component only owns shape.
+ */
+export const FLIPPER_COMPONENT_RADIAL_SEGMENTS = 18
+
+function createFlipperPaddleGeometry(dimensions: FlipperComponentDimensions): THREE.BufferGeometry {
+  const radius = dimensions.width / 2
+  const capOffset = flipperCapOffset(dimensions)
+  const outline = new THREE.Shape()
+  outline.moveTo(-capOffset, -radius)
+  outline.lineTo(capOffset, -radius)
+  outline.absarc(capOffset, 0, radius, -Math.PI / 2, Math.PI / 2, false)
+  outline.lineTo(-capOffset, radius)
+  outline.absarc(-capOffset, 0, radius, Math.PI / 2, Math.PI * 1.5, false)
+  outline.closePath()
+
+  const geometry = new VisualExtrudeGeometry(outline, {
+    bevelEnabled: false,
+    curveSegments: FLIPPER_COMPONENT_RADIAL_SEGMENTS / 2,
+    depth: dimensions.height,
+    steps: 1,
+  })
+  geometry.rotateX(Math.PI / 2)
+  geometry.translate(0, dimensions.height / 2, 0)
+  geometry.clearGroups()
+  geometry.addGroup(0, geometry.index?.count ?? geometry.getAttribute('position').count, 0)
+  return geometry
+}
+
+export function createFlipperPaddleVisual(
+  name: string,
+  material: THREE.Material,
+  dimensions: FlipperComponentDimensions = CANONICAL_FLIPPER_DIMENSIONS,
+): THREE.Group {
+  const paddle = new THREE.Group()
+  paddle.name = name
+  paddle.userData.mechanismComponent = 'canonical-flipper-paddle'
+  paddle.userData.flipperDimensions = { ...dimensions }
+  paddle.frustumCulled = false
+
+  const geometry = createFlipperPaddleGeometry(dimensions)
+  geometry.userData.mechanismComponent = 'canonical-flipper-paddle'
+  geometry.userData.flipperMaterialGroups = { paddle: 0 }
+  const surface = new THREE.Mesh(geometry, material)
+  surface.name = `${name}-surface`
+  surface.userData.flipperMaterialRoles = { paddle: 'primary' }
+  surface.castShadow = true
+  surface.receiveShadow = true
+  paddle.add(surface)
+  return paddle
+}
+
+/**
+ * A flipper-shaped arm whose object origin is the centre of its rounded hinge
+ * end. Runtime snapshots rotate this root while the child keeps the same
+ * half-length offset as the matching Rapier colliders.
+ */
+export function createEndPivotedFlipperPaddleVisual(
+  name: string,
+  material: THREE.Material,
+  dimensions: FlipperComponentDimensions = CANONICAL_FLIPPER_DIMENSIONS,
+  hubMaterial: THREE.Material = material,
+  hubName = `${name}-hub`,
+  hubHeightPadding = 0.24,
+): THREE.Group {
+  const pivot = new THREE.Group()
+  pivot.name = name
+  pivot.userData.mechanismComponent = 'canonical-flipper-paddle'
+  pivot.userData.flipperDimensions = { ...dimensions }
+  pivot.userData.flipperPivot = 'rounded-end'
+  pivot.frustumCulled = false
+
+  const arm = createFlipperPaddleVisual(`${name}-arm`, material, dimensions)
+  arm.position.x = -dimensions.length / 2
+  const surface = arm.getObjectByName(`${name}-arm-surface`)
+  if (!(surface instanceof THREE.Mesh)) throw new Error('Canonical flipper paddle surface is missing')
+  surface.name = `${name}-surface`
+  const hub = createFlipperHubVisual(hubName, hubMaterial, dimensions, hubHeightPadding)
+  pivot.add(arm, hub)
+  return pivot
+}
+
+export function createFlipperHubVisual(
+  name: string,
+  material: THREE.Material,
+  dimensions: FlipperComponentDimensions = CANONICAL_FLIPPER_DIMENSIONS,
+  heightPadding = 0.24,
+): THREE.Mesh {
+  const hub = new THREE.Mesh(
+    new VisualCylinderGeometry(
+      dimensions.width * 0.72,
+      dimensions.width * 0.72,
+      dimensions.height + heightPadding,
+      FLIPPER_COMPONENT_RADIAL_SEGMENTS,
+    ),
+    material,
+  )
+  hub.name = name
+  hub.userData.mechanismComponent = 'canonical-flipper-hub'
+  hub.userData.flipperDimensions = { ...dimensions }
+  hub.castShadow = true
+  hub.receiveShadow = true
+  return hub
+}

package/src/pages/track-lab/rising-wall-layout.ts

@@ -0,0 +1 @@
+export * from '@marble.fun/physics-engine/rising-wall-layout'

package/src/pages/track-lab/simple-obstacle-layout.ts

@@ -0,0 +1 @@
+export * from '@marble.fun/physics-engine/simple-obstacle-layout'

package/src/pages/track-lab/track-piece-layout.ts

@@ -0,0 +1,28 @@
+import {
+  createIntersectionRailDefinitions as createCoreIntersectionRailDefinitions,
+  createRoutingMergeDeck as createCoreRoutingMergeDeck,
+  createRoutingSplitterDeck as createCoreRoutingSplitterDeck,
+} from '@marble.fun/physics-engine/track-piece-layout'
+
+export * from '@marble.fun/physics-engine/track-piece-layout'
+
+export function createRoutingSplitterDeck(...args: Parameters<typeof createCoreRoutingSplitterDeck>) {
+  const definition = createCoreRoutingSplitterDeck(...args)
+  return {
+    ...definition,
+    railroadProfile: 'routing-split' as const,
+    centerDivider: definition.centerDivider
+      ? { ...definition.centerDivider, visualRole: 'obstacle' as const }
+      : undefined,
+  }
+}
+
+export function createRoutingMergeDeck(...args: Parameters<typeof createCoreRoutingMergeDeck>) {
+  return { ...createCoreRoutingMergeDeck(...args), railroadProfile: 'routing-merge' as const }
+}
+
+export function createIntersectionRailDefinitions(...args: Parameters<typeof createCoreIntersectionRailDefinitions>) {
+  const definitions = createCoreIntersectionRailDefinitions(...args)
+  if (args[2].length <= 1) return definitions
+  return definitions.map(definition => ({ ...definition, railroadProfile: 'intersection-merge' as const }))
+}