@hyperfrontend/project-scope 0.1.0

package/models/index.cjs.js

@@ -0,0 +1,3 @@
+'use strict';
+
+//# sourceMappingURL=index.cjs.js.map

package/models/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;"}

package/models/index.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Project type classification.
+ */
+export type ProjectType = 'application' | 'library' | 'e2e' | 'tool' | 'plugin' | 'unknown';
+/**
+ * Workspace type (monorepo vs standalone).
+ */
+export type WorkspaceType = 'nx' | 'turborepo' | 'lerna' | 'pnpm' | 'npm' | 'yarn' | 'standalone' | 'unknown';
+/**
+ * Complete project analysis result.
+ */
+export interface AnalysisResult {
+    /** Project name */
+    name: string;
+    /** Project root path */
+    root: string;
+    /** Project type classification */
+    projectType: ProjectType;
+    /** Workspace type */
+    workspaceType: WorkspaceType;
+    /** Detected frameworks */
+    frameworks: FrameworkInfo[];
+    /** Detected build tools */
+    buildTools: BuildToolInfo[];
+    /** Detected testing frameworks */
+    testingFrameworks: TestingInfo[];
+    /** Entry points */
+    entryPoints: EntryPointInfo[];
+    /** Configuration files found */
+    configFiles: ConfigFileInfo[];
+    /** Dependency summary */
+    dependencies: DependencySummary;
+    /** Analysis metadata */
+    metadata: AnalysisMetadata;
+}
+/**
+ * Detected framework information.
+ */
+export interface FrameworkInfo {
+    /** Framework identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detected version */
+    version?: string;
+    /** Detection confidence (0-100) */
+    confidence: number;
+    /** Meta-frameworks (e.g., Next.js for React) */
+    metaFrameworks?: string[];
+    /** Category */
+    category: 'frontend' | 'backend' | 'fullstack';
+}
+/**
+ * Build tool information.
+ */
+export interface BuildToolInfo {
+    /** Tool identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detected version */
+    version?: string;
+    /** Config file path */
+    configPath?: string;
+    /** Detection confidence (0-100) */
+    confidence: number;
+}
+/**
+ * Testing framework information.
+ */
+export interface TestingInfo {
+    /** Framework identifier */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Detected version */
+    version?: string;
+    /** Config file path */
+    configPath?: string;
+    /** Test type */
+    type: 'unit' | 'e2e' | 'integration';
+    /** Detection confidence (0-100) */
+    confidence: number;
+}
+/**
+ * Discovered entry point.
+ */
+export interface EntryPointInfo {
+    /** File path */
+    path: string;
+    /** Entry point type */
+    type: 'main' | 'app' | 'server' | 'cli' | 'test';
+    /** Detection confidence (0-100) */
+    confidence: number;
+}
+/**
+ * Detected configuration file.
+ */
+export interface ConfigFileInfo {
+    /** File path */
+    path: string;
+    /** File name */
+    name: string;
+    /** Config format */
+    format: 'json' | 'yaml' | 'js' | 'ts' | 'toml' | 'env';
+    /** Associated tool */
+    tool?: string;
+}
+/**
+ * Project configuration (from package.json, project.json, etc.)
+ */
+export interface ProjectConfig {
+    /** Project name */
+    name: string;
+    /** Version */
+    version?: string;
+    /** Description */
+    description?: string;
+    /** Project type (if NX project) */
+    projectType?: 'application' | 'library';
+    /** Source root */
+    sourceRoot?: string;
+    /** Tags */
+    tags?: string[];
+}
+/**
+ * Aggregated counts of dependencies by category.
+ */
+export interface DependencySummary {
+    /** Production dependency count */
+    production: number;
+    /** Dev dependency count */
+    development: number;
+    /** Peer dependency count */
+    peer: number;
+    /** Optional dependency count */
+    optional: number;
+    /** Total count */
+    total: number;
+}
+/**
+ * Dependency graph node.
+ */
+export interface DependencyNode {
+    /** Node identifier (same as path) */
+    id: string;
+    /** File path */
+    path: string;
+    /** Files this node depends on */
+    dependencies: string[];
+    /** Files that depend on this node */
+    dependents: string[];
+}
+/**
+ * Dependency graph structure.
+ */
+export interface DependencyGraph {
+    /** Nodes in the graph */
+    nodes: Map<string, DependencyNode>;
+    /** Root files (not imported by anything) */
+    roots: string[];
+    /** Leaf files (don't import anything) */
+    leaves: string[];
+}
+/**
+ * Information about when and how the analysis was performed.
+ */
+export interface AnalysisMetadata {
+    /** Analysis timestamp */
+    timestamp: Date;
+    /** Analysis duration in ms */
+    durationMs: number;
+    /** Library version */
+    version: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/models/index.d.ts.map

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

package/models/index.esm.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=index.esm.js.map

package/models/index.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.esm.js","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/nx/detect.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Files indicating NX workspace root.
+ */
+export declare const NX_CONFIG_FILES: readonly ["nx.json", "workspace.json"];
+/**
+ * NX-specific project file.
+ */
+export declare const NX_PROJECT_FILE = "project.json";
+/**
+ * NX workspace layout configuration.
+ */
+export interface NxWorkspaceLayout {
+    /** Applications directory (default: 'apps') */
+    appsDir: string;
+    /** Libraries directory (default: 'libs') */
+    libsDir: string;
+}
+/**
+ * nx.json configuration structure.
+ */
+export interface NxJson {
+    /** Default project */
+    defaultProject?: string;
+    /** Workspace layout */
+    workspaceLayout?: Partial<NxWorkspaceLayout>;
+    /** Named inputs for caching */
+    namedInputs?: Record<string, unknown>;
+    /** Target defaults */
+    targetDefaults?: Record<string, unknown>;
+    /** NX Cloud access token */
+    nxCloudAccessToken?: string;
+    /** Plugins configuration */
+    plugins?: unknown[];
+    /** Task runner options */
+    tasksRunnerOptions?: Record<string, unknown>;
+    /** Default base */
+    defaultBase?: string;
+    /** Additional properties */
+    [key: string]: unknown;
+}
+/**
+ * NX workspace information.
+ */
+export interface NxWorkspaceInfo {
+    /** Workspace root path */
+    root: string;
+    /** NX version from package.json */
+    version: string | null;
+    /** Parsed nx.json */
+    nxJson: NxJson;
+    /** Whether this is an integrated repo (vs standalone) */
+    isIntegrated: boolean;
+    /** Default project name */
+    defaultProject?: string;
+    /** Workspace layout configuration */
+    workspaceLayout: NxWorkspaceLayout;
+}
+/**
+ * Check if directory is an NX workspace root.
+ *
+ * @param path - Directory path to check
+ * @returns True if the directory contains nx.json or workspace.json
+ *
+ * @example
+ * ```typescript
+ * import { isNxWorkspace } from '@hyperfrontend/project-scope'
+ *
+ * if (isNxWorkspace('./my-project')) {
+ *   console.log('This is an NX monorepo')
+ * }
+ * ```
+ */
+export declare function isNxWorkspace(path: string): boolean;
+/**
+ * Check if directory is an NX project.
+ *
+ * @param path - Directory path to check
+ * @returns True if the directory contains project.json
+ */
+export declare function isNxProject(path: string): boolean;
+/**
+ * Find NX workspace root from any path.
+ *
+ * @param startPath - Starting path to search from
+ * @returns Workspace root path or null if not found
+ *
+ * @example
+ * ```typescript
+ * import { findNxWorkspaceRoot } from '@hyperfrontend/project-scope'
+ *
+ * const root = findNxWorkspaceRoot('./libs/my-lib/src')
+ * if (root) {
+ *   console.log('Workspace root:', root) // e.g., '/home/user/my-monorepo'
+ * }
+ * ```
+ */
+export declare function findNxWorkspaceRoot(startPath: string): string | null;
+/**
+ * Get comprehensive NX workspace information.
+ *
+ * @param workspacePath - Workspace root path
+ * @returns Workspace info or null if not an NX workspace
+ */
+export declare function getNxWorkspaceInfo(workspacePath: string): NxWorkspaceInfo | null;
+//# sourceMappingURL=detect.d.ts.map

package/nx/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../../../../../../libs/project-scope/src/nx/detect.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,eAAO,MAAM,eAAe,wCAAuC,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,eAAe,iBAAiB,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;IACf,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,uBAAuB;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;IAC5C,+BAA+B;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,sBAAsB;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACxC,4BAA4B;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,4BAA4B;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAA;IACrB,2BAA2B;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,qCAAqC;IACrC,eAAe,EAAE,iBAAiB,CAAA;CACnC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAIjD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASpE;AAkCD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAmDhF"}

package/nx/devkit-loader.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Type alias for the `@nx/devkit` module.
+ */
+export type NxDevkit = typeof import('@nx/devkit');
+/**
+ * Result of attempting to load `@nx/devkit`.
+ */
+export interface DevkitLoadResult {
+    /** Whether `@nx/devkit` is available */
+    available: boolean;
+    /** The loaded `@nx/devkit` module (if available) */
+    devkit?: NxDevkit;
+    /** Error encountered during loading (if not available) */
+    error?: Error;
+}
+/**
+ * Try to load `@nx/devkit` at runtime.
+ * Uses dynamic require to avoid bundling `@nx/devkit` into our output.
+ * Results are cached for subsequent calls.
+ *
+ * @returns DevkitLoadResult with availability status and devkit module or error
+ */
+export declare function tryLoadDevkit(): DevkitLoadResult;
+/**
+ * Check if `@nx/devkit` is available.
+ *
+ * @returns true if devkit can be loaded, false otherwise
+ */
+export declare function isDevkitAvailable(): boolean;
+/**
+ * Get `@nx/devkit` module if available.
+ * Throws if not available.
+ *
+ * @returns The `@nx/devkit` module with full type information
+ * @throws {Error} If `@nx/devkit` is not available
+ */
+export declare function getDevkit(): NxDevkit;
+/**
+ * Execute function with `@nx/devkit` if available, otherwise execute fallback.
+ * This pattern allows graceful degradation when `@nx/devkit` is not installed.
+ *
+ * @param ifAvailable - Function to execute if `@nx/devkit` is available
+ * @param fallback - Function to execute if `@nx/devkit` is not available
+ * @returns Result from whichever function was executed
+ *
+ * @example
+ * ```typescript
+ * const tree = withDevkit(
+ *   (devkit) => devkit.createTree(),
+ *   () => new FsTree(process.cwd())
+ * )
+ * ```
+ */
+export declare function withDevkit<T>(ifAvailable: (devkit: NxDevkit) => T, fallback: () => T): T;
+/**
+ * Reset the cached devkit load result.
+ * Primarily useful for testing.
+ *
+ * @internal
+ */
+export declare function resetDevkitCache(): void;
+//# sourceMappingURL=devkit-loader.d.ts.map

package/nx/devkit-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devkit-loader.d.ts","sourceRoot":"","sources":["../../../../../../../libs/project-scope/src/nx/devkit-loader.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,cAAc,YAAY,CAAC,CAAA;AAElD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,SAAS,EAAE,OAAO,CAAA;IAClB,oDAAoD;IACpD,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAKD;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,gBAAgB,CAqBhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAQpC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAQxF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}