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

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/spriteGenerator.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Procedural pixel art sprite generator for placeholder graphics
+ * Creates simple isometric tiles and buildings using Canvas API
+ */
+import type { BiomeTheme, LocationNodeType } from './types';
+/**
+ * Color palettes for different biomes (NES-style limited colors)
+ */
+export declare const BIOME_COLORS: Record<BiomeTheme, {
+    primary: string;
+    secondary: string;
+    accent: string;
+}>;
+/**
+ * Generate a simple grass background texture (for tiling)
+ */
+export declare function generateGrassBackgroundTile(): HTMLCanvasElement;
+/**
+ * Generate an isometric grass tile
+ */
+export declare function generateGrassTile(theme?: BiomeTheme): HTMLCanvasElement;
+/**
+ * Generate an isometric path tile
+ */
+export declare function generatePathTile(): HTMLCanvasElement;
+/**
+ * Generate an isometric bridge tile (wooden planks over water)
+ */
+export declare function generateBridgeTile(): HTMLCanvasElement;
+/**
+ * Generate a simple isometric building/location sprite
+ */
+export declare function generateLocationSprite(type: LocationNodeType, theme: BiomeTheme, size?: number): HTMLCanvasElement;
+/**
+ * Generate a decorative sprite (cloud, tree, etc.)
+ */
+export declare function generateDecorativeSprite(type: 'cloud' | 'tree' | 'bush' | 'rock'): HTMLCanvasElement;
+/**
+ * Load an image from a URL and draw it to a canvas
+ */
+export declare function loadCustomSprite(imagePath: string): Promise<HTMLCanvasElement | null>;
+/**
+ * Generate a complete sprite atlas from all tile types
+ * Returns a texture map for PixiJS
+ * @param customSprites Optional map of sprite keys to custom image paths
+ */
+export declare function generateSpriteAtlas(customSprites?: Record<string, string>): Promise<Record<string, HTMLCanvasElement>>;
+/**
+ * Synchronous version of generateSpriteAtlas for backwards compatibility
+ * Does not support custom sprites
+ */
+export declare function generateSpriteAtlasSync(): Record<string, HTMLCanvasElement>;
+//# sourceMappingURL=spriteGenerator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spriteGenerator.d.ts","sourceRoot":"","sources":["../../../src/panels/overworld-map/spriteGenerator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE5D;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA0BnG,CAAC;AAYF;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,iBAAiB,CA8B/D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,GAAE,UAAoB,GAAG,iBAAiB,CAsBhF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,iBAAiB,CAqBpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAwCtD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,UAAU,EACjB,IAAI,GAAE,MAAU,GACf,iBAAiB,CAqcnB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,iBAAiB,CAwCpG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmB3F;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC,CA6E5C;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CA4B3E"}

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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"}