feat: add types and library config

Author: zachfedor

README.md

@@ -46,6 +46,17 @@ Create a `reset.d.ts` file:
 import "@aha-co/config/reset.d.ts"
 ```
 
+#### TS for Libraries
+
+The configuration above assumes you're using a bundler to create an application.
+If you're creating a library, you'll want the configuration to be more strict to
+be consumable in as many setups as possible. You can extend a different config
+instead:
+
+```json
+  extends: ["@aha-co/config/typescript.lib"],
+```
+
 ### ESLint
 
 Create a `eslint.config.js` file in the project root and

eslint.config.d.ts

@@ -0,0 +1,15 @@
+import { type Linter } from "eslint"
+
+/**
+ * Check if a package is installed by attempting to resolve it
+ * @param pkg - The package name to check
+ * @returns True if the package is installed, false otherwise
+ */
+export declare const has: (pkg: string) => boolean
+
+/**
+ * ESLint configuration for Aha projects
+ */
+export declare const config: Linter.Config[]
+
+export default config

index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @aha-co/config main entry point
+ *
+ * This package provides standardized configurations for Aha JS projects.
+ * The main entry point intentionally throws an error as there is no default export.
+ * Import specific configurations using the named exports instead:
+ *
+ * @example
+ * ```ts
+ * import { config as prettierConfig } from '@aha-co/config/prettier'
+ * import { config as eslintConfig } from '@aha-co/config/eslint'
+ * ```
+ */
+
+declare const _default: never
+export default _default

package-lock.json

@@ -4,16 +4,28 @@
   "version": "1.0.1",
   "description": "Standardized configs for Aha JS projects",
   "main": "index.js",
+  "types": "index.d.ts",
   "type": "module",
   "imports": {
     "#/*": "./*"
   },
   "exports": {
-    ".": "./index.js",
-    "./prettier": "./prettier.js",
-    "./typescript": "./typescript.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    },
+    "./prettier": {
+      "types": "./prettier.d.ts",
+      "import": "./prettier.js"
+    },
+    "./typescript": "./typescript.app.json",
+    "./typescript.app": "./typescript.app.json",
+    "./typescript.lib": "./typescript.lib.json",
     "./reset.d.ts": "./reset.d.ts",
-    "./eslint": "./eslint.config.js"
+    "./eslint": {
+      "types": "./eslint.config.d.ts",
+      "import": "./eslint.config.js"
+    }
   },
   "prettier": "./prettier.js",
   "scripts": {
@@ -56,6 +68,7 @@
   },
   "devDependencies": {
     "@playwright/test": "^1.54.1",
+    "@types/eslint": "^9.6.1",
     "@types/react": "^19.1.8",
     "eslint": "^9.32.0",
     "npm-run-all": "^4.1.5",

package.json

@@ -0,0 +1,8 @@
+import { type Options } from "prettier"
+
+/**
+ * Prettier configuration for Aha projects
+ */
+export declare const config: Options
+
+export default config

prettier.d.ts

@@ -1,4 +1,4 @@
-/** @type {import("prettier").Options} */
+/** @type {import("prettier").Config} */
 export const config = {
 	arrowParens: "always",
 	bracketSameLine: false,

prettier.js

@@ -1,4 +1,4 @@
 {
-	"extends": "./typescript.json",
+	"extends": "./typescript.lib.json",
 	"include": ["**/*.ts", "**/*.tsx", "**/*.js", "**/*.jsx"]
 }

tsconfig.json

@@ -10,6 +10,9 @@
 		"allowImportingTsExtensions": true,
 		"noUncheckedIndexedAccess": true,
 		"forceConsistentCasingInFileNames": true,
-		"noEmit": true
+		"noEmit": true,
+		"moduleResolution": "bundler",
+		"allowSyntheticDefaultImports": true,
+		"esModuleInterop": true
 	}
 }

typescript.json renamed to typescript.app.json

@@ -0,0 +1,13 @@
+{
+	"$schema": "https://json.schemastore.org/tsconfig",
+	"compilerOptions": {
+		"module": "node18",
+		"target": "es2020",
+		"strict": true,
+		"verbatimModuleSyntax": true,
+		"declaration": true,
+		"sourceMap": true,
+		"declarationMap": true,
+		"outDir": "dist"
+	}
+}