pkgviz 0.7.6 → 0.8.0

package/.next/types/app/layout.ts

@@ -1,84 +0,0 @@
-// File: /Users/a_rtiphishl_e/git/pkgviz/src/app/layout.tsx
-import * as entry from '../../../src/app/layout.js'
-import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
-
-type TEntry = typeof import('../../../src/app/layout.js')
-
-type SegmentParams<T extends Object = any> = T extends Record<string, any>
-  ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }
-  : T
-
-// Check that the entry is a valid entry
-checkFields<Diff<{
-  default: Function
-  config?: {}
-  generateStaticParams?: Function
-  revalidate?: RevalidateRange<TEntry> | false
-  dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
-  dynamicParams?: boolean
-  fetchCache?: 'auto' | 'force-no-store' | 'only-no-store' | 'default-no-store' | 'default-cache' | 'only-cache' | 'force-cache'
-  preferredRegion?: 'auto' | 'global' | 'home' | string | string[]
-  runtime?: 'nodejs' | 'experimental-edge' | 'edge'
-  maxDuration?: number
-  
-  metadata?: any
-  generateMetadata?: Function
-  viewport?: any
-  generateViewport?: Function
-  experimental_ppr?: boolean
-  
-}, TEntry, ''>>()
-
-
-// Check the prop type of the entry function
-checkFields<Diff<LayoutProps, FirstArg<TEntry['default']>, 'default'>>()
-
-// Check the arguments and return type of the generateMetadata function
-if ('generateMetadata' in entry) {
-  checkFields<Diff<LayoutProps, FirstArg<MaybeField<TEntry, 'generateMetadata'>>, 'generateMetadata'>>()
-  checkFields<Diff<ResolvingMetadata, SecondArg<MaybeField<TEntry, 'generateMetadata'>>, 'generateMetadata'>>()
-}
-
-// Check the arguments and return type of the generateViewport function
-if ('generateViewport' in entry) {
-  checkFields<Diff<LayoutProps, FirstArg<MaybeField<TEntry, 'generateViewport'>>, 'generateViewport'>>()
-  checkFields<Diff<ResolvingViewport, SecondArg<MaybeField<TEntry, 'generateViewport'>>, 'generateViewport'>>()
-}
-
-// Check the arguments and return type of the generateStaticParams function
-if ('generateStaticParams' in entry) {
-  checkFields<Diff<{ params: SegmentParams }, FirstArg<MaybeField<TEntry, 'generateStaticParams'>>, 'generateStaticParams'>>()
-  checkFields<Diff<{ __tag__: 'generateStaticParams', __return_type__: any[] | Promise<any[]> }, { __tag__: 'generateStaticParams', __return_type__: ReturnType<MaybeField<TEntry, 'generateStaticParams'>> }>>()
-}
-
-export interface PageProps {
-  params?: Promise<SegmentParams>
-  searchParams?: Promise<any>
-}
-export interface LayoutProps {
-  children?: React.ReactNode
-
-  params?: Promise<SegmentParams>
-}
-
-// =============
-// Utility types
-type RevalidateRange<T> = T extends { revalidate: any } ? NonNegative<T['revalidate']> : never
-
-// If T is unknown or any, it will be an empty {} type. Otherwise, it will be the same as Omit<T, keyof Base>.
-type OmitWithTag<T, K extends keyof any, _M> = Omit<T, K>
-type Diff<Base, T extends Base, Message extends string = ''> = 0 extends (1 & T) ? {} : OmitWithTag<T, keyof Base, Message>
-
-type FirstArg<T extends Function> = T extends (...args: [infer T, any]) => any ? unknown extends T ? any : T : never
-type SecondArg<T extends Function> = T extends (...args: [any, infer T]) => any ? unknown extends T ? any : T : never
-type MaybeField<T, K extends string> = T extends { [k in K]: infer G } ? G extends Function ? G : never : never
-
-
-
-function checkFields<_ extends { [k in keyof any]: never }>() {}
-
-// https://github.com/sindresorhus/type-fest
-type Numeric = number | bigint
-type Zero = 0 | 0n
-type Negative<T extends Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never
-type NonNegative<T extends Numeric> = T extends Zero ? T : Negative<T> extends never ? T : '__invalid_negative_number__'

package/.next/types/app/page.ts

@@ -1,84 +0,0 @@
-// File: /Users/a_rtiphishl_e/git/pkgviz/src/app/page.tsx
-import * as entry from '../../../src/app/page.js'
-import type { ResolvingMetadata, ResolvingViewport } from 'next/dist/lib/metadata/types/metadata-interface.js'
-
-type TEntry = typeof import('../../../src/app/page.js')
-
-type SegmentParams<T extends Object = any> = T extends Record<string, any>
-  ? { [K in keyof T]: T[K] extends string ? string | string[] | undefined : never }
-  : T
-
-// Check that the entry is a valid entry
-checkFields<Diff<{
-  default: Function
-  config?: {}
-  generateStaticParams?: Function
-  revalidate?: RevalidateRange<TEntry> | false
-  dynamic?: 'auto' | 'force-dynamic' | 'error' | 'force-static'
-  dynamicParams?: boolean
-  fetchCache?: 'auto' | 'force-no-store' | 'only-no-store' | 'default-no-store' | 'default-cache' | 'only-cache' | 'force-cache'
-  preferredRegion?: 'auto' | 'global' | 'home' | string | string[]
-  runtime?: 'nodejs' | 'experimental-edge' | 'edge'
-  maxDuration?: number
-  
-  metadata?: any
-  generateMetadata?: Function
-  viewport?: any
-  generateViewport?: Function
-  experimental_ppr?: boolean
-  
-}, TEntry, ''>>()
-
-
-// Check the prop type of the entry function
-checkFields<Diff<PageProps, FirstArg<TEntry['default']>, 'default'>>()
-
-// Check the arguments and return type of the generateMetadata function
-if ('generateMetadata' in entry) {
-  checkFields<Diff<PageProps, FirstArg<MaybeField<TEntry, 'generateMetadata'>>, 'generateMetadata'>>()
-  checkFields<Diff<ResolvingMetadata, SecondArg<MaybeField<TEntry, 'generateMetadata'>>, 'generateMetadata'>>()
-}
-
-// Check the arguments and return type of the generateViewport function
-if ('generateViewport' in entry) {
-  checkFields<Diff<PageProps, FirstArg<MaybeField<TEntry, 'generateViewport'>>, 'generateViewport'>>()
-  checkFields<Diff<ResolvingViewport, SecondArg<MaybeField<TEntry, 'generateViewport'>>, 'generateViewport'>>()
-}
-
-// Check the arguments and return type of the generateStaticParams function
-if ('generateStaticParams' in entry) {
-  checkFields<Diff<{ params: SegmentParams }, FirstArg<MaybeField<TEntry, 'generateStaticParams'>>, 'generateStaticParams'>>()
-  checkFields<Diff<{ __tag__: 'generateStaticParams', __return_type__: any[] | Promise<any[]> }, { __tag__: 'generateStaticParams', __return_type__: ReturnType<MaybeField<TEntry, 'generateStaticParams'>> }>>()
-}
-
-export interface PageProps {
-  params?: Promise<SegmentParams>
-  searchParams?: Promise<any>
-}
-export interface LayoutProps {
-  children?: React.ReactNode
-
-  params?: Promise<SegmentParams>
-}
-
-// =============
-// Utility types
-type RevalidateRange<T> = T extends { revalidate: any } ? NonNegative<T['revalidate']> : never
-
-// If T is unknown or any, it will be an empty {} type. Otherwise, it will be the same as Omit<T, keyof Base>.
-type OmitWithTag<T, K extends keyof any, _M> = Omit<T, K>
-type Diff<Base, T extends Base, Message extends string = ''> = 0 extends (1 & T) ? {} : OmitWithTag<T, keyof Base, Message>
-
-type FirstArg<T extends Function> = T extends (...args: [infer T, any]) => any ? unknown extends T ? any : T : never
-type SecondArg<T extends Function> = T extends (...args: [any, infer T]) => any ? unknown extends T ? any : T : never
-type MaybeField<T, K extends string> = T extends { [k in K]: infer G } ? G extends Function ? G : never : never
-
-
-
-function checkFields<_ extends { [k in keyof any]: never }>() {}
-
-// https://github.com/sindresorhus/type-fest
-type Numeric = number | bigint
-type Zero = 0 | 0n
-type Negative<T extends Numeric> = T extends Zero ? never : `${T}` extends `-${string}` ? T : never
-type NonNegative<T extends Numeric> = T extends Zero ? T : Negative<T> extends never ? T : '__invalid_negative_number__'

package/.next/types/cache-life.d.ts

@@ -1,141 +0,0 @@
-// Type definitions for Next.js cacheLife configs
-
-declare module 'next/cache' {
-  export { unstable_cache } from 'next/dist/server/web/spec-extension/unstable-cache'
-  export {
-    revalidateTag,
-    revalidatePath,
-    unstable_expireTag,
-    unstable_expirePath,
-  } from 'next/dist/server/web/spec-extension/revalidate'
-  export { unstable_noStore } from 'next/dist/server/web/spec-extension/unstable-no-store'
-
-  
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"default"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 900 seconds (15 minutes)
-     *   expire:     never
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 15 minutes, start revalidating new values in the background.
-     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
-     */
-    export function unstable_cacheLife(profile: "default"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"seconds"` profile.
-     * ```
-     *   stale:      0 seconds
-     *   revalidate: 1 seconds
-     *   expire:     60 seconds (1 minute)
-     * ```
-     * 
-     * This cache may be stale on clients for 0 seconds before checking with the server.
-     * If the server receives a new request after 1 seconds, start revalidating new values in the background.
-     * If this entry has no traffic for 1 minute it will expire. The next request will recompute it.
-     */
-    export function unstable_cacheLife(profile: "seconds"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"minutes"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 60 seconds (1 minute)
-     *   expire:     3600 seconds (1 hour)
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 1 minute, start revalidating new values in the background.
-     * If this entry has no traffic for 1 hour it will expire. The next request will recompute it.
-     */
-    export function unstable_cacheLife(profile: "minutes"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"hours"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 3600 seconds (1 hour)
-     *   expire:     86400 seconds (1 day)
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 1 hour, start revalidating new values in the background.
-     * If this entry has no traffic for 1 day it will expire. The next request will recompute it.
-     */
-    export function unstable_cacheLife(profile: "hours"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"days"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 86400 seconds (1 day)
-     *   expire:     604800 seconds (1 week)
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 1 day, start revalidating new values in the background.
-     * If this entry has no traffic for 1 week it will expire. The next request will recompute it.
-     */
-    export function unstable_cacheLife(profile: "days"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"weeks"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 604800 seconds (1 week)
-     *   expire:     2592000 seconds (30 days)
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 1 week, start revalidating new values in the background.
-     * If this entry has no traffic for 30 days it will expire. The next request will recompute it.
-     */
-    export function unstable_cacheLife(profile: "weeks"): void
-    
-    /**
-     * Cache this `"use cache"` for a timespan defined by the `"max"` profile.
-     * ```
-     *   stale:      300 seconds (5 minutes)
-     *   revalidate: 2592000 seconds (30 days)
-     *   expire:     never
-     * ```
-     * 
-     * This cache may be stale on clients for 5 minutes before checking with the server.
-     * If the server receives a new request after 30 days, start revalidating new values in the background.
-     * It lives for the maximum age of the server cache. If this entry has no traffic for a while, it may serve an old value the next request.
-     */
-    export function unstable_cacheLife(profile: "max"): void
-    
-    /**
-     * Cache this `"use cache"` using a custom timespan.
-     * ```
-     *   stale: ... // seconds
-     *   revalidate: ... // seconds
-     *   expire: ... // seconds
-     * ```
-     *
-     * This is similar to Cache-Control: max-age=`stale`,s-max-age=`revalidate`,stale-while-revalidate=`expire-revalidate`
-     *
-     * If a value is left out, the lowest of other cacheLife() calls or the default, is used instead.
-     */
-    export function unstable_cacheLife(profile: {
-      /**
-       * This cache may be stale on clients for ... seconds before checking with the server.
-       */
-      stale?: number,
-      /**
-       * If the server receives a new request after ... seconds, start revalidating new values in the background.
-       */
-      revalidate?: number,
-      /**
-       * If this entry has no traffic for ... seconds it will expire. The next request will recompute it.
-       */
-      expire?: number
-    }): void
-  
-
-  export { cacheTag as unstable_cacheTag } from 'next/dist/server/use-cache/cache-tag'
-}

package/.next/types/package.json

@@ -1 +0,0 @@
-{"type": "module"}

package/src/app/actions/graph.actions.ts

@@ -1,25 +0,0 @@
-'use server';
-import type { ElementsDefinition } from 'cytoscape';
-
-import { markCyclicPackagesWithEvidence } from '@/app/utils/markCyclicPackages';
-import { getParsedFileStructure } from '@/app/utils/getParsedFileStructure';
-import { buildGraph } from '@/app/utils/buildGraph';
-import { relative } from 'node:path';
-import { detectLanguage } from '@/shared/utils/detectLanguage';
-import { resolveRoot } from '@/app/utils/getParsedFileStructure';
-import { parseProjectPath } from '@/shared/utils/parseProjectPath';
-
-export async function getGraphAction(): Promise<ElementsDefinition> {
-  const files = await getParsedFileStructure();
-  const graph = markCyclicPackagesWithEvidence(buildGraph(files), files);
-
-  return graph;
-}
-
-export async function getRootAction(): Promise<string> {
-  const projectRoot = parseProjectPath();
-  const { language } = await detectLanguage(projectRoot);
-  const relativeRootDir = relative(projectRoot, await resolveRoot(projectRoot, language));
-
-  return relativeRootDir;
-}

package/src/app/utils/parser/cpp/extractCppPackageFromImport.ts

@@ -1,18 +0,0 @@
-/**
- * Extracts the package/namespace from a C++ include statement
- * For example: "myapp/utils/Helper.h" -> "myapp.utils"
- */
-export function extractCppPackageFromImport(importPath: string): string {
-  // Remove file extension
-  const withoutExt = importPath.replace(/\.(h|hpp|hxx)$/, '');
-
-  // Split by path separator and take all but the last segment
-  const segments = withoutExt.split('/');
-
-  if (segments.length <= 1) {
-    return '';
-  }
-
-  // Join with dots to create package-like structure
-  return segments.slice(0, -1).join('.');
-}

package/src/app/utils/parser/delphi/extractPackageFromImport.ts

@@ -1,21 +0,0 @@
-/**
- * Extracts the package/unit name from a Delphi uses clause import.
- *
- * Delphi imports are in the format:
- * - uses UnitName;
- * - uses UnitName in 'path/to/UnitName.pas';
- * - uses Vcl.Forms, System.SysUtils;
- *
- * @param importStatement - The full import statement (e.g., "System.SysUtils")
- * @returns The package/namespace name
- */
-export function extractPackageFromImport(importStatement: string): string {
-  const trimmed = importStatement.trim();
-
-  // Handle dotted notation (e.g., "System.SysUtils" -> "System")
-  const parts = trimmed.split('.');
-  if (parts.length > 1) return parts[0];
-
-  // For single unit names without namespace, return as-is
-  return trimmed;
-}

package/src/app/utils/parser/java/extractJavaPackageFromImport.ts

@@ -1,39 +0,0 @@
-/**
- * Extracts the package from a reversed import array
- * @example ['B', 'A', 'java', 'com'] => 'com.java'
- */
-export function extractJavaPackageFromReversedImportArray(segments: string[]): string {
-  let collecting = false;
-  const pkgSegments: string[] = [];
-
-  for (const segment of segments) {
-    if (!collecting && /^[A-Z]/.test(segment)) continue;
-    collecting = true;
-    pkgSegments.push(segment);
-  }
-
-  return pkgSegments.reverse().join('.');
-}
-
-/**
- * Extracts the package name from an import string
- * @example import 'some.package.*'   => 'some.package'
- * @example import 'some.package.A'   => 'some.package'
- * @example import 'some.package.A.B' => 'some.package'
- */
-export function extractJavaPackageFromImport(imp: string) {
-  // Remove trailing '.*' if present
-  const cleaned = imp.replace(/\.\*$/, '');
-
-  // Reverse '.' splitted segments to work more easily
-  const segments = cleaned.split('.').reverse();
-
-  // No package nesting means done
-  if (segments.length < 2) return cleaned;
-
-  // If last segment starts with lowerCase means done
-  if (segments[0].toLowerCase() === segments[0]) return cleaned;
-
-  // Strip class(es) and return pure package name
-  return extractJavaPackageFromReversedImportArray(segments);
-}

package/src/app/utils/parser/java/getIntrinsicPackagesRecursive.ts

@@ -1,33 +0,0 @@
-'use server';
-import { readdirSync } from 'node:fs';
-import { relative, resolve } from 'node:path';
-import { parseProjectPath } from '@/shared/utils/parseProjectPath';
-import { JAVA_ROOT } from '@/shared/constants';
-
-export async function getIntrinsicPackagesRecursive(
-  root: string = parseProjectPath(),
-  currentPath?: string,
-  results: string[] = []
-) {
-  const basePath = resolve(root, JAVA_ROOT);
-  const dirPath = currentPath ?? basePath;
-
-  const entries = readdirSync(dirPath, { withFileTypes: true });
-
-  const subdirs = entries.filter(e => e.isDirectory());
-  const javaFiles = entries.filter(e => e.isFile() && e.name.endsWith('.java'));
-
-  // Only include if it has .java files and no subdirectories
-  if (javaFiles.length > 0 && subdirs.length === 0) {
-    const relPath = relative(basePath, dirPath).replace(/\//g, '.');
-    results.push(relPath);
-  }
-
-  // Recurse into subdirectories
-  for (const dir of subdirs) {
-    const fullPath = resolve(dirPath, dir.name);
-    await getIntrinsicPackagesRecursive(root, fullPath, results);
-  }
-
-  return results;
-}

package/src/app/utils/parser/kotlin/extractPackageFromImport.ts

@@ -1,19 +0,0 @@
-/**
- * Extract the package name from a Kotlin import statement.
- * Examples:
- * - "com.example.models.User" -> "com.example.models"
- * - "kotlinx.coroutines.launch" -> "kotlinx.coroutines"
- * - "java.util.Date" -> "java.util"
- */
-export function extractPackageFromImport(importPath: string): string {
-  // Remove any wildcard imports
-  const cleanPath = importPath.replace(/\.\*$/, '');
-
-  // Split by dots and remove the last part (class/function name)
-  const parts = cleanPath.split('.');
-
-  if (parts.length <= 1) return cleanPath;
-
-  // Return all but the last part
-  return parts.slice(0, -1).join('.');
-}

package/src/app/utils/parser/python/extractPythonPackageFromImport.ts

@@ -1,18 +0,0 @@
-/**
- * Extracts package name from Python import statement.
- *
- * Examples:
- *   "from flask import Flask" -> "flask"
- *   "import numpy as np" -> "numpy"
- *   "from utils.helpers import format_date" -> "utils"
- *   "from .models import User" -> "" (relative import, intrinsic)
- */
-export function extractPythonPackageFromImport(importName: string): string {
-  // Handle relative imports (. or ..)
-  if (importName.startsWith('.')) return '';
-
-  // Extract the base package (first part before any dots)
-  const parts = importName.split('.');
-
-  return parts[0] || importName;
-}

package/src/app/utils/parser/typescript/extractTypeScriptPackageFromImport.ts

@@ -1,18 +0,0 @@
-import { toPosix } from '@/shared/utils/toPosix';
-
-/**
- * Extracts the package path from an import string.
- * @example 'lodash/debounce'     => 'lodash'
- * @example '@nestjs/common'      => '@nestjs/common'
- * @example './components/Button' => './components'
- */
-export function extractTypeScriptPackageFromImport(imp: string): string {
-  const segments = toPosix(imp).split('/');
-  const pathSegments = segments.slice(0, -1).join('/'); // Remove file name
-  const replacedAlias = pathSegments.startsWith('@/')
-    ? pathSegments.replace(/^@/, 'src')
-    : pathSegments;
-
-  // Remove file/class-like suffixes (e.g., 'Button.tsx')
-  return replacedAlias.split('/').join('.');
-}

package/src/components/Cytoscape.tsx

@@ -1,23 +0,0 @@
-'use client';
-import type { ElementsDefinition } from 'cytoscape';
-
-import React from 'react';
-import { useCytoscape } from '@/components/useCytoscape';
-import ZoomInput from '@/components/ZoomInput';
-
-export function Cytoscape({ currentPackage, packageGraph, setCurrentPackage }: CytoscapeProps) {
-  const { cyRef, cyInstance } = useCytoscape(packageGraph, currentPackage, setCurrentPackage);
-
-  return (
-    <div className="flex flex-col w-full px-8 flex-1 gap-2">
-      <div ref={cyRef} className="h-[calc(100%-65px)]" />
-      <ZoomInput cyInstance={cyInstance} />
-    </div>
-  );
-}
-
-interface CytoscapeProps {
-  readonly currentPackage: string;
-  readonly packageGraph: ElementsDefinition | null;
-  readonly setCurrentPackage: (path: string) => void;
-}

package/src/components/Setting.tsx

@@ -1,17 +0,0 @@
-import React from 'react';
-
-const Setting: React.FC<SettingProps> = ({ children }) => {
-  return (
-    <div className="ml-[.8rem] px-[.8rem] py-2  bg-white dark:bg-neutral-900 border-b border-b-neutral-200 dark:border-b-neutral-800">
-      {children}
-    </div>
-  );
-};
-
-Setting.displayName = 'Setting';
-
-export default Setting;
-
-interface SettingProps {
-  readonly children: React.ReactNode;
-}