flatlock 1.2.0 → 1.3.0

package/dist/parsers/pnpm/shrinkwrap.d.ts

@@ -1,129 +0,0 @@
-/**
- * @fileoverview Parser for pnpm shrinkwrap.yaml (v3/v4) format
- *
- * Shrinkwrap format (2016-2019) characteristics:
- * - File: shrinkwrap.yaml
- * - Version field: shrinkwrapVersion (number, typically 3 or 4)
- * - Package key format: /name/version or /@scope/name/version
- * - Peer dependency suffix: /peer@ver with ! escaping for scoped packages
- *   Example: /foo/1.0.0/bar@2.0.0+@scope!qar@3.0.0
- *
- * @module flatlock/parsers/pnpm/shrinkwrap
- */
-/**
- * @typedef {Object} ParsedSpec
- * @property {string|null} name - The package name (null if unparseable)
- * @property {string|null} version - The package version (null if unparseable)
- */
-/**
- * Parse a shrinkwrap.yaml package spec (v3/v4 format).
- *
- * Shrinkwrap format uses:
- * - Slash separator between name and version: /name/version
- * - Peer dependencies after another slash: /name/version/peer@ver
- * - Scoped packages: /@scope/name/version
- * - Scoped peer dependencies use `!` to escape the `@`: `/name/1.0.0/peer@2.0.0+@scope!qar@3.0.0`
- *
- * @param {string} spec - Package spec from shrinkwrap.yaml packages section
- * @returns {ParsedSpec} Parsed name and version
- *
- * @example
- * // Unscoped package
- * parseSpecShrinkwrap('/lodash/4.17.21')
- * // => { name: 'lodash', version: '4.17.21' }
- *
- * @example
- * // Scoped package
- * parseSpecShrinkwrap('/@babel/core/7.23.0')
- * // => { name: '@babel/core', version: '7.23.0' }
- *
- * @example
- * // With peer dependency suffix
- * parseSpecShrinkwrap('/foo/1.0.0/bar@2.0.0')
- * // => { name: 'foo', version: '1.0.0' }
- *
- * @example
- * // With scoped peer dependency (`!` escapes `@`)
- * parseSpecShrinkwrap('/foo/1.0.0/bar@2.0.0+@scope!qar@3.0.0')
- * // => { name: 'foo', version: '1.0.0' }
- *
- * @example
- * // Scoped package with peer deps
- * parseSpecShrinkwrap('/@emotion/styled/10.0.27/react@17.0.2')
- * // => { name: '@emotion/styled', version: '10.0.27' }
- *
- * @example
- * // Multiple peer dependencies
- * parseSpecShrinkwrap('/styled-components/5.3.6/react-dom@17.0.2+react@17.0.2')
- * // => { name: 'styled-components', version: '5.3.6' }
- *
- * @example
- * // Package with hyphenated name
- * parseSpecShrinkwrap('/string-width/4.2.3')
- * // => { name: 'string-width', version: '4.2.3' }
- *
- * @example
- * // Scoped package with hyphenated name
- * parseSpecShrinkwrap('/@babel/helper-compilation-targets/7.23.6')
- * // => { name: '@babel/helper-compilation-targets', version: '7.23.6' }
- *
- * @example
- * // link: protocol - skipped
- * parseSpecShrinkwrap('link:packages/my-pkg')
- * // => { name: null, version: null }
- *
- * @example
- * // file: protocol - skipped
- * parseSpecShrinkwrap('file:../local-package')
- * // => { name: null, version: null }
- *
- * @example
- * // Null input
- * parseSpecShrinkwrap(null)
- * // => { name: null, version: null }
- *
- * @example
- * // Empty string
- * parseSpecShrinkwrap('')
- * // => { name: null, version: null }
- */
-export function parseSpecShrinkwrap(spec: string): ParsedSpec;
-/**
- * Check if a spec has peer dependency suffix (shrinkwrap v3/v4 format).
- *
- * In shrinkwrap v3/v4, peer dependencies are appended after the version
- * with another slash: /name/version/peer@ver+peer2@ver
- *
- * @param {string} spec - Package spec from shrinkwrap.yaml
- * @returns {boolean} True if the spec has peer dependency suffix
- *
- * @example
- * hasPeerSuffix('/lodash/4.17.21') // => false
- * hasPeerSuffix('/foo/1.0.0/bar@2.0.0') // => true
- * hasPeerSuffix('/@babel/core/7.23.0') // => false
- * hasPeerSuffix('/@emotion/styled/10.0.27/react@17.0.2') // => true
- */
-export function hasPeerSuffix(spec: string): boolean;
-/**
- * Extract the peer dependency suffix from a shrinkwrap spec.
- *
- * @param {string} spec - Package spec from shrinkwrap.yaml
- * @returns {string|null} The peer suffix or null if none
- *
- * @example
- * extractPeerSuffix('/lodash/4.17.21') // => null
- * extractPeerSuffix('/foo/1.0.0/bar@2.0.0') // => 'bar@2.0.0'
- * extractPeerSuffix('/foo/1.0.0/bar@2.0.0+@scope!qar@3.0.0') // => 'bar@2.0.0+@scope!qar@3.0.0'
- */
-export function extractPeerSuffix(spec: string): string | null;
-export type ParsedSpec = {
-    /**
-     * - The package name (null if unparseable)
-     */
-    name: string | null;
-    /**
-     * - The package version (null if unparseable)
-     */
-    version: string | null;
-};
-//# sourceMappingURL=shrinkwrap.d.ts.map

package/dist/parsers/pnpm/shrinkwrap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"shrinkwrap.d.ts","sourceRoot":"","sources":["../../../src/parsers/pnpm/shrinkwrap.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,0CA/DW,MAAM,GACJ,UAAU,CA0ItB;AAED;;;;;;;;;;;;;;GAcG;AACH,oCATW,MAAM,GACJ,OAAO,CA6BnB;AAED;;;;;;;;;;GAUG;AACH,wCARW,MAAM,GACJ,MAAM,GAAC,IAAI,CA6BvB;;;;;UAjOa,MAAM,GAAC,IAAI;;;;aACX,MAAM,GAAC,IAAI"}

package/dist/parsers/pnpm/v5.d.ts

@@ -1,139 +0,0 @@
-/**
- * @fileoverview Parser for pnpm-lock.yaml v5.x format
- *
- * pnpm-lock.yaml v5.x format (2019-2022) characteristics:
- * - File: pnpm-lock.yaml
- * - Version field: lockfileVersion (number like 5, 5.1, 5.2, 5.3, 5.4)
- * - Package key format: /name/version or /@scope/name/version
- * - Peer dependency suffix: _peer@ver with + escaping for scoped packages
- *   Example: /foo/1.0.0_bar@2.0.0+@scope+qar@3.0.0
- *
- * Key differences from shrinkwrap v3/v4:
- * - Peer suffix uses _ instead of /
- * - Scoped peer packages escape @ with + instead of !
- *
- * @module flatlock/parsers/pnpm/v5
- */
-/**
- * @typedef {Object} ParsedSpec
- * @property {string|null} name - The package name (null if unparseable)
- * @property {string|null} version - The package version (null if unparseable)
- */
-/**
- * Parse a pnpm-lock.yaml v5.x package spec.
- *
- * v5 format uses:
- * - Slash separator between name and version: /name/version
- * - Peer dependencies after underscore: /name/version_peer@ver
- * - Scoped packages: /@scope/name/version
- * - Multiple peers joined with +: /name/1.0.0_peer1@2.0.0+peer2@3.0.0
- * - Scoped peer dependencies use + to escape the /: _@scope+pkg@1.0.0
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml packages section
- * @returns {ParsedSpec} Parsed name and version
- *
- * @example
- * // Unscoped package
- * parseSpecV5('/lodash/4.17.21')
- * // => { name: 'lodash', version: '4.17.21' }
- *
- * @example
- * // Scoped package
- * parseSpecV5('/@babel/core/7.23.0')
- * // => { name: '@babel/core', version: '7.23.0' }
- *
- * @example
- * // With peer dependency suffix
- * parseSpecV5('/styled-jsx/3.0.9_react@17.0.2')
- * // => { name: 'styled-jsx', version: '3.0.9' }
- *
- * @example
- * // With multiple peer dependencies
- * parseSpecV5('/pkg/1.0.0_react-dom@17.0.2+react@17.0.2')
- * // => { name: 'pkg', version: '1.0.0' }
- *
- * @example
- * // Scoped package with peer deps
- * parseSpecV5('/@emotion/styled/10.0.27_react@17.0.2')
- * // => { name: '@emotion/styled', version: '10.0.27' }
- *
- * @example
- * // Prerelease version
- * parseSpecV5('/@verdaccio/ui-theme/6.0.0-6-next.50')
- * // => { name: '@verdaccio/ui-theme', version: '6.0.0-6-next.50' }
- *
- * @example
- * // Package with hyphenated name
- * parseSpecV5('/string-width/4.2.3')
- * // => { name: 'string-width', version: '4.2.3' }
- *
- * @example
- * // Scoped package with hyphenated name
- * parseSpecV5('/@babel/helper-compilation-targets/7.23.6')
- * // => { name: '@babel/helper-compilation-targets', version: '7.23.6' }
- *
- * @example
- * // Complex peer suffix with scoped peer
- * parseSpecV5('/styled-components/5.3.6_@babel+core@7.23.0+react@18.2.0')
- * // => { name: 'styled-components', version: '5.3.6' }
- *
- * @example
- * // link: protocol - skipped
- * parseSpecV5('link:packages/my-pkg')
- * // => { name: null, version: null }
- *
- * @example
- * // file: protocol - skipped
- * parseSpecV5('file:../local-package')
- * // => { name: null, version: null }
- *
- * @example
- * // Null input
- * parseSpecV5(null)
- * // => { name: null, version: null }
- *
- * @example
- * // Build metadata version
- * parseSpecV5('/esbuild/0.19.12+sha512.abc123')
- * // => { name: 'esbuild', version: '0.19.12+sha512.abc123' }
- */
-export function parseSpecV5(spec: string): ParsedSpec;
-/**
- * Check if a spec has peer dependency suffix (v5 format).
- *
- * In v5, peer dependencies are appended after the version
- * with an underscore: /name/version_peer@ver+peer2@ver
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml
- * @returns {boolean} True if the spec has peer dependency suffix
- *
- * @example
- * hasPeerSuffixV5('/lodash/4.17.21') // => false
- * hasPeerSuffixV5('/foo/1.0.0_bar@2.0.0') // => true
- * hasPeerSuffixV5('/@babel/core/7.23.0') // => false
- * hasPeerSuffixV5('/@emotion/styled/10.0.27_react@17.0.2') // => true
- */
-export function hasPeerSuffixV5(spec: string): boolean;
-/**
- * Extract the peer dependency suffix from a v5 spec.
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml v5
- * @returns {string|null} The peer suffix or null if none
- *
- * @example
- * extractPeerSuffixV5('/lodash/4.17.21') // => null
- * extractPeerSuffixV5('/foo/1.0.0_bar@2.0.0') // => 'bar@2.0.0'
- * extractPeerSuffixV5('/foo/1.0.0_bar@2.0.0+@scope+qar@3.0.0') // => 'bar@2.0.0+@scope+qar@3.0.0'
- */
-export function extractPeerSuffixV5(spec: string): string | null;
-export type ParsedSpec = {
-    /**
-     * - The package name (null if unparseable)
-     */
-    name: string | null;
-    /**
-     * - The package version (null if unparseable)
-     */
-    version: string | null;
-};
-//# sourceMappingURL=v5.d.ts.map

package/dist/parsers/pnpm/v5.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"v5.d.ts","sourceRoot":"","sources":["../../../src/parsers/pnpm/v5.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6EG;AACH,kCApEW,MAAM,GACJ,UAAU,CA+ItB;AAED;;;;;;;;;;;;;;GAcG;AACH,sCATW,MAAM,GACJ,OAAO,CAcnB;AAED;;;;;;;;;;GAUG;AACH,0CARW,MAAM,GACJ,MAAM,GAAC,IAAI,CAkBvB;;;;;UA7Ma,MAAM,GAAC,IAAI;;;;aACX,MAAM,GAAC,IAAI"}

package/dist/parsers/pnpm/v6plus.d.ts

@@ -1,212 +0,0 @@
-/**
- * @fileoverview Parser for pnpm-lock.yaml v6+ format (v6.0 and v9.0)
- *
- * pnpm-lock.yaml v6+ format (2023+) characteristics:
- * - File: pnpm-lock.yaml
- * - Version field: lockfileVersion (string like '6.0', '9.0')
- * - Package key format:
- *   - v6: /name@version or /@scope/name@version (with leading slash)
- *   - v9: name@version or @scope/name@version (no leading slash)
- * - Peer dependency suffix: (peer@ver) in parentheses
- *   Example: /@babel/core@7.23.0(@types/node@20.0.0)
- *
- * Key differences from v5:
- * - Uses @ separator between name and version instead of /
- * - Peer suffix uses parentheses () instead of underscore _
- * - Peer names are human-readable (no hashing)
- * - v9 additionally removes leading slash from keys
- *
- * @module flatlock/parsers/pnpm/v6plus
- */
-/**
- * @typedef {Object} ParsedSpec
- * @property {string|null} name - The package name (null if unparseable)
- * @property {string|null} version - The package version (null if unparseable)
- */
-/**
- * Parse a pnpm-lock.yaml v6+ package spec.
- *
- * v6/v9 format uses:
- * - @ separator between name and version: name@version
- * - Leading slash in v6: /name@version, no slash in v9: name@version
- * - Peer dependencies in parentheses: name@version(peer@ver)
- * - Scoped packages: @scope/name@version
- * - Multiple peers: name@version(peer1@ver)(peer2@ver)
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml packages section
- * @returns {ParsedSpec} Parsed name and version
- *
- * @example
- * // Unscoped package (v6 format with leading slash)
- * parseSpecV6Plus('/lodash@4.17.21')
- * // => { name: 'lodash', version: '4.17.21' }
- *
- * @example
- * // Unscoped package (v9 format without leading slash)
- * parseSpecV6Plus('lodash@4.17.21')
- * // => { name: 'lodash', version: '4.17.21' }
- *
- * @example
- * // Scoped package (v6)
- * parseSpecV6Plus('/@babel/core@7.23.0')
- * // => { name: '@babel/core', version: '7.23.0' }
- *
- * @example
- * // Scoped package (v9)
- * parseSpecV6Plus('@babel/core@7.23.0')
- * // => { name: '@babel/core', version: '7.23.0' }
- *
- * @example
- * // With peer dependency suffix
- * parseSpecV6Plus('/@babel/core@7.23.0(@types/node@20.0.0)')
- * // => { name: '@babel/core', version: '7.23.0' }
- *
- * @example
- * // With multiple peer dependencies
- * parseSpecV6Plus('/@aleph-alpha/config-css@0.18.4(@unocss/core@66.5.2)(postcss@8.5.6)')
- * // => { name: '@aleph-alpha/config-css', version: '0.18.4' }
- *
- * @example
- * // Prerelease version
- * parseSpecV6Plus('/unusual-pkg@1.0.0-beta.1')
- * // => { name: 'unusual-pkg', version: '1.0.0-beta.1' }
- *
- * @example
- * // Package with hyphenated name
- * parseSpecV6Plus('/string-width@4.2.3')
- * // => { name: 'string-width', version: '4.2.3' }
- *
- * @example
- * // Scoped package with hyphenated name
- * parseSpecV6Plus('@babel/helper-compilation-targets@7.23.6')
- * // => { name: '@babel/helper-compilation-targets', version: '7.23.6' }
- *
- * @example
- * // Complex nested peer dependencies (v9)
- * parseSpecV6Plus('@testing-library/react@14.0.0(react-dom@18.2.0)(react@18.2.0)')
- * // => { name: '@testing-library/react', version: '14.0.0' }
- *
- * @example
- * // link: protocol - skipped
- * parseSpecV6Plus('link:packages/my-pkg')
- * // => { name: null, version: null }
- *
- * @example
- * // file: protocol - skipped
- * parseSpecV6Plus('file:../local-package')
- * // => { name: null, version: null }
- *
- * @example
- * // Null input
- * parseSpecV6Plus(null)
- * // => { name: null, version: null }
- *
- * @example
- * // Build metadata version
- * parseSpecV6Plus('esbuild@0.19.12+sha512.abc123')
- * // => { name: 'esbuild', version: '0.19.12+sha512.abc123' }
- */
-export function parseSpecV6Plus(spec: string): ParsedSpec;
-/**
- * Check if a spec has peer dependency suffix (v6+ format).
- *
- * In v6+, peer dependencies are in parentheses: name@version(peer@ver)
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml
- * @returns {boolean} True if the spec has peer dependency suffix
- *
- * @example
- * hasPeerSuffixV6Plus('/lodash@4.17.21') // => false
- * hasPeerSuffixV6Plus('/@babel/core@7.23.0(@types/node@20.0.0)') // => true
- * hasPeerSuffixV6Plus('lodash@4.17.21') // => false
- * hasPeerSuffixV6Plus('@emotion/styled@10.0.27(react@17.0.2)') // => true
- */
-export function hasPeerSuffixV6Plus(spec: string): boolean;
-/**
- * Extract the peer dependency suffix from a v6+ spec.
- *
- * @param {string} spec - Package spec from pnpm-lock.yaml v6+
- * @returns {string|null} The peer suffix (including parentheses) or null if none
- *
- * @example
- * extractPeerSuffixV6Plus('/lodash@4.17.21') // => null
- * extractPeerSuffixV6Plus('/@babel/core@7.23.0(@types/node@20.0.0)') // => '(@types/node@20.0.0)'
- * extractPeerSuffixV6Plus('/@pkg@1.0.0(peer1@2.0.0)(peer2@3.0.0)') // => '(peer1@2.0.0)(peer2@3.0.0)'
- */
-export function extractPeerSuffixV6Plus(spec: string): string | null;
-/**
- * Parse peer dependencies from a v6+ peer suffix.
- *
- * @param {string} peerSuffix - The peer suffix like '(peer1@1.0.0)(peer2@2.0.0)'
- * @returns {Array<{name: string, version: string}>} Array of parsed peer dependencies
- *
- * @example
- * // Single scoped peer
- * parsePeerDependencies('(@types/node@20.0.0)')
- * // => [{ name: '@types/node', version: '20.0.0' }]
- *
- * @example
- * // Multiple unscoped peers
- * parsePeerDependencies('(react@18.2.0)(typescript@5.3.3)')
- * // => [{ name: 'react', version: '18.2.0' }, { name: 'typescript', version: '5.3.3' }]
- *
- * @example
- * // Single unscoped peer
- * parsePeerDependencies('(lodash@4.17.21)')
- * // => [{ name: 'lodash', version: '4.17.21' }]
- *
- * @example
- * // Multiple scoped peers
- * parsePeerDependencies('(@babel/core@7.23.0)(@types/react@18.2.0)')
- * // => [{ name: '@babel/core', version: '7.23.0' }, { name: '@types/react', version: '18.2.0' }]
- *
- * @example
- * // Mixed scoped and unscoped peers
- * parsePeerDependencies('(react@18.2.0)(@types/react@18.2.0)')
- * // => [{ name: 'react', version: '18.2.0' }, { name: '@types/react', version: '18.2.0' }]
- *
- * @example
- * // React ecosystem peers (common pattern)
- * parsePeerDependencies('(react-dom@18.2.0)(react@18.2.0)')
- * // => [{ name: 'react-dom', version: '18.2.0' }, { name: 'react', version: '18.2.0' }]
- *
- * @example
- * // Many peers (complex component library)
- * parsePeerDependencies('(@unocss/core@66.5.2)(postcss@8.5.6)(typescript@5.3.3)')
- * // => [{ name: '@unocss/core', version: '66.5.2' }, { name: 'postcss', version: '8.5.6' }, { name: 'typescript', version: '5.3.3' }]
- *
- * @example
- * // Prerelease peer version
- * parsePeerDependencies('(next@14.0.0-canary.0)')
- * // => [{ name: 'next', version: '14.0.0-canary.0' }]
- *
- * @example
- * // Empty/null input
- * parsePeerDependencies(null)
- * // => []
- *
- * @example
- * // No parentheses (invalid)
- * parsePeerDependencies('react@18.2.0')
- * // => []
- *
- * @example
- * // Deeply scoped peer
- * parsePeerDependencies('(@babel/helper-compilation-targets@7.23.6)')
- * // => [{ name: '@babel/helper-compilation-targets', version: '7.23.6' }]
- */
-export function parsePeerDependencies(peerSuffix: string): Array<{
-    name: string;
-    version: string;
-}>;
-export type ParsedSpec = {
-    /**
-     * - The package name (null if unparseable)
-     */
-    name: string | null;
-    /**
-     * - The package version (null if unparseable)
-     */
-    version: string | null;
-};
-//# sourceMappingURL=v6plus.d.ts.map

package/dist/parsers/pnpm/v6plus.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"v6plus.d.ts","sourceRoot":"","sources":["../../../src/parsers/pnpm/v6plus.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkFG;AACH,sCAzEW,MAAM,GACJ,UAAU,CAqHtB;AAED;;;;;;;;;;;;;GAaG;AACH,0CATW,MAAM,GACJ,OAAO,CAcnB;AAED;;;;;;;;;;GAUG;AACH,8CARW,MAAM,GACJ,MAAM,GAAC,IAAI,CAkBvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4DG;AACH,kDA1DW,MAAM,GACJ,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAC,CAkFlD;;;;;UA1Qa,MAAM,GAAC,IAAI;;;;aACX,MAAM,GAAC,IAAI"}

package/dist/parsers/pnpm.d.ts

@@ -1,2 +0,0 @@
-export * from "./pnpm/index.js";
-//# sourceMappingURL=pnpm.d.ts.map

package/dist/parsers/pnpm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pnpm.d.ts","sourceRoot":"","sources":["../../src/parsers/pnpm.js"],"names":[],"mappings":""}

package/dist/parsers/types.d.ts

@@ -1,23 +0,0 @@
-export type Dependency = {
-    /**
-     * - Package name
-     */
-    name: string;
-    /**
-     * - Resolved version
-     */
-    version: string;
-    /**
-     * - Integrity hash
-     */
-    integrity?: string;
-    /**
-     * - Resolution URL
-     */
-    resolved?: string;
-    /**
-     * - True if this is a symlink
-     */
-    link?: boolean;
-};
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/parsers/types.js"],"names":[],"mappings":";;;;UAEc,MAAM;;;;aACN,MAAM;;;;gBACN,MAAM;;;;eACN,MAAM;;;;WACN,OAAO"}

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

@@ -1,154 +0,0 @@
-/** @typedef {import('./types.js').Dependency} Dependency */
-/**
- * Extract package name from yarn berry resolution field.
- *
- * The resolution field is the CANONICAL identifier and should be used instead of the key.
- * Keys can contain npm aliases (e.g., "string-width-cjs@npm:string-width@^4.2.0") while
- * the resolution always contains the actual package name (e.g., "string-width@npm:4.2.3").
- *
- * @param {string} resolution - Resolution field from lockfile entry
- * @returns {string | null} Package name or null if parsing fails
- *
- * @example
- * // Unscoped npm package
- * parseResolution('lodash@npm:4.17.21')
- * // => 'lodash'
- *
- * @example
- * // Scoped npm package
- * parseResolution('@babel/core@npm:7.24.0')
- * // => '@babel/core'
- *
- * @example
- * // Aliased package - resolution shows the REAL package name
- * // (key was "string-width-cjs@npm:string-width@^4.2.0")
- * parseResolution('string-width@npm:4.2.3')
- * // => 'string-width'
- *
- * @example
- * // Scoped aliased package - resolution shows the REAL package name
- * // (key was "@babel-baseline/core@npm:@babel/core@7.24.4")
- * parseResolution('@babel/core@npm:7.24.4')
- * // => '@babel/core'
- *
- * @example
- * // Patch protocol (nested protocols)
- * parseResolution('pkg@patch:pkg@npm:1.0.0#./patch')
- * // => 'pkg'
- *
- * @example
- * // Scoped package with patch protocol
- * parseResolution('@scope/pkg@patch:@scope/pkg@npm:1.0.0#./fix.patch')
- * // => '@scope/pkg'
- *
- * @example
- * // Workspace protocol
- * parseResolution('my-pkg@workspace:packages/my-pkg')
- * // => 'my-pkg'
- *
- * @example
- * // Scoped workspace package
- * parseResolution('@myorg/utils@workspace:packages/utils')
- * // => '@myorg/utils'
- *
- * @example
- * // Git protocol
- * parseResolution('my-lib@git:github.com/user/repo#commit-hash')
- * // => 'my-lib'
- *
- * @example
- * // Null/empty input
- * parseResolution(null)
- * // => null
- *
- * @example
- * // Empty string
- * parseResolution('')
- * // => null
- *
- * @example
- * // Portal protocol (symlink to external package)
- * parseResolution('@scope/external@portal:../external-pkg')
- * // => '@scope/external'
- */
-export function parseResolution(resolution: string): string | null;
-/**
- * Extract package name from yarn berry key (fallback for when resolution is unavailable).
- *
- * WARNING: Keys can contain npm aliases. Prefer parseResolution() when possible.
- * The key may return an alias name instead of the real package name.
- *
- * @param {string} key - Lockfile entry key
- * @returns {string} Package name (may be alias name, not canonical name)
- *
- * @example
- * // Simple unscoped package
- * parseLockfileKey('lodash@npm:^4.17.21')
- * // => 'lodash'
- *
- * @example
- * // Scoped package
- * parseLockfileKey('@babel/core@npm:^7.24.0')
- * // => '@babel/core'
- *
- * @example
- * // Multiple version ranges (comma-separated) - takes first entry
- * parseLockfileKey('@types/node@npm:^18.0.0, @types/node@npm:^20.0.0')
- * // => '@types/node'
- *
- * @example
- * // npm alias - returns the ALIAS name (not real package)
- * // Use parseResolution() for the real package name
- * parseLockfileKey('string-width-cjs@npm:string-width@^4.2.0')
- * // => 'string-width-cjs'
- *
- * @example
- * // Scoped npm alias
- * parseLockfileKey('@babel-baseline/core@npm:@babel/core@7.24.4')
- * // => '@babel-baseline/core'
- *
- * @example
- * // Workspace protocol
- * parseLockfileKey('my-pkg@workspace:packages/my-pkg')
- * // => 'my-pkg'
- *
- * @example
- * // Scoped workspace package
- * parseLockfileKey('@myorg/utils@workspace:.')
- * // => '@myorg/utils'
- *
- * @example
- * // Portal protocol
- * parseLockfileKey('external-pkg@portal:../some/path')
- * // => 'external-pkg'
- *
- * @example
- * // Link protocol
- * parseLockfileKey('linked-pkg@link:./local')
- * // => 'linked-pkg'
- *
- * @example
- * // Patch protocol (complex nested format)
- * parseLockfileKey('pkg@patch:pkg@npm:1.0.0#./patches/fix.patch')
- * // => 'pkg'
- *
- * @example
- * // Scoped patch
- * parseLockfileKey('@scope/pkg@patch:@scope/pkg@npm:1.0.0#./fix.patch')
- * // => '@scope/pkg'
- *
- * @example
- * // File protocol
- * parseLockfileKey('local-pkg@file:../local-package')
- * // => 'local-pkg'
- */
-export function parseLockfileKey(key: string): string;
-/**
- * Parse yarn.lock v2+ (berry)
- * @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 fromYarnBerryLock(input: string | object, _options?: Object): Generator<Dependency>;
-export type Dependency = import("./types.js").Dependency;
-//# sourceMappingURL=yarn-berry.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"yarn-berry.d.ts","sourceRoot":"","sources":["../../src/parsers/yarn-berry.js"],"names":[],"mappings":"AAEA,4DAA4D;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,4CAjEW,MAAM,GACJ,MAAM,GAAG,IAAI,CA4FzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,sCAhEW,MAAM,GACJ,MAAM,CAiGlB;AAED;;;;;GAKG;AACH,yCAJW,MAAM,GAAG,MAAM,aACf,MAAM,GACJ,SAAS,CAAC,UAAU,CAAC,CAqCjC;yBA3Pa,OAAO,YAAY,EAAE,UAAU"}