@clayroach/unplugin 0.1.0-source-trace.2

package/dist/esm/utils/effectDetection.js

@@ -0,0 +1,59 @@
+/**
+ * Checks if a CallExpression is `Effect.gen(...)`.
+ */
+export function isEffectGenCall(node) {
+    if (node.type !== "CallExpression")
+        return false;
+    const callee = node.callee;
+    // Match Effect.gen(...)
+    if (callee.type === "MemberExpression" &&
+        callee.object.type === "Identifier" &&
+        callee.object.name === "Effect" &&
+        callee.property.type === "Identifier" &&
+        callee.property.name === "gen") {
+        return true;
+    }
+    // Match _.gen(...) where _ is an alias for Effect
+    if (callee.type === "MemberExpression" &&
+        callee.property.type === "Identifier" &&
+        callee.property.name === "gen") {
+        return true;
+    }
+    return false;
+}
+/**
+ * Checks if a node is inside an Effect.gen generator function.
+ * This walks up the AST to find if there's an enclosing generator function
+ * that is an argument to Effect.gen.
+ */
+export function isInsideEffectGen(path) {
+    let current = path.parentPath;
+    while (current) {
+        const node = current.parent;
+        if (node && isEffectGenCall(node)) {
+            return true;
+        }
+        current = current.parentPath;
+    }
+    return false;
+}
+/**
+ * Checks if a CallExpression is a call to the adapter function `_()`.
+ * The adapter is the first argument passed to the generator function.
+ */
+export function isAdapterCall(node) {
+    return node.callee.type === "Identifier" && node.callee.name === "_";
+}
+/**
+ * Checks if a YieldExpression is a `yield* _(effect)` pattern.
+ */
+export function isYieldAdapterCall(node) {
+    if (!node.delegate)
+        return false; // Must be yield*, not yield
+    if (!node.argument)
+        return false;
+    if (node.argument.type !== "CallExpression")
+        return false;
+    return isAdapterCall(node.argument);
+}
+//# sourceMappingURL=effectDetection.js.map

package/dist/esm/utils/effectDetection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectDetection.js","sourceRoot":"","sources":["../../../src/utils/effectDetection.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAA;IAEhD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;IAE1B,wBAAwB;IACxB,IACE,MAAM,CAAC,IAAI,KAAK,kBAAkB;QAClC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY;QACnC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;QACrC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,EAC9B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,kDAAkD;IAClD,IACE,MAAM,CAAC,IAAI,KAAK,kBAAkB;QAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,YAAY;QACrC,MAAM,CAAC,QAAQ,CAAC,IAAI,KAAK,KAAK,EAC9B,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAWD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,IAAI,OAAO,GAAG,IAAI,CAAC,UAAU,CAAA;IAC7B,OAAO,OAAO,EAAE,CAAC;QACf,MAAM,IAAI,GAAG,OAAO,CAAC,MAA4B,CAAA;QACjD,IAAI,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,GAAG,OAAO,CAAC,UAAU,CAAA;IAC9B,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAsB;IAClD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,GAAG,CAAA;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAuB;IACxD,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA,CAAC,4BAA4B;IAC7D,IAAI,CAAC,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAA;IAChC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAA;IACzD,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACrC,CAAC"}

package/dist/esm/utils/hoisting.js

@@ -0,0 +1,70 @@
+/**
+ * Utilities for hoisting trace metadata to module scope.
+ *
+ * @since 0.1.0
+ */
+import * as t from "@babel/types";
+/**
+ * Creates a new hoisting state.
+ */
+export function createHoistingState() {
+    return {
+        hoistedTraces: new Map(),
+        counter: 0,
+        statements: []
+    };
+}
+/**
+ * Creates a unique deduplication key for a source location.
+ * Uses line:column to disambiguate multiple yields on the same line.
+ */
+export function createDedupKey(filename, line, column) {
+    return `${filename}:${line}:${column}`;
+}
+/**
+ * Gets or creates a hoisted trace identifier for the given source location.
+ */
+export function getOrCreateTraceIdentifier(state, filename, line, column, label) {
+    const key = createDedupKey(filename, line, column);
+    let identifier = state.hoistedTraces.get(key);
+    if (identifier) {
+        return identifier;
+    }
+    // Create new identifier
+    identifier = t.identifier(`_trace${state.counter++}`);
+    state.hoistedTraces.set(key, identifier);
+    // Create the SourceLocation object literal
+    const properties = [
+        t.objectProperty(t.identifier("_tag"), t.stringLiteral("SourceLocation")),
+        t.objectProperty(t.identifier("path"), t.stringLiteral(filename)),
+        t.objectProperty(t.identifier("line"), t.numericLiteral(line)),
+        t.objectProperty(t.identifier("column"), t.numericLiteral(column))
+    ];
+    if (label) {
+        properties.push(t.objectProperty(t.identifier("label"), t.stringLiteral(label)));
+    }
+    // Wrap in Symbol.for call to add the type tag
+    const traceObject = t.objectExpression([
+        t.objectProperty(t.callExpression(t.memberExpression(t.identifier("Symbol"), t.identifier("for")), [t.stringLiteral("effect/SourceLocation")]), t.callExpression(t.memberExpression(t.identifier("Symbol"), t.identifier("for")), [t.stringLiteral("effect/SourceLocation")]), true // computed property
+        ),
+        ...properties
+    ]);
+    // Create variable declaration
+    const declaration = t.variableDeclaration("const", [
+        t.variableDeclarator(identifier, traceObject)
+    ]);
+    state.statements.push(declaration);
+    return identifier;
+}
+/**
+ * Extracts a label from a VariableDeclarator if the yield is part of an assignment.
+ * For example: `const user = yield* _(fetchUser(id))` extracts "user"
+ */
+export function extractLabelFromParent(path) {
+    const parent = path.parent;
+    if (parent?.type === "VariableDeclarator" && parent.id.type === "Identifier") {
+        return parent.id.name;
+    }
+    return undefined;
+}
+//# sourceMappingURL=hoisting.js.map

package/dist/esm/utils/hoisting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hoisting.js","sourceRoot":"","sources":["../../../src/utils/hoisting.ts"],"names":[],"mappings":"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"}

package/dist/esm/vite.js

@@ -0,0 +1,27 @@
+/**
+ * Vite plugin export for @effect/unplugin.
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import effectPlugin from "@effect/unplugin/vite"
+ *
+ * export default {
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @since 0.1.0
+ */
+import { unplugin } from "./index.js";
+/**
+ * Vite plugin for Effect transformations.
+ *
+ * @since 0.1.0
+ */
+export default unplugin.vite;
+//# sourceMappingURL=vite.js.map

package/dist/esm/vite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.js","sourceRoot":"","sources":["../../src/vite.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA4B,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/D;;;;GAIG;AACH,eAAe,QAAQ,CAAC,IAAI,CAAA"}

package/dist/esm/webpack.js

@@ -0,0 +1,27 @@
+/**
+ * Webpack plugin export for @effect/unplugin.
+ *
+ * @example
+ * ```typescript
+ * // webpack.config.js
+ * const effectPlugin = require("@effect/unplugin/webpack").default
+ *
+ * module.exports = {
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @since 0.1.0
+ */
+import { unplugin } from "./index.js";
+/**
+ * Webpack plugin for Effect transformations.
+ *
+ * @since 0.1.0
+ */
+export default unplugin.webpack;
+//# sourceMappingURL=webpack.js.map

package/dist/esm/webpack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack.js","sourceRoot":"","sources":["../../src/webpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA4B,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE/D;;;;GAIG;AACH,eAAe,QAAQ,CAAC,OAAO,CAAA"}

package/esbuild/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": [],
+  "main": "../dist/cjs/esbuild.js",
+  "module": "../dist/esm/esbuild.js",
+  "types": "../dist/dts/esbuild.d.ts"
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@clayroach/unplugin",
+  "version": "0.1.0-source-trace.2",
+  "description": "Universal bundler plugin for Effect transformations",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Effect-TS/effect.git",
+    "directory": "packages/unplugin"
+  },
+  "sideEffects": [],
+  "homepage": "https://effect.website",
+  "dependencies": {
+    "unplugin": "^2.3.2",
+    "@babel/types": "^7.26.0",
+    "@babel/parser": "^7.26.0",
+    "@babel/traverse": "^7.26.0",
+    "@babel/generator": "^7.26.0"
+  },
+  "peerDependencies": {
+    "@clayroach/effect": "^3.19.14-source-trace.2"
+  },
+  "publishConfig": {
+    "provenance": true
+  },
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/dts/index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/dts/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "default": "./dist/cjs/index.js"
+    },
+    "./vite": {
+      "types": "./dist/dts/vite.d.ts",
+      "import": "./dist/esm/vite.js",
+      "default": "./dist/cjs/vite.js"
+    },
+    "./rollup": {
+      "types": "./dist/dts/rollup.d.ts",
+      "import": "./dist/esm/rollup.js",
+      "default": "./dist/cjs/rollup.js"
+    },
+    "./webpack": {
+      "types": "./dist/dts/webpack.d.ts",
+      "import": "./dist/esm/webpack.js",
+      "default": "./dist/cjs/webpack.js"
+    },
+    "./esbuild": {
+      "types": "./dist/dts/esbuild.d.ts",
+      "import": "./dist/esm/esbuild.js",
+      "default": "./dist/cjs/esbuild.js"
+    },
+    "./rspack": {
+      "types": "./dist/dts/rspack.d.ts",
+      "import": "./dist/esm/rspack.js",
+      "default": "./dist/cjs/rspack.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "vite": [
+        "./dist/dts/vite.d.ts"
+      ],
+      "rollup": [
+        "./dist/dts/rollup.d.ts"
+      ],
+      "webpack": [
+        "./dist/dts/webpack.d.ts"
+      ],
+      "esbuild": [
+        "./dist/dts/esbuild.d.ts"
+      ],
+      "rspack": [
+        "./dist/dts/rspack.d.ts"
+      ]
+    }
+  }
+}

package/rollup/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": [],
+  "main": "../dist/cjs/rollup.js",
+  "module": "../dist/esm/rollup.js",
+  "types": "../dist/dts/rollup.d.ts"
+}

package/rspack/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": [],
+  "main": "../dist/cjs/rspack.js",
+  "module": "../dist/esm/rspack.js",
+  "types": "../dist/dts/rspack.d.ts"
+}

package/src/esbuild.ts

@@ -0,0 +1,30 @@
+/**
+ * esbuild plugin export for @effect/unplugin.
+ *
+ * @example
+ * ```typescript
+ * // build.js
+ * import * as esbuild from "esbuild"
+ * import effectPlugin from "@effect/unplugin/esbuild"
+ *
+ * await esbuild.build({
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * })
+ * ```
+ *
+ * @since 0.1.0
+ */
+import { type EffectPluginOptions, unplugin } from "./index.js"
+
+/**
+ * esbuild plugin for Effect transformations.
+ *
+ * @since 0.1.0
+ */
+export default unplugin.esbuild
+
+export type { EffectPluginOptions }

package/src/index.ts

@@ -0,0 +1,218 @@
+/**
+ * @effect/unplugin - Universal bundler plugin for Effect transformations.
+ *
+ * This plugin provides build-time transformations for Effect code:
+ * - Source trace injection for automatic log prefixing and debugging
+ * - Pure call annotations for tree-shaking optimization
+ *
+ * @example
+ * ```typescript
+ * // vite.config.ts
+ * import effectPlugin from "@effect/unplugin/vite"
+ *
+ * export default {
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @since 0.1.0
+ */
+import type { GeneratorResult } from "@babel/generator"
+import _generate from "@babel/generator"
+import { parse } from "@babel/parser"
+import type { Scope, TraverseOptions, Visitor } from "@babel/traverse"
+import _traverse from "@babel/traverse"
+import type { Node } from "@babel/types"
+import { createUnplugin, type UnpluginFactory, type UnpluginInstance } from "unplugin"
+import { createSourceTraceVisitor } from "./transformers/sourceTrace.js"
+import type { HoistingState } from "./utils/hoisting.js"
+
+// Define function types for Babel packages (they export differently in ESM vs CJS)
+type TraverseFn = <S>(
+  parent: Node,
+  opts: TraverseOptions<S>,
+  scope: Scope | undefined,
+  state: S
+) => void
+
+type GenerateFn = (
+  ast: Node,
+  opts?: { sourceMaps?: boolean; sourceFileName?: string },
+  code?: string
+) => GeneratorResult
+
+// Handle both ESM and CJS module exports for Babel packages
+const traverse: TraverseFn = typeof _traverse === "function"
+  ? _traverse as TraverseFn
+  : (_traverse as unknown as { default: TraverseFn }).default
+
+const generate: GenerateFn = typeof _generate === "function"
+  ? _generate as GenerateFn
+  : (_generate as unknown as { default: GenerateFn }).default
+
+/**
+ * Internal state used by transformers during AST traversal.
+ */
+interface TransformState {
+  filename: string
+  hoisting: HoistingState
+}
+
+/**
+ * Configuration options for the Effect plugin.
+ *
+ * @since 0.1.0
+ */
+export interface EffectPluginOptions {
+  /**
+   * Enable source trace injection into Effect.gen yields.
+   * When enabled, logs will automatically include source locations.
+   *
+   * @default true
+   */
+  readonly sourceTrace?: boolean
+
+  /**
+   * Enable @__PURE__ annotations for tree-shaking.
+   *
+   * @default false
+   */
+  readonly annotateEffects?: boolean
+
+  /**
+   * Glob patterns to include in transformation.
+   *
+   * @default ["**\/*.ts", "**\/*.tsx"]
+   */
+  readonly include?: ReadonlyArray<string>
+
+  /**
+   * Glob patterns to exclude from transformation.
+   *
+   * @default ["**\/node_modules/**", "**\/*.d.ts"]
+   */
+  readonly exclude?: ReadonlyArray<string>
+}
+
+/**
+ * Default file patterns to include.
+ */
+const DEFAULT_INCLUDE = [/\.[jt]sx?$/]
+
+/**
+ * Default file patterns to exclude.
+ */
+const DEFAULT_EXCLUDE = [/node_modules/, /\.d\.ts$/]
+
+/**
+ * Checks if a file should be transformed based on include/exclude patterns.
+ */
+function shouldTransform(
+  id: string,
+  include: ReadonlyArray<string | RegExp>,
+  exclude: ReadonlyArray<string | RegExp>
+): boolean {
+  // Check excludes first
+  for (const pattern of exclude) {
+    if (typeof pattern === "string") {
+      if (id.includes(pattern)) return false
+    } else if (pattern.test(id)) {
+      return false
+    }
+  }
+
+  // Check includes
+  for (const pattern of include) {
+    if (typeof pattern === "string") {
+      if (id.includes(pattern)) return true
+    } else if (pattern.test(id)) {
+      return true
+    }
+  }
+
+  return false
+}
+
+/**
+ * Creates the unplugin factory.
+ */
+const unpluginFactory: UnpluginFactory<EffectPluginOptions | undefined> = (options = {}) => {
+  const {
+    annotateEffects: _annotateEffects = false,
+    exclude = DEFAULT_EXCLUDE,
+    include = DEFAULT_INCLUDE,
+    sourceTrace = true
+  } = options
+
+  return {
+    name: "@effect/unplugin",
+
+    transformInclude(id) {
+      return shouldTransform(id, include as Array<string | RegExp>, exclude as Array<string | RegExp>)
+    },
+
+    transform(code, id) {
+      // Parse the source code
+      const ast = parse(code, {
+        sourceType: "module",
+        plugins: ["typescript", "jsx"]
+      })
+
+      // Collect visitors
+      const visitors: Array<Visitor<TransformState>> = []
+
+      if (sourceTrace) {
+        visitors.push(createSourceTraceVisitor(id))
+      }
+
+      // Combine visitors
+      if (visitors.length === 0) {
+        return null
+      }
+
+      // Initialize state for each visitor
+      const states = visitors.map(() => ({
+        filename: id,
+        hoisting: {
+          hoistedTraces: new Map(),
+          counter: 0,
+          statements: []
+        }
+      }))
+
+      // Run each visitor
+      for (let i = 0; i < visitors.length; i++) {
+        traverse(ast, visitors[i], undefined, states[i])
+      }
+
+      // Generate output
+      const output = generate(ast, {
+        sourceMaps: true,
+        sourceFileName: id
+      }, code)
+
+      return {
+        code: output.code,
+        map: output.map
+      }
+    }
+  }
+}
+
+/**
+ * The unplugin instance.
+ *
+ * @since 0.1.0
+ */
+export const unplugin: UnpluginInstance<EffectPluginOptions | undefined, boolean> = createUnplugin(unpluginFactory)
+
+/**
+ * Default export for convenience.
+ *
+ * @since 0.1.0
+ */
+export default unplugin

package/src/rollup.ts

@@ -0,0 +1,29 @@
+/**
+ * Rollup plugin export for @effect/unplugin.
+ *
+ * @example
+ * ```typescript
+ * // rollup.config.js
+ * import effectPlugin from "@effect/unplugin/rollup"
+ *
+ * export default {
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @since 0.1.0
+ */
+import { type EffectPluginOptions, unplugin } from "./index.js"
+
+/**
+ * Rollup plugin for Effect transformations.
+ *
+ * @since 0.1.0
+ */
+export default unplugin.rollup
+
+export type { EffectPluginOptions }

package/src/rspack.ts

@@ -0,0 +1,29 @@
+/**
+ * Rspack plugin export for @effect/unplugin.
+ *
+ * @example
+ * ```typescript
+ * // rspack.config.js
+ * const effectPlugin = require("@effect/unplugin/rspack").default
+ *
+ * module.exports = {
+ *   plugins: [
+ *     effectPlugin({
+ *       sourceTrace: true
+ *     })
+ *   ]
+ * }
+ * ```
+ *
+ * @since 0.1.0
+ */
+import { type EffectPluginOptions, unplugin } from "./index.js"
+
+/**
+ * Rspack plugin for Effect transformations.
+ *
+ * @since 0.1.0
+ */
+export default unplugin.rspack
+
+export type { EffectPluginOptions }

package/src/transformers/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Transformer registry for @effect/unplugin.
+ *
+ * @since 0.1.0
+ */
+export * from "./sourceTrace.js"