toolRegistry.js

const TOOL_NAME_SUFFIX_PATTERN = /(?:^|[\s_-])(v2|v3|new|final|copy)(?:$|[\s_-])/i;

export const TOOL_REGISTRY = Object.freeze([
  {
    id: "vector-map-editor",
    name: "Vector Map Editor",
    displayName: "Vector Map Editor",
    shortLabel: "Map",
    path: "Vector Map Editor",
    folderName: "Vector Map Editor",
    entryPoint: "Vector Map Editor/index.html",
    description: "Vector geometry authoring tool for map layout, collision review, and runtime export workflows.",
    showcaseTag: "Geometry",
    showcaseStatus: "Deterministic Runtime Ready",
    active: true,
    legacy: false,
    order: 1,
    sampleEntryPoints: [
      {
        label: "How To Use",
        path: "Vector Map Editor/how_to_use.html"
      },
      {
        label: "Sample 1208 - Tool Formatted Tiles Parallax",
        path: "../samples/phase-12/1208/index.html"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "vector-asset-studio",
    name: "Vector Asset Studio",
    displayName: "Vector Asset Studio",
    shortLabel: "Asset",
    path: "Vector Asset Studio",
    folderName: "Vector Asset Studio",
    entryPoint: "Vector Asset Studio/index.html",
    description: "Vector authoring studio for SVG-first asset work and first-class vector output for the platform.",
    showcaseTag: "Vector Assets",
    showcaseStatus: "SVG Contract Ready",
    active: true,
    legacy: false,
    order: 2,
    sampleEntryPoints: [
      {
        label: "Sample Manifest",
        path: "Vector Asset Studio/samples/sample-manifest.json"
      },
      {
        label: "Sample 1208 - Tool Formatted Tiles Parallax",
        path: "../samples/phase-12/1208/index.html"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "tile-map-editor",
    name: "Tilemap Studio",
    displayName: "Tilemap Studio",
    shortLabel: "Tile",
    path: "Tilemap Studio",
    folderName: "Tilemap Studio",
    entryPoint: "Tilemap Studio/index.html",
    description: "Tile map layout studio for layered map authoring, sample playback, simulation, and packaging flows.",
    showcaseTag: "Tile Maps",
    showcaseStatus: "Sample Loading Ready",
    active: true,
    legacy: false,
    order: 3,
    sampleEntryPoints: [
      {
        label: "How To Use",
        path: "Tilemap Studio/how_to_use.html"
      },
      {
        label: "Sample 1208 - Tool Formatted Tiles Parallax",
        path: "../samples/phase-12/1208/index.html"
      },
      {
        label: "Sample 1209 - Tilemap Basic Layout Preset",
        path: "../samples/phase-12/1209/index.html"
      },
      {
        label: "Sample 1210 - Tilemap Objective Layout Preset",
        path: "../samples/phase-12/1210/index.html"
      },
      {
        label: "Sample 1211 - Tilemap Mario Learning Layout Preset",
        path: "../samples/phase-12/1211/index.html"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "parallax-editor",
    name: "Parallax Scene Studio",
    displayName: "Parallax Scene Studio",
    shortLabel: "Parallax",
    path: "Parallax Scene Studio",
    folderName: "Parallax Scene Studio",
    entryPoint: "Parallax Scene Studio/index.html",
    description: "Parallax composition studio for layered scene depth, sample loading, simulation, and export flows.",
    showcaseTag: "Parallax",
    showcaseStatus: "Scene Preview Ready",
    active: true,
    legacy: false,
    order: 4,
    sampleEntryPoints: [
      {
        label: "Sample Manifest",
        path: "Parallax Scene Studio/samples/sample-manifest.json"
      },
      {
        label: "Sample 1208 - Tool Formatted Tiles Parallax",
        path: "../samples/phase-12/1208/index.html"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "sprite-editor",
    name: "Sprite Editor",
    displayName: "Sprite Editor",
    shortLabel: "Sprite",
    path: "Sprite Editor",
    folderName: "Sprite Editor",
    entryPoint: "Sprite Editor/index.html",
    description: "Pixel-art authoring workspace for palette-locked sprite sheets, animation frames, and registry-aware sprite projects.",
    showcaseTag: "Sprites",
    showcaseStatus: "First-Class Workspace",
    active: true,
    legacy: false,
    order: 5,
    sampleEntryPoints: [
      {
        label: "README",
        path: "Sprite Editor/README.md"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "skin-editor",
    name: "Primitive Skin Editor",
    displayName: "Primitive Skin Editor",
    shortLabel: "Skin",
    path: "Skin Editor",
    folderName: "Skin Editor",
    entryPoint: "Skin Editor/index.html",
    description: "Primitive shape skin authoring workflow for game color and sizing presets across playable arcade titles.",
    showcaseTag: "Primitive Skins",
    showcaseStatus: "Game Skin Ready",
    active: true,
    legacy: false,
    order: 5.5,
    sampleEntryPoints: [
      {
        label: "How To Use",
        path: "Skin Editor/how_to_use.html"
      },
      {
        label: "README",
        path: "Skin Editor/README.md"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "asset-browser",
    name: "Asset Browser / Import Hub",
    displayName: "Asset Browser / Import Hub",
    shortLabel: "Import",
    path: "Asset Browser",
    folderName: "Asset Browser",
    entryPoint: "Asset Browser/index.html",
    description: "Approved asset browsing and non-destructive import planning surface for vectors, palettes, parallax, tilemaps, and sprite workflow assets.",
    showcaseTag: "Asset Workflow",
    showcaseStatus: "Import Planning Ready",
    active: true,
    legacy: false,
    order: 6,
    sampleEntryPoints: [
      {
        label: "README",
        path: "Asset Browser/README.md"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "palette-browser",
    name: "Palette Browser / Manager",
    displayName: "Palette Browser / Manager",
    shortLabel: "Palette",
    path: "Palette Browser",
    folderName: "Palette Browser",
    entryPoint: "Palette Browser/index.html",
    description: "Shared palette browsing and management surface for engine palettes and local editable palette workflows.",
    showcaseTag: "Palettes",
    showcaseStatus: "Shared Contract Ready",
    active: true,
    legacy: false,
    order: 7,
    sampleEntryPoints: [
      {
        label: "README",
        path: "Palette Browser/README.md"
      }
    ],
    visibleInToolsList: true
  },
  {
    id: "state-inspector",
    name: "State Inspector",
    displayName: "State Inspector",
    shortLabel: "Inspect",
    path: "State Inspector",
    folderName: "State Inspector",
    entryPoint: "State Inspector/index.html",
    description: "Read-only state visibility tool for host context, storage snapshots, and structured runtime payload inspection.",
    showcaseTag: "Debug",
    showcaseStatus: "Inspector Baseline",
    active: true,
    legacy: false,
    order: 8,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "replay-visualizer",
    name: "Replay Visualizer",
    displayName: "Replay Visualizer",
    shortLabel: "Replay",
    path: "Replay Visualizer",
    folderName: "Replay Visualizer",
    entryPoint: "Replay Visualizer/index.html",
    description: "Event replay timeline viewer for stepping, autoplay, and frame inspection of runtime event streams.",
    showcaseTag: "Debug",
    showcaseStatus: "Replay Baseline",
    active: true,
    legacy: false,
    order: 9,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "performance-profiler",
    name: "Performance Profiler",
    displayName: "Performance Profiler",
    shortLabel: "Perf",
    path: "Performance Profiler",
    folderName: "Performance Profiler",
    entryPoint: "Performance Profiler/index.html",
    description: "Baseline performance profiler for frame cadence and deterministic workload timing summaries.",
    showcaseTag: "Debug",
    showcaseStatus: "Profiler Baseline",
    active: true,
    legacy: false,
    order: 10,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "physics-sandbox",
    name: "Physics Sandbox",
    displayName: "Physics Sandbox",
    shortLabel: "Physics",
    path: "Physics Sandbox",
    folderName: "Physics Sandbox",
    entryPoint: "Physics Sandbox/index.html",
    description: "Minimal reusable physics helper sandbox for acceleration, drag, and integration previews.",
    showcaseTag: "Debug",
    showcaseStatus: "Physics Baseline",
    active: true,
    legacy: false,
    order: 11,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "asset-pipeline-tool",
    name: "Asset Pipeline Tool",
    displayName: "Asset Pipeline Tool",
    shortLabel: "Pipeline",
    path: "Asset Pipeline Tool",
    folderName: "Asset Pipeline Tool",
    entryPoint: "Asset Pipeline Tool/index.html",
    description: "Launchable shared pipeline surface for load, validate, normalize, and emit contract checks.",
    showcaseTag: "Pipeline",
    showcaseStatus: "Pipeline Baseline",
    active: true,
    legacy: false,
    order: 12,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "tile-model-converter",
    name: "Tile Model Converter",
    displayName: "Tile Model Converter",
    shortLabel: "Convert",
    path: "Tile Model Converter",
    folderName: "Tile Model Converter",
    entryPoint: "Tile Model Converter/index.html",
    description: "Shared asset-converter surface for tile/vector conversion requests using normalized converter contracts.",
    showcaseTag: "Pipeline",
    showcaseStatus: "Converter Baseline",
    active: true,
    legacy: false,
    order: 13,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "3d-json-payload-normalizer",
    name: "3D JSON Payload Normalizer",
    displayName: "3D JSON Payload Normalizer",
    shortLabel: "3D JSON",
    path: "3D JSON Payload Normalizer",
    folderName: "3D JSON Payload Normalizer",
    entryPoint: "3D JSON Payload Normalizer/index.html",
    description: "3D payload normalization utility for point/segment JSON documents with deterministic sanitized output.",
    showcaseTag: "3D",
    showcaseStatus: "3D Baseline",
    active: true,
    legacy: false,
    order: 14,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "3d-asset-viewer",
    name: "3D Asset Viewer",
    displayName: "3D Asset Viewer",
    shortLabel: "3D View",
    path: "3D Asset Viewer",
    folderName: "3D Asset Viewer",
    entryPoint: "3D Asset Viewer/index.html",
    description: "Baseline 3D asset metadata viewer for vertices, bounds, and normalized runtime payload inspection.",
    showcaseTag: "3D",
    showcaseStatus: "3D Baseline",
    readOnly: true,
    active: true,
    legacy: false,
    order: 15,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "3d-camera-path-editor",
    name: "3D Camera Path Editor",
    displayName: "3D Camera Path Editor",
    shortLabel: "3D Cam",
    path: "3D Camera Path Editor",
    folderName: "3D Camera Path Editor",
    entryPoint: "3D Camera Path Editor/index.html",
    description: "Baseline 3D camera path editor for waypoint timeline authoring and deterministic JSON export.",
    showcaseTag: "3D",
    showcaseStatus: "3D Baseline",
    active: true,
    legacy: false,
    order: 16,
    sampleEntryPoints: [],
    visibleInToolsList: true
  },
  {
    id: "sprite-editor-old-keep",
    name: "SpriteEditor_old_keep",
    displayName: "SpriteEditor_old_keep",
    shortLabel: "Legacy",
    path: "SpriteEditor_old_keep",
    folderName: "SpriteEditor_old_keep",
    entryPoint: "SpriteEditor_old_keep/index.html",
    description: "Preserved historical sprite editor kept on disk for legacy reference only.",
    active: false,
    legacy: true,
    order: 999,
    visibleInToolsList: false
  }
]);

export { TOOL_NAME_SUFFIX_PATTERN };

export function getToolRegistry() {
  return TOOL_REGISTRY.map((tool) => ({
    ...tool,
    sampleEntryPoints: Array.isArray(tool.sampleEntryPoints) ? tool.sampleEntryPoints.map((entry) => ({ ...entry })) : []
  }));
}

export function getToolById(toolId) {
  return getToolRegistry().find((tool) => tool.id === toolId) ?? null;
}

export function getActiveToolRegistry() {
  return getToolRegistry()
    .filter((tool) => tool.active === true)
    .sort((left, right) => (left.order ?? Number.MAX_SAFE_INTEGER) - (right.order ?? Number.MAX_SAFE_INTEGER));
}

export function getVisibleActiveToolRegistry() {
  return getActiveToolRegistry().filter((tool) => tool.visibleInToolsList === true);
}