@industry-theme/file-city-panel 0.3.2 → 0.3.3

package/dist/components/TourPlayer.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
-import type { IntroductionTour, IntroductionTourStep } from '../types/IntroductionTour';
+import type { IntroductionTour, IntroductionTourStep } from '@principal-ai/file-city-builder';
 import type { TextToSpeechAdapter, TourAudioContext } from '../types/TextToSpeech';
 export interface TourPlayerProps {
     /** The introduction tour to play */

package/dist/components/TourPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourPlayer.d.ts","sourceRoot":"","sources":["../../src/components/TourPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAiBxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACxF,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGnF,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,gBAAgB,CAAC;IAEvB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAEvE,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1E,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qIAAqI;IACrI,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAE3D,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA4/BhD,CAAC"}
+{"version":3,"file":"TourPlayer.d.ts","sourceRoot":"","sources":["../../src/components/TourPlayer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAiBxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGnF,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,IAAI,EAAE,gBAAgB,CAAC;IAEvB,2CAA2C;IAC3C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAEvE,+BAA+B;IAC/B,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB,uDAAuD;IACvD,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAE1E,yCAAyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,qIAAqI;IACrI,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;IAE3D,wDAAwD;IACxD,WAAW,CAAC,EAAE,OAAO,CAAC;IAGtB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,mBAAmB,CAAC;IAEjC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IAEpC,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,iEAAiE;IACjE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA4/BhD,CAAC"}

package/dist/components/TourPlayerIntegration.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
 import type { PanelEventBus } from '@principal-ade/panel-framework-core';
-import type { IntroductionTour } from '../types/IntroductionTour';
+import type { IntroductionTour } from '@principal-ai/file-city-builder';
 export interface TourPlayerIntegrationProps {
     /** The introduction tour */
     tour: IntroductionTour;

package/dist/components/TourPlayerIntegration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TourPlayerIntegration.d.ts","sourceRoot":"","sources":["../../src/components/TourPlayerIntegration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAA8C,MAAM,2BAA2B,CAAC;AAG9G,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IAEvB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,CAAC;IAEtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,gIAAgI;IAChI,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CAC5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CA4LtE,CAAC"}
+{"version":3,"file":"TourPlayerIntegration.d.ts","sourceRoot":"","sources":["../../src/components/TourPlayerIntegration.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiC,MAAM,OAAO,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,gBAAgB,EAA8C,MAAM,iCAAiC,CAAC;AAGpH,MAAM,WAAW,0BAA0B;IACzC,4BAA4B;IAC5B,IAAI,EAAE,gBAAgB,CAAC;IAEvB,0DAA0D;IAC1D,MAAM,EAAE,aAAa,CAAC;IAEtB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IAEjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,gIAAgI;IAChI,QAAQ,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;CAC5D;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,0BAA0B,CA4LtE,CAAC"}

package/dist/hooks/useTourPlayer.d.ts

@@ -1,4 +1,4 @@
-import type { IntroductionTour, IntroductionTourStep } from '../types/IntroductionTour';
+import type { IntroductionTour, IntroductionTourStep } from '@principal-ai/file-city-builder';
 export interface TourPlayerState {
     /** Current step index */
     currentStepIndex: number;

package/dist/hooks/useTourPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useTourPlayer.d.ts","sourceRoot":"","sources":["../../src/hooks/useTourPlayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAExF,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mBAAmB;IACnB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEzC,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IAEnB,gCAAgC;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,qBAAqB;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,uBAAuB;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,mCAAmC;IACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,qCAAqC;IACrC,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,CAAC;IAExB,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnE,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,CAAC,eAAe,EAAE,iBAAiB,CAAC,CA0GtC"}
+{"version":3,"file":"useTourPlayer.d.ts","sourceRoot":"","sources":["../../src/hooks/useTourPlayer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE9F,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,gBAAgB,EAAE,MAAM,CAAC;IAEzB,mBAAmB;IACnB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAEzC,8BAA8B;IAC9B,QAAQ,EAAE,OAAO,CAAC;IAElB,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IAEnB,gCAAgC;IAChC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAE5B,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,qBAAqB;IACrB,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAC;IAElB,uBAAuB;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,sBAAsB;IACtB,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB,0BAA0B;IAC1B,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,mCAAmC;IACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC,qCAAqC;IACrC,YAAY,EAAE,MAAM,IAAI,CAAC;IAEzB,+BAA+B;IAC/B,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,KAAK,EAAE,gBAAgB,CAAC;IAExB,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnE,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAExB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IAEpB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,oBAAoB,GAC5B,CAAC,eAAe,EAAE,iBAAiB,CAAC,CA0GtC"}

package/dist/panels.bundle.js

@@ -38567,16 +38567,244 @@ const files = {
   defaultConfig,
   includeUnmatched
 };
+class TourValidationError extends Error {
+  constructor(message, field, value) {
+    super(message);
+    this.field = field;
+    this.value = value;
+    this.name = "TourValidationError";
+  }
+}
+function isValidHexColor(color2) {
+  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color2);
+}
+function isValidVersion(version2) {
+  return /^\d+\.\d+\.\d+$/.test(version2);
+}
+function isValidRelativePath(path) {
+  return !path.startsWith("/");
+}
+function isValidKebabCase(id2) {
+  return /^[a-z0-9-]+$/.test(id2);
+}
+function validateStep(step, index2) {
+  const errors = [];
+  if (!step.id || typeof step.id !== "string") {
+    errors.push(new TourValidationError(`Step ${index2}: Missing or invalid 'id'`, "id", step.id));
+  } else if (!isValidKebabCase(step.id)) {
+    errors.push(new TourValidationError(`Step ${index2}: 'id' must be kebab-case (lowercase, numbers, hyphens only)`, "id", step.id));
+  }
+  if (!step.title || typeof step.title !== "string") {
+    errors.push(new TourValidationError(`Step ${index2}: Missing or invalid 'title'`, "title", step.title));
+  }
+  if (!step.description || typeof step.description !== "string") {
+    errors.push(new TourValidationError(`Step ${index2}: Missing or invalid 'description'`, "description", step.description));
+  }
+  if (step.estimatedTime !== void 0 && (typeof step.estimatedTime !== "number" || step.estimatedTime < 1)) {
+    errors.push(new TourValidationError(`Step ${index2}: 'estimatedTime' must be a positive number`, "estimatedTime", step.estimatedTime));
+  }
+  if (step.focusDirectory !== void 0) {
+    if (typeof step.focusDirectory !== "string") {
+      errors.push(new TourValidationError(`Step ${index2}: 'focusDirectory' must be a string`, "focusDirectory", step.focusDirectory));
+    } else if (!isValidRelativePath(step.focusDirectory)) {
+      errors.push(new TourValidationError(`Step ${index2}: 'focusDirectory' must be a relative path (no leading slash)`, "focusDirectory", step.focusDirectory));
+    }
+  }
+  if (step.autoAdvance && step.autoAdvanceDelay !== void 0) {
+    if (typeof step.autoAdvanceDelay !== "number" || step.autoAdvanceDelay < 1e3) {
+      errors.push(new TourValidationError(`Step ${index2}: 'autoAdvanceDelay' must be at least 1000ms when auto-advance is enabled`, "autoAdvanceDelay", step.autoAdvanceDelay));
+    }
+  }
+  if (step.highlightLayers) {
+    step.highlightLayers.forEach((layer, layerIndex) => {
+      if (!layer.id || !isValidKebabCase(layer.id)) {
+        errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}: Invalid layer 'id' (must be kebab-case)`, `highlightLayers[${layerIndex}].id`, layer.id));
+      }
+      if (!layer.color || !isValidHexColor(layer.color)) {
+        errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}: Invalid hex color`, `highlightLayers[${layerIndex}].color`, layer.color));
+      }
+      if (layer.opacity !== void 0 && (layer.opacity < 0 || layer.opacity > 1)) {
+        errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}: 'opacity' must be between 0 and 1`, `highlightLayers[${layerIndex}].opacity`, layer.opacity));
+      }
+      if (layer.borderWidth !== void 0 && layer.borderWidth < 0) {
+        errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}: 'borderWidth' must be positive`, `highlightLayers[${layerIndex}].borderWidth`, layer.borderWidth));
+      }
+      if (!layer.items || layer.items.length === 0) {
+        errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}: 'items' array must not be empty`, `highlightLayers[${layerIndex}].items`, layer.items));
+      } else {
+        layer.items.forEach((item, itemIndex) => {
+          if (!item.path || !isValidRelativePath(item.path)) {
+            errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}, Item ${itemIndex}: Invalid relative path`, `highlightLayers[${layerIndex}].items[${itemIndex}].path`, item.path));
+          }
+          if (!item.type || item.type !== "file" && item.type !== "directory") {
+            errors.push(new TourValidationError(`Step ${index2}, Layer ${layerIndex}, Item ${itemIndex}: 'type' must be 'file' or 'directory'`, `highlightLayers[${layerIndex}].items[${itemIndex}].type`, item.type));
+          }
+        });
+      }
+    });
+  }
+  if (step.highlightFiles) {
+    step.highlightFiles.forEach((filePath, fileIndex) => {
+      if (!isValidRelativePath(filePath)) {
+        errors.push(new TourValidationError(`Step ${index2}, highlightFiles[${fileIndex}]: Must be a relative path (no leading slash)`, `highlightFiles[${fileIndex}]`, filePath));
+      }
+    });
+  }
+  if (step.interactiveActions) {
+    step.interactiveActions.forEach((action, actionIndex) => {
+      const needsTarget = ["click-file", "hover-directory", "toggle-layer"].includes(action.type);
+      if (needsTarget && !action.target) {
+        errors.push(new TourValidationError(`Step ${index2}, Action ${actionIndex}: '${action.type}' requires a 'target'`, `interactiveActions[${actionIndex}].target`, action.target));
+      }
+    });
+  }
+  return errors;
+}
+function validateTour(tour) {
+  const errors = [];
+  if (!tour.id || typeof tour.id !== "string") {
+    errors.push(new TourValidationError("Missing or invalid 'id'", "id", tour.id));
+  } else if (!isValidKebabCase(tour.id)) {
+    errors.push(new TourValidationError("Tour 'id' must be kebab-case (lowercase, numbers, hyphens only)", "id", tour.id));
+  }
+  if (!tour.title || typeof tour.title !== "string") {
+    errors.push(new TourValidationError("Missing or invalid 'title'", "title", tour.title));
+  }
+  if (!tour.description || typeof tour.description !== "string") {
+    errors.push(new TourValidationError("Missing or invalid 'description'", "description", tour.description));
+  }
+  if (!tour.version || !isValidVersion(tour.version)) {
+    errors.push(new TourValidationError("Invalid 'version' - must be semantic version (e.g., '1.0.0')", "version", tour.version));
+  }
+  if (!tour.steps || !Array.isArray(tour.steps) || tour.steps.length === 0) {
+    errors.push(new TourValidationError("'steps' array must contain at least one step", "steps", tour.steps));
+  } else {
+    tour.steps.forEach((step, index2) => {
+      const stepErrors = validateStep(step, index2);
+      errors.push(...stepErrors);
+    });
+    const stepIds = /* @__PURE__ */ new Set();
+    tour.steps.forEach((step, index2) => {
+      if (stepIds.has(step.id)) {
+        errors.push(new TourValidationError(`Duplicate step ID '${step.id}' at index ${index2}`, "steps", step.id));
+      }
+      stepIds.add(step.id);
+    });
+  }
+  if (tour.audience !== void 0 && typeof tour.audience !== "string") {
+    errors.push(new TourValidationError(`Invalid 'audience' - must be a string`, "audience", tour.audience));
+  }
+  return errors;
+}
+function parseTour(jsonString) {
+  try {
+    const parsed = JSON.parse(jsonString);
+    if (typeof parsed !== "object" || parsed === null) {
+      return {
+        success: false,
+        errors: [new TourValidationError("Tour JSON must be an object")]
+      };
+    }
+    const errors = validateTour(parsed);
+    if (errors.length > 0) {
+      return {
+        success: false,
+        errors
+      };
+    }
+    return {
+      success: true,
+      tour: parsed
+    };
+  } catch (error) {
+    return {
+      success: false,
+      errors: [
+        new TourValidationError(`Failed to parse JSON: ${error instanceof Error ? error.message : "Unknown error"}`)
+      ]
+    };
+  }
+}
+function parseTourOrThrow(jsonString) {
+  var _a;
+  const result = parseTour(jsonString);
+  if (!result.success || !result.tour) {
+    const errorMessages2 = ((_a = result.errors) == null ? void 0 : _a.map((e) => e.message).join("\n")) || "Unknown error";
+    throw new TourValidationError(`Tour validation failed:
+${errorMessages2}`);
+  }
+  return result.tour;
+}
+function findTourFilePathInFileTree(fileTree) {
+  const tourFiles = fileTree.allFiles.filter((file) => {
+    const path = file.path;
+    return path.endsWith(".tour.json") && !path.includes("/");
+  });
+  tourFiles.sort((a, b) => a.path.localeCompare(b.path));
+  const tourFile = tourFiles[0];
+  return tourFile ? tourFile.path : null;
+}
+function findAllTourFilesInFileTree(fileTree) {
+  return fileTree.allFiles.filter((file) => file.path.endsWith(".tour.json")).map((file) => file.path).sort((a, b) => a.localeCompare(b));
+}
+async function loadTourFromFileTree(fileTree, readFile) {
+  const tourFilePath = findTourFilePathInFileTree(fileTree);
+  if (!tourFilePath) {
+    return {
+      success: false,
+      errors: [new TourValidationError("No *.tour.json file found in repository root")]
+    };
+  }
+  try {
+    const tourContent = await readFile(tourFilePath);
+    return parseTour(tourContent);
+  } catch (error) {
+    return {
+      success: false,
+      errors: [
+        new TourValidationError(`Failed to read tour file: ${error instanceof Error ? error.message : "Unknown error"}`)
+      ]
+    };
+  }
+}
+async function loadAllToursFromFileTree(fileTree, readFile) {
+  const tourPaths = findAllTourFilesInFileTree(fileTree);
+  const results = await Promise.all(tourPaths.map(async (path) => {
+    try {
+      const content = await readFile(path);
+      const result = parseTour(content);
+      return { path, result };
+    } catch (error) {
+      return {
+        path,
+        result: {
+          success: false,
+          errors: [
+            new TourValidationError(`Failed to read tour file: ${error instanceof Error ? error.message : "Unknown error"}`)
+          ]
+        }
+      };
+    }
+  }));
+  return results;
+}
 const dist = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
   __proto__: null,
   CodeCityBuilderWithGrid,
   CommonSorts,
   GridLayoutManager,
   MultiVersionCityBuilder,
+  TourValidationError,
   buildFileSystemTreeFromFileInfoList,
   buildMultiVersionCity,
   defaultFileColorConfig: files,
-  getFilesFromGitHubTree
+  findAllTourFilesInFileTree,
+  findTourFilePathInFileTree,
+  getFilesFromGitHubTree,
+  loadAllToursFromFileTree,
+  loadTourFromFileTree,
+  parseTour,
+  parseTourOrThrow
 }, Symbol.toStringTag, { value: "Module" }));
 const require$$6 = /* @__PURE__ */ getAugmentedNamespace(dist);
 var fileColorOverrides = {};
@@ -53267,272 +53495,6 @@ function getLayersForColorMode(mode, buildings, qualityData, fileColorLayers, gi
     }
   }
 }
-class TourValidationError extends Error {
-  constructor(message, field, value) {
-    super(message);
-    this.field = field;
-    this.value = value;
-    this.name = "TourValidationError";
-  }
-}
-function isValidHexColor(color2) {
-  return /^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$/.test(color2);
-}
-function isValidVersion(version2) {
-  return /^\d+\.\d+\.\d+$/.test(version2);
-}
-function isValidRelativePath(path) {
-  return !path.startsWith("/");
-}
-function validateStep(step, index2) {
-  const errors = [];
-  if (!step.id || typeof step.id !== "string") {
-    errors.push(new TourValidationError(`Step ${index2}: Missing or invalid 'id'`, "id", step.id));
-  } else if (!/^[a-z0-9-]+$/.test(step.id)) {
-    errors.push(
-      new TourValidationError(
-        `Step ${index2}: 'id' must be kebab-case (lowercase, numbers, hyphens only)`,
-        "id",
-        step.id
-      )
-    );
-  }
-  if (!step.title || typeof step.title !== "string") {
-    errors.push(new TourValidationError(`Step ${index2}: Missing or invalid 'title'`, "title", step.title));
-  }
-  if (!step.description || typeof step.description !== "string") {
-    errors.push(
-      new TourValidationError(`Step ${index2}: Missing or invalid 'description'`, "description", step.description)
-    );
-  }
-  if (step.estimatedTime !== void 0 && (typeof step.estimatedTime !== "number" || step.estimatedTime < 1)) {
-    errors.push(
-      new TourValidationError(
-        `Step ${index2}: 'estimatedTime' must be a positive number`,
-        "estimatedTime",
-        step.estimatedTime
-      )
-    );
-  }
-  if (step.focusDirectory !== void 0) {
-    if (typeof step.focusDirectory !== "string") {
-      errors.push(
-        new TourValidationError(
-          `Step ${index2}: 'focusDirectory' must be a string`,
-          "focusDirectory",
-          step.focusDirectory
-        )
-      );
-    } else if (!isValidRelativePath(step.focusDirectory)) {
-      errors.push(
-        new TourValidationError(
-          `Step ${index2}: 'focusDirectory' must be a relative path (no leading slash)`,
-          "focusDirectory",
-          step.focusDirectory
-        )
-      );
-    }
-  }
-  if (step.autoAdvance && step.autoAdvanceDelay !== void 0) {
-    if (typeof step.autoAdvanceDelay !== "number" || step.autoAdvanceDelay < 1e3) {
-      errors.push(
-        new TourValidationError(
-          `Step ${index2}: 'autoAdvanceDelay' must be at least 1000ms when auto-advance is enabled`,
-          "autoAdvanceDelay",
-          step.autoAdvanceDelay
-        )
-      );
-    }
-  }
-  if (step.highlightLayers) {
-    step.highlightLayers.forEach((layer, layerIndex) => {
-      if (!layer.id || !/^[a-z0-9-]+$/.test(layer.id)) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Layer ${layerIndex}: Invalid layer 'id'`,
-            `highlightLayers[${layerIndex}].id`,
-            layer.id
-          )
-        );
-      }
-      if (!layer.color || !isValidHexColor(layer.color)) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Layer ${layerIndex}: Invalid hex color`,
-            `highlightLayers[${layerIndex}].color`,
-            layer.color
-          )
-        );
-      }
-      if (layer.opacity !== void 0 && (layer.opacity < 0 || layer.opacity > 1)) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Layer ${layerIndex}: 'opacity' must be between 0 and 1`,
-            `highlightLayers[${layerIndex}].opacity`,
-            layer.opacity
-          )
-        );
-      }
-      if (layer.borderWidth !== void 0 && layer.borderWidth < 0) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Layer ${layerIndex}: 'borderWidth' must be positive`,
-            `highlightLayers[${layerIndex}].borderWidth`,
-            layer.borderWidth
-          )
-        );
-      }
-      if (!layer.items || layer.items.length === 0) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Layer ${layerIndex}: 'items' array must not be empty`,
-            `highlightLayers[${layerIndex}].items`,
-            layer.items
-          )
-        );
-      } else {
-        layer.items.forEach((item, itemIndex) => {
-          if (!item.path || !isValidRelativePath(item.path)) {
-            errors.push(
-              new TourValidationError(
-                `Step ${index2}, Layer ${layerIndex}, Item ${itemIndex}: Invalid relative path`,
-                `highlightLayers[${layerIndex}].items[${itemIndex}].path`,
-                item.path
-              )
-            );
-          }
-          if (!item.type || item.type !== "file" && item.type !== "directory") {
-            errors.push(
-              new TourValidationError(
-                `Step ${index2}, Layer ${layerIndex}, Item ${itemIndex}: 'type' must be 'file' or 'directory'`,
-                `highlightLayers[${layerIndex}].items[${itemIndex}].type`,
-                item.type
-              )
-            );
-          }
-        });
-      }
-    });
-  }
-  if (step.highlightFiles) {
-    step.highlightFiles.forEach((filePath, fileIndex) => {
-      if (!isValidRelativePath(filePath)) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, highlightFiles[${fileIndex}]: Must be a relative path (no leading slash)`,
-            `highlightFiles[${fileIndex}]`,
-            filePath
-          )
-        );
-      }
-    });
-  }
-  if (step.interactiveActions) {
-    step.interactiveActions.forEach((action, actionIndex) => {
-      const needsTarget = ["click-file", "hover-directory", "toggle-layer"].includes(action.type);
-      if (needsTarget && !action.target) {
-        errors.push(
-          new TourValidationError(
-            `Step ${index2}, Action ${actionIndex}: '${action.type}' requires a 'target'`,
-            `interactiveActions[${actionIndex}].target`,
-            action.target
-          )
-        );
-      }
-    });
-  }
-  return errors;
-}
-function validateTour(tour) {
-  const errors = [];
-  if (!tour.id || typeof tour.id !== "string") {
-    errors.push(new TourValidationError("Missing or invalid 'id'", "id", tour.id));
-  } else if (!/^[a-z0-9-]+$/.test(tour.id)) {
-    errors.push(
-      new TourValidationError("Tour 'id' must be kebab-case (lowercase, numbers, hyphens only)", "id", tour.id)
-    );
-  }
-  if (!tour.title || typeof tour.title !== "string") {
-    errors.push(new TourValidationError("Missing or invalid 'title'", "title", tour.title));
-  }
-  if (!tour.description || typeof tour.description !== "string") {
-    errors.push(new TourValidationError("Missing or invalid 'description'", "description", tour.description));
-  }
-  if (!tour.version || !isValidVersion(tour.version)) {
-    errors.push(
-      new TourValidationError(
-        "Invalid 'version' - must be semantic version (e.g., '1.0.0')",
-        "version",
-        tour.version
-      )
-    );
-  }
-  if (!tour.steps || !Array.isArray(tour.steps) || tour.steps.length === 0) {
-    errors.push(new TourValidationError("'steps' array must contain at least one step", "steps", tour.steps));
-  } else {
-    tour.steps.forEach((step, index2) => {
-      const stepErrors = validateStep(step, index2);
-      errors.push(...stepErrors);
-    });
-    const stepIds = /* @__PURE__ */ new Set();
-    tour.steps.forEach((step, index2) => {
-      if (stepIds.has(step.id)) {
-        errors.push(new TourValidationError(`Duplicate step ID '${step.id}' at index ${index2}`, "steps", step.id));
-      }
-      stepIds.add(step.id);
-    });
-  }
-  if (tour.audience !== void 0 && typeof tour.audience !== "string") {
-    errors.push(
-      new TourValidationError(
-        `Invalid 'audience' - must be a string`,
-        "audience",
-        tour.audience
-      )
-    );
-  }
-  return errors;
-}
-function parseTour(jsonString) {
-  try {
-    const parsed = JSON.parse(jsonString);
-    if (typeof parsed !== "object" || parsed === null) {
-      return {
-        success: false,
-        errors: [new TourValidationError("Tour JSON must be an object")]
-      };
-    }
-    const errors = validateTour(parsed);
-    if (errors.length > 0) {
-      return {
-        success: false,
-        errors
-      };
-    }
-    return {
-      success: true,
-      tour: parsed
-    };
-  } catch (error) {
-    return {
-      success: false,
-      errors: [
-        new TourValidationError(
-          `Failed to parse JSON: ${error instanceof Error ? error.message : "Unknown error"}`
-        )
-      ]
-    };
-  }
-}
-function findTourFilePathInFileTree(fileTree) {
-  const tourFiles = fileTree.allFiles.filter((file) => {
-    const path = file.path;
-    return path.endsWith(".tour.json") && !path.includes("/");
-  });
-  tourFiles.sort((a, b) => a.path.localeCompare(b.path));
-  const tourFile = tourFiles[0];
-  return tourFile ? tourFile.path : null;
-}
 const GIT_STATUS_COLORS = {
   staged: "#22c55e",
   // Green
@@ -54735,7 +54697,7 @@ const CodeCityPanelContent = ({
                   }
                 )
               ] }) }),
-              !showTourPlayer && !headerCompact && tourData && /* @__PURE__ */ jsxs(
+              !showTourPlayer && tourData && /* @__PURE__ */ jsxs(
                 "button",
                 {
                   onClick: () => {