@jblib/should 0.0.1 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joseph Beck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/should-be-true.d.ts

@@ -1,5 +1,5 @@
 //#region src/should-be-true.d.ts
-declare const shouldBeTrue: (v: unknown) => boolean;
+declare const shouldBeTrue: (v: unknown, message?: string) => void;
 //#endregion
 export { shouldBeTrue };
 //# sourceMappingURL=should-be-true.d.ts.map

package/dist/should-be-true.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"should-be-true.d.ts","names":[],"sources":["../src/should-be-true.ts"],"mappings":";cAAM,YAAA,GAAgB,CAAA"}
+{"version":3,"file":"should-be-true.d.ts","names":[],"sources":["../src/should-be-true.ts"],"mappings":";cAAM,YAAA,GAAgB,CAAA,WAAY,OAAA"}

package/dist/should-be-true.js

@@ -1,5 +1,7 @@
 //#region src/should-be-true.ts
-const shouldBeTrue = (v) => v === true;
+const shouldBeTrue = (v, message) => {
+	if (v !== true) throw new Error(message ?? `should be true, but got ${String(v)}`);
+};
 
 //#endregion
 export { shouldBeTrue };

package/dist/should-be-true.js.map

@@ -1 +1 @@
-{"version":3,"file":"should-be-true.js","names":[],"sources":["../src/should-be-true.ts"],"sourcesContent":["const shouldBeTrue = (v: unknown): boolean => v === true\n\nexport { shouldBeTrue }\n"],"mappings":";AAAA,MAAM,gBAAgB,MAAwB,MAAM"}
+{"version":3,"file":"should-be-true.js","names":[],"sources":["../src/should-be-true.ts"],"sourcesContent":["const shouldBeTrue = (v: unknown, message?: string): void => {\n  if (v !== true) {\n    throw new Error(message ?? `should be true, but got ${String(v)}`)\n  }\n}\n\nexport { shouldBeTrue }\n"],"mappings":";AAAA,MAAM,gBAAgB,GAAY,YAA2B;AAC3D,KAAI,MAAM,KACR,OAAM,IAAI,MAAM,WAAW,2BAA2B,OAAO,EAAE,GAAG"}

package/package.json

@@ -1,42 +1,41 @@
 {
   "name": "@jblib/should",
-  "version": "0.0.1",
-  "description": "should",
+  "version": "0.0.2",
+  "description": "should, assertions that throw errors when conditions aren't met",
   "type": "module",
-  "scripts": {
-    "build": "tsdown",
-    "test": "vitest",
-    "lint": "eslint .",
-    "lint:fix": "eslint . --fix"
-  },
   "devDependencies": {
-    "vitest": "catalog:",
-    "typescript": "catalog:",
-    "@jblib/eslint": "workspace:*",
-    "prettier": "catalog:",
-    "tsdown": "catalog:"
+    "vitest": "^4.1.5",
+    "typescript": "^6.0.3",
+    "prettier": "^3.8.3",
+    "tsdown": "^0.21.10",
+    "@jblib/eslint": "0.0.1"
   },
   "keywords": [
-    "should"
+    "should",
+    "assert"
   ],
   "author": {
     "name": "Joseph Beck"
   },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "types": "./dist/index.d.ts",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/joseph-beck/jblib.git",
     "directory": "packages/should"
   },
   "license": "MIT",
-  "packageManager": "pnpm@10.33.0",
   "exports": {
-    ".": "./src/index.ts",
+    ".": "./dist/index.js",
     "./package.json": "./package.json"
   },
-  "publishConfig": {
-    "exports": {
-      ".": "./dist/index.js",
-      "./package.json": "./package.json"
-    }
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix"
   }
-}
+}

package/src/should-be-false.spec.ts

@@ -0,0 +1,26 @@
+import { describe, expect, it } from 'vitest'
+
+import { shouldBeFalse } from './should-be-false.js'
+
+describe('should be false', () => {
+  it('should not throw for false', () => {
+    expect(() => shouldBeFalse(false)).not.toThrow()
+  })
+
+  it('should throw for true', () => {
+    expect(() => shouldBeFalse(true)).toThrow('should be false, but got true')
+  })
+
+  it('should throw for non-false values', () => {
+    expect(() => shouldBeFalse(123)).toThrow('should be false, but got 123')
+    expect(() => shouldBeFalse('hello')).toThrow('should be false, but got hello')
+    expect(() => shouldBeFalse({})).toThrow('should be false, but got [object Object]')
+    expect(() => shouldBeFalse([])).toThrow('should be false, but got ')
+    expect(() => shouldBeFalse(null)).toThrow('should be false, but got null')
+    expect(() => shouldBeFalse(undefined)).toThrow('should be false, but got undefined')
+  })
+
+  it('should use custom message if provided', () => {
+    expect(() => shouldBeFalse(true, 'custom error message')).toThrow('custom error message')
+  })
+})

package/src/should-be-false.ts

@@ -0,0 +1,7 @@
+const shouldBeFalse = (v: unknown, message?: string): void => {
+  if (v !== false) {
+    throw new Error(message ?? `should be false, but got ${String(v)}`)
+  }
+}
+
+export { shouldBeFalse }

package/src/should-be-true.spec.ts

@@ -3,20 +3,24 @@ import { describe, expect, it } from 'vitest'
 import { shouldBeTrue } from './should-be-true.js'
 
 describe('should be true', () => {
-  it('should return true for true', () => {
-    expect(shouldBeTrue(true)).toBe(true)
+  it('should not throw for true', () => {
+    expect(() => shouldBeTrue(true)).not.toThrow()
   })
 
-  it('should return false for false', () => {
-    expect(shouldBeTrue(false)).toBe(false)
+  it('should throw for false', () => {
+    expect(() => shouldBeTrue(false)).toThrow('should be true, but got false')
   })
 
-  it('should return false for non-true values', () => {
-    expect(shouldBeTrue(123)).toBe(false)
-    expect(shouldBeTrue('hello')).toBe(false)
-    expect(shouldBeTrue({})).toBe(false)
-    expect(shouldBeTrue([])).toBe(false)
-    expect(shouldBeTrue(null)).toBe(false)
-    expect(shouldBeTrue(undefined)).toBe(false)
+  it('should throw for non-true values', () => {
+    expect(() => shouldBeTrue(123)).toThrow('should be true, but got 123')
+    expect(() => shouldBeTrue('hello')).toThrow('should be true, but got hello')
+    expect(() => shouldBeTrue({})).toThrow('should be true, but got [object Object]')
+    expect(() => shouldBeTrue([])).toThrow('should be true, but got ')
+    expect(() => shouldBeTrue(null)).toThrow('should be true, but got null')
+    expect(() => shouldBeTrue(undefined)).toThrow('should be true, but got undefined')
+  })
+
+  it('should use custom message if provided', () => {
+    expect(() => shouldBeTrue(false, 'custom error message')).toThrow('custom error message')
   })
 })

package/src/should-be-true.ts

@@ -1,3 +1,7 @@
-const shouldBeTrue = (v: unknown): boolean => v === true
+const shouldBeTrue = (v: unknown, message?: string): void => {
+  if (v !== true) {
+    throw new Error(message ?? `should be true, but got ${String(v)}`)
+  }
+}
 
 export { shouldBeTrue }

package/eslint.config.ts

@@ -1,6 +0,0 @@
-import { jblibConfig } from '@jblib/eslint'
-import { type Linter } from 'eslint'
-
-const config: Linter.Config[] = [...jblibConfig]
-
-export default config

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": true,
-    "noEmit": false
-  },
-  "include": ["src", "*.config.ts"]
-}

package/tsdown.config.ts

@@ -1,23 +0,0 @@
-import { defineConfig } from 'tsdown'
-
-export default defineConfig({
-  entry: ['./src/index.ts'],
-  format: ['esm'],
-  platform: 'node',
-  unbundle: true,
-  dts: true,
-  sourcemap: true,
-  clean: true,
-  minify: false,
-  fixedExtension: false,
-  exports: {
-    devExports: true,
-  },
-  publint: {
-    strict: true,
-  },
-  attw: {
-    profile: 'esm-only',
-    level: 'error',
-  },
-})

package/vitest.config.ts

@@ -1,11 +0,0 @@
-import { defineConfig } from 'vitest/config'
-
-export default defineConfig({
-  test: {
-    exclude: ['src/**/*.gen.ts'],
-    include: ['src/**/*.spec.ts'],
-  },
-  resolve: {
-    tsconfigPaths: true,
-  },
-})