@inventure71/paddockjs 0.1.0

package/src/app/domBindings.js

@@ -0,0 +1,64 @@
+export function querySimulatorDom(root) {
+  const readouts = {
+    timingTower: root.querySelector('[data-timing-tower]'),
+    mode: root.querySelector('[data-race-mode]'),
+    startLights: root.querySelector('[data-start-lights]'),
+    startLightsLabel: root.querySelector('[data-start-lights-label]'),
+    towerLap: root.querySelector('[data-tower-lap-readout]'),
+    towerTotalLaps: root.querySelector('[data-tower-total-laps]'),
+    towerSafetyBanner: root.querySelector('[data-tower-safety-banner]'),
+    timingGapLabel: root.querySelector('[data-timing-gap-label]'),
+    lap: root.querySelector('[data-lap-readout]'),
+    drs: root.querySelector('[data-drs-readout]'),
+    contacts: root.querySelector('[data-contact-readout]'),
+    camera: root.querySelector('[data-camera-readout]'),
+    fps: root.querySelector('[data-fps-readout]'),
+    selectedCode: root.querySelector('[data-selected-code]'),
+    selectedName: root.querySelector('[data-selected-name]'),
+    speed: root.querySelector('[data-telemetry-speed]'),
+    throttle: root.querySelector('[data-telemetry-throttle]'),
+    brake: root.querySelector('[data-telemetry-brake]'),
+    tyres: root.querySelector('[data-telemetry-tyres]'),
+    selectedDrs: root.querySelector('[data-telemetry-drs]'),
+    surface: root.querySelector('[data-telemetry-surface]'),
+    gap: root.querySelector('[data-telemetry-gap]'),
+    leaderGap: root.querySelector('[data-telemetry-leader-gap]'),
+    carOverview: root.querySelector('[data-paddock-component="car-driver-overview"]'),
+    carOverviewTitle: root.querySelector('[data-car-overview-title]'),
+    carOverviewDiagram: root.querySelector('.car-overview-diagram'),
+    carOverviewCode: root.querySelector('[data-car-overview-code]'),
+    carOverviewIcon: root.querySelector('[data-car-overview-icon]'),
+    carOverviewImage: root.querySelector('[data-car-overview-image]'),
+    carOverviewNumber: root.querySelector('[data-car-overview-number]'),
+    carOverviewCoreStat: root.querySelector('[data-car-overview-core-stat]'),
+    carOverviewFields: root.querySelectorAll('[data-overview-field]'),
+    raceDataPanel: root.querySelector('[data-race-data-panel]'),
+    raceDataKicker: root.querySelector('[data-race-data-kicker]'),
+    raceDataTitle: root.querySelector('[data-race-data-title]'),
+    raceDataNumber: root.querySelector('[data-race-data-number]'),
+    raceDataSubtitle: root.querySelector('[data-race-data-subtitle]'),
+    raceDataOpen: root.querySelector('[data-race-data-open]'),
+    finishPanel: root.querySelector('[data-race-finish-panel]'),
+    finishWinner: root.querySelector('[data-race-finish-winner]'),
+    finishClassification: root.querySelector('[data-race-finish-classification]'),
+  };
+
+  return {
+    canvasHost: root.querySelector('[data-track-canvas]'),
+    safetyButtons: root.querySelectorAll('[data-safety-car]'),
+    restartButton: root.querySelector('[data-restart-race]'),
+    openButton: root.querySelector('[data-race-data-open]'),
+    timingList: root.querySelector('[data-timing-list]'),
+    timingGapModeButtons: root.querySelectorAll('[data-timing-gap-mode]'),
+    cameraButtons: root.querySelectorAll('[data-camera-mode]'),
+    overviewModeButtons: root.querySelectorAll('[data-overview-mode]'),
+    zoomInButton: root.querySelector('[data-zoom-in]'),
+    zoomOutButton: root.querySelector('[data-zoom-out]'),
+    readouts,
+    startLightNodes: [...(readouts.startLights?.querySelectorAll('.start-lights__gantry span') ?? [])],
+  };
+}
+
+export function setText(node, value) {
+  if (node) node.textContent = value;
+}

package/src/config/defaultAssets.js

@@ -0,0 +1,29 @@
+import carSpriteUrl from '../../assets/f1-car-sprite-game.png';
+import safetyCarSpriteUrl from '../../assets/f1-safety-car-sprite.png';
+import broadcastPanelSurfaceUrl from '../../assets/f1-broadcast-panel-surface.png';
+import asphaltTextureUrl from '../../assets/f1-texture-asphalt.png';
+import f1LogoUrl from '../../assets/f1Logo.png';
+import driverHelmetUrl from '../../assets/f1-driver-helmet.png';
+
+export const DEFAULT_F1_SIMULATOR_ASSETS = {
+  car: carSpriteUrl,
+  carOverview: carSpriteUrl,
+  driverHelmet: driverHelmetUrl,
+  safetyCar: safetyCarSpriteUrl,
+  broadcastPanel: broadcastPanelSurfaceUrl,
+  f1Logo: f1LogoUrl,
+  trackTextures: {
+    asphalt: asphaltTextureUrl,
+  },
+};
+
+export function resolveF1SimulatorAssets(overrides = {}) {
+  return {
+    ...DEFAULT_F1_SIMULATOR_ASSETS,
+    ...overrides,
+    trackTextures: {
+      ...DEFAULT_F1_SIMULATOR_ASSETS.trackTextures,
+      ...(overrides.trackTextures ?? {}),
+    },
+  };
+}

package/src/config/defaultOptions.js

@@ -0,0 +1,184 @@
+import { resolveF1SimulatorAssets } from './defaultAssets.js';
+import { CHAMPIONSHIP_ENTRY_BLUEPRINTS } from '../data/championship.js';
+import { normalizeSimulatorDrivers } from '../data/normalizeDrivers.js';
+
+export const DEFAULT_F1_SIMULATOR_OPTIONS = {
+  seed: 1971,
+  totalLaps: 10,
+  initialCameraMode: 'leader',
+  title: 'F1 Simulator Lab',
+  kicker: 'Race Control',
+  backLinkHref: 'projects.html',
+  backLinkLabel: 'Projects',
+  showBackLink: true,
+  ui: {
+    layoutPreset: 'standard',
+    cameraControls: 'embedded',
+    showFps: true,
+    showTimingTower: true,
+    showTelemetry: true,
+    telemetryIncludesOverview: true,
+    showRaceDataPanel: true,
+    raceDataBanners: {
+      initial: 'project',
+      enabled: ['project', 'radio'],
+    },
+    raceDataBannerSize: 'custom',
+    timingTowerVerticalFit: 'expand-race-view',
+  },
+  theme: {
+    accentColor: '#e10600',
+    greenColor: '#14c784',
+    yellowColor: '#ffd166',
+    timingTowerMaxWidth: '390px',
+    raceViewMinHeight: '620px',
+  },
+};
+
+export const PADDOCK_SIMULATOR_PRESETS = {
+  dashboard: {
+    ui: {
+      layoutPreset: 'standard',
+      cameraControls: 'embedded',
+      showFps: true,
+      showTimingTower: true,
+      showTelemetry: true,
+      showRaceDataPanel: true,
+      raceDataBannerSize: 'custom',
+      timingTowerVerticalFit: 'expand-race-view',
+    },
+  },
+  'timing-overlay': {
+    ui: {
+      layoutPreset: 'left-tower-overlay',
+      cameraControls: 'external',
+      showFps: false,
+      showTimingTower: true,
+      showTelemetry: true,
+      showRaceDataPanel: true,
+      raceDataBannerSize: 'auto',
+      timingTowerVerticalFit: 'expand-race-view',
+      raceDataBanners: {
+        initial: 'project',
+        enabled: ['project', 'radio'],
+      },
+    },
+  },
+  'compact-race': {
+    ui: {
+      layoutPreset: 'standard',
+      cameraControls: 'embedded',
+      showFps: false,
+      showTimingTower: false,
+      showTelemetry: false,
+      showRaceDataPanel: true,
+      raceDataBannerSize: 'auto',
+      timingTowerVerticalFit: 'scroll',
+    },
+    theme: {
+      timingTowerMaxWidth: '340px',
+      raceViewMinHeight: '460px',
+    },
+  },
+  'full-dashboard': {
+    ui: {
+      layoutPreset: 'standard',
+      cameraControls: 'external',
+      showFps: true,
+      showTimingTower: true,
+      showTelemetry: true,
+      telemetryIncludesOverview: true,
+      showRaceDataPanel: true,
+      raceDataBannerSize: 'custom',
+      timingTowerVerticalFit: 'expand-race-view',
+    },
+  },
+};
+
+export const PADDOCK_THEME_CSS_VARIABLES = {
+  accentColor: '--paddock-accent-color',
+  greenColor: '--paddock-green-color',
+  yellowColor: '--paddock-yellow-color',
+  timingTowerMaxWidth: '--paddock-timing-tower-max-width',
+  raceViewMinHeight: '--paddock-race-view-min-height',
+};
+
+export function resolveF1SimulatorOptions(options = {}) {
+  const presetName = Object.hasOwn(PADDOCK_SIMULATOR_PRESETS, options.preset)
+    ? options.preset
+    : null;
+  const preset = presetName ? PADDOCK_SIMULATOR_PRESETS[presetName] : {};
+  const requestedUi = options.ui ?? {};
+  const presetUi = preset.ui ?? {};
+  const ui = {
+    ...DEFAULT_F1_SIMULATOR_OPTIONS.ui,
+    ...presetUi,
+    ...requestedUi,
+    raceDataBanners: {
+      ...DEFAULT_F1_SIMULATOR_OPTIONS.ui.raceDataBanners,
+      ...(presetUi.raceDataBanners ?? {}),
+      ...(requestedUi.raceDataBanners ?? {}),
+    },
+  };
+  ui.raceDataBanners.enabled = normalizeEnabledBanners(ui.raceDataBanners.enabled);
+  if (!['project', 'radio', 'hidden'].includes(ui.raceDataBanners.initial)) {
+    ui.raceDataBanners.initial = DEFAULT_F1_SIMULATOR_OPTIONS.ui.raceDataBanners.initial;
+  }
+  if (ui.raceDataBanners.initial !== 'hidden' && !ui.raceDataBanners.enabled.includes(ui.raceDataBanners.initial)) {
+    ui.raceDataBanners.initial = 'hidden';
+  }
+  if (!['expand-race-view', 'scroll'].includes(ui.timingTowerVerticalFit)) {
+    ui.timingTowerVerticalFit = DEFAULT_F1_SIMULATOR_OPTIONS.ui.timingTowerVerticalFit;
+  }
+  if (!['auto', 'custom'].includes(ui.raceDataBannerSize)) {
+    ui.raceDataBannerSize = DEFAULT_F1_SIMULATOR_OPTIONS.ui.raceDataBannerSize;
+  }
+  const mergedOptions = {
+    ...DEFAULT_F1_SIMULATOR_OPTIONS,
+    ...preset,
+    ...options,
+  };
+  const theme = normalizeTheme({
+    ...DEFAULT_F1_SIMULATOR_OPTIONS.theme,
+    ...(preset.theme ?? {}),
+    ...(options.theme ?? {}),
+  });
+  const drivers = normalizeSimulatorDrivers(mergedOptions.drivers, {
+    entries: mergedOptions.entries ?? CHAMPIONSHIP_ENTRY_BLUEPRINTS,
+  });
+
+  return {
+    ...DEFAULT_F1_SIMULATOR_OPTIONS,
+    ...preset,
+    ...options,
+    preset: presetName ?? options.preset,
+    ui,
+    theme,
+    drivers,
+    assets: resolveF1SimulatorAssets(options.assets),
+  };
+}
+
+export function applyPaddockThemeCssVariables(root, theme = DEFAULT_F1_SIMULATOR_OPTIONS.theme) {
+  Object.entries(PADDOCK_THEME_CSS_VARIABLES).forEach(([key, variable]) => {
+    const value = theme?.[key];
+    if (value == null || value === '') return;
+    root?.style?.setProperty?.(variable, String(value));
+  });
+}
+
+function normalizeEnabledBanners(value) {
+  if (value === false) return [];
+  if (value === true || value == null) return [...DEFAULT_F1_SIMULATOR_OPTIONS.ui.raceDataBanners.enabled];
+  if (!Array.isArray(value)) return [...DEFAULT_F1_SIMULATOR_OPTIONS.ui.raceDataBanners.enabled];
+  return [...new Set(value.filter((item) => item === 'project' || item === 'radio'))];
+}
+
+function normalizeTheme(theme) {
+  return Object.fromEntries(
+    Object.entries(DEFAULT_F1_SIMULATOR_OPTIONS.theme).map(([key, fallback]) => [
+      key,
+      theme?.[key] == null || theme?.[key] === '' ? fallback : theme[key],
+    ]),
+  );
+}

package/src/data/championship.js

@@ -0,0 +1,225 @@
+import { DriverData } from './driverData.js';
+import { DEMO_PROJECT_DRIVERS } from './demoDrivers.js';
+import { VehicleData } from './vehicleData.js';
+
+export { DriverData, DRIVER_STAT_DEFINITIONS } from './driverData.js';
+export { VehicleData, VEHICLE_STAT_DEFINITIONS } from './vehicleData.js';
+
+export const CHAMPIONSHIP = {
+  id: 'project-race-2026',
+  name: 'Project Race',
+  season: 2026,
+};
+
+export const CHAMPIONSHIP_ENTRY_BLUEPRINTS = [
+  {
+    driverId: 'budget',
+    driverNumber: 71,
+    timingName: 'Budget',
+    driver: new DriverData({ pace: 52, racecraft: 74, aggression: 38, riskTolerance: 47, patience: 81, consistency: 86 }),
+    vehicle: new VehicleData({ id: 'budget-bb01', name: 'BB-01 Ledger', power: 48, braking: 72, aero: 55, dragEfficiency: 66, mechanicalGrip: 63, weightControl: 58, tireCare: 82 }),
+  },
+  {
+    driverId: 'noir',
+    driverNumber: 13,
+    timingName: 'Noir',
+    driver: new DriverData({ pace: 68, racecraft: 83, aggression: 61, riskTolerance: 72, patience: 57, consistency: 64 }),
+    vehicle: new VehicleData({ id: 'noir-nn13', name: 'NN-13 Shadow', power: 64, braking: 60, aero: 73, dragEfficiency: 57, mechanicalGrip: 69, weightControl: 54, tireCare: 51 }),
+  },
+  {
+    driverId: 'vinyl',
+    driverNumber: 33,
+    timingName: 'HoloVinyl',
+    driver: new DriverData({ pace: 71, racecraft: 66, aggression: 52, riskTolerance: 59, patience: 62, consistency: 58 }),
+    vehicle: new VehicleData({ id: 'vinyl-hv33', name: 'HV-33 Groove', power: 70, braking: 49, aero: 58, dragEfficiency: 74, mechanicalGrip: 52, weightControl: 68, tireCare: 46 }),
+  },
+  {
+    driverId: 'drsorriso',
+    driverNumber: 55,
+    timingName: 'DrSorriso',
+    driver: new DriverData({ pace: 46, racecraft: 69, aggression: 44, riskTolerance: 43, patience: 76, consistency: 73 }),
+    vehicle: new VehicleData({ id: 'sorriso-ds55', name: 'DS-55 Intake', power: 54, braking: 67, aero: 62, dragEfficiency: 49, mechanicalGrip: 71, weightControl: 45, tireCare: 69 }),
+  },
+  {
+    driverId: 'victoria',
+    driverNumber: 11,
+    timingName: 'VictorIA',
+    driver: new DriverData({ pace: 78, racecraft: 79, aggression: 58, riskTolerance: 65, patience: 55, consistency: 68 }),
+    vehicle: new VehicleData({ id: 'victoria-vi11', name: 'VI-11 Vector', power: 76, braking: 58, aero: 65, dragEfficiency: 63, mechanicalGrip: 61, weightControl: 60, tireCare: 48 }),
+  },
+  {
+    driverId: 'reminderz',
+    driverNumber: 7,
+    timingName: 'ReminderZ',
+    driver: new DriverData({ pace: 41, racecraft: 61, aggression: 34, riskTolerance: 39, patience: 85, consistency: 80 }),
+    vehicle: new VehicleData({ id: 'reminderz-rz07', name: 'RZ-07 Recall', power: 42, braking: 76, aero: 50, dragEfficiency: 72, mechanicalGrip: 58, weightControl: 63, tireCare: 88 }),
+  },
+  {
+    driverId: 'clipclop',
+    driverNumber: 14,
+    timingName: 'ClipClop',
+    driver: new DriverData({ pace: 73, racecraft: 88, aggression: 76, riskTolerance: 78, patience: 48, consistency: 61 }),
+    vehicle: new VehicleData({ id: 'clipclop-cc14', name: 'CC-14 Sync', power: 68, braking: 63, aero: 59, dragEfficiency: 61, mechanicalGrip: 78, weightControl: 56, tireCare: 44 }),
+  },
+  {
+    driverId: 'evolve',
+    driverNumber: 23,
+    timingName: 'Evolve',
+    driver: new DriverData({ pace: 56, racecraft: 70, aggression: 63, riskTolerance: 61, patience: 58, consistency: 52 }),
+    vehicle: new VehicleData({ id: 'evolve-ev23', name: 'EV-23 Morph', power: 60, braking: 53, aero: 79, dragEfficiency: 46, mechanicalGrip: 66, weightControl: 49, tireCare: 57 }),
+  },
+  {
+    driverId: 'clash',
+    driverNumber: 47,
+    timingName: 'Clash',
+    driver: new DriverData({ pace: 44, racecraft: 67, aggression: 70, riskTolerance: 69, patience: 42, consistency: 59 }),
+    vehicle: new VehicleData({ id: 'clash-cr47', name: 'CR-47 Arena', power: 57, braking: 48, aero: 52, dragEfficiency: 55, mechanicalGrip: 73, weightControl: 52, tireCare: 64 }),
+  },
+  {
+    driverId: 'core',
+    driverNumber: 91,
+    timingName: 'Core',
+    driver: new DriverData({ pace: 82, racecraft: 85, aggression: 67, riskTolerance: 74, patience: 53, consistency: 72 }),
+    vehicle: new VehicleData({ id: 'core-ai91', name: 'AI-91 Core', power: 80, braking: 61, aero: 72, dragEfficiency: 59, mechanicalGrip: 75, weightControl: 51, tireCare: 50 }),
+  },
+];
+
+export const CHAMPIONSHIP_DRIVER_ENTRIES = CHAMPIONSHIP_ENTRY_BLUEPRINTS.map((entry) => ({
+  driverId: entry.driverId,
+  driverNumber: entry.driverNumber,
+  timingName: entry.timingName,
+}));
+
+const LETTERS = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
+
+function normalizeLetters(value) {
+  return String(value ?? '')
+    .normalize('NFKD')
+    .replace(/[\u0300-\u036f]/g, '')
+    .replace(/[^a-zA-Z]/g, '')
+    .toUpperCase();
+}
+
+function timingCodeCandidates(source) {
+  const letters = normalizeLetters(source);
+  if (!letters) return ['XXX'];
+  if (letters.length <= 3) return [letters.padEnd(3, 'X')];
+
+  const candidates = [letters.slice(0, 3)];
+  for (let index = 1; index <= letters.length - 3; index += 1) {
+    candidates.push(letters.slice(index, index + 3));
+  }
+  candidates.push(`${letters[0]}${letters[1]}${letters[letters.length - 1]}`);
+  return [...new Set(candidates)];
+}
+
+function pickUniqueTimingCode(source, usedCodes) {
+  for (const candidate of timingCodeCandidates(source)) {
+    if (!usedCodes.has(candidate)) {
+      usedCodes.add(candidate);
+      return candidate;
+    }
+  }
+
+  const letters = normalizeLetters(source).padEnd(2, 'X');
+  for (const suffix of LETTERS) {
+    const candidate = `${letters[0]}${letters[1]}${suffix}`;
+    if (!usedCodes.has(candidate)) {
+      usedCodes.add(candidate);
+      return candidate;
+    }
+  }
+
+  throw new Error(`Unable to create a unique three-letter timing code for "${source}"`);
+}
+
+function assertUniqueDriverNumbers(entries) {
+  const seen = new Set();
+  entries.forEach((entry) => {
+    if (seen.has(entry.driverNumber)) {
+      throw new Error(`Duplicate championship driver number: ${entry.driverNumber}`);
+    }
+    seen.add(entry.driverNumber);
+  });
+}
+
+function buildDriverConstructorArgs(entry) {
+  const driver = entry.driver instanceof DriverData
+    ? entry.driver
+    : new DriverData(entry.driver ?? {});
+  return driver.toConstructorArgs();
+}
+
+function buildVehicleConstructorArgs(entry) {
+  const vehicle = entry.vehicle instanceof VehicleData
+    ? entry.vehicle
+    : new VehicleData(entry.vehicle ?? {});
+  return vehicle.toConstructorArgs();
+}
+
+export function formatDriverNumber(driverNumber) {
+  return String(driverNumber ?? '').padStart(2, '0');
+}
+
+function normalizeTeamIcon(source) {
+  const letters = normalizeLetters(source);
+  return letters.slice(0, 2).padEnd(2, 'X');
+}
+
+function normalizeTeam(team, driver, timingCode) {
+  const source = team ?? driver.team;
+  if (!source) return null;
+  const name = source.name ?? source.id ?? `${driver.name ?? timingCode} Team`;
+  const id = (source.id ?? normalizeLetters(name).toLowerCase()) || `${driver.id}-team`;
+  return {
+    ...source,
+    id,
+    name,
+    color: source.color ?? driver.color,
+    icon: source.icon ?? normalizeTeamIcon(source.name ?? source.id ?? timingCode ?? driver.name),
+  };
+}
+
+export function buildChampionshipDriverGrid(drivers = DEMO_PROJECT_DRIVERS, entries = CHAMPIONSHIP_DRIVER_ENTRIES) {
+  assertUniqueDriverNumbers(entries);
+
+  const entryByDriverId = new Map(entries.map((entry) => [entry.driverId, entry]));
+  const blueprintByDriverId = new Map(CHAMPIONSHIP_ENTRY_BLUEPRINTS.map((entry) => [entry.driverId, entry]));
+  const usedTimingCodes = new Set();
+
+  return drivers.map((driver, index) => {
+    const entry = {
+      ...(blueprintByDriverId.get(driver.id) ?? {}),
+      ...(entryByDriverId.get(driver.id) ?? {}),
+    };
+    const timingCode = pickUniqueTimingCode(entry.timingName ?? driver.timingName ?? driver.name ?? driver.code, usedTimingCodes);
+    const driverNumber = entry.driverNumber ?? driver.driverNumber ?? index + 1;
+    const driverArgs = buildDriverConstructorArgs({ driverId: driver.id, ...entry });
+    const vehicleArgs = buildVehicleConstructorArgs({ driverId: driver.id, ...entry });
+
+    return {
+      ...driver,
+      code: timingCode,
+      timingCode,
+      raceName: timingCode,
+      driverNumber,
+      team: normalizeTeam(entry.team, driver, timingCode),
+      pace: driverArgs.pace,
+      racecraft: driverArgs.racecraft,
+      consistency: driverArgs.consistency,
+      personality: driverArgs.personality,
+      vehicle: vehicleArgs,
+      constructorArgs: {
+        driver: driverArgs,
+        vehicle: vehicleArgs,
+      },
+      championship: {
+        ...CHAMPIONSHIP,
+        entryIndex: index,
+        vehicleId: vehicleArgs.id,
+      },
+    };
+  });
+}
+
+export const CHAMPIONSHIP_PROJECT_DRIVERS = buildChampionshipDriverGrid();

package/src/data/customFields.js

@@ -0,0 +1,14 @@
+export function normalizeCustomFields(customFields) {
+  if (!customFields) return [];
+
+  const entries = Array.isArray(customFields)
+    ? customFields
+    : Object.entries(customFields).map(([label, value]) => ({ label, value }));
+
+  return entries
+    .map((field) => ({
+      label: String(field?.label ?? '').trim(),
+      value: String(field?.value ?? '').trim(),
+    }))
+    .filter((field) => field.label && field.value);
+}

package/src/data/demoDrivers.js

@@ -0,0 +1,134 @@
+export const DEMO_PROJECT_DRIVERS = [
+  {
+    id: 'budget',
+    code: 'BUD',
+    icon: 'BB',
+    raceName: 'BUDGET',
+    name: 'Budget Buddy',
+    color: '#ff2d55',
+    tire: 'M',
+    pace: 0.98,
+    racecraft: 0.78,
+    link: '/project_details/project-budget-buddy.html',
+    raceData: ['AI finance coach', 'Python + LLM', 'Budget guardrails'],
+  },
+  {
+    id: 'noir',
+    code: 'NOI',
+    icon: 'NN',
+    raceName: 'NOIR',
+    name: 'Neural Noir',
+    color: '#ffb000',
+    tire: 'M',
+    pace: 1.01,
+    racecraft: 0.84,
+    link: '/project_details/project-neural-noir.html',
+    raceData: ['Procedural mystery', 'Gemini storytelling', 'Unreal loop'],
+  },
+  {
+    id: 'vinyl',
+    code: 'HOL',
+    icon: 'HV',
+    raceName: 'VINYL',
+    name: 'HoloVinyl',
+    color: '#00c2a8',
+    tire: 'H',
+    pace: 1.03,
+    racecraft: 0.75,
+    link: '/project_details/project-holovinyl.html',
+    raceData: ['Touchless DJ control', 'Computer vision', 'Hand tracking'],
+  },
+  {
+    id: 'drsorriso',
+    code: 'DRS',
+    icon: 'DR',
+    raceName: 'SORRISO',
+    name: 'DrSorrisoDonations',
+    color: '#e10600',
+    tire: 'S',
+    pace: 0.97,
+    racecraft: 0.73,
+    link: '/project_details/project-drsorrisodonations.html',
+    raceData: ['Donation intake', 'Database workflow', 'Automation tool'],
+  },
+  {
+    id: 'victoria',
+    code: 'VIC',
+    icon: 'VI',
+    raceName: 'VICTORIA',
+    name: 'VictorIA',
+    color: '#00a3ff',
+    tire: 'M',
+    pace: 1.04,
+    racecraft: 0.82,
+    link: '/project_details/project-victoria.html',
+    raceData: ['Game AI sandbox', 'Robotics ideas', 'Vision systems'],
+  },
+  {
+    id: 'reminderz',
+    code: 'REM',
+    icon: 'RZ',
+    raceName: 'REMIND',
+    name: 'ReminderZ',
+    color: '#a3e635',
+    tire: 'H',
+    pace: 0.95,
+    racecraft: 0.69,
+    link: '/project_details/project-remainder-v0.html',
+    raceData: ['Knowledge workflow', 'Personal graph', 'Capture tool'],
+  },
+  {
+    id: 'clipclop',
+    code: 'CLP',
+    icon: 'CC',
+    raceName: 'CLIPCLOP',
+    name: 'ClipClop',
+    color: '#f97316',
+    tire: 'S',
+    pace: 1.02,
+    racecraft: 0.88,
+    link: '/project_details/project-clipclop.html',
+    raceData: ['Mac + Android sync', 'Local clipboard', 'Productivity app'],
+  },
+  {
+    id: 'evolve',
+    code: 'EVL',
+    icon: 'EV',
+    raceName: 'EVOLVE',
+    name: 'EvolveProject',
+    color: '#d946ef',
+    tire: 'M',
+    pace: 0.99,
+    racecraft: 0.77,
+    link: '/project_details/project-evolveproject.html',
+    raceData: ['Creature cards', 'Generative AI', 'Unreal prototype'],
+  },
+  {
+    id: 'clash',
+    code: 'CRP',
+    icon: 'PY',
+    raceName: 'CLASH',
+    name: 'Clash Royale In Python',
+    color: '#22c55e',
+    tire: 'H',
+    pace: 0.96,
+    racecraft: 0.72,
+    link: '/project_details/project-algorithms-project.html',
+    raceData: ['Python arena', 'Pathfinding', 'Game algorithms'],
+  },
+  {
+    id: 'core',
+    code: 'COR',
+    icon: 'AI',
+    raceName: 'CORE',
+    name: 'Core Conflict',
+    color: '#38bdf8',
+    tire: 'M',
+    pace: 1.05,
+    racecraft: 0.86,
+    link: '/project_details/project-gengame.html',
+    raceData: ['Runtime AI agents', 'Multiplayer state', 'Game systems'],
+  },
+];
+
+export const PROJECT_DRIVERS = DEMO_PROJECT_DRIVERS;