KT ExtendScript Builder

KT ExtendScript Builder is a specialized tool designed to simplify the process of transpiling TypeScript code to ExtendScript for Adobe Creative Cloud applications. Built on Vite, it provides a streamlined workflow for developing, building, and testing ExtendScript code.

Quick Start

Installation

npm install kt-extendscript-builder --save-dev

Basic Usage

# Build your project
npx kt-build

# Development mode with watch
npx kt-build --mode development --watch

# Build tests
npx kt-build --test

Configuration

Configure your builds using command-line options or a kt-config.json file in your project root. Define multiple build profiles for different environments (development, production, testing) with custom settings for input/output paths, Adobe app targeting, and ponyfills.

Example kt-config.json:

{
  "default": {
    "input": "src/index.ts",
    "output": "dist/index.js",
    "mode": "production"
  },
  "dev": {
    "mode": "development",
    "watch": true
  }
}

Usage

Use KT ExtendScript Builder via command-line interface, integrate it into your npm scripts, or call it programmatically in Node.js scripts. Supports watch mode for development and test-specific builds.

Example npm scripts in package.json:

{
  "scripts": {
    "build": "kt-build",
    "dev": "kt-build dev",
    "test": "kt-build --test"
  }
}

Documentation

• Installation - Detailed installation instructions
• Configuration - Command-line options and configuration files
• Usage - CLI usage, npm scripts integration, and programmatic API
• Advanced Features - Custom ponyfills, Adobe targeting, and testing
• Examples - Code examples and use cases

Features

• TypeScript to ExtendScript transpilation
• ES3 target support for maximum compatibility with Adobe apps
• Development and production build modes
• Watch mode for real-time development
• Command-line interface for easy integration into workflows
• Custom ponyfills support for extending ExtendScript compatibility
• Adobe application type definitions integration
• Test-specific configuration support

Links

• KT Testing Suite Core
• KT Testing Suite AE
• Bolt CEP
• After Effects Scripting Guide
• Types for Adobe

License

MIT