flatlock 1.2.0 → 1.3.0

package/dist/parsers/yarn-classic.d.ts

@@ -1,110 +0,0 @@
-/**
- * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
- * !! WARNING: DO NOT MODIFY THIS FUNCTION                                   !!
- * !! AI AGENTS (Claude, Copilot, etc.): DO NOT TOUCH THIS CODE              !!
- * !!                                                                        !!
- * !! This is YARN LOCKFILE KEY parsing, NOT npm spec parsing.               !!
- * !! Yarn lockfile keys have their own format:                              !!
- * !!   - Multiple comma-separated entries: "pkg@^1.0.0, pkg@^2.0.0"         !!
- * !!   - npm: aliasing protocol: "alias@npm:actual@^1.0.0"                  !!
- * !!                                                                        !!
- * !! npm-package-arg (npa) does NOT understand these formats.               !!
- * !! Do not "improve" this with npa.                                        !!
- * !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
- *
- * Extract package name from yarn classic key.
- *
- * @param {string} key - Lockfile entry key
- * @returns {string} Package name
- *
- * @example
- * // Simple unscoped package with semver range
- * parseLockfileKey('lodash@^4.17.21')
- * // => 'lodash'
- *
- * @example
- * // Scoped package
- * parseLockfileKey('@babel/core@^7.0.0')
- * // => '@babel/core'
- *
- * @example
- * // Multiple version ranges (comma-separated) - takes first entry
- * parseLockfileKey('lodash@^4.17.21, lodash@^4.0.0')
- * // => 'lodash'
- *
- * @example
- * // Multiple ranges for scoped package
- * parseLockfileKey('@types/node@^18.0.0, @types/node@^20.0.0')
- * // => '@types/node'
- *
- * @example
- * // npm: alias protocol - returns the ALIAS name
- * parseLockfileKey('@babel/traverse--for-generate-function-map@npm:@babel/traverse@^7.25.3')
- * // => '@babel/traverse--for-generate-function-map'
- *
- * @example
- * // Unscoped alias
- * parseLockfileKey('string-width-cjs@npm:string-width@^4.2.0')
- * // => 'string-width-cjs'
- *
- * @example
- * // Exact version
- * parseLockfileKey('typescript@5.3.3')
- * // => 'typescript'
- *
- * @example
- * // Git URL specifier
- * parseLockfileKey('my-lib@github:user/repo#v1.0.0')
- * // => 'my-lib'
- *
- * @example
- * // Tarball URL
- * parseLockfileKey('custom-pkg@https://example.com/pkg.tgz')
- * // => 'custom-pkg'
- *
- * @example
- * // Package with prerelease version
- * parseLockfileKey('@next/env@^14.0.0-canary.0')
- * // => '@next/env'
- *
- * @example
- * // Package without @ (bare name, edge case)
- * parseLockfileKey('lodash')
- * // => 'lodash'
- *
- * @example
- * // Deeply scoped alias pointing to scoped package
- * parseLockfileKey('@myorg/my-alias@npm:@original/package@^1.0.0')
- * // => '@myorg/my-alias'
- */
-export function parseLockfileKey(key: string): string;
-/**
- * Parse yarn.lock v1 (classic)
- * @param {string | object} input - Lockfile content string or pre-parsed object
- * @param {Object} [_options] - Parser options (unused, reserved for future use)
- * @returns {Generator<Dependency>}
- */
-export function fromYarnClassicLock(input: string | object, _options?: Object): Generator<Dependency>;
-/** @typedef {import('./types.js').Dependency} Dependency */
-/**
- * @typedef {Object} YarnClassicParseResult
- * @property {'success' | 'merge' | 'conflict'} type - Parse result type
- * @property {Record<string, any>} object - Parsed lockfile object
- */
-/**
- * The yarn classic parse function (handles CJS/ESM interop)
- * @type {(content: string) => YarnClassicParseResult}
- */
-export const parseYarnClassic: (content: string) => YarnClassicParseResult;
-export type Dependency = import("./types.js").Dependency;
-export type YarnClassicParseResult = {
-    /**
-     * - Parse result type
-     */
-    type: "success" | "merge" | "conflict";
-    /**
-     * - Parsed lockfile object
-     */
-    object: Record<string, any>;
-};
-//# sourceMappingURL=yarn-classic.d.ts.map

package/dist/parsers/yarn-classic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"yarn-classic.d.ts","sourceRoot":"","sources":["../../src/parsers/yarn-classic.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8EG;AACH,sCA/DW,MAAM,GACJ,MAAM,CA8FlB;AAED;;;;;GAKG;AACH,2CAJW,MAAM,GAAG,MAAM,aACf,MAAM,GACJ,SAAS,CAAC,UAAU,CAAC,CAgCjC;AAnKD,4DAA4D;AAE5D;;;;GAIG;AAEH;;;GAGG;AACH,+BAFU,CAAC,OAAO,EAAE,MAAM,KAAK,sBAAsB,CAE6B;yBAZpE,OAAO,YAAY,EAAE,UAAU;;;;;UAI/B,SAAS,GAAG,OAAO,GAAG,UAAU;;;;YAChC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC"}

package/dist/result.d.ts

@@ -1,12 +0,0 @@
-export function Ok<T>(value: T): OkResult<T>;
-export function Err(error: Error | string): ErrResult;
-export type OkResult<T> = {
-    ok: true;
-    value: T;
-};
-export type ErrResult = {
-    ok: false;
-    error: Error;
-};
-export type Result<T> = OkResult<T> | ErrResult;
-//# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.js"],"names":[],"mappings":"AAwBO,mBAJM,CAAC,SACH,CAAC,GACC,QAAQ,CAAC,CAAC,CAAC,CAEwB;AAOzC,2BAHI,KAAK,GAAG,MAAM,GACZ,SAAS,CAKpB;qBAjCW,CAAC;QAEA,IAAI;WACJ,CAAC;;;QAKD,KAAK;WACL,KAAK;;mBAIN,CAAC,IACD,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS"}

package/dist/set.d.ts

@@ -1,189 +0,0 @@
-/**
- * A Set-like container for lockfile dependencies.
- *
- * Identity is determined by name@version. Two dependencies with the same
- * name and version are considered equal, regardless of integrity or resolved URL.
- *
- * All set operations return new FlatlockSet instances (immutable pattern).
- *
- * NOTE: Set operations (union, intersection, difference) return sets that
- * cannot use dependenciesOf() because they lack lockfile traversal data.
- *
- * @example
- * const set = await FlatlockSet.fromPath('./package-lock.json');
- * console.log(set.size); // 1234
- * console.log(set.has('lodash@4.17.21')); // true
- *
- * // Get dependencies for a specific workspace
- * const pkg = JSON.parse(await readFile('./packages/foo/package.json'));
- * const subset = set.dependenciesOf(pkg, { workspacePath: 'packages/foo' });
- *
- * // Set operations
- * const other = await FlatlockSet.fromPath('./other-lock.json');
- * const common = set.intersection(other);
- */
-export class FlatlockSet {
-    /**
-     * Create FlatlockSet from lockfile path (auto-detect type)
-     * @param {string} path - Path to lockfile
-     * @param {FromStringOptions} [options] - Parser options
-     * @returns {Promise<FlatlockSet>}
-     */
-    static fromPath(path: string, options?: FromStringOptions): Promise<FlatlockSet>;
-    /**
-     * Create FlatlockSet from lockfile string
-     * @param {string} content - Lockfile content
-     * @param {FromStringOptions} [options] - Parser options
-     * @returns {FlatlockSet}
-     */
-    static fromString(content: string, options?: FromStringOptions): FlatlockSet;
-    /**
-     * Parse lockfile once, returning both processed deps and raw data
-     * @param {string} content
-     * @param {LockfileType} type
-     * @param {FromStringOptions} options
-     * @returns {{ deps: Map<string, Dependency>, packages: LockfilePackages, importers: LockfileImporters | null }}
-     */
-    static "__#private@#parseAll"(content: string, type: LockfileType, options: FromStringOptions): {
-        deps: Map<string, Dependency>;
-        packages: LockfilePackages;
-        importers: LockfileImporters | null;
-    };
-    /**
-     * @param {symbol} internal - Must be INTERNAL symbol
-     * @param {Map<string, Dependency>} deps
-     * @param {LockfilePackages | null} packages
-     * @param {LockfileImporters | null} importers
-     * @param {LockfileType | null} type
-     */
-    constructor(internal: symbol, deps: Map<string, Dependency>, packages: LockfilePackages | null, importers: LockfileImporters | null, type: LockfileType | null);
-    /** @returns {number} */
-    get size(): number;
-    /** @returns {LockfileType | null} */
-    get type(): LockfileType | null;
-    /** @returns {boolean} */
-    get canTraverse(): boolean;
-    /**
-     * Check if a dependency exists
-     * @param {string} nameAtVersion - e.g., "lodash@4.17.21"
-     * @returns {boolean}
-     */
-    has(nameAtVersion: string): boolean;
-    /**
-     * Get a dependency by name@version
-     * @param {string} nameAtVersion
-     * @returns {Dependency | undefined}
-     */
-    get(nameAtVersion: string): Dependency | undefined;
-    /** @returns {IterableIterator<Dependency>} */
-    values(): IterableIterator<Dependency>;
-    /** @returns {IterableIterator<string>} */
-    keys(): IterableIterator<string>;
-    /** @returns {IterableIterator<[string, Dependency]>} */
-    entries(): IterableIterator<[string, Dependency]>;
-    /**
-     * Execute a callback for each dependency
-     * @param {(dep: Dependency, key: string, set: FlatlockSet) => void} callback
-     * @param {any} [thisArg]
-     */
-    forEach(callback: (dep: Dependency, key: string, set: FlatlockSet) => void, thisArg?: any): void;
-    /**
-     * Union of this set with another
-     * @param {FlatlockSet} other
-     * @returns {FlatlockSet}
-     */
-    union(other: FlatlockSet): FlatlockSet;
-    /**
-     * Intersection of this set with another
-     * @param {FlatlockSet} other
-     * @returns {FlatlockSet}
-     */
-    intersection(other: FlatlockSet): FlatlockSet;
-    /**
-     * Difference: elements in this set but not in other
-     * @param {FlatlockSet} other
-     * @returns {FlatlockSet}
-     */
-    difference(other: FlatlockSet): FlatlockSet;
-    /**
-     * Check if this set is a subset of another
-     * @param {FlatlockSet} other
-     * @returns {boolean}
-     */
-    isSubsetOf(other: FlatlockSet): boolean;
-    /**
-     * Check if this set is a superset of another
-     * @param {FlatlockSet} other
-     * @returns {boolean}
-     */
-    isSupersetOf(other: FlatlockSet): boolean;
-    /**
-     * Check if this set has no elements in common with another
-     * @param {FlatlockSet} other
-     * @returns {boolean}
-     */
-    isDisjointFrom(other: FlatlockSet): boolean;
-    /**
-     * Get transitive dependencies of a package.json
-     *
-     * For monorepos, provide workspacePath to get correct resolution.
-     * Without workspacePath, assumes root package (hoisted deps only).
-     *
-     * NOTE: This method is only available on sets created directly from
-     * fromPath/fromString. Sets created via union/intersection/difference
-     * cannot use this method (canTraverse will be false).
-     *
-     * @param {PackageJson} packageJson - Parsed package.json
-     * @param {DependenciesOfOptions} [options]
-     * @returns {FlatlockSet}
-     * @throws {Error} If called on a set that cannot traverse
-     */
-    dependenciesOf(packageJson: PackageJson, options?: DependenciesOfOptions): FlatlockSet;
-    /**
-     * Convert to array
-     * @returns {Dependency[]}
-     */
-    toArray(): Dependency[];
-    /** @returns {IterableIterator<Dependency>} */
-    [Symbol.iterator](): IterableIterator<Dependency>;
-    #private;
-}
-export type Dependency = import("./parsers/npm.js").Dependency;
-export type LockfileType = import("./detect.js").LockfileType;
-export type DependenciesOfOptions = {
-    /**
-     * - Path to workspace (e.g., 'packages/foo')
-     */
-    workspacePath?: string;
-    /**
-     * - Include devDependencies
-     */
-    dev?: boolean;
-    /**
-     * - Include optionalDependencies
-     */
-    optional?: boolean;
-    /**
-     * - Include peerDependencies (default false: peers are provided by consumer)
-     */
-    peer?: boolean;
-};
-export type FromStringOptions = {
-    /**
-     * - Path hint for type detection
-     */
-    path?: string;
-    /**
-     * - Explicit lockfile type
-     */
-    type?: LockfileType;
-};
-export type PackageJson = {
-    dependencies?: Record<string, string>;
-    devDependencies?: Record<string, string>;
-    optionalDependencies?: Record<string, string>;
-    peerDependencies?: Record<string, string>;
-};
-export type LockfilePackages = Record<string, any>;
-export type LockfileImporters = Record<string, any>;
-//# sourceMappingURL=set.d.ts.map

package/dist/set.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"set.d.ts","sourceRoot":"","sources":["../src/set.js"],"names":[],"mappings":"AAoDA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;IAoCE;;;;;OAKG;IACH,sBAJW,MAAM,YACN,iBAAiB,GACf,OAAO,CAAC,WAAW,CAAC,CAKhC;IAED;;;;;OAKG;IACH,2BAJW,MAAM,YACN,iBAAiB,GACf,WAAW,CAgBvB;IAED;;;;;;OAMG;IACH,uCALW,MAAM,QACN,YAAY,WACZ,iBAAiB,GACf;QAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAAC,QAAQ,EAAE,gBAAgB,CAAC;QAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAA;KAAE,CAmD9G;IA7GD;;;;;;OAMG;IACH,sBANW,MAAM,QACN,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,YACvB,gBAAgB,GAAG,IAAI,aACvB,iBAAiB,GAAG,IAAI,QACxB,YAAY,GAAG,IAAI,EAa7B;IA6FD,wBAAwB;IACxB,YADc,MAAM,CAGnB;IAED,qCAAqC;IACrC,YADc,YAAY,GAAG,IAAI,CAGhC;IAED,yBAAyB;IACzB,mBADc,OAAO,CAGpB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;;OAIG;IACH,mBAHW,MAAM,GACJ,UAAU,GAAG,SAAS,CAIlC;IAOD,8CAA8C;IAC9C,UADc,gBAAgB,CAAC,UAAU,CAAC,CAGzC;IAED,0CAA0C;IAC1C,QADc,gBAAgB,CAAC,MAAM,CAAC,CAGrC;IAED,wDAAwD;IACxD,WADc,gBAAgB,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAGnD;IAED;;;;OAIG;IACH,kBAHW,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,KAAK,IAAI,YACxD,GAAG,QAMb;IAED;;;;OAIG;IACH,aAHW,WAAW,GACT,WAAW,CAUvB;IAED;;;;OAIG;IACH,oBAHW,WAAW,GACT,WAAW,CAUvB;IAED;;;;OAIG;IACH,kBAHW,WAAW,GACT,WAAW,CAUvB;IAED;;;;OAIG;IACH,kBAHW,WAAW,GACT,OAAO,CAOnB;IAED;;;;OAIG;IACH,oBAHW,WAAW,GACT,OAAO,CAInB;IAED;;;;OAIG;IACH,sBAHW,WAAW,GACT,OAAO,CAOnB;IAED;;;;;;;;;;;;;;OAcG;IACH,4BALW,WAAW,YACX,qBAAqB,GACnB,WAAW,CA4BvB;IAiOD;;;OAGG;IACH,WAFa,UAAU,EAAE,CAIxB;IA5XD,8CAA8C;IAC9C,qBADc,gBAAgB,CAAC,UAAU,CAAC,CAGzC;;CA0XF;yBA1lBY,OAAO,kBAAkB,EAAE,UAAU;2BACrC,OAAO,aAAa,EAAE,YAAY;;;;;oBAKjC,MAAM;;;;UACN,OAAO;;;;eACP,OAAO;;;;WACP,OAAO;;;;;;WAKP,MAAM;;;;WACN,YAAY;;;mBAKZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;sBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;2BACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;uBACtB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;+BAIvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;gCAInB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC"}