ttsc 0.10.2 → 0.11.0-dev.20260517

package/src/structures/ITtscPluginContributor.ts

@@ -0,0 +1,27 @@
+/**
+ * One contributor entry inside `ITtscPlugin.contributors`.
+ *
+ * The native builder copies `source` into `<scratch>/contrib/<name>/` and adds
+ * a blank-import for `<host-module>/contrib/<name>` to the synthesized
+ * `ttsc_contributions.go` placed alongside the host's main package.
+ */
+export interface ITtscPluginContributor {
+  /**
+   * Sub-package name.
+   *
+   * Forms the final import path together with the host plugin's Go module path;
+   * must match `/^[a-z][a-z0-9_]*$/` — a lowercase ASCII letter followed by
+   * lowercase letters, digits, or underscores — and be unique within one plugin
+   * build.
+   */
+  name: string;
+
+  /**
+   * Absolute path to the contributor's Go source directory.
+   *
+   * Every `.go` file under this directory is copied into the scratch build tree
+   * as a sub-package of the host plugin's module. Subdirectories are copied
+   * recursively; `go.mod` files, `node_modules`, and `.git` are pruned.
+   */
+  source: string;
+}

package/src/structures/ITtscPluginFactoryContext.ts

@@ -10,8 +10,8 @@ import type { ITtscProjectPluginConfig } from "./ITtscProjectPluginConfig";
  * project root.
  *
  * The factory runs in Node.js while ttsc is loading `compilerOptions.plugins`.
- * It should only create the descriptor. Heavy validation and TypeScript-Go
- * work belong in the Go sidecar selected by {@link ITtscPlugin.source}.
+ * It should only create the descriptor. Heavy validation and TypeScript-Go work
+ * belong in the Go sidecar selected by {@link ITtscPlugin.source}.
  */
 export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
   /**
@@ -19,8 +19,8 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
    *
    * This is the package's own native helper, not the plugin sidecar and not the
    * JavaScript launcher. Most plugins do not need it; it is provided for
-   * advanced factories that need to derive behavior from the active ttsc
-   * native host.
+   * advanced factories that need to derive behavior from the active ttsc native
+   * host.
    */
   binary: string;
 
@@ -36,7 +36,7 @@ export interface ITtscPluginFactoryContext<T = ITtscProjectPluginConfig> {
   /**
    * Original `compilerOptions.plugins[]` entry that loaded this plugin.
    *
-   * ttsc reserves `transform` and `enabled`. Every other property is
+   * Ttsc reserves `transform` and `enabled`. Every other property is
    * plugin-owned config and is later serialized unchanged into the native
    * sidecar manifest.
    */

package/src/structures/ITtscProjectPluginConfig.ts

@@ -6,7 +6,7 @@
  * or plugin packages expose through `package.json`. ttsc deliberately keeps it
  * open-ended because plugin packages own their own config fields.
  *
- * ttsc interprets only two properties:
+ * Ttsc interprets only two properties:
  *
  * - `transform`: the JavaScript module specifier used to load the plugin
  *   descriptor or factory.
@@ -42,7 +42,7 @@ export interface ITtscProjectPluginConfig {
   /**
    * Plugin-specific config passed through unchanged to the native sidecar.
    *
-   * ttsc does not validate these fields. Plugin packages should document their
+   * Ttsc does not validate these fields. Plugin packages should document their
    * own config contract and validate it inside their factory or Go sidecar.
    */
   [key: string]: unknown;

package/src/structures/TtscPluginStage.ts

@@ -3,8 +3,9 @@
  *
  * - `"transform"`: participates in the TypeScript-Go transform path. Transform
  *   plugins do not receive emitted JavaScript or emitted file text.
- * - `"check"`: runs before emit and reports diagnostics only. Use this for
- *   lint or validation plugins that should fail the compile before JavaScript
- *   or declaration output is generated.
+ * - `"check"`: runs before emit and reports diagnostics. Use this for lint or
+ *   validation plugins that should fail the compile before JavaScript or
+ *   declaration output is generated. Check plugins may also implement a `fix`
+ *   command, which `ttsc fix` invokes with emit disabled.
  */
 export type TtscPluginStage = "transform" | "check";

package/src/structures/index.ts

@@ -3,6 +3,7 @@ export * from "./ITtscCompilerDiagnostic";
 export * from "./ITtscCompilerResult";
 export * from "./ITtscCompilerTransformation";
 export * from "./ITtscPlugin";
+export * from "./ITtscPluginContributor";
 export * from "./ITtscPluginFactoryContext";
 export * from "./ITtscProjectPluginConfig";
 export * from "./TtscPluginStage";

package/src/structures/internal/ITtscLoadedNativePlugin.ts

@@ -1,3 +1,4 @@
+import type { ITtscPluginContributor } from "../ITtscPluginContributor";
 import type { ITtscProjectPluginConfig } from "../ITtscProjectPluginConfig";
 import type { TtscPluginStage } from "../TtscPluginStage";
 
@@ -7,6 +8,8 @@ export interface ITtscLoadedNativePlugin {
   binary: string;
   /** Original tsconfig plugin entry passed unchanged to the sidecar. */
   config: ITtscProjectPluginConfig;
+  /** Contributor Go sources statically linked into the binary, if any. */
+  contributors?: readonly ITtscPluginContributor[];
   /** Stable plugin name used in diagnostics and native manifests. */
   name: string;
   /** Go source directory selected by the plugin descriptor. */

package/src/structures/internal/TtscBuildOptions.ts

@@ -12,6 +12,19 @@ export interface TtscBuildOptions extends TtscCommonOptions {
    * - `undefined`: follow the resolved tsconfig exactly.
    */
   emit?: boolean;
+  /**
+   * Invoke fix-capable check-stage plugins before the final no-emit check.
+   * Source files may be rewritten; JavaScript/declaration emit stays disabled.
+   */
+  fix?: boolean;
+  /**
+   * Invoke format-capable check-stage plugins. Source files may be rewritten
+   * with formatter-class edits (whitespace, punctuation, ordering); diagnostics
+   * are not reported and JavaScript/declaration emit stays disabled. The
+   * launcher selects this through the `ttsc format` subcommand and rejects
+   * combination with watch mode, single-file mode, or an explicit `--emit`.
+   */
+  format?: boolean;
   /** Per-call TypeScript-Go `outDir` override. */
   outDir?: string;
   /** Suppress summary banners from ttsc/native sidecars. Defaults to `true`. */

package/src/structures/internal/TtscCommonOptions.ts

@@ -1,6 +1,9 @@
 import type { ITtscProjectPluginConfig } from "../ITtscProjectPluginConfig";
 
-/** Internal options shared by the CLI build, single-file emit, and runtime paths. */
+/**
+ * Internal options shared by the CLI build, single-file emit, and runtime
+ * paths.
+ */
 export interface TtscCommonOptions {
   /**
    * Explicit TypeScript-Go executable.
@@ -23,7 +26,7 @@ export interface TtscCommonOptions {
    * Override project plugin loading for this invocation.
    *
    * - `false`: ignore `compilerOptions.plugins` completely.
-   * - array: use these plugin entries instead of the project config entries.
+   * - Array: use these plugin entries instead of the project config entries.
    * - `undefined`: use the project config entries as written.
    */
   plugins?: readonly ITtscProjectPluginConfig[] | false;