@inventure71/paddockjs 4.1.0 → 4.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/CHANGELOG.md +76 -0
  2. package/INSTALL_AND_UPDATE.md +31 -5
  3. package/README.md +34 -3
  4. package/docs/advanced_ai_pace.md +131 -0
  5. package/docs/advanced_physics_rebuild.md +166 -0
  6. package/docs/architecture.md +111 -30
  7. package/docs/cleanup_coverage.md +284 -0
  8. package/docs/component_inventory.md +32 -16
  9. package/docs/composable-layouts.md +2 -0
  10. package/docs/concepts.md +12 -1
  11. package/docs/custom_model_controller.md +1 -1
  12. package/docs/data_contract.md +33 -10
  13. package/docs/data_model.md +4 -2
  14. package/docs/efficiency_cleanup_2026-10-13.md +80 -0
  15. package/docs/getting-started.md +3 -0
  16. package/docs/grid_walk.md +80 -0
  17. package/docs/index.md +5 -2
  18. package/docs/keyboard_driving_fix.md +118 -0
  19. package/docs/limit_driving_2026-10-14.md +88 -0
  20. package/docs/loading.md +141 -0
  21. package/docs/maintainability_audit_2026-09-08.md +146 -0
  22. package/docs/racing_ai_improvements.md +145 -0
  23. package/docs/rules.md +43 -13
  24. package/docs/sense_contract.md +4 -1
  25. package/docs/system_specs.md +40 -12
  26. package/docs/testing-reliability-guide.md +67 -0
  27. package/docs/v11_improvements.md +108 -0
  28. package/package.json +23 -15
  29. package/src/api/MountedSimulatorComponents.js +101 -0
  30. package/src/api/PaddockSimulatorController.js +56 -81
  31. package/src/app/BrowserExpertAdapter.js +0 -6
  32. package/src/app/BrowserExpertExternalRenderer.js +72 -50
  33. package/src/app/ExternalTrackSnapshot.js +50 -0
  34. package/src/app/F1SimulatorApp.js +242 -297
  35. package/src/app/HostLifecycleEmitter.js +93 -0
  36. package/src/app/banners/raceDataBannerController.js +9 -4
  37. package/src/app/camera/cameraConstants.js +1 -1
  38. package/src/app/camera/cameraController.js +10 -13
  39. package/src/app/camera/cameraGeometry.js +1 -1
  40. package/src/app/controls/SimulatorViewControls.js +45 -0
  41. package/src/app/controls/workbenchBindings.js +64 -0
  42. package/src/app/controls/workbenchDisclosure.js +41 -0
  43. package/src/app/domBindings.js +21 -13
  44. package/src/app/gridWalk/GridWalkController.js +180 -0
  45. package/src/app/gridWalk/gridWalkCamera.js +88 -0
  46. package/src/app/gridWalk/gridWalkControls.js +24 -0
  47. package/src/app/gridWalk/gridWalkCrew.js +246 -0
  48. package/src/app/gridWalk/gridWalkLabels.js +104 -0
  49. package/src/app/gridWalk/gridWalkLayout.js +46 -0
  50. package/src/app/gridWalk/gridWalkNavigation.js +99 -0
  51. package/src/app/gridWalk/gridWalkProjectBanner.js +43 -0
  52. package/src/app/gridWalk/gridWalkSession.js +50 -0
  53. package/src/app/layoutSupport.js +2 -0
  54. package/src/app/raceOverlayClearanceSupport.js +21 -7
  55. package/src/app/readouts/carOverviewRenderer.js +9 -4
  56. package/src/app/readouts/readoutFormatters.js +1 -8
  57. package/src/app/readouts/telemetryRenderer.js +1 -3
  58. package/src/app/readouts/timingTowerRenderer.js +48 -50
  59. package/src/app/rendering/appAssets.js +8 -10
  60. package/src/app/rendering/carRenderer.js +27 -79
  61. package/src/app/rendering/displayUtils.js +0 -6
  62. package/src/app/rendering/expertSensorRenderer.js +1 -1
  63. package/src/app/rendering/replayGhostRenderer.js +4 -1
  64. package/src/app/rendering/trackRenderer.js +2 -2
  65. package/src/app/runtime/frameLoop.js +18 -17
  66. package/src/app/runtime/pixiStartupLifecycle.js +94 -0
  67. package/src/app/runtime/runtimeTiming.js +4 -1
  68. package/src/app/runtime/runtimeVisibility.js +7 -2
  69. package/src/config/cssValues.js +1 -1
  70. package/src/config/defaultOptions.js +12 -173
  71. package/src/config/restartOptions.js +1 -0
  72. package/src/config/runtimeSeed.js +10 -0
  73. package/src/config/simulatorDefaults.js +106 -0
  74. package/src/config/telemetryModules.js +20 -0
  75. package/src/config/theme/cssTokens.js +85 -0
  76. package/src/config/theme/themeCss.js +72 -0
  77. package/src/config/theme/themeInputs.js +155 -0
  78. package/src/config/theme/themeResolver.js +172 -0
  79. package/src/config/theme/themeSelectors.js +69 -0
  80. package/src/config/theme/themeTokens.js +257 -0
  81. package/src/config/theme/themeUtils.js +15 -0
  82. package/src/config/themeOptions.js +14 -830
  83. package/src/config/timingGapMode.js +0 -2
  84. package/src/config/uiOptions.js +53 -0
  85. package/src/data/championship.js +16 -158
  86. package/src/data/championshipDefaults.js +87 -0
  87. package/src/data/driverData.js +10 -20
  88. package/src/data/entryIdentity.js +67 -0
  89. package/src/data/entryPresentation.js +23 -0
  90. package/src/data/entryTypes.d.ts +160 -0
  91. package/src/data/index.d.ts +12 -195
  92. package/src/data/ratingScale.js +14 -0
  93. package/src/data/teamTypes.d.ts +23 -0
  94. package/src/data/trackTypes.d.ts +101 -0
  95. package/src/data/vehicleData.js +12 -23
  96. package/src/environment/actions.js +3 -2
  97. package/src/environment/controllerLoop.js +57 -44
  98. package/src/environment/controllerScheduler.js +30 -0
  99. package/src/environment/driverObservations.js +260 -0
  100. package/src/environment/driverReset.js +51 -0
  101. package/src/environment/episode.js +0 -1
  102. package/src/environment/evaluation.js +6 -90
  103. package/src/environment/evaluationTracker.js +100 -0
  104. package/src/environment/events.js +23 -0
  105. package/src/environment/index.d.ts +35 -91
  106. package/src/environment/metrics.js +3 -17
  107. package/src/environment/observationSchema.js +104 -0
  108. package/src/environment/observationVector.js +16 -115
  109. package/src/environment/observations.js +16 -316
  110. package/src/environment/options.js +5 -24
  111. package/src/environment/renderFrames.js +21 -0
  112. package/src/environment/resetOptions.js +41 -0
  113. package/src/environment/results.js +125 -0
  114. package/src/environment/rewards.js +10 -16
  115. package/src/environment/runtime.js +17 -300
  116. package/src/environment/scenarioOptions.js +90 -0
  117. package/src/environment/scenarioPlacements.js +70 -0
  118. package/src/environment/scenarioPresets.js +78 -0
  119. package/src/environment/scenarios.js +5 -236
  120. package/src/environment/scratch.js +18 -0
  121. package/src/environment/sensorOptions.js +20 -0
  122. package/src/environment/sensors/index.js +2 -556
  123. package/src/environment/sensors/indexedRayBands.js +0 -18
  124. package/src/environment/sensors/nearbyCars.js +18 -15
  125. package/src/environment/sensors/opponentRadar.js +3 -2
  126. package/src/environment/sensors/pitConnectorProximity.js +20 -0
  127. package/src/environment/sensors/rayBandTrace.js +1 -37
  128. package/src/environment/sensors/rayBatch.js +81 -0
  129. package/src/environment/sensors/rayConfig.js +26 -0
  130. package/src/environment/sensors/rayGeometry.js +0 -8
  131. package/src/environment/sensors/rayGuards.js +0 -6
  132. package/src/environment/sensors/rayOutputs.js +75 -0
  133. package/src/environment/sensors/rayQuery.js +110 -0
  134. package/src/environment/sensors/rayScratch.js +146 -0
  135. package/src/environment/sensors/sensorTargets.js +12 -4
  136. package/src/environment/sensors/surfaceRays.js +6 -61
  137. package/src/environment/sensors/trackRays.js +7 -80
  138. package/src/environment/simulationSetup.js +30 -0
  139. package/src/environment/specs.js +15 -109
  140. package/src/index.d.ts +43 -202
  141. package/src/index.js +28 -6
  142. package/src/placeholder/index.js +1 -8
  143. package/src/rendering/displayLifecycle.js +6 -0
  144. package/src/rendering/proceduralTrackAsset.js +1 -1
  145. package/src/rendering/renderSnapshot.js +3 -0
  146. package/src/rendering/track/finishLineRenderer.js +1 -1
  147. package/src/rendering/track/gridRenderer.js +1 -1
  148. package/src/rendering/track/offsetStrokeSafety.js +2 -2
  149. package/src/rendering/track/pitLaneRenderer.js +1 -1
  150. package/src/rendering/track/trackMaterialRenderer.js +4 -4
  151. package/src/rendering/track/trackRenderConstants.js +0 -1
  152. package/src/rendering/track/trackRenderGeometry.js +1 -7
  153. package/src/simulation/collisionGeometry.js +12 -20
  154. package/src/simulation/driver/advancedPathControls.js +53 -0
  155. package/src/simulation/driver/advancedRacePace.js +112 -0
  156. package/src/simulation/driver/advancedRacingControls.js +61 -0
  157. package/src/simulation/driver/advancedRacingEnvelope.js +255 -0
  158. package/src/simulation/driver/advancedRacingSteering.js +76 -0
  159. package/src/simulation/driver/advancedRacingTiming.js +16 -0
  160. package/src/simulation/driver/arcadeRacePace.js +83 -0
  161. package/src/simulation/driver/arcadeRacingControls.js +111 -0
  162. package/src/simulation/driver/arcadeRacingEnvelope.js +63 -0
  163. package/src/simulation/driver/driverControlConstants.js +0 -2
  164. package/src/simulation/driver/driverController.js +16 -5
  165. package/src/simulation/driver/edgeRecovery.js +2 -3
  166. package/src/simulation/driver/racingControls.js +10 -396
  167. package/src/simulation/driver/racingDriverProfile.js +48 -0
  168. package/src/simulation/driver/racingLinePlan.js +54 -20
  169. package/src/simulation/driver/rejoinControls.js +59 -112
  170. package/src/simulation/driver/safetyCarControls.js +12 -0
  171. package/src/simulation/driver/trafficScan.js +136 -27
  172. package/src/simulation/participants/participantInteractions.js +24 -15
  173. package/src/simulation/pit/pitCarPlacement.js +29 -0
  174. package/src/simulation/pit/pitFlow.js +8 -30
  175. package/src/simulation/pit/pitIntent.js +4 -3
  176. package/src/simulation/pit/pitOccupancy.js +2 -2
  177. package/src/simulation/pit/pitQueue.js +2 -18
  178. package/src/simulation/pit/pitRouteMovement.js +1 -36
  179. package/src/simulation/pit/pitRouting.js +5 -81
  180. package/src/simulation/pit/pitService.js +3 -32
  181. package/src/simulation/pit/pitServiceConstants.js +1 -0
  182. package/src/simulation/pit/pitServiceProgress.js +34 -0
  183. package/src/simulation/pit/pitSnapshots.js +8 -4
  184. package/src/simulation/pit/pitState.js +1 -5
  185. package/src/simulation/race/classification.js +1 -8
  186. package/src/simulation/race/raceFinish.js +3 -8
  187. package/src/simulation/race/raceOrder.js +2 -13
  188. package/src/simulation/race/raceProgress.js +6 -20
  189. package/src/simulation/race/raceSetup.js +1 -1
  190. package/src/simulation/race/raceStep.js +20 -11
  191. package/src/simulation/race/redFlag.js +2 -4
  192. package/src/simulation/race/safetyCar.js +5 -9
  193. package/src/simulation/race/stalledDnf.js +2 -4
  194. package/src/simulation/raceSimulation.js +6 -38
  195. package/src/simulation/replay/replayGhosts.js +44 -32
  196. package/src/simulation/rules/collisionSteward.js +0 -14
  197. package/src/simulation/rules/penaltyActions.js +37 -0
  198. package/src/simulation/rules/penaltyLedger.js +8 -1
  199. package/src/simulation/rules/pitLaneSpeedingSteward.js +1 -1
  200. package/src/simulation/rules/rulesReview.js +20 -16
  201. package/src/simulation/rules/trackLimitsSteward.js +2 -2
  202. package/src/simulation/simMath.js +4 -0
  203. package/src/simulation/snapshots/raceSnapshots.js +30 -11
  204. package/src/simulation/timing/drsState.js +8 -0
  205. package/src/simulation/timing/drsTiming.js +2 -4
  206. package/src/simulation/timing/lapTelemetry.js +7 -4
  207. package/src/simulation/timing/sectorPerformance.js +14 -6
  208. package/src/simulation/timing/timingLines.js +12 -6
  209. package/src/simulation/track/pitLaneAccess.js +2 -2
  210. package/src/simulation/track/pitLaneLayout.js +4 -135
  211. package/src/simulation/track/pitLaneModel.js +70 -0
  212. package/src/simulation/track/pitLaneState.js +0 -1
  213. package/src/simulation/track/pitServiceLayout.js +121 -0
  214. package/src/simulation/track/proceduralTrack.js +77 -0
  215. package/src/simulation/track/spatialQueries.js +76 -31
  216. package/src/simulation/track/trackBuilder.js +54 -0
  217. package/src/simulation/track/trackConstants.js +0 -22
  218. package/src/simulation/track/trackMath.js +4 -29
  219. package/src/simulation/track/trackModel.js +12 -240
  220. package/src/simulation/track/trackModelCache.js +105 -0
  221. package/src/simulation/track/trackNearestQueries.js +1218 -0
  222. package/src/simulation/track/trackQueryConstants.js +3 -0
  223. package/src/simulation/track/trackQueryConstruction.js +368 -0
  224. package/src/simulation/track/trackQueryIndex.js +12 -1933
  225. package/src/simulation/track/trackQuerySegments.js +174 -0
  226. package/src/simulation/track/trackQueryStats.js +12 -0
  227. package/src/simulation/track/trackRayQueries.js +165 -0
  228. package/src/simulation/vehicle/advancedContactResponse.js +89 -0
  229. package/src/simulation/vehicle/advancedTireForces.js +92 -0
  230. package/src/simulation/vehicle/advancedVehicleModel.js +65 -0
  231. package/src/simulation/vehicle/advancedVehiclePhysics.js +127 -0
  232. package/src/simulation/vehicle/contactResolution.js +23 -9
  233. package/src/simulation/vehicle/mainTrackWheelSurface.js +2 -13
  234. package/src/simulation/vehicle/pitWheelSurface.js +0 -12
  235. package/src/simulation/vehicle/runoffResponse.js +2 -4
  236. package/src/simulation/vehicle/sampledWheelSurface.js +266 -0
  237. package/src/simulation/vehicle/vehicleGeometry.js +85 -103
  238. package/src/simulation/vehicle/vehicleKinematics.js +10 -0
  239. package/src/simulation/vehicle/vehiclePhysics.js +42 -196
  240. package/src/simulation/vehicle/vehicleSnapshots.js +18 -6
  241. package/src/simulation/vehicle/vehicleState.js +5 -3
  242. package/src/simulation/vehicle/wheelSurface.js +13 -432
  243. package/src/simulation/vehicle/wheelSurfaceCache.js +55 -0
  244. package/src/simulation/vehicle/wheelSurfaceSummary.js +101 -0
  245. package/src/styles.css +173 -19
  246. package/src/ui/bannerTemplates.js +4 -2
  247. package/src/ui/cameraControlsTemplate.js +4 -2
  248. package/src/ui/gridWalkTemplate.js +29 -0
  249. package/src/ui/htmlEscaping.js +8 -0
  250. package/src/ui/raceCanvasTemplate.js +3 -2
  251. package/src/ui/shellTemplate.js +3 -0
  252. package/src/ui/telemetryDrawerTemplate.js +4 -2
  253. package/src/ui/telemetryTemplates.js +3 -22
  254. package/src/ui/templateUtils.js +2 -8
  255. package/src/ui/viewControlsTemplate.js +21 -0
  256. package/examples/train-basic-policy.mjs +0 -276
  257. package/examples/trainingData.mjs +0 -133
@@ -0,0 +1,257 @@
1
+ import { toKebabCase } from './themeUtils.js';
2
+
3
+ export const THEME_MODES = new Set(['dark', 'light', 'system']);
4
+
5
+ export const THEME_COLOR_TOKEN_KEYS = [
6
+ 'primary',
7
+ 'primaryText',
8
+ 'secondary',
9
+ 'secondaryText',
10
+ 'surface',
11
+ 'surfaceRaised',
12
+ 'surfacePanel',
13
+ 'text',
14
+ 'mutedText',
15
+ 'border',
16
+ 'success',
17
+ 'warning',
18
+ 'danger',
19
+ 'info',
20
+ 'yellowFlag',
21
+ 'greenFlag',
22
+ 'redFlag',
23
+ 'safetyCar',
24
+ 'drsActive',
25
+ 'pitLane',
26
+ 'track',
27
+ 'trackEdge',
28
+ ];
29
+
30
+ export const THEME_SIZE_TOKEN_KEYS = [
31
+ 'timingTowerMaxWidth',
32
+ 'raceViewMinHeight',
33
+ ];
34
+
35
+ export const THEME_TOKEN_KEYS = [...THEME_COLOR_TOKEN_KEYS, ...THEME_SIZE_TOKEN_KEYS];
36
+ export const PADDOCK_THEME_TOKEN_KEYS = THEME_TOKEN_KEYS;
37
+ export const THEME_TOKEN_SET = new Set(THEME_TOKEN_KEYS);
38
+
39
+ export const LEGACY_TOKEN_ALIASES = {
40
+ accentColor: 'primary',
41
+ greenColor: 'greenFlag',
42
+ yellowColor: 'yellowFlag',
43
+ blueColor: 'info',
44
+ raceControlRedColor: 'redFlag',
45
+ surfaceColor: 'surface',
46
+ surfaceRaisedColor: 'surfaceRaised',
47
+ surfacePanelColor: 'surfacePanel',
48
+ lineColor: 'border',
49
+ lineStrongColor: 'border',
50
+ textColor: 'text',
51
+ mutedTextColor: 'mutedText',
52
+ trackColor: 'track',
53
+ trackEdgeColor: 'trackEdge',
54
+ };
55
+
56
+ export const LEGACY_ALIAS_KEYS = Object.keys(LEGACY_TOKEN_ALIASES);
57
+
58
+ export const PADDOCK_THEME_CSS_VARIABLES = {
59
+ primary: '--paddock-color-primary',
60
+ primaryText: '--paddock-color-primary-text',
61
+ secondary: '--paddock-color-secondary',
62
+ secondaryText: '--paddock-color-secondary-text',
63
+ surface: '--paddock-color-surface',
64
+ surfaceRaised: '--paddock-color-surface-raised',
65
+ surfacePanel: '--paddock-color-surface-panel',
66
+ text: '--paddock-color-text',
67
+ mutedText: '--paddock-color-muted-text',
68
+ border: '--paddock-color-border',
69
+ success: '--paddock-color-success',
70
+ warning: '--paddock-color-warning',
71
+ danger: '--paddock-color-danger',
72
+ info: '--paddock-color-info',
73
+ yellowFlag: '--paddock-color-yellow-flag',
74
+ greenFlag: '--paddock-color-green-flag',
75
+ redFlag: '--paddock-color-red-flag',
76
+ safetyCar: '--paddock-color-safety-car',
77
+ drsActive: '--paddock-color-drs-active',
78
+ pitLane: '--paddock-color-pit-lane',
79
+ track: '--paddock-color-track',
80
+ trackEdge: '--paddock-color-track-edge',
81
+ timingTowerMaxWidth: '--paddock-timing-tower-max-width',
82
+ raceViewMinHeight: '--paddock-race-view-min-height',
83
+ };
84
+
85
+ export const LEGACY_THEME_CSS_VARIABLES = {
86
+ accentColor: '--paddock-accent-color',
87
+ greenColor: '--paddock-green-color',
88
+ yellowColor: '--paddock-yellow-color',
89
+ blueColor: '--paddock-blue-color',
90
+ raceControlRedColor: '--paddock-race-control-red-color',
91
+ surfaceColor: '--paddock-surface-color',
92
+ surfaceRaisedColor: '--paddock-surface-raised-color',
93
+ surfacePanelColor: '--paddock-surface-panel-color',
94
+ lineColor: '--paddock-line-color',
95
+ lineStrongColor: '--paddock-line-strong-color',
96
+ textColor: '--paddock-text-color',
97
+ mutedTextColor: '--paddock-muted-text-color',
98
+ trackColor: '--paddock-track-color',
99
+ trackEdgeColor: '--paddock-track-edge-color',
100
+ };
101
+
102
+ export const DEFAULT_COMPONENT_SLOTS = {
103
+ button: {
104
+ background: 'primary',
105
+ text: 'primaryText',
106
+ border: 'primary',
107
+ },
108
+ raceControls: {
109
+ background: 'surfacePanel',
110
+ text: 'text',
111
+ border: 'border',
112
+ accent: 'primary',
113
+ },
114
+ cameraControls: {
115
+ background: 'surfacePanel',
116
+ text: 'text',
117
+ border: 'border',
118
+ accent: 'primary',
119
+ },
120
+ timingTower: {
121
+ shellBackground: 'surfacePanel',
122
+ rowBackground: 'surfaceRaised',
123
+ driverText: 'text',
124
+ gapText: 'mutedText',
125
+ warningText: 'yellowFlag',
126
+ },
127
+ raceCanvas: {
128
+ track: 'track',
129
+ trackEdge: 'trackEdge',
130
+ pitLane: 'pitLane',
131
+ },
132
+ raceDataPanel: {
133
+ background: 'surfacePanel',
134
+ text: 'text',
135
+ accent: 'primary',
136
+ },
137
+ selectedDriverPanel: {
138
+ background: 'surfacePanel',
139
+ text: 'text',
140
+ accent: 'primary',
141
+ },
142
+ driverRows: {
143
+ background: 'surfaceRaised',
144
+ text: 'text',
145
+ accent: 'primary',
146
+ },
147
+ };
148
+
149
+ export const DEFAULT_COMPONENT_THEME_SELECTORS = {
150
+ 'car-driver-overview': 'selectedTeam',
151
+ 'race-data-panel': 'selectedTeam',
152
+ };
153
+
154
+ const PADDOCK_COMPONENT_SLOT_CSS_VARIABLES = Object.entries(DEFAULT_COMPONENT_SLOTS).flatMap(([componentName, slots]) => (
155
+ Object.keys(slots).map((slot) => `--paddock-${toKebabCase(componentName)}-${toKebabCase(slot)}`)
156
+ ));
157
+
158
+ export const PADDOCK_THEME_SCOPED_CSS_VARIABLES = [
159
+ ...new Set([
160
+ ...Object.values(PADDOCK_THEME_CSS_VARIABLES),
161
+ ...Object.values(LEGACY_THEME_CSS_VARIABLES),
162
+ ...PADDOCK_COMPONENT_SLOT_CSS_VARIABLES,
163
+ ]),
164
+ ];
165
+
166
+ export const PACKAGE_COMPONENT_THEME_KEYS = new Set([
167
+ 'button',
168
+ 'race-controls',
169
+ 'camera-controls',
170
+ 'safety-car-control',
171
+ 'timing-tower',
172
+ 'race-canvas',
173
+ 'race-data-panel',
174
+ 'car-driver-overview',
175
+ 'race-telemetry-drawer',
176
+ 'telemetry-stack',
177
+ 'telemetry-core',
178
+ 'telemetry-sectors',
179
+ 'telemetry-lap-times',
180
+ 'telemetry-sector-times',
181
+ 'telemetry-sector-banner',
182
+ 'steward-message',
183
+ 'driver-rows',
184
+ ]);
185
+
186
+ export const COMPONENT_THEME_SELECTOR_ALIASES = {
187
+ selectedDriverPanel: ['car-driver-overview', 'race-data-panel'],
188
+ carDriverOverview: ['car-driver-overview'],
189
+ };
190
+
191
+ export const DEFAULT_DARK_THEME_TOKENS = {
192
+ primary: '#e10600',
193
+ primaryText: '#ffffff',
194
+ secondary: '#151923',
195
+ secondaryText: '#f4f7fb',
196
+ surface: '#08090b',
197
+ surfaceRaised: '#111318',
198
+ surfacePanel: '#171a20',
199
+ text: '#f4f7fb',
200
+ mutedText: '#8d97a7',
201
+ border: 'rgba(255, 255, 255, 0.13)',
202
+ success: '#14c784',
203
+ warning: '#ffd166',
204
+ danger: '#e10600',
205
+ info: '#39a7ff',
206
+ yellowFlag: '#ffd166',
207
+ greenFlag: '#14c784',
208
+ redFlag: '#e10600',
209
+ safetyCar: '#f5c542',
210
+ drsActive: '#8b5cf6',
211
+ pitLane: '#2f3540',
212
+ track: '#262a31',
213
+ trackEdge: '#f4f7fb',
214
+ timingTowerMaxWidth: '390px',
215
+ raceViewMinHeight: '620px',
216
+ };
217
+
218
+ export const DEFAULT_LIGHT_THEME_TOKENS = {
219
+ primary: '#c90400',
220
+ primaryText: '#ffffff',
221
+ secondary: '#eef2f7',
222
+ secondaryText: '#111827',
223
+ surface: '#f6f8fb',
224
+ surfaceRaised: '#ffffff',
225
+ surfacePanel: '#eef2f7',
226
+ text: '#111827',
227
+ mutedText: '#5d6675',
228
+ border: 'rgba(17, 24, 39, 0.16)',
229
+ success: '#0f9f6a',
230
+ warning: '#b97800',
231
+ danger: '#c90400',
232
+ info: '#1e74c9',
233
+ yellowFlag: '#b97800',
234
+ greenFlag: '#0f9f6a',
235
+ redFlag: '#c90400',
236
+ safetyCar: '#b97800',
237
+ drsActive: '#6d28d9',
238
+ pitLane: '#d8dee8',
239
+ track: '#d7dde6',
240
+ trackEdge: '#111827',
241
+ timingTowerMaxWidth: '390px',
242
+ raceViewMinHeight: '620px',
243
+ };
244
+
245
+ export const DEFAULT_PADDOCK_THEME_INPUT = {
246
+ mode: 'dark',
247
+ use: 'default',
248
+ };
249
+ export const DEFAULT_PADDOCK_THEME = DEFAULT_PADDOCK_THEME_INPUT;
250
+
251
+ export const DEFAULT_THEME_PACKAGE = {
252
+ tokens: {
253
+ light: DEFAULT_LIGHT_THEME_TOKENS,
254
+ dark: DEFAULT_DARK_THEME_TOKENS,
255
+ },
256
+ components: DEFAULT_COMPONENT_SLOTS,
257
+ };
@@ -0,0 +1,15 @@
1
+ export function toKebabCase(value) {
2
+ return String(value)
3
+ .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
4
+ .replace(/_/g, '-')
5
+ .toLowerCase();
6
+ }
7
+
8
+ export function warnUnknownThemeKey(key) {
9
+ if (globalThis.process?.env?.NODE_ENV === 'production') return;
10
+ globalThis.console?.warn?.(`[PaddockJS] Ignoring unknown theme token or slot "${key}".`);
11
+ }
12
+
13
+ export function isPlainObject(value) {
14
+ return value != null && typeof value === 'object' && !Array.isArray(value);
15
+ }