Merge pull request #558 from stepchowfun/typescript-import-extension-default

Make TypeScript import extensions configurable

Author: stepchowfun

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.0] - 2026-07-09
+
+### Added
+- The `generate` subcommand now accepts `--typescript-import-extension` to configure relative import specifiers in generated TypeScript code.
+
+### Changed
+- The TypeScript generator now emits `.ts` import specifiers by default.
+
 ## [0.15.0] - 2026-04-22
 
 ### Changed

Cargo.lock

@@ -1,6 +1,6 @@
 [package]
 name = "typical"
-version = "0.15.0"
+version = "0.16.0"
 authors = ["Stephan Boyer <stephan@stephanboyer.com>"]
 edition = "2024"
 description = "Data interchange with algebraic data types."

Cargo.toml

@@ -697,11 +697,16 @@ Arguments:
   <SCHEMA_PATH>  Set the path to the schema
 
 Options:
-      --list-schemas       List the schemas imported by the given schema (and the given schema
-                           itself)
-      --rust-file <PATH>      Set the path to the Rust file to emit
-      --typescript-dir <PATH>  Set the directory in which the TypeScript files will be emitted
-  -h, --help               Print help
+      --list-schemas
+          List the schemas imported by the given schema (and the given schema itself)
+      --rust-file <PATH>
+          Set the path to the Rust file to emit
+      --typescript-dir <PATH>
+          Set the directory in which the TypeScript files will be emitted
+      --typescript-import-extension <EXTENSION>
+          Set the extension to use in TypeScript import specifiers [default: .ts]
+  -h, --help
+          Print help
 ```
 
 ## Installation instructions

README.md

@@ -1,6 +1,7 @@
 {
   "name": "benchmark",
   "version": "1.0.0",
+  "type": "module",
   "scripts": {
     "main": "npm run typical && rm -rf dist && tsc --project tsconfig.json && node dist/src/main.js",
     "lint": "npm run typical && vp check",

benchmarks/typescript/package-lock.json

@@ -1,6 +1,6 @@
 // oxlint-disable no-console -- The benchmark reports measurements to stdout.
 import { hrtime } from 'node:process';
-import { Message, Struct } from '../generated/types';
+import { Message, Struct } from '../generated/types.ts';
 
 const pathologicalIterations = 5_000;
 const massiveStringSize = 500_000_000;

benchmarks/typescript/package.json

@@ -7,6 +7,7 @@
     "types": ["node"],
     "erasableSyntaxOnly": true,
     "noFallthroughCasesInSwitch": true,
+    "rewriteRelativeImportExtensions": true,
     "skipLibCheck": true,
     "strict": true
   },

benchmarks/typescript/src/main.ts

@@ -1,6 +1,7 @@
 {
   "name": "example",
   "version": "1.0.0",
+  "type": "module",
   "scripts": {
     "main": "npm run typical && rm -rf dist && tsc --project tsconfig.json && node dist/src/main.js",
     "lint": "npm run typical && vp check",