@soda-gql/tsc-transformer 0.1.0

package/README.md

@@ -0,0 +1,68 @@
+# @soda-gql/tsc-transformer
+
+Core TypeScript transformation logic for soda-gql. This package extracts the AST transformation functionality used by `@soda-gql/tsc-plugin` and provides conformance tests for other plugin implementations.
+
+## Status
+
+**Internal package** - This package is used internally by soda-gql plugins and is not intended for direct use by end users.
+
+## Purpose
+
+This package provides:
+
+1. **Shared transformation logic** - The core AST transformation that converts `gql.default()` calls to runtime registrations
+2. **Conformance test cases** - Test fixtures and utilities for verifying plugin implementations match expected behavior
+3. **TypeScript AST utilities** - Helpers for import management and code generation
+
+## Used By
+
+- `@soda-gql/tsc-plugin` - TypeScript compiler plugin
+- `@soda-gql/babel-plugin` - Babel transformation plugin (for test conformance)
+
+## API
+
+### createTransformer
+
+Creates a TypeScript transformer that processes soda-gql files.
+
+```typescript
+import { createTransformer } from "@soda-gql/tsc-transformer";
+import type { BuilderArtifact } from "@soda-gql/builder";
+import type { ResolvedSodaGqlConfig } from "@soda-gql/config";
+import * as ts from "typescript";
+
+const transformer = createTransformer({
+  compilerOptions: ts.getDefaultCompilerOptions(),
+  config: resolvedConfig,
+  artifact: builderArtifact,
+});
+
+// Use in a TypeScript transformer factory
+const result = transformer.transform({
+  sourceFile,
+  context: transformationContext,
+});
+```
+
+### createAfterStubTransformer
+
+Creates a post-transformation step that cleans up stub imports.
+
+```typescript
+import { createAfterStubTransformer } from "@soda-gql/tsc-transformer";
+```
+
+### TypeScriptEnv
+
+Type definition for the TypeScript-specific environment.
+
+```typescript
+type TypeScriptEnv = {
+  readonly sourceFile: ts.SourceFile;
+  readonly context: ts.TransformationContext;
+};
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@soda-gql/tsc-transformer",
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "author": {
+    "name": "Shota Hatada",
+    "email": "shota.hatada@whatasoda.me",
+    "url": "https://github.com/whatasoda"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "@soda-gql": "./src/index.ts",
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.mjs"
+    },
+    "./test": {
+      "@soda-gql": "./test/export.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@soda-gql/builder": "0.1.0",
+    "@soda-gql/common": "0.1.0",
+    "@soda-gql/config": "0.1.0",
+    "@soda-gql/core": "0.1.0",
+    "@soda-gql/plugin-common": "0.1.0",
+    "neverthrow": "^8.1.1"
+  },
+  "devDependencies": {
+    "@soda-gql/codegen": "0.1.0",
+    "prettier": "^3.4.2"
+  },
+  "peerDependencies": {
+    "typescript": "5.*"
+  }
+}