feat(internal): PACKAGE_PATH_REGEX

Signed-off-by: Lexus Drumgold <unicornware@flexdevelopment.llc>

Author: unicornware

src/internal/__tests__/regex-package-path.spec.ts

@@ -0,0 +1,88 @@
+/**
+ * @file Unit Tests - PACKAGE_PATH_REGEX
+ * @module mlly/internal/tests/unit/PACKAGE_PATH_REGEX
+ */
+
+import TEST_SUBJECT from '../regex-package-path'
+
+describe('unit:internal/PACKAGE_PATH_REGEX', () => {
+  it('should match if specifier is valid package path', () => {
+    // Arrange
+    const cases: [string, Record<string, string | undefined>][] = [
+      [
+        '@flex-development/mlly',
+        {
+          pkg: '@flex-development/mlly',
+          scope: '@flex-development',
+          subpath: undefined,
+          version: undefined,
+          version_prefix: undefined
+        }
+      ],
+      [
+        '@flex-development/mlly@1.0.0-alpha.7',
+        {
+          pkg: '@flex-development/mlly',
+          scope: '@flex-development',
+          subpath: undefined,
+          version: '1.0.0-alpha.7',
+          version_prefix: undefined
+        }
+      ],
+      [
+        '@flex-development/mlly@v1.0.0-alpha.7',
+        {
+          pkg: '@flex-development/mlly',
+          scope: '@flex-development',
+          subpath: undefined,
+          version: '1.0.0-alpha.7',
+          version_prefix: 'v'
+        }
+      ],
+      [
+        '@flex-development/mlly@v1.0.0-alpha.7/dist/index.mjs',
+        {
+          pkg: '@flex-development/mlly',
+          scope: '@flex-development',
+          subpath: '/dist/index.mjs',
+          version: '1.0.0-alpha.7',
+          version_prefix: 'v'
+        }
+      ],
+      [
+        'mlly',
+        {
+          pkg: 'mlly',
+          scope: undefined,
+          subpath: undefined,
+          version: undefined,
+          version_prefix: undefined
+        }
+      ]
+    ]
+
+    // Act + Expect
+    cases.forEach(([specifier, groups]) => {
+      const match = TEST_SUBJECT.exec(specifier)
+
+      expect(match).to.not.be.null
+      expect(match?.groups).to.deep.equal(groups)
+    })
+  })
+
+  it('should not match if specifier is not valid package path', () => {
+    // Arrange
+    const cases: string[] = [
+      '#src',
+      './package.json',
+      '@FLEX-DEVELOPMENT/MLLY',
+      'MLLY',
+      'node:fs',
+      'node_modules/@flex-development/mlly',
+      import.meta.url
+    ]
+
+    // Act + Expect
+    cases.forEach(specifier => expect(TEST_SUBJECT.test(specifier)).to.be.false)
+  })
+})

src/internal/regex-package-path.ts

@@ -0,0 +1,18 @@
+/**
+ * @file Internal - PACKAGE_PATH_REGEX
+ * @module mlly/internal/PACKAGE_PATH_REGEX
+ */
+
+/**
+ * Regex pattern matching bare specifiers beginning with valid package names.
+ *
+ * **Note**: Does **not** match specifiers beginning with `'node_modules'`.
+ *
+ * @see https://regex101.com/r/z0MPgj
+ *
+ * @const {RegExp} PACKAGE_PATH_REGEX
+ */
+const PACKAGE_PATH_REGEX: RegExp =
+  /^(?!\S+:|node_modules)(?<pkg>(?:(?:(?<scope>@[\d*a-z~-][\w*.~-]*)\/)?[\da-z~-][\w.~-]*))@?(?<version_prefix>v)?(?<version>(?:(?:0|[1-9]\d*)\.){2}(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-z-][\da-z-]*))*)?(?:\+[\da-z-]+(?:\.[\da-z-]+)*)?)?(?<subpath>\/.*)?(?<!.*(?:%2[Ff]|%5[Cc]))/
+
+export default PACKAGE_PATH_REGEX