@mrgrain/cdk-esbuild 4.0.0-alpha.8 → 4.0.0-beta.1

package/.jsii

@@ -8,7 +8,7 @@
     "url": "https://moritzkornher.de"
   },
   "dependencies": {
-    "aws-cdk-lib": "^2.0.0",
+    "aws-cdk-lib": "^2.12.0",
     "constructs": "^10.0.5"
   },
   "dependencyClosure": {
@@ -105,6 +105,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_amplifyuibuilder": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.AmplifyUIBuilder"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.amplifyuibuilder"
+            },
+            "python": {
+              "module": "aws_cdk.aws_amplifyuibuilder"
+            }
+          }
+        },
         "aws-cdk-lib.aws_apigateway": {
           "targets": {
             "dotnet": {
@@ -1120,6 +1133,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_evidently": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.Evidently"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.evidently"
+            },
+            "python": {
+              "module": "aws_cdk.aws_evidently"
+            }
+          }
+        },
         "aws-cdk-lib.aws_finspace": {
           "targets": {
             "dotnet": {
@@ -1159,6 +1185,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_forecast": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.Forecast"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.forecast"
+            },
+            "python": {
+              "module": "aws_cdk.aws_forecast"
+            }
+          }
+        },
         "aws-cdk-lib.aws_frauddetector": {
           "targets": {
             "dotnet": {
@@ -1341,6 +1380,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_inspectorv2": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.InspectorV2"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.inspectorv2"
+            },
+            "python": {
+              "module": "aws_cdk.aws_inspectorv2"
+            }
+          }
+        },
         "aws-cdk-lib.aws_iot": {
           "targets": {
             "dotnet": {
@@ -1471,6 +1523,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_kafkaconnect": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.KafkaConnect"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.kafkaconnect"
+            },
+            "python": {
+              "module": "aws_cdk.aws_kafkaconnect"
+            }
+          }
+        },
         "aws-cdk-lib.aws_kendra": {
           "targets": {
             "dotnet": {
@@ -1510,6 +1575,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_kinesisanalyticsv2": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.KinesisAnalyticsV2"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.kinesisanalyticsv2"
+            },
+            "python": {
+              "module": "aws_cdk.aws_kinesisanalyticsv2"
+            }
+          }
+        },
         "aws-cdk-lib.aws_kinesisfirehose": {
           "targets": {
             "dotnet": {
@@ -1523,6 +1601,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_kinesisvideo": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.KinesisVideo"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.kinesisvideo"
+            },
+            "python": {
+              "module": "aws_cdk.aws_kinesisvideo"
+            }
+          }
+        },
         "aws-cdk-lib.aws_kms": {
           "targets": {
             "dotnet": {
@@ -1601,6 +1692,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_lex": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.Lex"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.lex"
+            },
+            "python": {
+              "module": "aws_cdk.aws_lex"
+            }
+          }
+        },
         "aws-cdk-lib.aws_licensemanager": {
           "targets": {
             "dotnet": {
@@ -2030,6 +2134,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_refactorspaces": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.RefactorSpaces"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.refactorspaces"
+            },
+            "python": {
+              "module": "aws_cdk.aws_refactorspaces"
+            }
+          }
+        },
         "aws-cdk-lib.aws_rekognition": {
           "targets": {
             "dotnet": {
@@ -2043,6 +2160,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_resiliencehub": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.ResilienceHub"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.resiliencehub"
+            },
+            "python": {
+              "module": "aws_cdk.aws_resiliencehub"
+            }
+          }
+        },
         "aws-cdk-lib.aws_resourcegroups": {
           "targets": {
             "dotnet": {
@@ -2147,6 +2277,19 @@
             }
           }
         },
+        "aws-cdk-lib.aws_rum": {
+          "targets": {
+            "dotnet": {
+              "namespace": "Amazon.CDK.AWS.RUM"
+            },
+            "java": {
+              "package": "software.amazon.awscdk.services.rum"
+            },
+            "python": {
+              "module": "aws_cdk.aws_rum"
+            }
+          }
+        },
         "aws-cdk-lib.aws_s3": {
           "targets": {
             "dotnet": {
@@ -2777,7 +2920,7 @@
     "stability": "stable"
   },
   "homepage": "https://github.com/mrgrain/cdk-esbuild",
-  "jsiiVersion": "1.61.0 (build abf4039)",
+  "jsiiVersion": "1.73.0 (build 6faeda3)",
   "keywords": [
     "aws-cdk",
     "bundler",
@@ -2800,7 +2943,7 @@
   },
   "name": "@mrgrain/cdk-esbuild",
   "readme": {
-    "markdown": "# cdk-esbuild\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started)\n[Documentation](#documentation) | [API Reference](#api-reference) | [Versioning](#versioning) | [Upgrading from AWS CDK v1](#upgrading-from-aws-cdk-v1)\n\n[![View on Construct Hub](https://constructs.dev/badge?package=%40mrgrain%2Fcdk-esbuild)](https://constructs.dev/packages/@mrgrain/cdk-esbuild)\n\n## Why?\n\n_esbuild_ is an extremely fast bundler and minifier for Typescript and JavaScript.\nThis package makes _esbuild_ available to deploy lambda functions, static websites or to publish build artefacts (assets) for further use.\n\nAWS CDK [supports _esbuild_ with Lambda Functions](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-lambda-nodejs-readme.html). However the implementation cannot be used with any other Constructs and doesn't expose all of _esbuild_'s build interface.\n\nThis package is running _esbuild_ directly in Node.js and bypasses Docker which the AWS CDK implementation uses. The approach is quicker and easier to use for Node.js users, but incompatible with other languages.\n\n**Production readiness**\n\nThis package is stable and ready to be used in production, as many do. However _esbuild_ has not yet released a version 1.0.0 and its API is still in active development. Please read the guide on [esbuild's production readiness](https://esbuild.github.io/faq/#production-readiness).\n\nNotably upgrades of the _esbuild_ minimum version requirement will be introduced in **minor versions** of this package and will inherit breaking changes from _esbuild_.\n\n## Getting started\n\nInstall `cdk-esbuild`:\n\n```\nnpm install @mrgrain/cdk-esbuild@3\n```\n\nIf _peer_ or _optional dependencies_ are not installed automatically (e.g. when using npm v4-6), please use this command to install all of them:\n\n```\nnpm install @mrgrain/cdk-esbuild@3 esbuild\n```\n\n### AWS Lambda: Serverless function\n\n> 💡 See [Lambda Function](examples/lambda) for a complete working example of a how to deploy a lambda function.\n\nUse `TypeScriptCode` as the `code` of a [lambda function](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#code):\n\n```ts\nimport * as lambda from \"aws-cdk-lib/aws-lambda\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\");\n\nconst fn = new lambda.Function(stack, \"MyFunction\", {\n  runtime: lambda.Runtime.NODEJS_16_X,\n  handler: \"index.handler\",\n  code: bundledCode,\n});\n```\n\n### AWS S3: Static Website\n\n> 💡 See [Static Website with React](examples/website) for a complete working example of a how to deploy a React app to S3.\n\nUse `TypeScriptSource` as one of the `sources` of a [static website deployment](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html#roadmap):\n\n```ts\nimport * as s3 from \"aws-cdk-lib/aws-s3\";\nimport * as s3deploy from \"aws-cdk-lib/aws-s3-deployment\";\nimport { TypeScriptSource } from \"@mrgrain/cdk-esbuild\";\n\nconst websiteBundle = new TypeScriptSource(\"src/index.tsx\");\n\nconst websiteBucket = new s3.Bucket(stack, \"WebsiteBucket\", {\n  autoDeleteObjects: true,\n  publicReadAccess: true,\n  removalPolicy: RemovalPolicy.DESTROY,\n  websiteIndexDocument: \"index.html\",\n});\n\nnew s3deploy.BucketDeployment(stack, \"DeployWebsite\", {\n  destinationBucket: websiteBucket,\n  sources: [websiteBundle],\n});\n```\n\n### Amazon CloudWatch Synthetics: Canary monitoring\n\n> 💡 See [Monitored Website](examples/website) for a complete working example of a deployed and monitored website.\n\nSynthetics runs a canary to produce traffic to an application for monitoring purposes. Use `TypeScriptCode` as the `code` of a Canary test:\n\n> ℹ️ This feature depends on the `@aws-cdk/aws-synthetics-alpha` package which is a developer preview. You may need to update your source code when upgrading to a newer version of this package.\n>\n> ```\n> npm i @aws-cdk/aws-synthetics-alpha\n> ```\n\n```ts\nimport * as synthetics from \"@aws-cdk/aws-synthetics-alpha\";\nimport { TypeScriptCode } from \"@mrgrain/cdk-esbuild\";\n\nconst bundledCode = new TypeScriptCode(\"src/index.ts\", {\n  buildOptions: {\n    outdir: \"nodejs/node_modules\", // This is required by Synthetics\n  },\n});\n\nconst canary = new synthetics.Canary(stack, \"MyCanary\", {\n  runtime: synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_3_2,\n  test: synthetics.Test.custom({\n    code: bundledCode,\n    handler: \"index.handler\",\n  });\n});\n```\n\n## Documentation\n\nThe package exports various different constructs for use with existing CDK features. A major guiding design principal for this package is to _extend, don't replace_. Expect constructs that you can provide as props, not complete replacements.\n\nFor use in **Lambda Functions** and **Synthetic Canaries**, the following classes implement `lambda.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-synthetics-alpha.Code.html)):\n\n- `TypeScriptCode` & `JavaScriptCode`\n\nInline code is only supported by **Lambda**:\n\n- `InlineTypeScriptCode` & `InlineJavaScriptCode`\n- `InlineTsxCode` & `InlineJsxCode`\n\nFor use with **S3 bucket deployments**, classes implementing `s3deploy.ISource` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html)):\n\n- `TypeScriptSource` & `JavaScriptSource`\n\n> _Code and Source constructs seamlessly plug-in to other high-level CDK constructs. They share the same set of parameters, props and build options._\n\nThe following classes power the other features. You normally won't have to use them, but they are there if you need them:\n\n- `TypeScriptAsset` & `JavaScriptAsset` implements `s3.Asset` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3_assets.Asset.html)) \\\n  creates an asset uploaded to S3 which can be referenced by other constructs\n\n- `EsbuildBundler` implements `core.BundlingOptions` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.BundlingOptions.html)) \\\n  provides an interface for a _esbuild_ bundler wherever needed\n\n### [API Reference](API.md)\n\nAuto-generated reference for classes and structs. This information is also available as part of your IDE's code completion.\n\n### Escape hatches\n\nIt's possible that you want to use an implementation of esbuild that's different to the default one. Common reasons are:\n\n- The current version constraints for esbuild are not suitable\n- To use a version of esbuild that is installed by any other means than `npm`, including Docker\n- Plugin support is needed for building\n\nFor these situations, this package offers an escape hatch to bypass regular the implementation and provide a custom build and transform function.\n\n#### Esbuild binary path\n\nIt is possible to override the binary used by esbuild. The usual way to do this is to set the `ESBUILD_BINARY_PATH` environment variable. For convenience this package allows to set the binary path as a prop:\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  esbuildBinaryPath: \"path/to/esbuild/binary\"\n});\n```\n\n#### Custom build function\n\n> 💡 See [Using esbuild with plugins](examples/esbuild-with-plugins) for a complete working example of a custom build function using this escape hatch.\n\nConstructs that result in starting a build, take a `buildFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `buildSync` function.\n\n```ts\nnew TypeScriptCode(\"fixtures/handlers/ts-handler.ts\", {\n  buildFn: (options: BuildOptions): BuildResult => {\n    try {\n      // custom implementation returning BuildResult\n    } catch (error) {\n      // throw BuildFailure exception here\n    }\n  },\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated build options. The custom build function can amend, change or discard any of these. However integration with CDK relies heavily on the values `outdir`/`outfile` are set to and it's usually required to use them unchanged.\n\nFailures have to cause a `BuildFailure` exception in order to be fully handled.\n\n#### Custom transform function\n\nConstructs that result in starting a transformation, take a `transformFn` as optional prop. While the defined type for this function is `any`, it must implement the same signature as esbuild's `transformSync` function.\n\n```ts\nnew InlineTypeScriptCode(\"let x: number = 1\", {\n  transformFn: (options: TransformOptions): TransformResult => {\n    try {\n      // custom implementation returning TransformResult\n    } catch (error) {\n      // throw TransformFailure exception here\n    }\n  },,\n});\n```\n\nInstead of esbuild, the provided function will be invoked with the calculated transform options. The custom transform function can amend, change or discard any of these.\n\nFailures have to cause a `TransformFailure` exception in order to be fully handled.\n\n### Upgrading from AWS CDK v1\n\nThis version is compatible with AWS CDK v2. For the previous, AWS CDK v1 compatible release, see [cdk-esbuild@v2](https://github.com/mrgrain/cdk-esbuild/tree/v2).\n\nTo upgrade from AWS CDK v1 and cdk-esbuild@v2, please follow these steps:\n\n- This version requires AWS CDK v2. Follow the [official migration guide](https://docs.aws.amazon.com/cdk/latest/guide/work-with-cdk-v2.html) to upgrade.\n- Update the package dependency to v3: `npm install --save @mrgrain/cdk-esbuild@^3.0.0`\n- `esbuild` is installed as an optional dependency. If your setup does not automatically install optional dependencies, make sure to add it as an explicit dependency.\n- Any use of `InlineCode` variations has to be updated. Previously the second parameter was either of type `TransformerProps` or `TransformOptions`. Now it must be `TransformerProps`.\\\n  If the passed value is of type `TransformOptions`, turn it into the correct type like this:\n\n  ```ts\n  const oldOptions: TransformOptions = {...}\n\n  new InlineTypeScriptCode('// inline code', {\n    transformOptions: oldOptions\n  });\n  ```\n\n## Versioning\n\nThis package follows [Semantic Versioning](https://semver.org/), with the exception of upgrades to `esbuild`. These will be released as **minor versions** and often include breaking changes from `esbuild`.\n\n### Npm Tags\n\nSome users prefer to use tags over version ranges. The following stable tags are available for use:\n\n- `cdk-v1`, `cdk-v2` are provided for the latest release compatible with each version of the AWS CDK.\n\n- `latest` is the most recent stable release.\n\nThese tags also exist, but usage is strongly not recommended:\n\n- `unstable`, `next` are used for pre-release of the current and next major version respectively.\n\n- ~~`cdk-1.x.x`~~ tags have been deprecated in favour of `cdk-v1`. Use that one instead.\n\n## Roadmap & Contributions\n\n[The project's roadmap is available on GitHub.](https://github.com/mrgrain/cdk-esbuild/projects/1) Please submit any feature requests as issues to the repository.\n\nAll contributions are welcome, no matter if they are for already planned or completely new features.\n\n## Library authors\n\nBuilding a library consumed by other packages that relies on `cdk-esbuild` might require you to set `buildOptions.absWorkingDir`. The easiest way to do this, is to resolve based on the directory name of the calling file, and traverse the tree upwards to the root of your library package (that's where `package.json` and `tsconfig.json` are):\n\n```ts\n// file: project/src/index.ts\nconst props = {\n  buildOptions: {\n    absWorkingDir: path.resolve(__dirname, \"..\"), // now: /user/project\n  },\n};\n```\n\nThis will dynamically resolve to the correct path, wherever the package is installed.\n\nPlease open an issue if you encounter any difficulties.\n"
+    "markdown": "<img src=\"https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/wordmark-light.svg\" alt=\"cdk-esbuild\">\n\n_CDK constructs for [esbuild](https://github.com/evanw/esbuild), an extremely fast JavaScript bundler_\n\n[Getting started](#getting-started) |\n[Documentation](#documentation) | [API Reference](#api-reference) | [Python & .NET](#python-and-net) | [FAQ](#faq)\n\n[![View on Construct Hub](https://constructs.dev/badge?package=%40mrgrain%2Fcdk-esbuild)](https://constructs.dev/packages/@mrgrain/cdk-esbuild)\n\n## Why?\n\n_esbuild_ is an extremely fast bundler and minifier for TypeScript and JavaScript.\nThis package makes _esbuild_ available to deploy AWS Lambda Functions, static websites or publish assets for further usage.\n\nAWS CDK [supports _esbuild_ for AWS Lambda Functions](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-lambda-nodejs-readme.html), but the implementation cannot be used with other Constructs and doesn't expose all of _esbuild_'s API.\n\n## Getting started\n\nInstall `cdk-esbuild` for Node.js using your favorite package manager:\n\n```sh\n# npm\nnpm install @mrgrain/cdk-esbuild@4\n# Yarn\nyarn add @mrgrain/cdk-esbuild@4\n# pnpm\npnpm add @mrgrain/cdk-esbuild@4\n```\n\nFor Python and .NET, use these commands:\n\n```sh\n# Python\npip install mrgrain.cdk-esbuild\n\n# .NET\ndotnet add package Mrgrain.CdkEsbuild\n```\n\n### AWS Lambda: Serverless function\n\n> 💡 See [Lambda (TypeScript)](examples/typescript/lambda) and [Lambda (Python)](examples/typescript/lambda) for complete working examples of a how to deploy an AWS Lambda Function.\n\nUse `TypeScriptCode` as the `code` of a [lambda function](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Function.html#code):\n\n```ts\nconst bundledCode = new TypeScriptCode(\"src/handler.ts\");\n\nconst fn = new lambda.Function(stack, \"MyFunction\", {\n  runtime: lambda.Runtime.NODEJS_18_X,\n  handler: \"index.handler\",\n  code: bundledCode,\n});\n```\n\n### AWS S3: Static Website\n\n> 💡 See [React App (TypeScript)](examples/typescript/website) for a complete working example of a how to deploy a React app to S3.\n\nUse `TypeScriptSource` as one of the `sources` of a [static website deployment](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html#roadmap):\n\n```ts\nconst websiteBundle = new TypeScriptSource(\"src/index.tsx\");\n\nconst websiteBucket = new s3.Bucket(stack, \"WebsiteBucket\", {\n  autoDeleteObjects: true,\n  publicReadAccess: true,\n  removalPolicy: cdk.RemovalPolicy.DESTROY,\n  websiteIndexDocument: \"index.html\",\n});\n\nnew s3deploy.BucketDeployment(stack, \"DeployWebsite\", {\n  destinationBucket: websiteBucket,\n  sources: [websiteBundle],\n});\n```\n\n### Amazon CloudWatch Synthetics: Canary monitoring\n\n> 💡 See [Monitored Website (TypeScript)](examples/typescript/website) for a complete working example of a deployed and monitored website.\n\nSynthetics runs a canary to produce traffic to an application for monitoring purposes. Use `TypeScriptCode` as the `code` of a Canary test:\n\n> ℹ️ This feature depends on `@aws-cdk/aws-synthetics-alpha` which is in developer preview.\n> Please install the package using the respective tool of your language.\n> You may need to update your source code when upgrading to a newer version of this alpha package.\n\n```ts\nconst bundledCode = new TypeScriptCode(\"src/canary.ts\", {\n  buildOptions: {\n    outdir: \"nodejs/node_modules\", // This is required by AWS Synthetics\n  },\n});\n\nconst canary = new synthetics.Canary(stack, \"MyCanary\", {\n  runtime: synthetics.Runtime.SYNTHETICS_NODEJS_PUPPETEER_3_2,\n  test: synthetics.Test.custom({\n    code: bundledCode,\n    handler: \"index.handler\",\n  }),\n});\n```\n\n## Documentation\n\nThe package exports various different constructs for use with AWS CDK features. The guiding design principal for this package is _\"extend, don't replace\"_. Expect constructs that you can provide as props, not complete replacements.\n\nFor use in **Lambda Functions** and **Synthetic Canaries**, the following classes implement `lambda.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_lambda.Code.html)) and `synthetics.Code` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/@aws-cdk_aws-synthetics-alpha.Code.html)):\n\n- `TypeScriptCode` & `JavaScriptCode`\n\nInline code is only supported by **Lambda**:\n\n- `InlineTypeScriptCode` & `InlineJavaScriptCode`\n\nFor use with **S3 bucket deployments**, classes implementing `s3deploy.ISource` ([reference](https://docs.aws.amazon.com/cdk/api/latest/docs/aws-s3-deployment-readme.html)):\n\n- `TypeScriptSource` & `JavaScriptSource`\n\n> _Code and Source constructs seamlessly plug-in to other high-level CDK constructs. They share the same set of parameters, props and build options._\n\nThe following classes power the other features. You normally won't have to use them, but they are there if you need them:\n\n- `TypeScriptAsset` & `JavaScriptAsset` implements `s3.Asset` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.aws_s3_assets.Asset.html)) \\\n  creates an asset uploaded to S3 which can be referenced by other constructs\n\n- `EsbuildBundler` implements `core.BundlingOptions` ([reference](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.BundlingOptions.html)) \\\n  provides an interface for a _esbuild_ bundler wherever needed\n\n- `EsbuildProvider` implements `IBuildProvider` and `ITransformProvider` \\\n  provides the default _esbuild_ API implementation and can be replaced with a custom implementation\n\n### [API Reference](API.md)\n\nAuto-generated reference for Constructs, Classes and Structs.\nThis information is also available as part of your IDE's code completion.\n\n### Python and .NET\n\n_Esbuild_ requires a platform and architecture specific binary and currently has to be installed with a Node.js package manager like npm.\n\nWhen using `cdk-esbuild` with Python or .NET, the package will automatically detect a local or global installation of the _esbuild_ npm package.If none can be found, it will fall back to dynamically installing a copy into a temporary location.\nThe exact algorithm of this mechanism must be treated as an implementation detail and should not be relied on.\nIt can however be configured to a certain extent.\nSee the examples below for more details.\n\nThis \"best effort\" approach makes it easy to get started.\nBut is not always desirable, for example in environments with limited network access or when guaranteed repeatability of builds is a concern.\nYou have several options to opt-out of this behavior.\n\n#### Provide a controlled installation of _esbuild_\n\nThe first step is to install a version of _esbuild_ that is controlled by you.\n\nI **strongly recommend** to install _esbuild_ as a local package.\nThe easiest approach is to manage an additional Node.js project at the root of your AWS CDK project.\n_esbuild_ can then be added to the `package.json` file and it is your responsibility to ensure required setup steps are taken in all environments like development machines and CI/CD systems.\n\nInstead of installing the _esbuild_ package in a local project, it can also be **installed globally** with `npm install -g esbuild` or a similar command.\nThis approach might be preferred if a build container is prepared ahead of time, thus avoiding repeated package installation.\n\n#### Change the automatic package detection\n\nThe second step is to make `cdk-esbuild` aware of your chosen install location.\nThis step is optional, but it's a good idea to have the location or at least the method explicitly defined.\n\nTo do this, you can set the `esbuildModulePath` prop on a `EsbuildProvider`.\nEither pass a known, absolute or relative path as value, or use the `EsbuildSource` helper to set the detection method.\nPlease refer to the [`EsbuildSource`](API.md#esbuildsource) reference for a complete list of available methods.\n\n```ts\n// Use the standard Node.js algorithm to detect a locally installed package\nnew EsbuildProvider({\n  esbuildModulePath: EsbuildSource.nodeJs(),\n});\n\n// Provide an explicit path\nnew EsbuildProvider({\n  esbuildModulePath: '/home/user/node_modules/esbuild/lib/main.js',\n});\n```\n\nAs a no-code approach, the `CDK_ESBUILD_MODULE_PATH` environment variable can be set in the same way.\nAn advantage of this is that the path can easily be changed for different systems.\nSetting the env variable can be used with any installation approach, but is typically paired with a global installation of the _esbuild_ package.\nNote that `esbuildModulePath` takes precedence.\n\n#### Override the default detection method\n\nFor an AWS CDK app with many instances of `TypeScriptCode` etc. it would be annoying to change the above for every single one of them.\nLuckily, the default can be changed for all usages per app:\n\n```ts\nconst customModule = new EsbuildProvider({\n  esbuildModulePath: EsbuildSource.globalPaths(),\n});\nEsbuildProvider.overrideDefaultProvider(customModule);\n```\n\n### Customizing the Esbuild API\n\nThis package uses the _esbuild_ JavaScript API.\nIn most situations the default API configuration will be suitable.\nBut sometimes it is required to configure _esbuild_ differently or even provide a custom implementation.\nCommon reasons for this are:\n\n- Using a pre-installed version of _esbuild_ with Python or .NET\n- If features not supported by the synchronous API are required, e.g. support for plugins\n- If the default version constraints for _esbuild_ are not suitable\n- To use a version of esbuild that is installed by any other means than `npm`, including Docker\n\nFor these scenarios, this package offers customization options and an interface to provide a custom implementation:\n\n```ts\ndeclare const myCustomBuildProvider: IBuildProvider;\n\nnew TypeScriptCode(\"src/handler.ts\", {\n  buildProvider: myCustomBuildProvider,\n});\n\n\ndeclare const myCustomTransformProvider: ITransformProvider;\n\nnew InlineTypeScriptCode(\"let x: number = 1\", {\n  transformProvider: myCustomTransformProvider,\n});\n```\n\n#### Esbuild binary path\n\nIt is possible to override the binary used by _esbuild_ by setting a property on `EsbuildProvider`.\nThis is the same as setting the `ESBUILD_BINARY_PATH` environment variable.\nDefining the `esbuildBinaryPath` prop takes precedence.\n\n```ts\nconst buildProvider = new EsbuildProvider({\n  esbuildBinaryPath: \"path/to/esbuild/binary\",\n});\n\n// This will use a different esbuild binary\nnew TypeScriptCode(\"src/handler.ts\", { buildProvider });\n```\n\n#### Esbuild module path\n\nThe Node.js module discovery algorithm will normally be used to find the _esbuild_ package.\nIt can be useful to use specify a different module path, for example if a globally installed package should be used instead of a local version.\n\n```ts\nconst buildProvider = new EsbuildProvider({\n  esbuildModulePath: \"/home/user/node_modules/esbuild/lib/main.js\",\n});\n\n// This will use a different esbuild module\nnew TypeScriptCode(\"src/handler.ts\", { buildProvider });\n```\n\nAlternatively supported by setting the `CDK_ESBUILD_MODULE_PATH` environment variable, which will apply to all uses.\nDefining the `esbuildModulePath` prop takes precedence.\n\nIf you are a Python or .NET users, see the language specific guide for a more detailed expose on this feature.\n\n#### Custom Build and Transform API implementations\n\n> 💡 See [esbuild plugins w/ TypeScript](examples/typescript/esbuild-with-plugins) for a complete working example of a custom Build API implementation.\n\nA custom implementation can be provided by implementing `IBuildProvider` or `ITransformProvider`:\n\n```ts\nclass CustomEsbuild implements IBuildProvider, ITransformProvider {\n    buildSync(options: BuildOptions): void {\n      // custom implementation goes here\n    }\n\n    transformSync(code: string, options?: TransformOptions): string {\n      // custom implementation goes here, return transformed code\n      return 'transformed code';\n    }\n}\n\n// These will use the custom implementation\nnew TypeScriptCode(\"src/handler.ts\", {\n  buildProvider: new CustomEsbuild(),\n});\nnew InlineTypeScriptCode(\"let x: number = 1\", {\n  transformProvider: new CustomEsbuild(),\n});\n```\n\nInstead of _esbuild_, the custom methods will be invoked with all computed options.\nCustom implementations can amend, change or discard any of the options.\n\nThe `IBuildProvider` integration with CDK relies on the `outdir`/`outfile` values and it's usually required to use them unchanged.\n\n`ITransformProvider` must return the transformed code as a string.\n\nFailures and warnings should be printed to stderr and thrown as the respective _esbuild_ error.\n\n#### Overriding the default implementation providers\n\nThe default implementation can also be set for all usages of `TypeScriptCode` etc. in an AWS CDK app.\nYou can change the default for both APIs at once or set a different implementation for each of them.\n\n```ts\nconst myCustomEsbuildProvider = new MyCustomEsbuildProvider();\n\nEsbuildProvider.overrideDefaultProvider(myCustomEsbuildProvider);\nEsbuildProvider.overrideDefaultBuildProvider(myCustomEsbuildProvider);\nEsbuildProvider.overrideDefaultTransformationProvider(myCustomEsbuildProvider);\n\n// This will use the custom provider without the need to define it as a prop\nnew TypeScriptCode(\"src/handler.ts\");\n```\n\n### Roadmap & Contributions\n\n[The project's roadmap is available on GitHub.](https://github.com/users/mrgrain/projects/1/views/7)\n\nPlease submit feature requests as issues to the repository.\nAll contributions are welcome, no matter if they are for already planned or completely new features.\n\n## FAQ\n\n### Should I use this package in production?\n\nThis package is stable and ready to be used in production, as many do.\nHowever _esbuild_ has not yet released a version 1.0.0 and its API is still in active development.\nPlease read the guide on [esbuild's production readiness](https://esbuild.github.io/faq/#production-readiness).\n\nNote that _esbuild_ minor version upgrades are also introduced in **minor versions** of this package.\nSince _esbuild_ is pre v1, these versions typically introduce breaking changes and this package will inherit them.\nTo avoid this behavior, add the desired _esbuild_ version as a dependency to your package.\n\n### How do I upgrade from `cdk-esbuild` v3?\n\nPlease refer to the [v4 release notes](https://github.com/mrgrain/cdk-esbuild/releases/tag/v4.0.0) for a list of backwards incompatible changes and respective upgrade instructions.\n\n### [TS/JS] Why am I getting the error `Cannot find module 'esbuild'`?\n\nThis package depends on _esbuild_ as an optional dependencies. If optional dependencies are not installed automatically on your system (e.g. when using npm v4-6), install _esbuild_ explicitly:\n\n```console\nnpm install esbuild\n```\n\n### [TS/JS] How can I use a different version of _esbuild_?\n\nUse the [override](https://docs.npmjs.com/cli/v9/configuring-npm/package-json?v=true#overrides) instructions for your package manager to force a specific version, for example:\n\n```json\n{\n  \"overrides\": {\n    \"esbuild\": \"0.14.7\"\n  }\n}\n```\n\nBuild and Transform interfaces are relatively stable across _esbuild_ versions.\nHowever if any incompatibilities occur, `buildOptions` / `transformOptions` can be cast to `any`:\n\n```ts\nconst bundledCode = new TypeScriptCode(\"src/handler.ts\", {\n  buildOptions: {\n    unsupportedOption: \"value\"\n  } as any,\n});\n```\n\n### [Python/.NET] How can I use a different version of _esbuild_?\n\nInstall the desired version of _esbuild_ locally or globally [as described in the documentation above](#python-and-dotnet).\n\nBuild and Transform interfaces are relatively stable across _esbuild_ versions.\nHowever if any incompatibilities occur, use the appropriate language features to cast any incompatible `buildOptions` / `transformOptions` to the correct types.\n\n### Can I use this package in my published AWS CDK Construct?\n\nIt is possible to use `cdk-esbuild` in a published AWS CDK Construct library, but not recommended.\nAlways prefer to ship a compiled `.js` file or even bundle a zip archive in your package.\nFor AWS Lambda Functions, [projen provides an excellent solution](https://projen.io/awscdk.html#aws-lambda-functions).\n\nIf you do end up consuming `cdk-esbuild`, you will have to set `buildOptions.absWorkingDir`. The easiest way to do this, is to resolve the path based on the directory name of the calling file:\n\n```js\n// file: node_modules/construct-library/src/index.ts\nconst props = {\n  buildOptions: {\n    absWorkingDir: path.resolve(__dirname, \"..\"),\n    // now: /user/local-app/node_modules/construct-library\n  },\n};\n```\n\nThis will dynamically resolve to the correct path, wherever the package is installed. Please open an issue if you encounter any difficulties.\n\n### Can I use this package with AWS CDK v1?\n\nYes, the `2.x.x` line of `cdk-esbuild` is compatible with AWS CDK v1. You can find the [documentation for it on the v2 branch](https://github.com/mrgrain/cdk-esbuild/tree/v2).\n\nHowever, in line with AWS CDK v2, this version release now only receives security updates and critical bug fixes and support will fully end on June 1, 2023.\n"
   },
   "repository": {
     "type": "git",
@@ -2808,6 +2951,11 @@
   },
   "schema": "jsii/0.10.0",
   "targets": {
+    "dotnet": {
+      "iconUrl": "https://raw.githubusercontent.com/mrgrain/cdk-esbuild/main/images/logo.png",
+      "namespace": "Mrgrain.CdkEsbuild",
+      "packageId": "Mrgrain.CdkEsbuild"
+    },
     "js": {
       "npm": "@mrgrain/cdk-esbuild"
     },
@@ -2837,14 +2985,14 @@
         {
           "abstract": true,
           "docs": {
-            "remarks": "E.g. `src/index.ts`.",
+            "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
             "stability": "stable",
-            "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            "summary": "A path or list or map of paths to the entry points of your code."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/asset.ts",
-            "line": 29
+            "line": 40
           },
           "name": "entryPoints",
           "type": {
@@ -2904,7 +3052,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/esbuild-types.ts",
-        "line": 78
+        "line": 86
       },
       "name": "BuildOptions",
       "properties": [
@@ -2917,7 +3065,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 130
+            "line": 140
           },
           "name": "absWorkingDir",
           "optional": true,
@@ -2925,6 +3073,28 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#alias."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 106
+          },
+          "name": "alias",
+          "optional": true,
+          "type": {
+            "collection": {
+              "elementtype": {
+                "primitive": "string"
+              },
+              "kind": "map"
+            }
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -2934,7 +3104,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 108
+            "line": 118
           },
           "name": "allowOverwrite",
           "optional": true,
@@ -2951,7 +3121,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 120
+            "line": 130
           },
           "name": "assetNames",
           "optional": true,
@@ -2968,7 +3138,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 124
+            "line": 134
           },
           "name": "banner",
           "optional": true,
@@ -2990,7 +3160,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 80
+            "line": 88
           },
           "name": "bundle",
           "optional": true,
@@ -3007,7 +3177,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 48
+            "line": 50
           },
           "name": "charset",
           "optional": true,
@@ -3024,7 +3194,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 118
+            "line": 128
           },
           "name": "chunkNames",
           "optional": true,
@@ -3041,7 +3211,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 69
+            "line": 77
           },
           "name": "color",
           "optional": true,
@@ -3058,7 +3228,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 104
+            "line": 114
           },
           "name": "conditions",
           "optional": true,
@@ -3080,7 +3250,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 62
+            "line": 70
           },
           "name": "define",
           "optional": true,
@@ -3102,7 +3272,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 38
+            "line": 40
           },
           "name": "drop",
           "optional": true,
@@ -3124,7 +3294,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 116
+            "line": 126
           },
           "name": "entryNames",
           "optional": true,
@@ -3141,7 +3311,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 96
+            "line": 102
           },
           "name": "external",
           "optional": true,
@@ -3163,7 +3333,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 126
+            "line": 136
           },
           "name": "footer",
           "optional": true,
@@ -3197,7 +3367,7 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Documentation: https://esbuild.github.io/api/#globalName."
+            "summary": "Documentation: https://esbuild.github.io/api/#global-name."
           },
           "immutable": true,
           "locationInModule": {
@@ -3219,7 +3389,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 52
+            "line": 54
           },
           "name": "ignoreAnnotations",
           "optional": true,
@@ -3236,7 +3406,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 128
+            "line": 138
           },
           "name": "incremental",
           "optional": true,
@@ -3253,7 +3423,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 122
+            "line": 132
           },
           "name": "inject",
           "optional": true,
@@ -3275,7 +3445,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 55
+            "line": 57
           },
           "name": "jsx",
           "optional": true,
@@ -3283,6 +3453,23 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-development."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 65
+          },
+          "name": "jsxDev",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -3292,7 +3479,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 57
+            "line": 59
           },
           "name": "jsxFactory",
           "optional": true,
@@ -3309,7 +3496,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 59
+            "line": 61
           },
           "name": "jsxFragment",
           "optional": true,
@@ -3317,6 +3504,40 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-import-source."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 63
+          },
+          "name": "jsxImportSource",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-side-effects."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 67
+          },
+          "name": "jsxSideEffects",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -3326,7 +3547,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 66
+            "line": 74
           },
           "name": "keepNames",
           "optional": true,
@@ -3360,7 +3581,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 98
+            "line": 108
           },
           "name": "loader",
           "optional": true,
@@ -3382,7 +3603,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 71
+            "line": 79
           },
           "name": "logLevel",
           "optional": true,
@@ -3399,7 +3620,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 73
+            "line": 81
           },
           "name": "logLimit",
           "optional": true,
@@ -3416,7 +3637,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 75
+            "line": 83
           },
           "name": "logOverride",
           "optional": true,
@@ -3433,12 +3654,12 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Documentation: https://esbuild.github.io/api/#mainFields."
+            "summary": "Documentation: https://esbuild.github.io/api/#main-fields."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 102
+            "line": 112
           },
           "name": "mainFields",
           "optional": true,
@@ -3460,7 +3681,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 36
+            "line": 38
           },
           "name": "mangleCache",
           "optional": true,
@@ -3491,7 +3712,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 30
+            "line": 32
           },
           "name": "mangleProps",
           "optional": true,
@@ -3508,7 +3729,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 34
+            "line": 36
           },
           "name": "mangleQuoted",
           "optional": true,
@@ -3525,7 +3746,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 88
+            "line": 96
           },
           "name": "metafile",
           "optional": true,
@@ -3542,7 +3763,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 40
+            "line": 42
           },
           "name": "minify",
           "optional": true,
@@ -3559,7 +3780,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 44
+            "line": 46
           },
           "name": "minifyIdentifiers",
           "optional": true,
@@ -3576,7 +3797,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 46
+            "line": 48
           },
           "name": "minifySyntax",
           "optional": true,
@@ -3593,7 +3814,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 42
+            "line": 44
           },
           "name": "minifyWhitespace",
           "optional": true,
@@ -3610,7 +3831,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 132
+            "line": 142
           },
           "name": "nodePaths",
           "optional": true,
@@ -3632,7 +3853,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 92
+            "line": 100
           },
           "name": "outbase",
           "optional": true,
@@ -3649,7 +3870,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 90
+            "line": 98
           },
           "name": "outdir",
           "optional": true,
@@ -3666,7 +3887,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 112
+            "line": 122
           },
           "name": "outExtension",
           "optional": true,
@@ -3688,7 +3909,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 86
+            "line": 94
           },
           "name": "outfile",
           "optional": true,
@@ -3696,6 +3917,23 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#packages."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 104
+          },
+          "name": "packages",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -3705,7 +3943,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 94
+            "line": 29
           },
           "name": "platform",
           "optional": true,
@@ -3722,7 +3960,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 84
+            "line": 92
           },
           "name": "preserveSymlinks",
           "optional": true,
@@ -3739,7 +3977,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 114
+            "line": 124
           },
           "name": "publicPath",
           "optional": true,
@@ -3756,7 +3994,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 64
+            "line": 72
           },
           "name": "pure",
           "optional": true,
@@ -3778,7 +4016,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 32
+            "line": 34
           },
           "name": "reserveProps",
           "optional": true,
@@ -3795,7 +4033,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 100
+            "line": 110
           },
           "name": "resolveExtensions",
           "optional": true,
@@ -3877,7 +4115,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 82
+            "line": 90
           },
           "name": "splitting",
           "optional": true,
@@ -3947,7 +4185,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 50
+            "line": 52
           },
           "name": "treeShaking",
           "optional": true,
@@ -3964,7 +4202,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 110
+            "line": 120
           },
           "name": "tsconfig",
           "optional": true,
@@ -3981,7 +4219,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 106
+            "line": 116
           },
           "name": "write",
           "optional": true,
@@ -4002,64 +4240,59 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/bundler.ts",
-        "line": 23
+        "line": 34
       },
       "name": "BundlerProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "custom": {
-              "throws": "esbuild.BuildFailure",
-              "type": "esbuild.buildSync"
-            },
-            "default": "esbuild.buildSync",
-            "remarks": "The function will receive the computed options from the bundler. It can use with these options as it wishes, however `outdir`/`outfile` must be respected to integrate with CDK.\nMust throw a `BuildFailure` on failure to correctly inform the bundler.",
-            "returns": "esbuild.BuildResult",
-            "stability": "experimental",
-            "summary": "Escape hatch to provide the bundler with a custom build function."
+            "remarks": "* `buildOptions.outdir: string`\nThe actual path for the output directory is defined by CDK. However setting this option allows to write files into a subdirectory. \\\nFor example `{ outdir: 'js' }` will create an asset with a single directory called `js`, which contains all built files. This approach can be useful for static website deployments, where JavaScript code should be placed into a subdirectory. \\\n*Cannot be used together with `outfile`*.\n* `buildOptions.outfile: string`\nRelative path to a file inside the CDK asset output directory.\nFor example `{ outfile: 'js/index.js' }` will create an asset with a single directory called `js`, which contains a single file `index.js`. This can be useful to rename the entry point. \\\n*Cannot be used with multiple entryPoints or together with `outdir`.*\n* `buildOptions.absWorkingDir: string`\nAbsolute path to the [esbuild working directory](https://esbuild.github.io/api/#working-directory) and defaults to the [current working directory](https://en.wikipedia.org/wiki/Working_directory). \\\nIf paths cannot be found, a good starting point is to look at the concatenation of `absWorkingDir + entryPoint`. It must always be a valid absolute path pointing to the entry point. When needed, the probably easiest way to set absWorkingDir is to use a combination of `resolve` and `__dirname` (see \"Library authors\" section in the documentation).",
+            "see": "https://esbuild.github.io/api/#build-api",
+            "stability": "stable",
+            "summary": "Build options passed on to esbuild. Please refer to the esbuild Build API docs for details."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 79
+            "line": 53
           },
-          "name": "buildFn",
+          "name": "buildOptions",
           "optional": true,
           "type": {
-            "primitive": "any"
+            "fqn": "@mrgrain/cdk-esbuild.BuildOptions"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "remarks": "* `buildOptions.outdir: string`\nThe actual path for the output directory is defined by CDK. However setting this option allows to write files into a subdirectory. \\\nFor example `{ outdir: 'js' }` will create an asset with a single directory called `js`, which contains all built files. This approach can be useful for static website deployments, where JavaScript code should be placed into a subdirectory. \\\n*Cannot be used together with `outfile`*.\n* `buildOptions.outfile: string`\nRelative path to a file inside the CDK asset output directory.\nFor example `{ outfile: 'js/index.js' }` will create an asset with a single directory called `js`, which contains a single file `index.js`. This can be useful to rename the entry point. \\\n*Cannot be used with multiple entryPoints or together with `outdir`.*\n* `buildOptions.absWorkingDir: string`\nAbsolute path to the [esbuild working directory](https://esbuild.github.io/api/#working-directory) and defaults to the [current working directory](https://en.wikipedia.org/wiki/Working_directory). \\\nIf paths cannot be found, a good starting point is to look at the concatenation of `absWorkingDir + entryPoint`. It must always be a valid absolute path pointing to the entry point. When needed, the probably easiest way to set absWorkingDir is to use a combination of `resolve` and `__dirname` (see \"Library authors\" section in the documentation).",
-            "see": "https://esbuild.github.io/api/#build-api",
+            "default": "new EsbuildProvider()",
+            "remarks": "Configure the default `EsbuildProvider` for more options or\nprovide a custom `IBuildProvider` as an escape hatch.",
             "stability": "stable",
-            "summary": "Build options passed on to esbuild. Please refer to the esbuild Build API docs for details."
+            "summary": "The esbuild Build API implementation to be used."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 42
+            "line": 65
           },
-          "name": "buildOptions",
+          "name": "buildProvider",
           "optional": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.BuildOptions"
+            "fqn": "@mrgrain/cdk-esbuild.IBuildProvider"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "remarks": "* When provided with a `string` or `array`, all files are copied to the root of asset staging directory.\n* When given a `map`, the key indicates the destination relative to the asset staging directory and the value is a list of all sources to be copied.\n\nTherefore the following values for `copyDir` are all equivalent:\n```ts\n{ copyDir: \"path/to/source\" }\n{ copyDir: [\"path/to/source\"] }\n{ copyDir: { \".\": \"path/to/source\" } }\n{ copyDir: { \".\": [\"path/to/source\"] } }\n```\nThe destination cannot be outside of the asset staging directory.\nIf you are receiving the error \"Cannot copy files to outside of the asset staging directory.\"\nyou are likely using `..` or an absolute path as key on the `copyDir` map.\nInstead use only relative paths and avoid `..`.",
+            "remarks": "* When provided with a `string` or `array`, all files are copied to the root of asset staging directory.\n* When given a `map`, the key indicates the destination relative to the asset staging directory and the value is a list of all sources to be copied.\n\nTherefore the following values for `copyDir` are all equivalent:\n```\n{ copyDir: \"path/to/source\" }\n{ copyDir: [\"path/to/source\"] }\n{ copyDir: { \".\": \"path/to/source\" } }\n{ copyDir: { \".\": [\"path/to/source\"] } }\n```\nThe destination cannot be outside of the asset staging directory.\nIf you are receiving the error \"Cannot copy files to outside of the asset staging directory.\"\nyou are likely using `..` or an absolute path as key on the `copyDir` map.\nInstead use only relative paths and avoid `..`.",
             "stability": "stable",
             "summary": "Copy additional files to the code [asset staging directory](https://docs.aws.amazon.com/cdk/api/v2/docs/aws-cdk-lib.AssetStaging.html#absolutestagedpath), before the build runs. Files copied like this will be overwritten by esbuild if they share the same name as any of the outputs."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 65
+            "line": 88
           },
           "name": "copyDir",
           "optional": true,
@@ -4102,24 +4335,6 @@
               ]
             }
           }
-        },
-        {
-          "abstract": true,
-          "docs": {
-            "remarks": "This is the same as setting the ESBUILD_BINARY_PATH environment variable.",
-            "stability": "experimental",
-            "summary": "Path to the binary used by esbuild."
-          },
-          "immutable": true,
-          "locationInModule": {
-            "filename": "src/bundler.ts",
-            "line": 88
-          },
-          "name": "esbuildBinaryPath",
-          "optional": true,
-          "type": {
-            "primitive": "string"
-          }
         }
       ],
       "symbolId": "src/bundler:BundlerProps"
@@ -4196,6 +4411,103 @@
       ],
       "symbolId": "aws-lambda/lib/code:CodeConfig"
     },
+    "@mrgrain/cdk-esbuild.CompilerOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.CompilerOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/esbuild-types.ts",
+        "line": 603
+      },
+      "name": "CompilerOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 607
+          },
+          "name": "importsNotUsedAsValues",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 604
+          },
+          "name": "jsxFactory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 605
+          },
+          "name": "jsxFragmentFactory",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 608
+          },
+          "name": "preserveValueImports",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 606
+          },
+          "name": "useDefineForClassFields",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/esbuild-types:CompilerOptions"
+    },
     "@mrgrain/cdk-esbuild.EsbuildAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "aws-cdk-lib.aws_s3_assets.Asset",
@@ -4211,7 +4523,7 @@
         },
         "locationInModule": {
           "filename": "src/asset.ts",
-          "line": 46
+          "line": 57
         },
         "parameters": [
           {
@@ -4237,7 +4549,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/asset.ts",
-        "line": 42
+        "line": 53
       },
       "name": "EsbuildAsset",
       "symbolId": "src/asset:EsbuildAsset"
@@ -4261,9 +4573,9 @@
         "parameters": [
           {
             "docs": {
-              "remarks": "E.g. `src/index.ts`.",
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
               "stability": "experimental",
-              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+              "summary": "A path or list or map of paths to the entry points of your code."
             },
             "name": "entryPoints",
             "type": {
@@ -4295,7 +4607,7 @@
           {
             "docs": {
               "stability": "experimental",
-              "summary": "Props to change the behaviour of the bundler."
+              "summary": "Props to change the behavior of the bundler."
             },
             "name": "props",
             "type": {
@@ -4313,14 +4625,14 @@
       "properties": [
         {
           "docs": {
-            "remarks": "E.g. `src/index.ts`.",
+            "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
             "stability": "experimental",
-            "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            "summary": "A path or list or map of paths to the entry points of your code."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 122
+            "line": 132
           },
           "name": "entryPoints",
           "type": {
@@ -4382,12 +4694,12 @@
         {
           "docs": {
             "stability": "experimental",
-            "summary": "Props to change the behaviour of the bundler."
+            "summary": "Props to change the behavior of the bundler."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/bundler.ts",
-            "line": 129
+            "line": 139
           },
           "name": "props",
           "type": {
@@ -4412,14 +4724,14 @@
         },
         "locationInModule": {
           "filename": "src/code.ts",
-          "line": 51
+          "line": 48
         },
         "parameters": [
           {
             "docs": {
-              "remarks": "E.g. `src/index.ts`.",
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
               "stability": "stable",
-              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+              "summary": "A path or list or map of paths to the entry points of your code."
             },
             "name": "entryPoints",
             "type": {
@@ -4473,7 +4785,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 29
+        "line": 26
       },
       "methods": [
         {
@@ -4483,7 +4795,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 91
+            "line": 93
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_lambda.Code",
@@ -4509,7 +4821,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 119
+            "line": 121
           },
           "name": "bindToResource",
           "overrides": "aws-cdk-lib.aws_lambda.Code",
@@ -4535,7 +4847,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 32
+            "line": 29
           },
           "name": "getAsset",
           "parameters": [
@@ -4558,14 +4870,14 @@
       "properties": [
         {
           "docs": {
-            "remarks": "E.g. `src/index.ts`.",
+            "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
             "stability": "stable",
-            "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+            "summary": "A path or list or map of paths to the entry points of your code."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 58
+            "line": 65
           },
           "name": "entryPoints",
           "type": {
@@ -4600,7 +4912,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 42
+            "line": 39
           },
           "name": "asset",
           "protected": true,
@@ -4616,7 +4928,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 49
+            "line": 46
           },
           "name": "isInline",
           "type": {
@@ -4629,7 +4941,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 40
+            "line": 37
           },
           "name": "props",
           "protected": true,
@@ -4640,171 +4952,519 @@
       ],
       "symbolId": "src/code:EsbuildCode"
     },
-    "@mrgrain/cdk-esbuild.InlineJavaScriptCode": {
+    "@mrgrain/cdk-esbuild.EsbuildProvider": {
       "assembly": "@mrgrain/cdk-esbuild",
-      "base": "aws-cdk-lib.aws_lambda.InlineCode",
       "docs": {
-        "stability": "experimental",
-        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
+        "stability": "stable",
+        "summary": "Default esbuild implementation calling esbuild's JavaScript API."
       },
-      "fqn": "@mrgrain/cdk-esbuild.InlineJavaScriptCode",
+      "fqn": "@mrgrain/cdk-esbuild.EsbuildProvider",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
-          "filename": "src/inline-code.ts",
-          "line": 84
+          "filename": "src/provider.ts",
+          "line": 139
         },
         "parameters": [
           {
-            "docs": {
-              "stability": "experimental",
-              "summary": "The inline code to be transformed."
-            },
-            "name": "code",
-            "type": {
-              "primitive": "string"
-            }
-          },
-          {
-            "docs": {
-              "remarks": "Props to change the behaviour of the transformer.\n\nDefault values for `props.transformOptions`:\n- `loader='js'`",
-              "see": "https://esbuild.github.io/api/#transform-api",
-              "stability": "experimental",
-              "summary": "Support for `TransformOptions` is deprecated. Please provide `TransformerProps`!"
-            },
             "name": "props",
             "optional": true,
             "type": {
-              "union": {
-                "types": [
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
-                  },
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
-                  }
-                ]
-              }
+              "fqn": "@mrgrain/cdk-esbuild.EsbuildProviderProps"
             }
           }
         ]
       },
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.IBuildProvider",
+        "@mrgrain/cdk-esbuild.ITransformProvider"
+      ],
       "kind": "class",
       "locationInModule": {
-        "filename": "src/inline-code.ts",
-        "line": 83
-      },
-      "name": "InlineJavaScriptCode",
-      "symbolId": "src/inline-code:InlineJavaScriptCode"
-    },
-    "@mrgrain/cdk-esbuild.InlineJsxCode": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "base": "aws-cdk-lib.aws_lambda.InlineCode",
-      "docs": {
-        "stability": "experimental",
-        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
+        "filename": "src/provider.ts",
+        "line": 95
       },
-      "fqn": "@mrgrain/cdk-esbuild.InlineJsxCode",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "src/inline-code.ts",
-          "line": 115
-        },
-        "parameters": [
-          {
-            "docs": {
-              "stability": "experimental",
-              "summary": "The inline code to be transformed."
-            },
-            "name": "code",
-            "type": {
-              "primitive": "string"
-            }
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Get the default implementation for the Build API."
           },
-          {
-            "docs": {
-              "remarks": "Props to change the behaviour of the transformer.\n\nDefault values for `transformOptions`:\n- `loader='jsx'`",
-              "see": "https://esbuild.github.io/api/#transform-api",
-              "stability": "experimental",
-              "summary": "Support for `TransformOptions` is deprecated. Please provide `TransformerProps`!"
-            },
-            "name": "props",
-            "optional": true,
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 118
+          },
+          "name": "defaultBuildProvider",
+          "returns": {
             "type": {
-              "union": {
-                "types": [
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
-                  },
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
-                  }
-                ]
-              }
+              "fqn": "@mrgrain/cdk-esbuild.IBuildProvider"
             }
-          }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/inline-code.ts",
-        "line": 114
-      },
-      "name": "InlineJsxCode",
-      "symbolId": "src/inline-code:InlineJsxCode"
-    },
-    "@mrgrain/cdk-esbuild.InlineTsxCode": {
-      "assembly": "@mrgrain/cdk-esbuild",
-      "base": "aws-cdk-lib.aws_lambda.InlineCode",
-      "docs": {
-        "stability": "experimental",
-        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
-      },
-      "fqn": "@mrgrain/cdk-esbuild.InlineTsxCode",
-      "initializer": {
-        "docs": {
-          "stability": "experimental"
-        },
-        "locationInModule": {
-          "filename": "src/inline-code.ts",
-          "line": 175
+          },
+          "static": true
         },
-        "parameters": [
-          {
-            "docs": {
-              "stability": "experimental",
-              "summary": "The inline code to be transformed."
-            },
-            "name": "code",
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Get the default implementation for the Transformation API."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 132
+          },
+          "name": "defaultTransformationProvider",
+          "returns": {
             "type": {
-              "primitive": "string"
+              "fqn": "@mrgrain/cdk-esbuild.ITransformProvider"
             }
           },
-          {
-            "docs": {
-              "remarks": "Props to change the behaviour of the transformer.\n\nDefault values for `transformOptions`:\n- `loader='tsx'`",
-              "see": "https://esbuild.github.io/api/#transform-api",
-              "stability": "experimental",
-              "summary": "Support for `TransformOptions` is deprecated. Please provide `TransformerProps`!"
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set the default implementation for the Build API."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 111
+          },
+          "name": "overrideDefaultBuildProvider",
+          "parameters": [
+            {
+              "name": "provider",
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.IBuildProvider"
+              }
+            }
+          ],
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set the default implementation for both Build and Transformation API."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 103
+          },
+          "name": "overrideDefaultProvider",
+          "parameters": [
+            {
+              "name": "provider",
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.IEsbuildProvider"
+              }
+            }
+          ],
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Set the default implementation for the Transformation API."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 125
+          },
+          "name": "overrideDefaultTransformationProvider",
+          "parameters": [
+            {
+              "name": "provider",
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.ITransformProvider"
+              }
+            }
+          ],
+          "static": true
+        },
+        {
+          "docs": {
+            "remarks": "During synth time, the method will receive all computed `BuildOptions` from the bundler.\n\nIt MUST implement any output options to integrate correctly and MAY use any other options.\nOn failure, it SHOULD print any warnings & errors to stderr and throw a `BuildFailure` to inform the bundler.",
+            "stability": "stable",
+            "summary": "A method implementing the code build."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 144
+          },
+          "name": "buildSync",
+          "overrides": "@mrgrain/cdk-esbuild.IBuildProvider",
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.ProviderBuildOptions"
+              }
+            }
+          ]
+        },
+        {
+          "docs": {
+            "remarks": "During synth time, the method will receive the inline code and all computed `TransformOptions` from the bundler.\n\nMUST return the transformed code as a string to integrate correctly.\nIt MAY use these options to do so.\nOn failure, it SHOULD print any warnings & errors to stderr and throw a `TransformFailure` to inform the bundler.",
+            "stability": "stable",
+            "summary": "A method implementing the inline code transformation."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 151
+          },
+          "name": "transformSync",
+          "overrides": "@mrgrain/cdk-esbuild.ITransformProvider",
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "primitive": "string"
+              }
             },
-            "name": "props",
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.ProviderTransformOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "EsbuildProvider",
+      "symbolId": "src/provider:EsbuildProvider"
+    },
+    "@mrgrain/cdk-esbuild.EsbuildProviderProps": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable",
+        "summary": "Configure the default EsbuildProvider."
+      },
+      "fqn": "@mrgrain/cdk-esbuild.EsbuildProviderProps",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 60
+      },
+      "name": "EsbuildProviderProps",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "remarks": "This is the same as setting the ESBUILD_BINARY_PATH environment variable.",
+            "stability": "stable",
+            "summary": "Path to the binary used by esbuild."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 68
+          },
+          "name": "esbuildBinaryPath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "default": "- `CDK_ESBUILD_MODULE_PATH` or package resolution (see description)",
+            "remarks": "E.g. \"/home/user/.npm/node_modules/esbuild/lib/main.js\"\n\nIf not set, the module path will be determined in the following order:\n\n- Use a path from the `CDK_ESBUILD_MODULE_PATH` environment variable\n- In TypeScript, fallback to the default Node.js package resolution mechanism\n- All other languages (Python, Go, .NET, Java) use an automatic \"best effort\" resolution mechanism. \\\n   The exact algorithm of this mechanism is considered an implementation detail and should not be relied on.\n   If `esbuild` cannot be found, it might be installed dynamically to a temporary location.\n   To opt-out of this behavior, set either `esbuildModulePath` or `CDK_ESBUILD_MODULE_PATH` env variable.\n\nUse the static methods on `EsbuildSource` to customize the default behavior.",
+            "stability": "stable",
+            "summary": "Absolute path to the esbuild module JS file."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 89
+          },
+          "name": "esbuildModulePath",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        }
+      ],
+      "symbolId": "src/provider:EsbuildProviderProps"
+    },
+    "@mrgrain/cdk-esbuild.EsbuildSource": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.EsbuildSource",
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/private/esbuild-source.ts",
+        "line": 11
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Try to find the module in most common paths."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 30
+          },
+          "name": "anywhere",
+          "returns": {
             "optional": true,
             "type": {
-              "union": {
-                "types": [
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
-                  },
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
-                  }
-                ]
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "First try to find to module, then install it to a temporary location."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 58
+          },
+          "name": "auto",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Try to find the module in common global installation paths."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 37
+          },
+          "name": "globalPaths",
+          "returns": {
+            "optional": true,
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Install the module to a temporary location."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 51
+          },
+          "name": "install",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Require module by name, do not attempt to find it anywhere else."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 44
+          },
+          "name": "nodeJs",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        },
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "`EsbuildSource.nodeJs()` for NodeJs, `EsbuildSource.auto()` for all other languages."
+          },
+          "locationInModule": {
+            "filename": "src/private/esbuild-source.ts",
+            "line": 19
+          },
+          "name": "platformDefault",
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          },
+          "static": true
+        }
+      ],
+      "name": "EsbuildSource",
+      "symbolId": "src/private/esbuild-source:EsbuildSource"
+    },
+    "@mrgrain/cdk-esbuild.IBuildProvider": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "docs": {
+        "stability": "stable",
+        "summary": "Provides an implementation of the esbuild Build API."
+      },
+      "fqn": "@mrgrain/cdk-esbuild.IBuildProvider",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 20
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "throws": "`esbuild.BuildFailure`"
+            },
+            "remarks": "During synth time, the method will receive all computed `BuildOptions` from the bundler.\n\nIt MUST implement any output options to integrate correctly and MAY use any other options.\nOn failure, it SHOULD print any warnings & errors to stderr and throw a `BuildFailure` to inform the bundler.",
+            "stability": "stable",
+            "summary": "A method implementing the code build."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 31
+          },
+          "name": "buildSync",
+          "parameters": [
+            {
+              "name": "options",
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.ProviderBuildOptions"
+              }
+            }
+          ]
+        }
+      ],
+      "name": "IBuildProvider",
+      "symbolId": "src/provider:IBuildProvider"
+    },
+    "@mrgrain/cdk-esbuild.IEsbuildProvider": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "docs": {
+        "stability": "stable",
+        "summary": "Provides an implementation of the esbuild Build & Transform API."
+      },
+      "fqn": "@mrgrain/cdk-esbuild.IEsbuildProvider",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.IBuildProvider",
+        "@mrgrain/cdk-esbuild.ITransformProvider"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 55
+      },
+      "name": "IEsbuildProvider",
+      "symbolId": "src/provider:IEsbuildProvider"
+    },
+    "@mrgrain/cdk-esbuild.ITransformProvider": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "docs": {
+        "stability": "stable",
+        "summary": "Provides an implementation of the esbuild Transform API."
+      },
+      "fqn": "@mrgrain/cdk-esbuild.ITransformProvider",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 37
+      },
+      "methods": [
+        {
+          "abstract": true,
+          "docs": {
+            "custom": {
+              "throws": "`esbuild.TransformFailure`"
+            },
+            "remarks": "During synth time, the method will receive the inline code and all computed `TransformOptions` from the bundler.\n\nMUST return the transformed code as a string to integrate correctly.\nIt MAY use these options to do so.\nOn failure, it SHOULD print any warnings & errors to stderr and throw a `TransformFailure` to inform the bundler.",
+            "stability": "stable",
+            "summary": "A method implementing the inline code transformation."
+          },
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 49
+          },
+          "name": "transformSync",
+          "parameters": [
+            {
+              "name": "input",
+              "type": {
+                "primitive": "string"
               }
+            },
+            {
+              "name": "options",
+              "optional": true,
+              "type": {
+                "fqn": "@mrgrain/cdk-esbuild.ProviderTransformOptions"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "primitive": "string"
+            }
+          }
+        }
+      ],
+      "name": "ITransformProvider",
+      "symbolId": "src/provider:ITransformProvider"
+    },
+    "@mrgrain/cdk-esbuild.InlineJavaScriptCode": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "base": "aws-cdk-lib.aws_lambda.InlineCode",
+      "docs": {
+        "stability": "stable",
+        "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
+      },
+      "fqn": "@mrgrain/cdk-esbuild.InlineJavaScriptCode",
+      "initializer": {
+        "docs": {
+          "stability": "stable"
+        },
+        "locationInModule": {
+          "filename": "src/inline-code.ts",
+          "line": 93
+        },
+        "parameters": [
+          {
+            "docs": {
+              "stability": "stable",
+              "summary": "The inline code to be transformed."
+            },
+            "name": "code",
+            "type": {
+              "primitive": "string"
+            }
+          },
+          {
+            "docs": {
+              "remarks": "Default values for `props.transformOptions`:\n- `loader='js'`\n- `platform=node`\n- `target=nodeX` with X being the major node version running locally",
+              "see": "https://esbuild.github.io/api/#transform-api",
+              "stability": "stable",
+              "summary": "Props to change the behavior of the transformer."
+            },
+            "name": "props",
+            "optional": true,
+            "type": {
+              "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
             }
           }
         ]
@@ -4812,31 +5472,76 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 174
+        "line": 92
       },
-      "name": "InlineTsxCode",
-      "symbolId": "src/inline-code:InlineTsxCode"
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Called when the lambda or layer is initialized to allow this object to bind to the stack, add resources and have fun."
+          },
+          "locationInModule": {
+            "filename": "src/inline-code.ts",
+            "line": 65
+          },
+          "name": "bind",
+          "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
+              }
+            }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_lambda.CodeConfig"
+            }
+          }
+        }
+      ],
+      "name": "InlineJavaScriptCode",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Determines whether this Code is inline code or not."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/inline-code.ts",
+            "line": 34
+          },
+          "name": "isInline",
+          "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
+      "symbolId": "src/inline-code:InlineJavaScriptCode"
     },
     "@mrgrain/cdk-esbuild.InlineTypeScriptCode": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "aws-cdk-lib.aws_lambda.InlineCode",
       "docs": {
-        "stability": "experimental",
+        "stability": "stable",
         "summary": "An implementation of `lambda.InlineCode` using the esbuild Transform API. Inline function code is limited to 4 KiB after transformation."
       },
       "fqn": "@mrgrain/cdk-esbuild.InlineTypeScriptCode",
       "initializer": {
         "docs": {
-          "stability": "experimental"
+          "stability": "stable"
         },
         "locationInModule": {
           "filename": "src/inline-code.ts",
-          "line": 145
+          "line": 124
         },
         "parameters": [
           {
             "docs": {
-              "stability": "experimental",
+              "stability": "stable",
               "summary": "The inline code to be transformed."
             },
             "name": "code",
@@ -4846,34 +5551,70 @@
           },
           {
             "docs": {
-              "remarks": "Props to change the behaviour of the transformer.\n\nDefault values for `transformOptions`:\n- `loader='ts'`",
+              "remarks": "Default values for `transformOptions`:\n- `loader='ts'`\n- `platform=node`\n- `target=nodeX` with X being the major node version running locally",
               "see": "https://esbuild.github.io/api/#transform-api",
-              "stability": "experimental",
-              "summary": "Support for `TransformOptions` is deprecated. Please provide `TransformerProps`!"
+              "stability": "stable",
+              "summary": "Props to change the behavior of the transformer."
             },
             "name": "props",
             "optional": true,
             "type": {
-              "union": {
-                "types": [
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
-                  },
-                  {
-                    "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
-                  }
-                ]
+              "fqn": "@mrgrain/cdk-esbuild.TransformerProps"
+            }
+          }
+        ]
+      },
+      "kind": "class",
+      "locationInModule": {
+        "filename": "src/inline-code.ts",
+        "line": 123
+      },
+      "methods": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Called when the lambda or layer is initialized to allow this object to bind to the stack, add resources and have fun."
+          },
+          "locationInModule": {
+            "filename": "src/inline-code.ts",
+            "line": 65
+          },
+          "name": "bind",
+          "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
+          "parameters": [
+            {
+              "name": "scope",
+              "type": {
+                "fqn": "constructs.Construct"
               }
             }
+          ],
+          "returns": {
+            "type": {
+              "fqn": "aws-cdk-lib.aws_lambda.CodeConfig"
+            }
           }
-        ]
-      },
-      "kind": "class",
-      "locationInModule": {
-        "filename": "src/inline-code.ts",
-        "line": 144
-      },
+        }
+      ],
       "name": "InlineTypeScriptCode",
+      "properties": [
+        {
+          "docs": {
+            "stability": "stable",
+            "summary": "Determines whether this Code is inline code or not."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/inline-code.ts",
+            "line": 34
+          },
+          "name": "isInline",
+          "overrides": "aws-cdk-lib.aws_lambda.InlineCode",
+          "type": {
+            "primitive": "boolean"
+          }
+        }
+      ],
       "symbolId": "src/inline-code:InlineTypeScriptCode"
     },
     "@mrgrain/cdk-esbuild.JavaScriptAsset": {
@@ -4891,7 +5632,7 @@
         },
         "locationInModule": {
           "filename": "src/asset.ts",
-          "line": 46
+          "line": 57
         },
         "parameters": [
           {
@@ -4917,7 +5658,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/asset.ts",
-        "line": 101
+        "line": 126
       },
       "name": "JavaScriptAsset",
       "symbolId": "src/asset:JavaScriptAsset"
@@ -4936,14 +5677,14 @@
         },
         "locationInModule": {
           "filename": "src/code.ts",
-          "line": 143
+          "line": 145
         },
         "parameters": [
           {
             "docs": {
-              "remarks": "E.g. `src/index.ts`.",
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
               "stability": "stable",
-              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+              "summary": "A path or list or map of paths to the entry points of your code."
             },
             "name": "entryPoints",
             "type": {
@@ -4989,7 +5730,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 134
+        "line": 136
       },
       "methods": [
         {
@@ -4998,7 +5739,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 135
+            "line": 137
           },
           "name": "getAsset",
           "overrides": "@mrgrain/cdk-esbuild.EsbuildCode",
@@ -5034,7 +5775,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 19
+        "line": 16
       },
       "name": "JavaScriptCodeProps",
       "properties": [
@@ -5071,10 +5812,15 @@
         },
         "locationInModule": {
           "filename": "src/source.ts",
-          "line": 89
+          "line": 113
         },
         "parameters": [
           {
+            "docs": {
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
+              "stability": "stable",
+              "summary": "A path or list or map of paths to the entry points of your code."
+            },
             "name": "entryPoints",
             "type": {
               "union": {
@@ -5103,6 +5849,11 @@
             }
           },
           {
+            "docs": {
+              "remarks": "Default values for `props.buildOptions`:\n- `bundle=true`\n- `platform=browser`",
+              "stability": "stable",
+              "summary": "Props to change the behavior of the bundler."
+            },
             "name": "props",
             "optional": true,
             "type": {
@@ -5117,7 +5868,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/source.ts",
-        "line": 83
+        "line": 107
       },
       "methods": [
         {
@@ -5127,7 +5878,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 49
+            "line": 73
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_s3_deployment.ISource",
@@ -5184,7 +5935,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 87
+            "line": 111
           },
           "name": "assetClass",
           "type": {
@@ -5246,6 +5997,80 @@
       ],
       "symbolId": "src/source:JavaScriptSourceProps"
     },
+    "@mrgrain/cdk-esbuild.ProviderBuildOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.ProviderBuildOptions",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.BuildOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 9
+      },
+      "name": "ProviderBuildOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#entry-points."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/provider.ts",
+            "line": 11
+          },
+          "name": "entryPoints",
+          "optional": true,
+          "type": {
+            "union": {
+              "types": [
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "array"
+                  }
+                },
+                {
+                  "collection": {
+                    "elementtype": {
+                      "primitive": "string"
+                    },
+                    "kind": "map"
+                  }
+                }
+              ]
+            }
+          }
+        }
+      ],
+      "symbolId": "src/provider:ProviderBuildOptions"
+    },
+    "@mrgrain/cdk-esbuild.ProviderTransformOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.ProviderTransformOptions",
+      "interfaces": [
+        "@mrgrain/cdk-esbuild.TransformOptions"
+      ],
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/provider.ts",
+        "line": 14
+      },
+      "name": "ProviderTransformOptions",
+      "symbolId": "src/provider:ProviderTransformOptions"
+    },
     "@mrgrain/cdk-esbuild.TransformOptions": {
       "assembly": "@mrgrain/cdk-esbuild",
       "datatype": true,
@@ -5256,7 +6081,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/esbuild-types.ts",
-        "line": 240
+        "line": 250
       },
       "name": "TransformOptions",
       "properties": [
@@ -5268,7 +6093,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 245
+            "line": 255
           },
           "name": "banner",
           "optional": true,
@@ -5285,7 +6110,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 48
+            "line": 50
           },
           "name": "charset",
           "optional": true,
@@ -5302,7 +6127,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 69
+            "line": 77
           },
           "name": "color",
           "optional": true,
@@ -5319,7 +6144,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 62
+            "line": 70
           },
           "name": "define",
           "optional": true,
@@ -5341,7 +6166,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 38
+            "line": 40
           },
           "name": "drop",
           "optional": true,
@@ -5362,7 +6187,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 246
+            "line": 256
           },
           "name": "footer",
           "optional": true,
@@ -5391,7 +6216,7 @@
           "abstract": true,
           "docs": {
             "stability": "stable",
-            "summary": "Documentation: https://esbuild.github.io/api/#globalName."
+            "summary": "Documentation: https://esbuild.github.io/api/#global-name."
           },
           "immutable": true,
           "locationInModule": {
@@ -5413,7 +6238,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 52
+            "line": 54
           },
           "name": "ignoreAnnotations",
           "optional": true,
@@ -5430,7 +6255,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 55
+            "line": 57
           },
           "name": "jsx",
           "optional": true,
@@ -5438,6 +6263,23 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-development."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 65
+          },
+          "name": "jsxDev",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -5447,7 +6289,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 57
+            "line": 59
           },
           "name": "jsxFactory",
           "optional": true,
@@ -5464,7 +6306,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 59
+            "line": 61
           },
           "name": "jsxFragment",
           "optional": true,
@@ -5472,6 +6314,40 @@
             "primitive": "string"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-import-source."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 63
+          },
+          "name": "jsxImportSource",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#jsx-side-effects."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 67
+          },
+          "name": "jsxSideEffects",
+          "optional": true,
+          "type": {
+            "primitive": "boolean"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -5481,7 +6357,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 66
+            "line": 74
           },
           "name": "keepNames",
           "optional": true,
@@ -5514,7 +6390,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 244
+            "line": 254
           },
           "name": "loader",
           "optional": true,
@@ -5531,7 +6407,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 71
+            "line": 79
           },
           "name": "logLevel",
           "optional": true,
@@ -5548,7 +6424,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 73
+            "line": 81
           },
           "name": "logLimit",
           "optional": true,
@@ -5565,7 +6441,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 75
+            "line": 83
           },
           "name": "logOverride",
           "optional": true,
@@ -5587,7 +6463,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 36
+            "line": 38
           },
           "name": "mangleCache",
           "optional": true,
@@ -5618,7 +6494,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 30
+            "line": 32
           },
           "name": "mangleProps",
           "optional": true,
@@ -5635,7 +6511,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 34
+            "line": 36
           },
           "name": "mangleQuoted",
           "optional": true,
@@ -5652,7 +6528,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 40
+            "line": 42
           },
           "name": "minify",
           "optional": true,
@@ -5669,7 +6545,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 44
+            "line": 46
           },
           "name": "minifyIdentifiers",
           "optional": true,
@@ -5686,7 +6562,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 46
+            "line": 48
           },
           "name": "minifySyntax",
           "optional": true,
@@ -5703,7 +6579,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 42
+            "line": 44
           },
           "name": "minifyWhitespace",
           "optional": true,
@@ -5711,6 +6587,23 @@
             "primitive": "boolean"
           }
         },
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable",
+            "summary": "Documentation: https://esbuild.github.io/api/#platform."
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 29
+          },
+          "name": "platform",
+          "optional": true,
+          "type": {
+            "primitive": "string"
+          }
+        },
         {
           "abstract": true,
           "docs": {
@@ -5720,7 +6613,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 64
+            "line": 72
           },
           "name": "pure",
           "optional": true,
@@ -5742,7 +6635,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 32
+            "line": 34
           },
           "name": "reserveProps",
           "optional": true,
@@ -5758,7 +6651,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 243
+            "line": 253
           },
           "name": "sourcefile",
           "optional": true,
@@ -5888,7 +6781,7 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 50
+            "line": 52
           },
           "name": "treeShaking",
           "optional": true,
@@ -5904,12 +6797,21 @@
           "immutable": true,
           "locationInModule": {
             "filename": "src/esbuild-types.ts",
-            "line": 241
+            "line": 251
           },
           "name": "tsconfigRaw",
           "optional": true,
           "type": {
-            "primitive": "string"
+            "union": {
+              "types": [
+                {
+                  "primitive": "string"
+                },
+                {
+                  "fqn": "@mrgrain/cdk-esbuild.TsconfigOptions"
+                }
+              ]
+            }
           }
         }
       ],
@@ -5919,62 +6821,90 @@
       "assembly": "@mrgrain/cdk-esbuild",
       "datatype": true,
       "docs": {
-        "stability": "experimental"
+        "stability": "stable"
       },
       "fqn": "@mrgrain/cdk-esbuild.TransformerProps",
       "kind": "interface",
       "locationInModule": {
         "filename": "src/inline-code.ts",
-        "line": 9
+        "line": 11
       },
       "name": "TransformerProps",
       "properties": [
         {
           "abstract": true,
           "docs": {
-            "custom": {
-              "throws": "esbuild.TransformFailure",
-              "type": "esbuild.transformSync"
-            },
-            "default": "esbuild.transformSync",
-            "remarks": "The function will receive the computed options from the bundler. It can use with these options as it wishes, however a TransformResult must be returned to integrate with CDK.\nMust throw a `TransformFailure` on failure to correctly inform the bundler.",
-            "returns": "esbuild.TransformResult",
-            "stability": "experimental",
-            "summary": "Escape hatch to provide the bundler with a custom transform function."
+            "remarks": "Please refer to the esbuild Transform API docs for details.",
+            "see": "https://esbuild.github.io/api/#transform-api",
+            "stability": "stable",
+            "summary": "Transform options passed on to esbuild."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 29
+            "line": 18
           },
-          "name": "transformFn",
+          "name": "transformOptions",
           "optional": true,
           "type": {
-            "primitive": "any"
+            "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
           }
         },
         {
           "abstract": true,
           "docs": {
-            "remarks": "Please refer to the esbuild Transform API docs for details.",
-            "see": "https://esbuild.github.io/api/#transform-api",
+            "default": "new DefaultEsbuildProvider()",
+            "remarks": "Configure the default `EsbuildProvider` for more options or\nprovide a custom `ITransformProvider` as an escape hatch.",
             "stability": "stable",
-            "summary": "Transform options passed on to esbuild."
+            "summary": "The esbuild Transform API implementation to be used."
           },
           "immutable": true,
           "locationInModule": {
             "filename": "src/inline-code.ts",
-            "line": 16
+            "line": 30
           },
-          "name": "transformOptions",
+          "name": "transformProvider",
           "optional": true,
           "type": {
-            "fqn": "@mrgrain/cdk-esbuild.TransformOptions"
+            "fqn": "@mrgrain/cdk-esbuild.ITransformProvider"
           }
         }
       ],
       "symbolId": "src/inline-code:TransformerProps"
     },
+    "@mrgrain/cdk-esbuild.TsconfigOptions": {
+      "assembly": "@mrgrain/cdk-esbuild",
+      "datatype": true,
+      "docs": {
+        "stability": "stable"
+      },
+      "fqn": "@mrgrain/cdk-esbuild.TsconfigOptions",
+      "kind": "interface",
+      "locationInModule": {
+        "filename": "src/esbuild-types.ts",
+        "line": 611
+      },
+      "name": "TsconfigOptions",
+      "properties": [
+        {
+          "abstract": true,
+          "docs": {
+            "stability": "stable"
+          },
+          "immutable": true,
+          "locationInModule": {
+            "filename": "src/esbuild-types.ts",
+            "line": 612
+          },
+          "name": "compilerOptions",
+          "optional": true,
+          "type": {
+            "fqn": "@mrgrain/cdk-esbuild.CompilerOptions"
+          }
+        }
+      ],
+      "symbolId": "src/esbuild-types:TsconfigOptions"
+    },
     "@mrgrain/cdk-esbuild.TypeScriptAsset": {
       "assembly": "@mrgrain/cdk-esbuild",
       "base": "@mrgrain/cdk-esbuild.EsbuildAsset",
@@ -5990,7 +6920,7 @@
         },
         "locationInModule": {
           "filename": "src/asset.ts",
-          "line": 46
+          "line": 57
         },
         "parameters": [
           {
@@ -6016,7 +6946,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/asset.ts",
-        "line": 110
+        "line": 135
       },
       "name": "TypeScriptAsset",
       "symbolId": "src/asset:TypeScriptAsset"
@@ -6035,14 +6965,14 @@
         },
         "locationInModule": {
           "filename": "src/code.ts",
-          "line": 181
+          "line": 194
         },
         "parameters": [
           {
             "docs": {
-              "remarks": "E.g. `src/index.ts`.",
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
               "stability": "stable",
-              "summary": "A relative path or list or map of relative paths to the entry points of your code from the root of the project."
+              "summary": "A path or list or map of paths to the entry points of your code."
             },
             "name": "entryPoints",
             "type": {
@@ -6088,7 +7018,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 172
+        "line": 185
       },
       "methods": [
         {
@@ -6097,7 +7027,7 @@
           },
           "locationInModule": {
             "filename": "src/code.ts",
-            "line": 173
+            "line": 186
           },
           "name": "getAsset",
           "overrides": "@mrgrain/cdk-esbuild.EsbuildCode",
@@ -6133,7 +7063,7 @@
       "kind": "interface",
       "locationInModule": {
         "filename": "src/code.ts",
-        "line": 20
+        "line": 17
       },
       "name": "TypeScriptCodeProps",
       "properties": [
@@ -6170,10 +7100,15 @@
         },
         "locationInModule": {
           "filename": "src/source.ts",
-          "line": 103
+          "line": 154
         },
         "parameters": [
           {
+            "docs": {
+              "remarks": "Relative paths are by default resolved from the current working directory.\nTo change the working directory, see `buildOptions.absWorkingDir`.\n\nAbsolute paths can be used if files are part of the working directory.\n\nExamples:\n  - `'src/index.ts'`\n  - `require.resolve('./lambda')`\n  - `['src/index.ts', 'src/util.ts']`\n  - `{one: 'src/two.ts', two: 'src/one.ts'}`",
+              "stability": "stable",
+              "summary": "A path or list or map of paths to the entry points of your code."
+            },
             "name": "entryPoints",
             "type": {
               "union": {
@@ -6202,6 +7137,11 @@
             }
           },
           {
+            "docs": {
+              "remarks": "Default values for `props.buildOptions`:\n- `bundle=true`\n- `platform=browser`",
+              "stability": "stable",
+              "summary": "Props to change the behavior of the bundler."
+            },
             "name": "props",
             "optional": true,
             "type": {
@@ -6216,7 +7156,7 @@
       "kind": "class",
       "locationInModule": {
         "filename": "src/source.ts",
-        "line": 97
+        "line": 148
       },
       "methods": [
         {
@@ -6226,7 +7166,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 49
+            "line": 73
           },
           "name": "bind",
           "overrides": "aws-cdk-lib.aws_s3_deployment.ISource",
@@ -6283,7 +7223,7 @@
           },
           "locationInModule": {
             "filename": "src/source.ts",
-            "line": 101
+            "line": 152
           },
           "name": "assetClass",
           "type": {
@@ -6346,6 +7286,6 @@
       "symbolId": "src/source:TypeScriptSourceProps"
     }
   },
-  "version": "4.0.0-alpha.8",
-  "fingerprint": "8MURwY4BSmgsy1As8iitI7E981KW259pIKcdAY9BDuE="
-}
+  "version": "4.0.0-beta.1",
+  "fingerprint": "Ql2qf6q0czRFU4J09lF7FC76VwV5OlAcB4FrKmsRolU="
+}