Move module docs to .d.ts

index.d.ts

@@ -1,3 +1,15 @@
+/**
+ * A tiny, secure, URL-friendly, unique string ID generator for JavaScript
+ * with hardware random generator.
+ *
+ * ```js
+ * import { nanoid } from 'nanoid'
+ * model.id = nanoid() //=> "V1StGXR8_Z5jdHi6B-myT"
+ * ```
+ *
+ * @module
+ */
+
 /**
  * Generate secure URL-friendly unique ID.
  *

index.js

@@ -1,15 +1,3 @@
-/**
- * A tiny, secure, URL-friendly, unique string ID generator for JavaScript
- * with hardware random generator.
- *
- * ```js
- * import { nanoid } from 'nanoid'
- * model.id = nanoid() //=> "V1StGXR8_Z5jdHi6B-myT"
- * ```
- *
- * @module
- */
-
 import { webcrypto as crypto } from 'node:crypto'
 
 import { urlAlphabet as scopedUrlAlphabet } from './url-alphabet/index.js'

non-secure/index.d.ts

@@ -1,3 +1,16 @@
+/**
+ * By default, Nano ID uses hardware random bytes generation for security
+ * and low collision probability. If you are not so concerned with security,
+ * you can use it for environments without hardware random generators.
+ *
+ * ```js
+ * import { nanoid } from 'nanoid/non-secure'
+ * const id = nanoid() //=> "Uakgb_J5m9g-0JDMbcJqLJ"
+ * ```
+ *
+ * @module
+ */
+
 /**
  * Generate URL-friendly unique ID. This method uses the non-secure
  * predictable random generator with bigger collision probability.

non-secure/index.js

@@ -1,18 +1,5 @@
 /* @ts-self-types="./index.d.ts" */
 
-/**
- * By default, Nano ID uses hardware random bytes generation for security
- * and low collision probability. If you are not so concerned with security,
- * you can use it for environments without hardware random generators.
- *
- * ```js
- * import { nanoid } from 'nanoid/non-secure'
- * const id = nanoid() //=> "Uakgb_J5m9g-0JDMbcJqLJ"
- * ```
- *
- * @module
- */
-
 // This alphabet uses `A-Za-z0-9_-` symbols.
 // The order of characters is optimized for better gzip and brotli compression.
 // References to the same file (works both for gzip and brotli):