feat(semver): introduce new domain!

Author: jasonkuhrt

package.json

@@ -54,6 +54,8 @@
     "#ts/ts": "./build/utils/ts/$$.js",
     "#rec": "./build/domains/rec/$.js",
     "#rec/rec": "./build/domains/rec/$$.js",
+    "#semver": "./build/domains/semver/$.js",
+    "#semver/semver": "./build/domains/semver/$$.js",
     "#lang": "./build/utils/lang/$.js",
     "#lang/lang": "./build/utils/lang/$$.js",
     "#mask": "./build/utils/mask/$.js",
@@ -175,6 +177,7 @@
     "./rec": "./build/domains/rec/$$.js",
     "./resource": "./build/utils/resource/$$.js",
     "./sch": "./build/utils/sch/$$.js",
+    "./semver": "./build/domains/semver/$$.js",
     "./str": "./build/domains/str/$$.js",
     "./test": "./build/utils/test/$.js",
     "./traitor": "./build/utils/traitor/$$.js",
@@ -240,6 +243,7 @@
   "dependencies": {
     "@types/node": "^24.6.1",
     "@types/object-inspect": "^1.13.0",
+    "@vltpkg/semver": "0.0.0-30",
     "ansis": "^4.2.0",
     "consola": "^3.4.2",
     "es-toolkit": "^1.39.10",

pnpm-lock.yaml

@@ -0,0 +1,3 @@
+export * as OfficialRelease from './official-release.js'
+export * as PreRelease from './pre-release.js'
+export * from './semver.js'

src/domains/semver/$$.ts

@@ -0,0 +1,98 @@
+import { S } from '#deps/effect'
+import { Test } from '#test'
+import { Semver } from './$.js'
+
+const decodeSync = S.decodeSync(Semver.Semver)
+
+Test
+  .describe('decodeSync')
+  .on(decodeSync)
+  .casesInput(
+    ['1.2.3'],
+    ['1.2.3-beta.1+build.123'],
+    ['invalid'],
+  )
+  .describeInputs('discriminated union', [
+    ['1.2.3'],
+    ['1.2.3+build.123'],
+    ['1.2.3-beta'],
+    ['1.2.3-beta+build.123'],
+  ])
+  .test()
+
+Test
+  .on(Semver.order)
+  .cases(
+    [[decodeSync('1.0.0'), decodeSync('2.0.0')], -1],
+    [[decodeSync('2.0.0'), decodeSync('1.0.0')], 1],
+    [[decodeSync('1.0.0'), decodeSync('1.0.0')], 0],
+  )
+  .test()
+
+Test
+  .on(Semver.equivalence)
+  .cases(
+    [[decodeSync('1.0.0'), decodeSync('1.0.0')], true],
+    [[decodeSync('1.0.0'), decodeSync('2.0.0')], false],
+  )
+  .test()
+
+Test
+  .on(Semver.is)
+  .cases(
+    [[decodeSync('1.2.3')], true],
+    [[{ major: 1, minor: 2, patch: 3 }], false],
+    [['1.2.3'], false],
+  )
+  .test()
+
+Test
+  .on(Semver.increment)
+  .casesInput(
+    [decodeSync('1.2.3'), 'major'],
+    [decodeSync('1.2.3'), 'minor'],
+    [decodeSync('1.2.3'), 'patch'],
+  )
+  .test()
+
+Test
+  .on(Semver.min)
+  .casesInput(
+    [decodeSync('1.0.0'), decodeSync('2.0.0')],
+    [decodeSync('2.0.0'), decodeSync('1.0.0')],
+  )
+  .test()
+
+Test
+  .on(Semver.max)
+  .casesInput(
+    [decodeSync('1.0.0'), decodeSync('2.0.0')],
+    [decodeSync('2.0.0'), decodeSync('1.0.0')],
+  )
+  .test()
+
+Test
+  .on(Semver.make)
+  .casesInput(
+    [1, 2, 3],
+    [1, 2, 3, 'beta.1'],
+    [1, 2, 3, 'beta.1', 'build.123'],
+    [1, 2, 3, undefined, 'build.123'],
+  )
+  .test()
+
+Test
+  .on(Semver.satisfies)
+  .onSetup(() => ({
+    v: decodeSync('1.2.3'),
+  }))
+  .casesInput(
+    // todo: this should work:
+    // ({ v }) => [v, '>=1.0.0'],
+    [decodeSync('1.2.3'), '>=1.0.0'],
+    [decodeSync('1.2.3'), '^1.0.0'],
+    [decodeSync('1.2.3'), '~1.2.0'],
+    [decodeSync('1.2.3'), '2.x'],
+    [decodeSync('1.2.3'), 'invalid'],
+  )
+  .test()

src/domains/semver/$.test.ts

@@ -0,0 +1 @@
+export * as Semver from './$$.js'