@marble.fun/track-catalog 3.0.0

package/src/pages/play/race/under-track-support-architecture.ts

@@ -0,0 +1,122 @@
+import * as THREE from 'three'
+
+/**
+ * One architecture contract for every visual under-track support.
+ *
+ * Track pieces provide only their canonical path. Styles may change member
+ * profiles and materials, but they may not redefine depth, fade, or bay rhythm.
+ */
+export const UNDER_TRACK_SUPPORT_DEPTH = 4.8
+export const UNDER_TRACK_SUPPORT_FADE_START_DEPTH = 3.2
+export const UNDER_TRACK_SUPPORT_FADE_DEPTH = 1.6
+export const UNDER_TRACK_SUPPORT_BAY_LENGTH = 2.5
+
+/** Reduces the old monument-scale footprints and member sections uniformly. */
+export const UNDER_TRACK_SUPPORT_FOOTPRINT_SCALE = 0.55
+export const UNDER_TRACK_SUPPORT_MEMBER_SCALE = 0.45
+
+/** Decorative support runs join only when both connected pieces select the same style. */
+export function underTrackSupportStylesConnect(
+  sourceSupportId: string | undefined,
+  targetSupportId: string | undefined,
+): boolean {
+  return sourceSupportId !== undefined && sourceSupportId === targetSupportId
+}
+
+/** Shared placement of vertical load-bearing members beneath a lane. */
+export function underTrackSupportHalfSpan(trackWidth: number): number {
+  return Math.max(0.65, trackWidth * 0.25)
+}
+
+export interface UnderTrackSupportBaySchedule {
+  count: number
+  bayLength: number
+  centers: number[]
+}
+
+export interface UnderTrackSupportOwnedBay {
+  start: number
+  end: number
+}
+
+export interface UnderTrackSupportLayout extends UnderTrackSupportBaySchedule {
+  /** Complete global-grid bays whose midpoint is owned by this route interval. */
+  ownedBays: UnderTrackSupportOwnedBay[]
+}
+
+/**
+ * Places support bents on one absolute 2.5-unit metric grid.
+ *
+ * `connectionPhase` is the cumulative path length at this piece's input. The
+ * half-open interval deliberately gives a connector-aligned bent to the
+ * downstream piece, so adjacent pieces cannot render the same bent twice.
+ */
+export function createUnderTrackSupportBaySchedule(
+  length: number,
+  connectionPhase = 0,
+): UnderTrackSupportBaySchedule {
+  if (!Number.isFinite(length) || length <= 0.000_001) {
+    return { count: 0, bayLength: 0, centers: [] }
+  }
+  const pitch = UNDER_TRACK_SUPPORT_BAY_LENGTH
+  const phase = ((connectionPhase % pitch) + pitch) % pitch
+  let center = ((pitch * 0.5 - phase) % pitch + pitch) % pitch
+  if (Math.abs(center - pitch) < 0.000_001) center = 0
+  const centers: number[] = []
+  while (center < length - 0.000_001) {
+    centers.push(center)
+    center += pitch
+  }
+  return {
+    count: centers.length,
+    bayLength: pitch,
+    centers,
+  }
+}
+
+/**
+ * One topology-safe layout for every support style.
+ *
+ * Stations are owned by the half-open piece interval. Bays are independently
+ * owned by their midpoint, allowing one piece to draw a complete bay across a
+ * connector (or across a short piece with no local station) without its
+ * neighbour drawing the same span.
+ */
+export function createUnderTrackSupportLayout(
+  length: number,
+  connectionPhase = 0,
+  connectedStart = false,
+  connectedEnd = false,
+): UnderTrackSupportLayout {
+  const schedule = createUnderTrackSupportBaySchedule(length, connectionPhase)
+  if (!Number.isFinite(length) || length <= 0.000_001) return { ...schedule, ownedBays: [] }
+  const pitch = UNDER_TRACK_SUPPORT_BAY_LENGTH
+  const firstGlobalStation = pitch * 0.5
+  const firstIndex = Math.floor((connectionPhase - firstGlobalStation) / pitch) - 2
+  const lastIndex = Math.ceil((connectionPhase + length - firstGlobalStation) / pitch) + 2
+  const ownedBays: UnderTrackSupportOwnedBay[] = []
+  for (let index = firstIndex; index <= lastIndex; index += 1) {
+    const globalStart = firstGlobalStation + index * pitch
+    const globalEnd = globalStart + pitch
+    const start = globalStart - connectionPhase
+    const end = globalEnd - connectionPhase
+    const midpoint = (start + end) / 2
+    // Spans use (start, end] ownership: the route ending at a connector owns
+    // the complete crossing bay; the following route cannot duplicate it.
+    if (midpoint <= 0.000_001 || midpoint > length + 0.000_001) continue
+    if (start < -0.000_001 && !connectedStart) continue
+    if (end > length + 0.000_001 && !connectedEnd) continue
+    ownedBays.push({ start, end })
+  }
+  return { ...schedule, bayLength: pitch, ownedBays }
+}
+
+/** Shared clearance used when several routes occupy one junction volume. */
+export function underTrackSupportStationClearance(trackWidth: number): number {
+  return Math.max(UNDER_TRACK_SUPPORT_BAY_LENGTH * 0.9, underTrackSupportHalfSpan(trackWidth) * 1.25)
+}
+
+/** Continuous local-depth fade shared by procedural and authored supports. */
+export function underTrackSupportFadeAtDepth(depth: number): number {
+  return 1 - THREE.MathUtils.smoothstep(depth, UNDER_TRACK_SUPPORT_FADE_START_DEPTH, UNDER_TRACK_SUPPORT_DEPTH)
+}

package/src/pages/play/race/vortex-profile.ts

@@ -0,0 +1,5 @@
+export {
+  vortexExitProfilePoint,
+  type VortexExitProfileOptions,
+  type VortexExitProfilePoint,
+} from '@marble.fun/physics-engine'