@jay-framework/typescript-bridge 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import type * as typescript from 'typescript';
+declare const tsModule: typeof typescript;
+/**
+ * Re-export the TypeScript module to avoid ESM/CommonJS compatibility issues
+ * This allows importing TypeScript in a consistent way across the project
+ */
+export declare const ts: typeof typescript;
+/**
+ * Re-export the TypeScript types for use in type annotations
+ */
+export type { typescript as TypeScript };
+/**
+ * Create a proxy that forwards all property access to the TypeScript module
+ * This allows accessing any TypeScript utility without explicitly listing them
+ */
+export declare const tsBridge: typeof typescript;
+/**
+ * Alternative approach: Create a function that returns any TypeScript utility
+ * Usage: getTs('isIdentifier')(node)
+ */
+export declare function getTs<T extends keyof typeof tsModule>(utilName: T): (typeof tsModule)[T];
+/**
+ * Default export for easy importing and destructuring
+ * Usage: import tsBridge, { ts } from '@jay-framework/typescript-bridge'
+ */
+export default tsBridge;

package/dist/index.js

@@ -0,0 +1,29 @@
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+const tsModule = require('typescript');
+/**
+ * Re-export the TypeScript module to avoid ESM/CommonJS compatibility issues
+ * This allows importing TypeScript in a consistent way across the project
+ */
+export const ts = tsModule;
+/**
+ * Create a proxy that forwards all property access to the TypeScript module
+ * This allows accessing any TypeScript utility without explicitly listing them
+ */
+export const tsBridge = new Proxy(tsModule, {
+    get(target, prop) {
+        return target[prop];
+    },
+});
+/**
+ * Alternative approach: Create a function that returns any TypeScript utility
+ * Usage: getTs('isIdentifier')(node)
+ */
+export function getTs(utilName) {
+    return tsModule[utilName];
+}
+/**
+ * Default export for easy importing and destructuring
+ * Usage: import tsBridge, { ts } from '@jay-framework/typescript-bridge'
+ */
+export default tsBridge;

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@jay-framework/typescript-bridge",
+  "version": "0.2.0",
+  "type": "module",
+  "description": "TypeScript CommonJS to ESM bridge for seamless TypeScript utility access",
+  "license": "Apache-2.0",
+  "main": "dist/index.js",
+  "directories": {
+    "lib": "lib"
+  },
+  "files": [
+    "dist",
+    "readme.md"
+  ],
+  "scripts": {
+    "build": "npm run build:js && npm run build:types",
+    "build:watch": "npm run build:js -- --watch & npm run build:types -- --watch",
+    "build:js": "vite build",
+    "build:types": "tsup lib/index.ts --dts-only --format esm",
+    "build:check-types": "tsc",
+    "clean": "rimraf dist",
+    "confirm": "npm run clean && npm run build && npm run build:check-types",
+    "test": "echo \"No tests specified\""
+  },
+  "author": "",
+  "dependencies": {
+    "typescript": "^5.3.3"
+  },
+  "devDependencies": {
+    "@jay-framework/dev-environment": "^0.7.0",
+    "@types/node": "^20.11.5",
+    "rimraf": "^5.0.5",
+    "tsup": "^8.0.1",
+    "vite": "^5.0.11"
+  }
+}

package/readme.md

@@ -0,0 +1,77 @@
+# @jay-framework/typescript-bridge
+
+A TypeScript CommonJS to ESM bridge that provides seamless access to TypeScript utilities without ESM/CommonJS compatibility issues.
+
+## Installation
+
+```bash
+npm install @jay-framework/typescript-bridge
+```
+
+## Usage
+
+### Default Import (Recommended)
+
+```typescript
+import tsBridge from '@jay-framework/typescript-bridge';
+
+// Decompose into individual functions
+const { isIdentifier, isStatement, isBinaryExpression, visitEachChild, SyntaxKind } = tsBridge;
+
+// Use as normal
+if (isIdentifier(node)) {
+  console.log(node.text);
+}
+```
+
+### Named Imports
+
+```typescript
+import { tsBridge, ts, getTs } from '@jay-framework/typescript-bridge';
+
+// Use the proxy directly
+tsBridge.isIdentifier(node);
+
+// Access the full TypeScript module
+ts.visitEachChild(node, visitor, context);
+
+// Get utilities dynamically
+const isIdentifier = getTs('isIdentifier');
+isIdentifier(node);
+```
+
+### Type Imports
+
+```typescript
+import type { TypeScript as ts } from '@jay-framework/typescript-bridge';
+
+function processNode(node: ts.Node): void {
+  // Type-safe TypeScript usage
+}
+```
+
+## Benefits
+
+- **No ESM/CommonJS issues**: Handles the compatibility problems automatically
+- **Type-safe**: Full TypeScript intellisense and type checking
+- **Flexible**: Multiple import patterns to suit your needs
+- **Lightweight**: Minimal overhead, direct access to TypeScript utilities
+- **Maintainable**: No need to list all utilities explicitly
+
+## API
+
+### `tsBridge` (default export)
+
+A proxy object that provides access to all TypeScript utilities.
+
+### `ts`
+
+The full TypeScript module for direct access.
+
+### `getTs(utilName)`
+
+A function that returns any TypeScript utility by name.
+
+### `TypeScript` (type)
+
+TypeScript types for type annotations.