chore: types. (#13)

package.json

@@ -1,25 +1,32 @@
 {
   "name": "@knighted/specifier",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.2",
   "description": "Node.js tool for updating your ESM and CJS specifiers.",
   "type": "module",
   "main": "dist",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "require": "./dist/cjs/index.cjs",
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
       "default": "./dist/index.js"
     },
     "./package.json": "./package.json"
   },
+  "types": "./dist/index.d.cts",
   "engines": {
     "node": ">=12.20.0"
   },
   "scripts": {
-    "prettier": "prettier -w src/*.js test/*.js",
+    "prettier": "prettier -w src/*.{js,ts} test/*.js",
     "lint": "eslint src/*.js test/*.js",
     "test": "c8 --reporter=text --reporter=text-summary --reporter=lcov node --test --test-reporter=spec test/*.js",
-    "build": "babel-dual-package src",
+    "build": "babel-dual-package src --copy-files --no-cjs-dir",
     "prepack": "npm run build"
   },
   "keywords": [
@@ -56,6 +63,7 @@
     "magic-string": "^0.30.1"
   },
   "devDependencies": {
+    "@babel/preset-env": "^7.22.9",
     "@knighted/dump": "^1.0.2",
     "babel-dual-package": "^1.0.0",
     "c8": "^8.0.0",

src/index.d.ts

@@ -0,0 +1,60 @@
+import type { SourceMap } from 'magic-string'
+
+interface Position {
+  line: number
+  column: number
+}
+interface SourceLocation {
+  start: Position
+  end: Position
+}
+interface UpdateError {
+  error: boolean
+  msg: string
+  filename?: string
+  syntaxError?: {
+    code: string
+    reasonCode: string
+    pos: number
+    loc: Position
+  }
+}
+interface Spec {
+  type: 'StringLiteral' | 'TemplateLiteral' | 'BinaryExpression' | 'NewExpression'
+  start: number
+  end: number
+  value: string
+  loc: SourceLocation
+}
+interface Opts {
+  dts?: boolean
+  sourceMap?: boolean
+}
+interface Update {
+  code?: string
+  map?: SourceMap | null
+  error?: UpdateError
+}
+interface RegexMap {
+  [regex: string]: string
+}
+type Callback = (spec: Spec) => string
+
+interface Specifier {
+  mapper: (
+    filename: string,
+    map: { [regex: string]: string },
+  ) => Promise<string | UpdateError>
+  update: (
+    filename: string,
+    callbackOrMap: Callback | RegexMap,
+  ) => Promise<string | UpdateError>
+  updateSrc: (
+    code: string,
+    callbackOrMap: Callback | RegexMap,
+    opts?: Opts,
+  ) => Promise<Update>
+}
+
+export const specifier: Specifier
+export type { Specifier, Spec, Callback, RegexMap, Update, UpdateError, Opts }