feat(js): new version facade functions

`majorVersion`, `untilMinorVersion`, `untilPatchVersion`, and `fullVersion`.

.changeset/js-version-facades.md

@@ -0,0 +1,5 @@
+---
+'@haetae/javascript': patch
+---
+
+Add new functions `majorVersion`, `untilMinorVersion`, `untilPatchVersion`, and `fullVersion`.

packages/docs/pages/apis/javascript.mdx

@@ -177,6 +177,78 @@ export default configure({
 ```
 </TokenLinkCode>
 
+### `majorVersion`
+
+A [Facade pattern](https://en.wikipedia.org/wiki/Facade_pattern) for the major version from [`version()`](#version).
+
+**Implementation**
+
+<TokenLinkCode tokens={['version', 'VersionOptions']}>
+```ts
+async function majorVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<number> {
+  const { major } = await version(packageName, options)
+  return major
+}
+```
+</TokenLinkCode>
+
+### `untilMinorVersion`
+
+A [Facade pattern](https://en.wikipedia.org/wiki/Facade_pattern) for the until-minor(`x.y`) version of [`version()`](#version).
+
+**Implementation**
+
+<TokenLinkCode tokens={['version', 'VersionOptions']}>
+```ts
+async function untilMinorVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { untilMinor } = await version(packageName, options)
+  return untilMinor
+}
+```
+</TokenLinkCode>
+
+### `untilPatchVersion`
+
+A [Facade pattern](https://en.wikipedia.org/wiki/Facade_pattern) for the until-patch(`x.y.z`) version from [`version()`](#version).
+
+**Implementation**
+
+<TokenLinkCode tokens={['version', 'VersionOptions']}>
+```ts
+async function untilPatchVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { untilPatch } = await version(packageName, options)
+  return untilPatch
+}
+```
+</TokenLinkCode>
+
+### `fullVersion`
+
+A [Facade pattern](https://en.wikipedia.org/wiki/Facade_pattern) for the full version from [`version()`](#version).
+
+**Implementation**
+
+<TokenLinkCode tokens={['version', 'VersionOptions']}>
+```ts
+async function fullVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { value } = await version(packageName, options)
+  return value
+}
+```
+</TokenLinkCode>
+
 ### `GraphOptions`
 
 An argument interface for [`graph`](#graph).

packages/docs/pages/getting-started.mdx

@@ -529,7 +529,7 @@ For instance, let's change the config to this.
   'configure': './apis/haetae#configure',
   'pkg': './apis/haetae#pkg',
   '.hash': './apis/utils#hash',
-  '.version': './apis/javascript#version',
+  '.majorVersion': './apis/javascript#majorversion',
   '.branch': './apis/git#branch',
 }}>
 ```js filename="haetae.config.js" showLineNumbers
@@ -545,7 +545,7 @@ export default configure({
         return {
           NODE_ENV: process.env.NODE_ENV,
           jestConfig: await utils.hash(['jest.config.js']),
-          jest: (await js.version('jest')).major,
+          jest: await js.majorVersion('jest'),
           branch: await git.branch(),
           os: process.platform,
           node: semver.major(process.version),
@@ -1516,7 +1516,7 @@ haetaeConfig: await utils.hash(
 ```
 </TokenLinkCode>
 
-Evaluated `env` is passed from each command's `env` to upper levels.
+Evaluated `env` object is propagated to upper levels.
 
 <TokenLinkCode tokens={{
   'configure': './apis/haetae#configure',
@@ -1527,15 +1527,15 @@ import { configure } from 'haetae'
 
 export default configure({
   env: async (env) => {
-    // Evaluated `env` from each command
+    // Env from each command
     assert(env.hello === 'world')
     return {
       ...env,
       hi: 'there',
     }
   },
   recordData: async (data, { env }) => {
-    // Evaluated `env` from root env
+    // Eenv from RootEnv
     assert(env.hi === 'there')
     assert(env.hello === 'world')
     // ...
@@ -1544,7 +1544,7 @@ export default configure({
     myCommand: {
       env: { hello: 'world' },,
       run: async ({ env }) => {
-        // Evaluated `env` of "myCommand"
+        // Env from "myCommand"
         assert(env.hello === 'world')
         // ...
       }

packages/js/src/version.ts

@@ -98,3 +98,35 @@ export async function version(
     return parseVersion(await versionFromYarnBerry(packageName, { rootDir }))
   }
 }
+
+export async function majorVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<number> {
+  const { major } = await version(packageName, options)
+  return major
+}
+
+export async function untilMinorVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { untilMinor } = await version(packageName, options)
+  return untilMinor
+}
+
+export async function untilPatchVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { untilPatch } = await version(packageName, options)
+  return untilPatch
+}
+
+export async function fullVersion(
+  packageName: string,
+  options: VersionOptions = {},
+): Promise<string> {
+  const { value } = await version(packageName, options)
+  return value
+}