@mohou/values 1.0.20

package/README.md

@@ -0,0 +1,8 @@
+---
+status: locked
+updated: 2026-09-16
+---
+
+Role: `values`.
+
+`assertNever` marks an unreachable closed-union branch.

package/lib/types/assert-never.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Mark an unreachable closed-union branch.
+ * @param value - impossible value; an unhandled typed variant fails at the call site.
+ * @param context - optional switch-site label included in the failure message.
+ * @returns never; a runtime value that escaped its type always throws.
+ */
+export declare function assertNever(value: never, context?: string): never;
+//# sourceMappingURL=assert-never.d.ts.map

package/lib/types/assert-never.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert-never.d.ts","sourceRoot":"","sources":["../../src/assert-never.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAIjE"}

package/lib/types/brand.d.ts

@@ -0,0 +1,7 @@
+declare const brand: unique symbol;
+/** A string admitted at one boundary and not re-parsed by the callee. */
+export type Branded<B extends string> = string & {
+    readonly [brand]: B;
+};
+export {};
+//# sourceMappingURL=brand.d.ts.map

package/lib/types/brand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand.d.ts","sourceRoot":"","sources":["../../src/brand.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,EAAE,OAAO,MAAM,CAAA;AAElC,yEAAyE;AACzE,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA"}

package/lib/types/index.d.ts

@@ -0,0 +1,5 @@
+/** Closed-union helpers. @module @mohou/values */
+export declare const packageId: "@mohou/values";
+export { assertNever } from './assert-never.ts';
+export type { Branded } from './brand.ts';
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,eAAO,MAAM,SAAS,EAAG,eAAwB,CAAA;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@mohou/values",
+  "version": "1.0.20",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "lib/types",
+    "README.md",
+    "!**/*.tsbuildinfo"
+  ],
+  "main": "./src/index.ts",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  }
+}

package/src/assert-never.ts

@@ -0,0 +1,11 @@
+/**
+ * Mark an unreachable closed-union branch.
+ * @param value - impossible value; an unhandled typed variant fails at the call site.
+ * @param context - optional switch-site label included in the failure message.
+ * @returns never; a runtime value that escaped its type always throws.
+ */
+export function assertNever(value: never, context?: string): never {
+  const rendered = JSON.stringify(value)
+  const label = context === undefined ? '' : ` in ${context}`
+  throw new Error(`unreachable variant${label}: ${rendered}`)
+}

package/src/brand.ts

@@ -0,0 +1,4 @@
+declare const brand: unique symbol
+
+/** A string admitted at one boundary and not re-parsed by the callee. */
+export type Branded<B extends string> = string & { readonly [brand]: B }

package/src/index.ts

@@ -0,0 +1,6 @@
+/** Closed-union helpers. @module @mohou/values */
+
+export const packageId = '@mohou/values' as const
+
+export { assertNever } from './assert-never.ts'
+export type { Branded } from './brand.ts'