@industry-theme/repository-composition-panels 0.7.14 → 0.7.16

package/dist/panels/overworld-map/isometricUtils.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Isometric rendering utilities for converting between grid and screen coordinates
+ */
+import type { Viewport } from 'pixi-viewport';
+import { type GridPoint, type IsometricCoords } from './types';
+export { TILE_SIZE } from './types';
+/**
+ * Isometric tile dimensions
+ * For 32x32 logical tiles, we use a 2:1 ratio diamond
+ */
+export declare const ISO_TILE_WIDTH: number;
+export declare const ISO_TILE_HEIGHT = 32;
+/**
+ * Convert grid coordinates to isometric screen coordinates
+ * @param gridX Grid X position
+ * @param gridY Grid Y position
+ * @returns Screen coordinates {screenX, screenY}
+ */
+export declare function gridToScreen(gridX: number, gridY: number): IsometricCoords;
+/**
+ * Convert screen coordinates back to grid coordinates
+ * @param screenX Screen X position
+ * @param screenY Screen Y position
+ * @returns Grid coordinates {gridX, gridY}
+ */
+export declare function screenToGrid(screenX: number, screenY: number): GridPoint;
+/**
+ * Get the bounding box for an isometric tile
+ * @param gridX Grid X position
+ * @param gridY Grid Y position
+ * @returns Corner points of the diamond in screen space
+ */
+export declare function getTileBounds(gridX: number, gridY: number): {
+    top: {
+        x: number;
+        y: number;
+    };
+    right: {
+        x: number;
+        y: number;
+    };
+    bottom: {
+        x: number;
+        y: number;
+    };
+    left: {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Calculate the correct render order (z-index) for isometric tiles
+ * Tiles further "back" (higher Y + higher X) should render first
+ * @param gridX Grid X position
+ * @param gridY Grid Y position
+ * @returns Z-index value
+ */
+export declare function getIsometricZIndex(gridX: number, gridY: number): number;
+/**
+ * Get the center point of a tile in screen coordinates
+ * @param gridX Grid X position
+ * @param gridY Grid Y position
+ * @returns Center point in screen space
+ */
+export declare function getTileCenter(gridX: number, gridY: number): IsometricCoords;
+/**
+ * Check if a point in screen space is inside an isometric tile
+ * @param screenX Screen X coordinate to test
+ * @param screenY Screen Y coordinate to test
+ * @param gridX Grid X of tile
+ * @param gridY Grid Y of tile
+ * @returns true if point is inside the diamond
+ */
+export declare function isPointInTile(screenX: number, screenY: number, gridX: number, gridY: number): boolean;
+/**
+ * Create a path between two grid points for drawing connections
+ * Uses simple straight line for now, can be enhanced with pathfinding
+ * @param from Starting grid point
+ * @param to Ending grid point
+ * @param segments Number of segments (for smooth curves)
+ * @returns Array of screen coordinates
+ */
+export declare function createIsometricPath(from: GridPoint, to: GridPoint, segments?: number): IsometricCoords[];
+/**
+ * Calculate the optimal map dimensions to fit all nodes
+ * Adds padding around the edges
+ * @param nodes Array of grid points
+ * @param padding Padding in tiles
+ * @returns Map dimensions {width, height}
+ */
+export declare function calculateMapBounds(nodes: GridPoint[], padding?: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Offset all grid positions by a delta (useful for centering)
+ * @param nodes Array of grid points
+ * @param deltaX X offset
+ * @param deltaY Y offset
+ * @returns New array with offset positions
+ */
+export declare function offsetGridPositions(nodes: GridPoint[], deltaX: number, deltaY: number): GridPoint[];
+/**
+ * Region bounds for camera calculations
+ */
+export interface RegionBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Camera position result for centering on a region
+ */
+export interface RegionCameraPosition {
+    /** Screen X coordinate to center the camera on */
+    centerX: number;
+    /** Screen Y coordinate to center the camera on */
+    centerY: number;
+    /** Width of the region in screen pixels */
+    screenWidth: number;
+    /** Height of the region in screen pixels */
+    screenHeight: number;
+}
+/**
+ * Calculate the camera position needed to center on a region
+ * This computes the screen coordinates for the center point and the
+ * screen dimensions of the region for zoom calculations.
+ *
+ * @param regionCenterX Grid X coordinate of the region center
+ * @param regionCenterY Grid Y coordinate of the region center
+ * @param bounds The region bounds in grid coordinates
+ * @returns Camera position with center point and screen dimensions
+ */
+export declare function calculateRegionCameraPosition(regionCenterX: number, regionCenterY: number, bounds: RegionBounds): RegionCameraPosition;
+/**
+ * Convert DOM event coordinates to grid coordinates
+ * This handles the full transformation pipeline:
+ * 1. DOM event (clientX, clientY) -> viewport screen coords
+ * 2. Viewport screen coords -> world coords (accounting for pan/zoom)
+ * 3. World coords -> grid coords (isometric conversion)
+ *
+ * @param clientX DOM event clientX (screen position)
+ * @param clientY DOM event clientY (screen position)
+ * @param viewport PIXI Viewport instance
+ * @param canvasElement The canvas element (for getting bounding rect)
+ * @returns Grid coordinates {gridX, gridY}
+ */
+export declare function domEventToGridCoords(clientX: number, clientY: number, viewport: Viewport | null, canvasElement: HTMLElement | null): GridPoint;
+//# sourceMappingURL=isometricUtils.d.ts.map

package/dist/panels/overworld-map/isometricUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"isometricUtils.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/isometricUtils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAa,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAG1E,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,cAAc,QAAgB,CAAC;AAC5C,eAAO,MAAM,eAAe,KAAY,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAOxE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;EAYzD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAO3E;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAST;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,SAAS,EACf,EAAE,EAAE,SAAS,EACb,QAAQ,GAAE,MAAW,GACpB,eAAe,EAAE,CAYnB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAAE,EAClB,OAAO,GAAE,MAAU,GAClB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAqBnC;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAAE,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,SAAS,EAAE,CAKb;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAC3C,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,YAAY,GACnB,oBAAoB,CAuBtB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,aAAa,EAAE,WAAW,GAAG,IAAI,GAChC,SAAS,CAoBX"}

package/dist/panels/overworld-map/packageExpansion.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Package Expansion Utilities
+ *
+ * Converts repositories with multiple packages into multiple GenericNode instances,
+ * with each node sized based on individual package file counts.
+ */
+import type { AlexandriaEntryWithMetrics } from '../CollectionMapPanel';
+/**
+ * Add package metadata to a repository node for subdivision rendering
+ *
+ * @param repository - Repository with optional packages array
+ * @returns Array of PackageInfo for rendering subdivision, or undefined if no packages
+ */
+export declare function extractPackageInfo(repository: AlexandriaEntryWithMetrics): import('./genericMapper').PackageInfo[] | undefined;
+//# sourceMappingURL=packageExpansion.d.ts.map

package/dist/panels/overworld-map/packageExpansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageExpansion.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/packageExpansion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAwBxE;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,0BAA0B,GACrC,OAAO,iBAAiB,EAAE,WAAW,EAAE,GAAG,SAAS,CAmCrD"}

package/dist/panels/overworld-map/spriteLayoutEngine.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Sprite Layout Engine
+ * Handles collision-free placement of sprites in regions using circle packing
+ */
+export interface LayoutNode {
+    id: string;
+    gridX: number;
+    gridY: number;
+    size: number;
+    language?: string;
+    lastEditedAt?: string;
+}
+export interface RegionBounds {
+    width: number;
+    height: number;
+}
+export interface LayoutOptions {
+    /** Minimum spacing between sprite boundaries in tiles (default: 0.5) */
+    spacing?: number;
+    /** Start position offset from top-left (default: boundary radius of first sprite) */
+    startOffset?: number;
+}
+/**
+ * Layout sprites in a region using circle packing
+ * Places sprites starting from top-left, largest first
+ *
+ * @param nodes - Nodes to layout (must have id and size)
+ * @param bounds - Region boundaries
+ * @param options - Layout options
+ * @returns Array of nodes with assigned positions, and array of nodes that didn't fit
+ */
+export declare function layoutSpritesInRegion(nodes: Array<{
+    id: string;
+    size: number;
+    language?: string;
+}>, bounds: RegionBounds, options?: LayoutOptions): {
+    placed: LayoutNode[];
+    overflow: Array<{
+        id: string;
+        size: number;
+        language?: string;
+    }>;
+};
+/**
+ * Calculate region capacity metrics
+ */
+export interface RegionCapacity {
+    totalArea: number;
+    usedArea: number;
+    remainingArea: number;
+    utilization: number;
+    isFull: boolean;
+}
+export declare function calculateRegionCapacity(placedNodes: LayoutNode[], bounds: RegionBounds): RegionCapacity;
+/**
+ * Region with positioned nodes
+ */
+export interface LayoutRegion {
+    regionId: string;
+    gridPosition: {
+        row: number;
+        col: number;
+    };
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    nodes: LayoutNode[];
+    capacity: RegionCapacity;
+    ageBucket?: AgeBucket;
+    name?: string;
+}
+/**
+ * Age bucket definitions for region grouping
+ */
+export declare enum AgeBucket {
+    LAST_MONTH = "last-month",
+    LAST_3_MONTHS = "last-3-months",
+    LAST_YEAR = "last-year",
+    OLDER = "older"
+}
+/**
+ * Layout sprites across multiple regions if needed
+ * Groups nodes by age (last edited) before packing:
+ * - Last month → First region(s)
+ * - Last 3 months → Next region(s)
+ * - Last year → Next region(s)
+ * - Older → Final region(s)
+ *
+ * @param nodes - Nodes to layout
+ * @param regionSize - Size of each region in tiles (default: 25)
+ * @param options - Layout options
+ * @returns Array of regions with positioned nodes
+ */
+export declare function layoutSpritesMultiRegion(nodes: Array<{
+    id: string;
+    size: number;
+    language?: string;
+    lastEditedAt?: string;
+}>, regionSize?: number, options?: LayoutOptions): LayoutRegion[];
+//# sourceMappingURL=spriteLayoutEngine.d.ts.map

package/dist/panels/overworld-map/spriteLayoutEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteLayoutEngine.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/spriteLayoutEngine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2FD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC7D,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC1B;IAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CA2B5F;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,UAAU,EAAE,EACzB,MAAM,EAAE,YAAY,GACnB,cAAc,CAoBhB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,oBAAY,SAAS;IACnB,UAAU,eAAe;IACzB,aAAa,kBAAkB;IAC/B,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAyCD;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACpF,UAAU,GAAE,MAAW,EACvB,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CAyFhB"}

package/dist/panels/overworld-map/starDecoration.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub Star Decoration System
+ * Determines decoration type and visual style based on star count
+ */
+export interface StarTier {
+    min: number;
+    max: number;
+    name: string;
+    decorationType: 'flag' | 'trophy' | 'statue';
+    color: number;
+}
+export declare const STAR_TIERS: StarTier[];
+/**
+ * Get the star tier for a given star count
+ */
+export declare function getStarTier(stars: number): StarTier | null;
+/**
+ * Format star count for display (e.g., 1.2k, 45.3k, 1.2M)
+ */
+export declare function formatStarCount(stars: number): string;
+/**
+ * Calculate extra size multiplier needed to accommodate star decorations
+ * Decorations need roughly 20-30% extra horizontal space
+ *
+ * @param stars - GitHub star count
+ * @returns Extra size multiplier to add (0.0 - 0.4)
+ */
+export declare function getDecorationSizeBonus(stars: number): number;
+/**
+ * Calculate a scale factor for the star decoration based on absolute count
+ * Uses logarithmic scaling to handle wide range of star counts
+ *
+ * @param stars - GitHub star count
+ * @returns Scale factor starting at 0.7, +0.3 per order of magnitude
+ */
+export declare function getStarScaleFactor(stars: number): number;
+//# sourceMappingURL=starDecoration.d.ts.map

package/dist/panels/overworld-map/starDecoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"starDecoration.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/starDecoration.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,UAAU,EAAE,QAAQ,EA6EhC,CAAC;AAEF;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAU1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQrD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/dist/panels/overworld-map/test-setup.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Test setup for DOM environment
+ * This file is preloaded before running tests to provide browser APIs like Canvas
+ */
+export {};
+//# sourceMappingURL=test-setup.d.ts.map

package/dist/panels/overworld-map/test-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-setup.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/test-setup.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/panels/overworld-map/types.d.ts

@@ -0,0 +1,228 @@
+/**
+ * Core type definitions for 8-bit overworld map
+ */
+import type { AgingMetrics } from '../../utils/repositoryAging';
+export declare const TILE_SIZE = 32;
+export declare const ISO_TILE_WIDTH = 32;
+export declare const ISO_TILE_HEIGHT = 16;
+/**
+ * Basic point in grid coordinates
+ */
+export interface GridPoint {
+    gridX: number;
+    gridY: number;
+}
+/**
+ * Theme/Biome types for different package languages
+ */
+export type BiomeTheme = 'grass' | 'desert' | 'water' | 'volcano' | 'ice';
+/**
+ * Tile types for the terrain grid
+ */
+export type TileType = 'grass' | 'water' | 'path' | 'mountain' | 'sand' | 'ice' | 'lava' | 'empty';
+/**
+ * Individual tile in the grid
+ */
+export interface Tile {
+    x: number;
+    y: number;
+    type: TileType;
+    spriteIndex: number;
+    biome: BiomeTheme;
+}
+/**
+ * Location node types (different building/landmark types)
+ */
+export type LocationNodeType = 'castle' | 'fortress' | 'house' | 'tower' | 'pipe' | 'git-repo' | 'monorepo';
+/**
+ * Location node representing a package on the map
+ */
+export interface PackageSubdivision {
+    name: string;
+    size: number;
+    sprite: string;
+}
+export interface LocationNode {
+    id: string;
+    gridX: number;
+    gridY: number;
+    type: LocationNodeType;
+    sprite: string;
+    size: number;
+    theme: BiomeTheme;
+    label: string;
+    packageType: 'node' | 'python' | 'cargo' | 'go' | 'package';
+    isRoot: boolean;
+    color: string;
+    aging?: AgingMetrics;
+    subdivisions?: PackageSubdivision[];
+    customSpritePath?: string;
+    stars?: number;
+    collaborators?: number;
+    license?: string;
+    ownerAvatar?: string;
+}
+/**
+ * Path connection style
+ */
+export type PathStyle = 'dotted' | 'solid' | 'dashed' | 'bridge';
+/**
+ * Path connection type
+ */
+export type PathConnectionType = 'dependency' | 'dev-dependency';
+/**
+ * Connection path between two locations
+ */
+export interface PathConnection {
+    id: string;
+    from: string;
+    to: string;
+    points: GridPoint[];
+    type: PathConnectionType;
+    style: PathStyle;
+}
+/**
+ * Decorative sprite types
+ */
+export type DecorativeSpriteType = 'cloud' | 'tree' | 'bush' | 'rock' | 'flower' | 'mushroom' | 'cactus';
+/**
+ * Layer for z-ordering
+ */
+export type RenderLayer = 'background' | 'foreground';
+/**
+ * Decorative sprite for visual flair
+ */
+export interface DecorativeSprite {
+    id: string;
+    gridX: number;
+    gridY: number;
+    sprite: DecorativeSpriteType;
+    layer: RenderLayer;
+    animated?: boolean;
+    animationSpeed?: number;
+}
+/**
+ * Biome zone definition
+ */
+export interface BiomeZone {
+    id: string;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    theme: BiomeTheme;
+    backgroundColor: string;
+}
+/**
+ * Camera/viewport configuration
+ */
+export interface Camera {
+    x: number;
+    y: number;
+    viewportWidth: number;
+    viewportHeight: number;
+}
+/**
+ * Map limits and configuration
+ */
+export declare const MAX_NODES_PER_MAP = 12;
+export declare const MAP_TRANSITION_THRESHOLD = 10;
+export declare const REGION_SIZE_TILES = 25;
+/**
+ * Region within a unified map
+ */
+export interface MapRegion {
+    id: string;
+    name: string;
+    description?: string;
+    gridPosition?: {
+        row: number;
+        col: number;
+    };
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    centerX: number;
+    centerY: number;
+    nodeIds: string[];
+}
+/**
+ * Complete overworld map data structure (unified map with regions)
+ */
+export interface OverworldMap {
+    width: number;
+    height: number;
+    tiles: Tile[];
+    nodes: LocationNode[];
+    paths: PathConnection[];
+    decorations?: DecorativeSprite[];
+    biomeZones?: BiomeZone[];
+    regions: MapRegion[];
+    name: string;
+    description?: string;
+}
+/**
+ * Collection of multiple overworld maps (deprecated - use single map with regions)
+ * @deprecated Use OverworldMap with regions instead
+ */
+export interface OverworldMapCollection {
+    maps: OverworldMap[];
+    currentMapIndex: number;
+    totalPackages: number;
+}
+/**
+ * Isometric coordinate conversion
+ */
+export interface IsometricCoords {
+    screenX: number;
+    screenY: number;
+}
+/**
+ * Sprite definition in atlas
+ */
+export interface SpriteDefinition {
+    name: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Sprite atlas/tileset
+ */
+export interface SpriteAtlas {
+    image?: HTMLImageElement;
+    imageUrl?: string;
+    sprites: Record<string, SpriteDefinition>;
+    tileSize: number;
+}
+/**
+ * Map configuration/settings
+ */
+export interface MapConfig {
+    showGrid: boolean;
+    showPaths: boolean;
+    showDecorations: boolean;
+    enableAnimations: boolean;
+    cameraSpeed: number;
+    zoomSpeed: number;
+    minZoom: number;
+    maxZoom: number;
+}
+/**
+ * Event types for isometric components
+ */
+export interface IsometricDragEvent {
+    id: string;
+    gridX: number;
+    gridY: number;
+}
+export interface IsometricHoverEvent {
+    id: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/panels/overworld-map/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/types.ts"],"names":[],"mappings":"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"}

package/dist/panels.bundle.js

@@ -1,34 +1,35 @@
-import { aR, aS, aB, aC, aD, as, at, au, aN, aH, av, aw, ax, ay, az, aA, aO, aP, aQ, aF, aG, aE, aL, aI, aK, aJ, aq, ar, ap, aM } from "./index-pPFTSf2O.js";
+import { z, B, D, l, m, G, f, g, M, O, P, h, i, R, S, j, k, T, x, y, q, r, n, v, s, u, t, o, d, p, w } from "./index-Bt-XsLNt.js";
 export {
-  aR as CollectionMapPanel,
-  aS as CollectionMapPanelContent,
-  aB as DependencyGraphPanel,
-  aC as DependencyGraphPanelContent,
-  aD as DependencyGraphPanelPreview,
-  as as GitChangesPanel,
-  at as GitChangesPanelContent,
-  au as GitChangesPanelPreview,
-  aN as MAX_NODES_PER_MAP,
-  aH as OverworldMapPanelContent,
-  av as PackageCompositionPanel,
-  aw as PackageCompositionPanelContent,
-  ax as PackageCompositionPanelPreview,
-  ay as SearchPanel,
-  az as SearchPanelContent,
-  aA as SearchPanelPreview,
-  aO as TelemetryCoveragePanel,
-  aP as TelemetryCoveragePanelContent,
-  aQ as TelemetryCoveragePanelPreview,
-  aF as applyForceLayout,
-  aG as applySugiyamaLayout,
-  aE as dependencyTreeToCanvas,
-  aL as gridToScreen,
-  aI as nodesToOverworldMap,
-  aK as nodesToOverworldMapCollection,
-  aJ as nodesToUnifiedOverworldMap,
-  aq as onPackageLoad,
-  ar as onPackageUnload,
-  ap as panels,
-  aM as screenToGrid
+  z as CollectionMapPanel,
+  B as CollectionMapPanelContent,
+  D as DependencyGraphPanel,
+  l as DependencyGraphPanelContent,
+  m as DependencyGraphPanelPreview,
+  G as GitChangesPanel,
+  f as GitChangesPanelContent,
+  g as GitChangesPanelPreview,
+  M as MAX_NODES_PER_MAP,
+  O as OverworldMapPanelContent,
+  P as PackageCompositionPanel,
+  h as PackageCompositionPanelContent,
+  i as PackageCompositionPanelPreview,
+  R as RepoSprite,
+  S as SearchPanel,
+  j as SearchPanelContent,
+  k as SearchPanelPreview,
+  T as TelemetryCoveragePanel,
+  x as TelemetryCoveragePanelContent,
+  y as TelemetryCoveragePanelPreview,
+  q as applyForceLayout,
+  r as applySugiyamaLayout,
+  n as dependencyTreeToCanvas,
+  v as gridToScreen,
+  s as nodesToOverworldMap,
+  u as nodesToOverworldMapCollection,
+  t as nodesToUnifiedOverworldMap,
+  o as onPackageLoad,
+  d as onPackageUnload,
+  p as panels,
+  w as screenToGrid
 };
 //# sourceMappingURL=panels.bundle.js.map