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

package/dist/services/LocalSearchService.d.ts

@@ -0,0 +1,70 @@
+import type { FileTree } from '@principal-ai/repository-abstraction';
+export interface FileDocument {
+    id: string;
+    path: string;
+    name: string;
+    relativePath: string;
+}
+export interface SearchResult {
+    path: string;
+    name: string;
+    relativePath: string;
+    score: number;
+}
+export interface DirectoryFilter {
+    id: string;
+    path: string;
+    mode: 'include' | 'exclude';
+}
+export interface SearchOptions {
+    directoryFilter?: string;
+    excludeDirectory?: boolean;
+    fileType?: string;
+    limit?: number;
+    directoryFilters?: DirectoryFilter[];
+}
+/**
+ * LocalSearchService - Filename search on FileTree data
+ * Content search is provided by the host application
+ */
+declare class LocalSearchService {
+    private documentsMap;
+    private baseDirectory;
+    private initialized;
+    /**
+     * Index files from FileTree
+     */
+    indexFileSystemTree(tree: FileTree, baseDirectory: string): void;
+    /**
+     * Convert glob pattern to regex
+     */
+    private globToRegex;
+    /**
+     * Check if query contains wildcards
+     */
+    private hasWildcards;
+    /**
+     * Check if document matches filter options
+     */
+    private matchesFilters;
+    /**
+     * Calculate relevance score for a match
+     */
+    private calculateScore;
+    /**
+     * Search files by filename
+     */
+    search(query: string, options?: SearchOptions): SearchResult[];
+    /**
+     * Get unique directories from indexed files
+     */
+    getDirectories(): string[];
+    /**
+     * Clear the search index
+     */
+    clear(): void;
+    isInitialized(): boolean;
+}
+export declare const localSearchService: LocalSearchService;
+export {};
+//# sourceMappingURL=LocalSearchService.d.ts.map

package/dist/services/LocalSearchService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalSearchService.d.ts","sourceRoot":"","sources":["../../src/services/LocalSearchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;CACtC;AAED;;;GAGG;AACH,cAAM,kBAAkB;IACtB,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,WAAW,CAAS;IAE5B;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI;IAwBhE;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAsBtB;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,YAAY,EAAE;IAmD9D;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;IAe1B;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,aAAa,IAAI,OAAO;CAGzB;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Panel Tools
+ *
+ * UTCP-compatible tools for this panel extension.
+ * These tools can be invoked by AI agents and emit events that panels listen for.
+ *
+ * IMPORTANT: This file should NOT import any React components to ensure
+ * it can be imported server-side without pulling in React dependencies.
+ * Use the './tools' subpath export for server-safe imports.
+ */
+import type { PanelTool, PanelToolsMetadata } from '@principal-ade/utcp-panel-event';
+/**
+ * Tool: Refresh Git Status
+ */
+export declare const refreshGitStatusTool: PanelTool;
+/**
+ * Tool: Select File
+ */
+export declare const selectFileTool: PanelTool;
+/**
+ * Tool: Toggle Section
+ */
+export declare const toggleSectionTool: PanelTool;
+/**
+ * All tools exported as an array.
+ */
+export declare const examplePanelTools: PanelTool[];
+/**
+ * Panel tools metadata for registration with PanelToolRegistry.
+ */
+export declare const examplePanelToolsMetadata: PanelToolsMetadata;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAwBlC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,SA6B5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SA+B/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,EAIxC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,kBAKvC,CAAC"}

package/dist/tools.bundle.js

@@ -0,0 +1,106 @@
+// src/tools/index.ts
+var refreshGitStatusTool = {
+  name: "refresh_git_status",
+  description: "Refreshes the git status display in the example panel",
+  inputs: {
+    type: "object",
+    properties: {
+      force: {
+        type: "boolean",
+        description: "Force refresh even if data is fresh"
+      }
+    }
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      message: { type: "string" }
+    }
+  },
+  tags: ["git", "refresh", "status"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "your-org.example-panel:refresh-git"
+  }
+};
+var selectFileTool = {
+  name: "select_file",
+  description: "Selects and highlights a file in the example panel file list",
+  inputs: {
+    type: "object",
+    properties: {
+      filePath: {
+        type: "string",
+        description: "Path to the file to select"
+      },
+      scrollIntoView: {
+        type: "boolean",
+        description: "Whether to scroll the file into view"
+      }
+    },
+    required: ["filePath"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      selectedFile: { type: "string" }
+    }
+  },
+  tags: ["file", "selection", "navigation"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "your-org.example-panel:select-file"
+  }
+};
+var toggleSectionTool = {
+  name: "toggle_section",
+  description: "Toggles the visibility of a section in the example panel",
+  inputs: {
+    type: "object",
+    properties: {
+      section: {
+        type: "string",
+        enum: ["staged", "unstaged", "untracked"],
+        description: "The section to toggle"
+      },
+      expanded: {
+        type: "boolean",
+        description: "Whether to expand (true) or collapse (false) the section"
+      }
+    },
+    required: ["section"]
+  },
+  outputs: {
+    type: "object",
+    properties: {
+      success: { type: "boolean" },
+      section: { type: "string" },
+      expanded: { type: "boolean" }
+    }
+  },
+  tags: ["ui", "toggle", "section"],
+  tool_call_template: {
+    call_template_type: "panel_event",
+    event_type: "your-org.example-panel:toggle-section"
+  }
+};
+var examplePanelTools = [
+  refreshGitStatusTool,
+  selectFileTool,
+  toggleSectionTool
+];
+var examplePanelToolsMetadata = {
+  id: "your-org.example-panel",
+  name: "Example Panel",
+  description: "Tools provided by the example panel extension",
+  tools: examplePanelTools
+};
+export {
+  toggleSectionTool,
+  selectFileTool,
+  refreshGitStatusTool,
+  examplePanelToolsMetadata,
+  examplePanelTools
+};

package/dist/types/composition.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Types re-exported from @principal-ai/codebase-composition
+ *
+ * This file re-exports types from the core library to avoid duplication.
+ * All composition-related types should be imported from here.
+ */
+import type { PackageLayer as BasePackageLayer } from '@principal-ai/codebase-composition';
+import type { AgingMetrics } from '../utils/repositoryAging';
+export type { FilePattern, FileSet, BaseLayer, PackageCommand, ConfigFile, QualityMetrics, LensOperation, LensReadiness, LensRequirement, LensRequirements, RequirementCheckResult, MonorepoOrchestrator, MonorepoMetadata, MonorepoRootRole, } from '@principal-ai/codebase-composition';
+/**
+ * Extended PackageLayer with visualization-specific properties
+ * Used internally for overworld map rendering
+ */
+export interface PackageLayer extends BasePackageLayer {
+    /** Size multiplier for sprite (1.5x - 4.0x, based on repository metrics) */
+    size?: number;
+    /** Importance level 0-100 (affects visual prominence) */
+    importance?: number;
+    /** Aging metrics for weathering and color fade (based on lastEditedAt) */
+    aging?: AgingMetrics;
+}
+//# sourceMappingURL=composition.d.ts.map

package/dist/types/composition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition.d.ts","sourceRoot":"","sources":["../../src/types/composition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,YAAY,EAEV,WAAW,EACX,OAAO,EACP,SAAS,EAGT,cAAc,EACd,UAAU,EAGV,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,sBAAsB,EAGtB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oCAAoC,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,4EAA4E;IAC5E,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB"}

package/dist/types/dependencies.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Dependencies Panel Type Definitions
+ */
+import type { PackageLayer, PackageSummary, PackagesSliceData } from '@principal-ai/codebase-composition';
+export type { PackageLayer, PackageSummary, PackagesSliceData };
+/**
+ * Dependency type
+ */
+export type DependencyType = 'production' | 'development' | 'peer';
+/**
+ * Basic dependency item for display
+ * Supports multiple dependency types for packages that appear in multiple categories
+ */
+export interface DependencyItem {
+    name: string;
+    version: string;
+    /** Primary dependency type (for sorting) */
+    dependencyType: DependencyType;
+    /** All dependency types this package belongs to */
+    dependencyTypes: DependencyType[];
+    /** Package scope/namespace (e.g., '@scope' from '@scope/package') */
+    namespace?: string;
+    /** Package name without scope */
+    packageName: string;
+}
+//# sourceMappingURL=dependencies.d.ts.map

package/dist/types/dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencies.d.ts","sourceRoot":"","sources":["../../src/types/dependencies.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EAClB,MAAM,oCAAoC,CAAC;AAG5C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,MAAM,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,cAAc,EAAE,cAAc,CAAC;IAC/B,mDAAmD;IACnD,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/types/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Panel Extension Type Definitions
+ *
+ * Re-exports core types from @principal-ade/panel-framework-core
+ */
+export type { PackageLayer, PackageCommand, ConfigFile, QualityMetrics, LensOperation, BaseLayer, FilePattern, FileSet, } from './composition';
+export type { DependencyItem, PackageSummary, PackagesSliceData, } from './dependencies';
+export type { DataSlice, WorkspaceMetadata, RepositoryMetadata, FileTreeSource, ActiveFileSlice, PanelEventType, PanelEvent, PanelEventEmitter, PanelActions, PanelContextValue, PanelComponentProps, PanelMetadata, PanelLifecycleHooks, PanelDefinition, PanelModule, PanelRegistryEntry, PanelLoader, PanelRegistryConfig, PanelTool, PanelToolsMetadata, JsonSchema, PanelEventCallTemplate, } from '@principal-ade/panel-framework-core';
+import type { PanelActions as CorePanelActions, PanelComponentProps as CorePanelComponentProps, DataSlice } from '@principal-ade/panel-framework-core';
+import type { FileTree, GitStatusWithFiles } from '@principal-ai/repository-abstraction';
+import type { AlexandriaEntry } from '@principal-ai/alexandria-core-library';
+import type { PackagesSliceData } from './dependencies';
+export type { AlexandriaEntry } from '@principal-ai/alexandria-core-library';
+export type { GitFileStatus } from '@principal-ade/dynamic-file-tree';
+export type { FileTree, GitStatusWithFiles, } from '@principal-ai/repository-abstraction';
+/**
+ * Git status data - categorized file paths
+ */
+export interface GitStatus {
+    staged: string[];
+    unstaged: string[];
+    untracked: string[];
+    deleted: string[];
+}
+/**
+ * Git change selection status for callbacks
+ */
+export type GitChangeSelectionStatus = 'staged' | 'unstaged' | 'untracked' | 'deleted';
+/**
+ * Typed context for GitChangesPanel
+ *
+ * Note: Slices use `DataSlice<T | null>` to distinguish between:
+ * - `null` = "not fetched yet" or "not available"
+ * - Empty data = "fetched successfully, no items"
+ */
+export interface GitChangesPanelContext {
+    gitStatusWithFiles: DataSlice<GitStatusWithFiles | null>;
+    fileTree: DataSlice<FileTree | null>;
+}
+/**
+ * Typed panel props for GitChangesPanel
+ */
+export type GitChangesPanelPropsTyped = CorePanelComponentProps<CorePanelActions, GitChangesPanelContext>;
+/**
+ * Typed context for PackageCompositionPanel
+ */
+export interface PackageCompositionPanelContext {
+    packages: DataSlice<PackagesSliceData | null>;
+    /** Alexandria repository entry with GitHub metadata */
+    repositoryEntry: DataSlice<AlexandriaEntry | null>;
+}
+/**
+ * Extended actions for PackageCompositionPanel
+ */
+export interface PackageCompositionPanelActions extends CorePanelActions {
+    /** Read file content from the repository */
+    readFile?: (filePath: string) => Promise<string>;
+}
+/**
+ * Typed panel props for PackageCompositionPanel
+ */
+export type PackageCompositionPanelPropsTyped = CorePanelComponentProps<PackageCompositionPanelActions, PackageCompositionPanelContext>;
+/**
+ * Typed context for SearchPanel
+ */
+export interface SearchPanelContext {
+    fileTree: DataSlice<FileTree | null>;
+}
+/**
+ * Typed panel props for SearchPanel
+ */
+export type SearchPanelPropsTyped = CorePanelComponentProps<CorePanelActions, SearchPanelContext>;
+/**
+ * Typed context for DependencyGraphPanel
+ */
+export interface DependencyGraphPanelContext {
+    packages: DataSlice<PackagesSliceData | null>;
+}
+/**
+ * Typed panel props for DependencyGraphPanel
+ */
+export type DependencyGraphPanelPropsTyped = CorePanelComponentProps<CorePanelActions, DependencyGraphPanelContext>;
+/**
+ * Typed context for TelemetryCoveragePanel
+ */
+export interface TelemetryCoveragePanelContext {
+    packages: DataSlice<PackagesSliceData | null>;
+    fileTree: DataSlice<FileTree | null>;
+}
+/**
+ * Typed panel props for TelemetryCoveragePanel
+ */
+export type TelemetryCoveragePanelPropsTyped = CorePanelComponentProps<CorePanelActions, TelemetryCoveragePanelContext>;
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/utils/envParser.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Environment Variable Parser
+ *
+ * Parses environment variable documentation from both:
+ * - env.json (structured JSON format)
+ * - .env.example / .env.sample (dotenv format with comments)
+ */
+export interface EnvVariable {
+    name: string;
+    description?: string;
+    required: boolean;
+    default?: string;
+    example?: string;
+    group?: string;
+    link?: string;
+}
+export interface EnvParseResult {
+    variables: EnvVariable[];
+    format: 'json' | 'dotenv';
+}
+/**
+ * Parse environment variable documentation file
+ *
+ * @param content - File content
+ * @param fileType - File type ('json' for env.json, 'custom' for .env.example)
+ * @returns Parsed environment variables
+ */
+export declare function parseEnvFile(content: string, fileType: 'json' | 'yaml' | 'toml' | 'js' | 'ts' | 'ini' | 'custom'): EnvParseResult;
+//# sourceMappingURL=envParser.d.ts.map

package/dist/utils/envParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envParser.d.ts","sourceRoot":"","sources":["../../src/utils/envParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC3B;AAqJD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,GAClE,cAAc,CAahB"}

package/dist/utils/licenseColors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * License permissiveness levels and color mapping
+ */
+export type LicensePermissiveness = 'permissive' | 'weakCopyleft' | 'strongCopyleft' | 'unknown';
+/**
+ * Get the permissiveness level of a license
+ */
+export declare function getLicensePermissiveness(license: string | undefined): LicensePermissiveness;
+/**
+ * Get a color for a license based on its permissiveness
+ */
+export declare function getLicenseColor(license: string | undefined): string;
+//# sourceMappingURL=licenseColors.d.ts.map

package/dist/utils/licenseColors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"licenseColors.d.ts","sourceRoot":"","sources":["../../src/utils/licenseColors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,SAAS,CAAC;AAiCd;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,qBAAqB,CAqBvB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAcnE"}

package/dist/utils/repositoryAging.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Utilities for calculating repository age and weathering effects
+ * Based on lastEditedAt timestamp to show aging/inactivity
+ */
+export type AgeCategory = 'fresh' | 'recent' | 'old';
+export interface AgingMetrics {
+    category: AgeCategory;
+    monthsSinceEdit: number;
+    weatheringLevel: number;
+    colorFade: number;
+    lastEditedAt?: string;
+}
+/**
+ * Calculate aging metrics from last edit timestamp
+ * Categories:
+ * - Fresh: 0-3 months (no weathering, vibrant colors)
+ * - Recent: 3-12 months (light weathering, slight color fade)
+ * - Old: 1+ year (heavy weathering, significant color fade)
+ */
+export declare function calculateAgingMetrics(lastEditedAt?: string): AgingMetrics;
+/**
+ * Apply color desaturation/fading to a hex color
+ * fadeAmount: 0.0 (no change) to 1.0 (fully desaturated/grayed)
+ */
+export declare function applyColorFade(hexColor: string, fadeAmount: number): string;
+//# sourceMappingURL=repositoryAging.d.ts.map

package/dist/utils/repositoryAging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositoryAging.d.ts","sourceRoot":"","sources":["../../src/utils/repositoryAging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAErD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,YAAY,CAgDzE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAoE3E"}

package/dist/utils/repositoryScaling.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Repository Scaling Utilities
+ *
+ * Provides logarithmic scaling functions to size repository visualizations
+ * based on metrics like file count, lines of code, etc.
+ *
+ * Sizes are rounded to discrete tiers to ensure boundaries cover whole tiles.
+ */
+export interface RepositoryMetrics {
+    fileCount?: number;
+}
+/**
+ * Available size tiers for repository visualization
+ * These ensure that boundaries (4 × size) always cover whole numbers of tiles
+ */
+export declare const SIZE_TIERS: readonly [1, 1.5, 2, 2.5, 3, 3.5, 4];
+/**
+ * Calculate sprite size multiplier based on file count using logarithmic scaling
+ *
+ * Scaling formula (before rounding):
+ * - ≤100 files → 1.0x (minimum)
+ * - 1,000 files → 2.0x
+ * - 10,000 files → 3.0x
+ * - 100,000+ files → 4.0x (maximum)
+ *
+ * Result is rounded to nearest tier (1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0)
+ *
+ * @param fileCount - Number of files in the repository
+ * @returns Size multiplier from SIZE_TIERS
+ */
+export declare function calculateSizeFromFileCount(fileCount: number): number;
+/**
+ * Main function to calculate repository sprite size
+ * Uses file count as the primary metric
+ *
+ * @param metrics - Repository metrics object
+ * @returns Size multiplier from SIZE_TIERS (1.0, 1.5, 2.0, 2.5, 3.0, 3.5, 4.0)
+ */
+export declare function calculateRepositorySize(metrics?: RepositoryMetrics): number;
+//# sourceMappingURL=repositoryScaling.d.ts.map

package/dist/utils/repositoryScaling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositoryScaling.d.ts","sourceRoot":"","sources":["../../src/utils/repositoryScaling.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU,sCAA+C,CAAC;AAYvE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiBpE;AAGD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAU3E"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@industry-theme/repository-composition-panels",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "description": "Repository composition panels including Git Changes panel for the panel framework",
   "type": "module",
   "main": "dist/panels.bundle.js",