@vercel/python-analysis 0.9.1 → 0.10.0

package/dist/manifest/requirements-txt-parser.d.ts

@@ -1,13 +1,10 @@
 import type { PyProjectToml } from './pyproject/types';
 import type { NormalizedRequirement } from './requirement/types';
+import type { ReadFileFn } from '../wasm/host-utils';
 /**
  * Parsed pip arguments from requirements file.
  */
 export interface PipOptions {
-    /** Files referenced via -r or --requirement */
-    requirementFiles: string[];
-    /** Files referenced via -c or --constraint */
-    constraintFiles: string[];
     /** Primary index URL (--index-url or -i) - only the last one is kept */
     indexUrl?: string;
     /** Extra index URLs (--extra-index-url) */
@@ -25,35 +22,27 @@ export interface ParsedRequirementsFile {
     pipOptions: PipOptions;
 }
 /**
- * Function type for reading referenced requirement files.
+ * Options for parsing requirements files.
  */
-export type ReadFileFn = (path: string) => string | null;
+export interface ParseRequirementsOptions {
+    /** Function to read referenced requirement files (-r, -c). */
+    readFile?: ReadFileFn;
+    /** Directory containing the requirements file, used for resolving relative paths. */
+    workingDir?: string;
+    /**
+     * Package root directory (where pyproject.toml lives).
+     * When set and different from workingDir, source paths are rebased
+     * relative to this directory in convertRequirementsToPyprojectToml.
+     */
+    packageRoot?: string;
+}
 /**
  * Convert a requirements.txt content to a pyproject.toml object suitable for uv.
- *
- * This creates a minimal pyproject:
- *
- * [project]
- * dependencies = [...]
- *
- * [tool.uv.sources]
- * package = { git = "..." }
- *
- * Note: Hash information is not included in pyproject.toml output.
- *
- * @param fileContent - The content of the requirements.txt file
- * @param readFile - Optional function to read referenced requirement files (-r, --requirement).
- *                   If provided, referenced files will be recursively processed.
  */
-export declare function convertRequirementsToPyprojectToml(fileContent: string, readFile?: ReadFileFn): PyProjectToml;
+export declare function convertRequirementsToPyprojectToml(fileContent: string, options?: ParseRequirementsOptions): Promise<PyProjectToml>;
 /**
  * Parse requirements file content with full pip options support.
- * Returns both the normalized requirements and the parsed pip options
- * (--requirement, --constraint, --index-url, --extra-index-url, --hash).
- *
- * @param fileContent - The content of the requirements.txt file
- * @param readFile - Optional function to read referenced requirement files (-r, --requirement).
- *                   If provided, referenced files will be recursively processed and their
- *                   requirements merged into the result.
+ * The upstream WASM parser handles -r/-c recursion natively via the host-bridge.
  */
-export declare function parseRequirementsFile(fileContent: string, readFile?: ReadFileFn): ParsedRequirementsFile;
+export declare function parseRequirementsFile(fileContent: string, options?: ParseRequirementsOptions): Promise<ParsedRequirementsFile>;
+export type { ReadFileFn };

package/dist/manifest/uv-lock-parser.d.ts

@@ -9,6 +9,12 @@ export interface UvLockPackageSource {
     editable?: string;
     virtual?: string;
 }
+/**
+ * A wheel entry from a uv.lock file.
+ */
+export interface UvLockWheel {
+    url: string;
+}
 /**
  * A package entry from a parsed uv.lock file.
  */
@@ -16,6 +22,7 @@ export interface UvLockPackage {
     name: string;
     version: string;
     source?: UvLockPackageSource;
+    wheels: UvLockWheel[];
 }
 /**
  * Parsed uv.lock file structure.

package/dist/manifest/wheel-compat.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Check if a wheel filename is compatible with a given platform.
+ *
+ * Uses uv's `WheelFilename::is_compatible()` and `Tags::from_env()` via WASM
+ * — the same logic uv uses for resolution.
+ *
+ * @param wheelFilename - The wheel filename (e.g. "numpy-1.26.4-cp312-cp312-manylinux_2_17_x86_64.whl")
+ * @param pythonMajor - Python major version (e.g. 3)
+ * @param pythonMinor - Python minor version (e.g. 12)
+ * @param osName - OS name: "manylinux", "musllinux", "macos", or "windows"
+ * @param archName - Architecture: "x86_64", "aarch64", etc.
+ * @param osMajor - OS major version (glibc major for Linux, macOS major version)
+ * @param osMinor - OS minor version (glibc minor for Linux, macOS minor version)
+ * @returns true if the wheel is compatible with the platform
+ */
+export declare function isWheelCompatible(wheelFilename: string, pythonMajor: number, pythonMinor: number, osName: string, archName: string, osMajor: number, osMinor: number): Promise<boolean>;

package/dist/wasm/host-utils.d.ts

@@ -0,0 +1,23 @@
+/// <reference types="node" />
+/**
+ * Host-side implementation of the `vercel:python-analysis/host-utils` WIT interface.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/**
+ * Function type for reading referenced requirement files.
+ */
+export type ReadFileFn = (path: string) => string | null;
+export interface ReadFileContext {
+    readFile: ReadFileFn;
+    workingDir?: string;
+}
+export declare const readFileStorage: AsyncLocalStorage<ReadFileContext>;
+export declare function createHostUtils(): {
+    readFile(path: string): string;
+    domainToAscii(domain: string): string;
+    domainToUnicode(domain: string): [string, boolean];
+    nfcNormalize(s: string): string;
+    nfdNormalize(s: string): string;
+    nfkcNormalize(s: string): string;
+    nfkdNormalize(s: string): string;
+};

package/dist/wasm/interfaces/vercel-python-analysis-host-utils.d.ts

@@ -0,0 +1,4 @@
+/** @module Interface vercel:python-analysis/host-utils **/
+export function domainToAscii(domain: string): string;
+export function nfkcNormalize(s: string): string;
+export function readFile(path: string): string;

package/dist/wasm/interfaces/wasi-clocks-wall-clock.d.ts

@@ -0,0 +1,5 @@
+/** @module Interface wasi:clocks/wall-clock@0.2.6 **/
+export interface Datetime {
+  seconds: bigint,
+  nanoseconds: number,
+}

package/dist/wasm/interfaces/wasi-filesystem-preopens.d.ts

@@ -0,0 +1,3 @@
+/** @module Interface wasi:filesystem/preopens@0.2.6 **/
+export function getDirectories(): Array<[Descriptor, string]>;
+export type Descriptor = import('./wasi-filesystem-types.js').Descriptor;

package/dist/wasm/interfaces/wasi-filesystem-types.d.ts

@@ -0,0 +1,142 @@
+/** @module Interface wasi:filesystem/types@0.2.6 **/
+export type Filesize = bigint;
+export type InputStream = import('./wasi-io-streams.js').InputStream;
+/**
+ * # Variants
+ * 
+ * ## `"access"`
+ * 
+ * ## `"would-block"`
+ * 
+ * ## `"already"`
+ * 
+ * ## `"bad-descriptor"`
+ * 
+ * ## `"busy"`
+ * 
+ * ## `"deadlock"`
+ * 
+ * ## `"quota"`
+ * 
+ * ## `"exist"`
+ * 
+ * ## `"file-too-large"`
+ * 
+ * ## `"illegal-byte-sequence"`
+ * 
+ * ## `"in-progress"`
+ * 
+ * ## `"interrupted"`
+ * 
+ * ## `"invalid"`
+ * 
+ * ## `"io"`
+ * 
+ * ## `"is-directory"`
+ * 
+ * ## `"loop"`
+ * 
+ * ## `"too-many-links"`
+ * 
+ * ## `"message-size"`
+ * 
+ * ## `"name-too-long"`
+ * 
+ * ## `"no-device"`
+ * 
+ * ## `"no-entry"`
+ * 
+ * ## `"no-lock"`
+ * 
+ * ## `"insufficient-memory"`
+ * 
+ * ## `"insufficient-space"`
+ * 
+ * ## `"not-directory"`
+ * 
+ * ## `"not-empty"`
+ * 
+ * ## `"not-recoverable"`
+ * 
+ * ## `"unsupported"`
+ * 
+ * ## `"no-tty"`
+ * 
+ * ## `"no-such-device"`
+ * 
+ * ## `"overflow"`
+ * 
+ * ## `"not-permitted"`
+ * 
+ * ## `"pipe"`
+ * 
+ * ## `"read-only"`
+ * 
+ * ## `"invalid-seek"`
+ * 
+ * ## `"text-file-busy"`
+ * 
+ * ## `"cross-device"`
+ */
+export type ErrorCode = 'access' | 'would-block' | 'already' | 'bad-descriptor' | 'busy' | 'deadlock' | 'quota' | 'exist' | 'file-too-large' | 'illegal-byte-sequence' | 'in-progress' | 'interrupted' | 'invalid' | 'io' | 'is-directory' | 'loop' | 'too-many-links' | 'message-size' | 'name-too-long' | 'no-device' | 'no-entry' | 'no-lock' | 'insufficient-memory' | 'insufficient-space' | 'not-directory' | 'not-empty' | 'not-recoverable' | 'unsupported' | 'no-tty' | 'no-such-device' | 'overflow' | 'not-permitted' | 'pipe' | 'read-only' | 'invalid-seek' | 'text-file-busy' | 'cross-device';
+export type OutputStream = import('./wasi-io-streams.js').OutputStream;
+export interface DescriptorFlags {
+  read?: boolean,
+  write?: boolean,
+  fileIntegritySync?: boolean,
+  dataIntegritySync?: boolean,
+  requestedWriteSync?: boolean,
+  mutateDirectory?: boolean,
+}
+/**
+ * # Variants
+ * 
+ * ## `"unknown"`
+ * 
+ * ## `"block-device"`
+ * 
+ * ## `"character-device"`
+ * 
+ * ## `"directory"`
+ * 
+ * ## `"fifo"`
+ * 
+ * ## `"symbolic-link"`
+ * 
+ * ## `"regular-file"`
+ * 
+ * ## `"socket"`
+ */
+export type DescriptorType = 'unknown' | 'block-device' | 'character-device' | 'directory' | 'fifo' | 'symbolic-link' | 'regular-file' | 'socket';
+export type LinkCount = bigint;
+export type Datetime = import('./wasi-clocks-wall-clock.js').Datetime;
+export interface DescriptorStat {
+  type: DescriptorType,
+  linkCount: LinkCount,
+  size: Filesize,
+  dataAccessTimestamp?: Datetime,
+  dataModificationTimestamp?: Datetime,
+  statusChangeTimestamp?: Datetime,
+}
+export interface PathFlags {
+  symlinkFollow?: boolean,
+}
+export interface MetadataHashValue {
+  lower: bigint,
+  upper: bigint,
+}
+
+export class Descriptor {
+  /**
+   * This type does not have a public constructor.
+   */
+  private constructor();
+  readViaStream(offset: Filesize): InputStream;
+  writeViaStream(offset: Filesize): OutputStream;
+  appendViaStream(): OutputStream;
+  getFlags(): DescriptorFlags;
+  stat(): DescriptorStat;
+  statAt(pathFlags: PathFlags, path: string): DescriptorStat;
+  metadataHash(): MetadataHashValue;
+  metadataHashAt(pathFlags: PathFlags, path: string): MetadataHashValue;
+}

package/dist/wasm/vercel_python_analysis.d.ts

@@ -53,6 +53,31 @@ export interface DirectUrlInfoVcs {
   tag: 'vcs',
   val: VcsUrlInfo,
 }
+export interface ParsedVcsInfo {
+  url: string,
+  rev?: string,
+}
+export interface ParsedReqEntry {
+  name?: string,
+  pep508: string,
+  extras: Array<string>,
+  markers?: string,
+  versionSpec?: string,
+  url?: string,
+  hashes: Array<string>,
+  editable: boolean,
+  vcs?: ParsedVcsInfo,
+  givenUrl?: string,
+}
+export interface ParsedRequirementsTxt {
+  requirements: Array<ParsedReqEntry>,
+  editables: Array<ParsedReqEntry>,
+  indexUrl?: string,
+  extraIndexUrls: Array<string>,
+  findLinks: Array<string>,
+  noIndex: boolean,
+}
+import type * as VercelPythonAnalysisHostUtils from './interfaces/vercel-python-analysis-host-utils.js'; // vercel:python-analysis/host-utils
 import type * as WasiCliEnvironment from './interfaces/wasi-cli-environment.js'; // wasi:cli/environment@0.2.6
 import type * as WasiCliExit from './interfaces/wasi-cli-exit.js'; // wasi:cli/exit@0.2.6
 import type * as WasiCliStderr from './interfaces/wasi-cli-stderr.js'; // wasi:cli/stderr@0.2.6
@@ -63,11 +88,15 @@ import type * as WasiCliTerminalOutput from './interfaces/wasi-cli-terminal-outp
 import type * as WasiCliTerminalStderr from './interfaces/wasi-cli-terminal-stderr.js'; // wasi:cli/terminal-stderr@0.2.6
 import type * as WasiCliTerminalStdin from './interfaces/wasi-cli-terminal-stdin.js'; // wasi:cli/terminal-stdin@0.2.6
 import type * as WasiCliTerminalStdout from './interfaces/wasi-cli-terminal-stdout.js'; // wasi:cli/terminal-stdout@0.2.6
+import type * as WasiClocksWallClock from './interfaces/wasi-clocks-wall-clock.js'; // wasi:clocks/wall-clock@0.2.6
+import type * as WasiFilesystemPreopens from './interfaces/wasi-filesystem-preopens.js'; // wasi:filesystem/preopens@0.2.6
+import type * as WasiFilesystemTypes from './interfaces/wasi-filesystem-types.js'; // wasi:filesystem/types@0.2.6
 import type * as WasiIoError from './interfaces/wasi-io-error.js'; // wasi:io/error@0.2.6
 import type * as WasiIoPoll from './interfaces/wasi-io-poll.js'; // wasi:io/poll@0.2.6
 import type * as WasiIoStreams from './interfaces/wasi-io-streams.js'; // wasi:io/streams@0.2.6
 import type * as WasiRandomInsecureSeed from './interfaces/wasi-random-insecure-seed.js'; // wasi:random/insecure-seed@0.2.6
 export interface ImportObject {
+  'vercel:python-analysis/host-utils': typeof VercelPythonAnalysisHostUtils,
   'wasi:cli/environment@0.2.6': typeof WasiCliEnvironment,
   'wasi:cli/exit@0.2.6': typeof WasiCliExit,
   'wasi:cli/stderr@0.2.6': typeof WasiCliStderr,
@@ -78,6 +107,9 @@ export interface ImportObject {
   'wasi:cli/terminal-stderr@0.2.6': typeof WasiCliTerminalStderr,
   'wasi:cli/terminal-stdin@0.2.6': typeof WasiCliTerminalStdin,
   'wasi:cli/terminal-stdout@0.2.6': typeof WasiCliTerminalStdout,
+  'wasi:clocks/wall-clock@0.2.6': typeof WasiClocksWallClock,
+  'wasi:filesystem/preopens@0.2.6': typeof WasiFilesystemPreopens,
+  'wasi:filesystem/types@0.2.6': typeof WasiFilesystemTypes,
   'wasi:io/error@0.2.6': typeof WasiIoError,
   'wasi:io/poll@0.2.6': typeof WasiIoPoll,
   'wasi:io/streams@0.2.6': typeof WasiIoStreams,
@@ -91,6 +123,8 @@ export interface Root {
   parseRecord(content: string): Array<RecordEntry>,
   parseDirectUrl(content: string): DirectUrlInfo,
   normalizePackageName(name: string): string,
+  parseRequirementsTxt(content: string, workingDir: string | undefined, filename: string | undefined): ParsedRequirementsTxt,
+  isWheelCompatible(wheelFilename: string, pythonMajor: number, pythonMinor: number, osName: string, archName: string, osMajor: number, osMinor: number): boolean,
 }
 
 /**