@ttsc/banner 0.12.3 → 0.13.0

package/README.md

@@ -20,45 +20,56 @@ npm install -D ttsc @typescript/native-preview
 npm install -D @ttsc/banner
 ```
 
-Pass the banner text inline on the `compilerOptions.plugins[]` entry:
+Register the plugin in your `tsconfig.json`:
 
 ```jsonc
 // tsconfig.json
 {
   "compilerOptions": {
     "plugins": [
-      { "transform": "@ttsc/banner", "text": "License MIT (c) 2026 Acme" }
+      { "transform": "@ttsc/banner" }
     ]
   }
 }
 ```
 
-Or keep the text in a separate file `banner.config.ts` next to your tsconfig:
+Drop a `banner.config.ts` next to your `tsconfig.json`:
 
 ```ts
 // banner.config.ts
-import type { TtscBannerConfig } from "@ttsc/banner";
+import type { ITtscBannerConfig } from "@ttsc/banner";
 
 export default {
   text: "License MIT (c) 2026 Acme",
-} satisfies TtscBannerConfig;
+} satisfies ITtscBannerConfig;
 ```
 
+A `banner.config.*` file always exports an object with a `text` string.
+
 Run your normal `ttsc` command:
 
 ```bash
 npx ttsc
 ```
 
-If `@ttsc/banner` is installed and none of the three text sources (inline `text:`, `config:` path, or an auto-discovered `banner.config.*`) yields a banner, the compile fails.
+If `@ttsc/banner` is installed and no `banner.config.*` file is found, the compile fails.
 
 ## Configuration
 
-`@ttsc/banner` resolves its text in this order:
+`@ttsc/banner` discovers its config by walking upward from the tsconfig directory, looking for `banner.config.{ts,cts,mts,js,cjs,mjs,json}`.
+
+To point at a specific file instead of using auto-discovery, set `configFile` on the tsconfig entry:
 
-1. the entry's inline `text` string;
-2. the entry's `config: "./path/to/banner.config.ts"` path;
-3. an upward walk for any `banner.config.{js,cjs,mjs,ts,mts,cts}` starting from the tsconfig directory.
+```jsonc
+// tsconfig.json
+{
+  "compilerOptions": {
+    "plugins": [
+      { "transform": "@ttsc/banner", "configFile": "./config/banner.config.ts" }
+    ]
+  }
+}
+```
 
 The plugin formats every line of the resolved text inside a JSDoc block and appends `@packageDocumentation`.
 

package/driver/banner.go

@@ -1,215 +1,297 @@
 package banner
 
 import (
-	"encoding/json"
-	"fmt"
-	"os"
-	"os/exec"
-	"path/filepath"
-	"strings"
-
-	"github.com/samchon/ttsc/packages/ttsc/driver"
+  "bytes"
+  "encoding/json"
+  "fmt"
+  "os"
+  "os/exec"
+  "path/filepath"
+  "strings"
+
+  "github.com/samchon/ttsc/packages/ttsc/driver"
 )
 
 func init() {
-	driver.RegisterPlugin(plugin{})
+  driver.RegisterPlugin(plugin{})
 }
 
+// plugin implements driver.SourcePreamblePlugin for @ttsc/banner.
 type plugin struct{}
 
 var (
-	linkConfigNodeModules = linkNearestNodeModules
-	writeConfigLoaderFile = os.WriteFile
+  // linkConfigNodeModules is overridable in tests to avoid real symlink creation.
+  linkConfigNodeModules = linkNearestNodeModules
+  // writeConfigLoaderFile is overridable in tests to avoid real file I/O.
+  writeConfigLoaderFile = os.WriteFile
 )
 
+// frameworkKeys lists the tsconfig plugin-entry keys that the ttsc host
+// framework owns. They are accepted without error; all other keys are rejected.
+var frameworkKeys = map[string]struct{}{
+  "enabled":   {},
+  "name":      {},
+  "stage":     {},
+  "transform": {},
+}
+
+// validateBannerConfig rejects any tsconfig plugin entry key that is not a
+// known framework key and is not the single banner-specific "configFile" key.
+func validateBannerConfig(config map[string]any) error {
+  for key := range config {
+    if _, ok := frameworkKeys[key]; ok {
+      continue
+    }
+    if key == "configFile" {
+      continue
+    }
+    return fmt.Errorf(
+      "@ttsc/banner: tsconfig plugin entry contains unsupported key %q. "+
+        "Banner options must be placed in a banner.config.{ts,cts,mts,js,cjs,mjs,json} file. "+
+        "The only accepted key in the tsconfig entry is \"configFile\" (optional path to the config file).",
+      key,
+    )
+  }
+  return nil
+}
+
+// SourcePreamble resolves the banner text from the plugin config and returns it
+// formatted as a JSDoc block comment suitable for prepending to each emitted file.
 func (plugin) SourcePreamble(ctx driver.PluginContext) (string, error) {
-	return parseBanner(ctx.Entry.Config, ctx.Cwd, ctx.Tsconfig)
+  return parseBanner(ctx.Entry.Config, ctx.Cwd, ctx.Tsconfig)
 }
 
+// parseBanner resolves and formats banner text into a JSDoc block comment.
+// Trailing blank lines are stripped from the resolved text before formatting.
 func parseBanner(config map[string]any, cwd, tsconfigPath string) (string, error) {
-	text, err := resolveBannerText(config, cwd, tsconfigPath)
-	if err != nil {
-		return "", err
-	}
-	lines := strings.Split(strings.ReplaceAll(text, "\r\n", "\n"), "\n")
-	for len(lines) > 0 && strings.TrimSpace(lines[len(lines)-1]) == "" {
-		lines = lines[:len(lines)-1]
-	}
-	var b strings.Builder
-	sep := strings.Repeat("-", 64)
-	b.WriteString("/**\n")
-	b.WriteString(" * ")
-	b.WriteString(sep)
-	b.WriteByte('\n')
-	for _, line := range lines {
-		b.WriteString(" * ")
-		b.WriteString(sanitizeJSDocLine(line))
-		b.WriteByte('\n')
-	}
-	b.WriteString(" *\n")
-	b.WriteString(" * @packageDocumentation\n ")
-	b.WriteString("*/\n")
-	return b.String(), nil
+  text, err := resolveBannerText(config, cwd, tsconfigPath)
+  if err != nil {
+    return "", err
+  }
+  lines := strings.Split(strings.ReplaceAll(text, "\r\n", "\n"), "\n")
+  for len(lines) > 0 && strings.TrimSpace(lines[len(lines)-1]) == "" {
+    lines = lines[:len(lines)-1]
+  }
+  var b strings.Builder
+  sep := strings.Repeat("-", 64)
+  b.WriteString("/**\n")
+  b.WriteString(" * ")
+  b.WriteString(sep)
+  b.WriteByte('\n')
+  for _, line := range lines {
+    b.WriteString(" * ")
+    b.WriteString(sanitizeJSDocLine(line))
+    b.WriteByte('\n')
+  }
+  b.WriteString(" *\n")
+  b.WriteString(" * @packageDocumentation\n ")
+  b.WriteString("*/\n")
+  return b.String(), nil
 }
 
+// resolveBannerText extracts the banner text from the plugin config.
+// The config entry is validated first: only the "configFile" key (plus
+// framework keys) is accepted. When "configFile" is present its value is
+// resolved to an absolute path and loaded. When absent the upward-walk
+// discovery is used. Returns an error when the config is invalid or when
+// no banner text can be found.
 func resolveBannerText(config map[string]any, cwd, tsconfigPath string) (string, error) {
-	if text, ok, err := bannerTextFromConfigValue(config["text"], `"text"`); ok || err != nil {
-		return text, err
-	}
-	if rawConfigPath, ok := config["config"]; ok {
-		configPath, ok := rawConfigPath.(string)
-		if !ok || strings.TrimSpace(configPath) == "" {
-			return "", fmt.Errorf("@ttsc/banner: \"config\" must be a non-empty string path")
-		}
-		location := resolveBannerConfigPath(configPath, cwd, tsconfigPath)
-		raw, err := loadBannerConfigFile(location)
-		if err != nil {
-			return "", err
-		}
-		text, ok, err := bannerTextFromConfigValue(raw, filepath.Base(location))
-		if err != nil {
-			return "", err
-		}
-		if !ok {
-			return "", fmt.Errorf("@ttsc/banner: %s must export a non-empty string or an object with a non-empty \"text\" string", location)
-		}
-		return text, nil
-	}
-	location, err := findBannerConfigFile(cwd, tsconfigPath)
-	if err != nil {
-		return "", err
-	}
-	if location == "" {
-		return "", fmt.Errorf("@ttsc/banner: \"text\" must be a non-empty string or a banner.config.{js,cjs,mjs,ts,mts,cts} file must exist")
-	}
-	raw, err := loadBannerConfigFile(location)
-	if err != nil {
-		return "", err
-	}
-	text, ok, err := bannerTextFromConfigValue(raw, filepath.Base(location))
-	if err != nil {
-		return "", err
-	}
-	if !ok {
-		return "", fmt.Errorf("@ttsc/banner: %s must export a non-empty string or an object with a non-empty \"text\" string", location)
-	}
-	return text, nil
+  if err := validateBannerConfig(config); err != nil {
+    return "", err
+  }
+
+  if rawConfigFile, ok := config["configFile"]; ok {
+    configFile, ok := rawConfigFile.(string)
+    if !ok || strings.TrimSpace(configFile) == "" {
+      return "", fmt.Errorf("@ttsc/banner: \"configFile\" must be a non-empty string path")
+    }
+    location := resolveBannerConfigPath(configFile, cwd, tsconfigPath)
+    raw, err := loadBannerConfigFile(location)
+    if err != nil {
+      return "", err
+    }
+    text, ok, err := bannerTextFromConfigValue(raw, filepath.Base(location))
+    if err != nil {
+      return "", err
+    }
+    if !ok {
+      return "", fmt.Errorf("@ttsc/banner: %s must export an object with a non-empty \"text\" string", location)
+    }
+    return text, nil
+  }
+
+  location, err := findBannerConfigFile(cwd, tsconfigPath)
+  if err != nil {
+    return "", err
+  }
+  if location == "" {
+    return "", fmt.Errorf("@ttsc/banner: no banner.config.{ts,cts,mts,js,cjs,mjs,json} file found; create one or set \"configFile\" in the tsconfig plugin entry")
+  }
+  raw, err := loadBannerConfigFile(location)
+  if err != nil {
+    return "", err
+  }
+  text, ok, err := bannerTextFromConfigValue(raw, filepath.Base(location))
+  if err != nil {
+    return "", err
+  }
+  if !ok {
+    return "", fmt.Errorf("@ttsc/banner: %s must export an object with a non-empty \"text\" string", location)
+  }
+  return text, nil
 }
 
+// bannerTextFromConfigValue extracts a banner text string from a config value.
+// A banner config value must be an object with a non-empty "text" string; raw
+// may also be nil (not present). Returns (text, true, nil) on success,
+// ("", false, nil) when absent, or ("", true, err) on a type mismatch. label is
+// used in error messages and is the config file's base name (e.g.
+// "banner.config.json").
 func bannerTextFromConfigValue(raw any, label string) (string, bool, error) {
-	if raw == nil {
-		return "", false, nil
-	}
-	text, ok := raw.(string)
-	if ok {
-		if strings.TrimSpace(text) == "" {
-			return "", true, fmt.Errorf("@ttsc/banner: %s must be a non-empty string", label)
-		}
-		return text, true, nil
-	}
-	object, ok := raw.(map[string]any)
-	if !ok {
-		return "", true, fmt.Errorf("@ttsc/banner: %s must be a string or an object with a non-empty \"text\" string", label)
-	}
-	rawText, ok := object["text"]
-	if !ok {
-		return "", false, nil
-	}
-	text, ok = rawText.(string)
-	if !ok || strings.TrimSpace(text) == "" {
-		return "", true, fmt.Errorf("@ttsc/banner: %s.text must be a non-empty string", label)
-	}
-	return text, true, nil
+  if raw == nil {
+    return "", false, nil
+  }
+  object, ok := raw.(map[string]any)
+  if !ok {
+    return "", true, fmt.Errorf("@ttsc/banner: %s must be an object with a non-empty \"text\" string", label)
+  }
+  rawText, ok := object["text"]
+  if !ok {
+    return "", false, nil
+  }
+  text, ok := rawText.(string)
+  if !ok || strings.TrimSpace(text) == "" {
+    return "", true, fmt.Errorf("@ttsc/banner: %s.text must be a non-empty string", label)
+  }
+  return text, true, nil
 }
 
+// findBannerConfigFile walks up from the tsconfig (or cwd) directory looking for
+// a banner.config.{ts,cts,mts,js,cjs,mjs,json} file. Returns the path when exactly
+// one match is found per directory, "" when none exists at any level, or an
+// error when multiple candidates exist in the same directory.
 func findBannerConfigFile(cwd, tsconfigPath string) (string, error) {
-	dir := discoveryConfigBaseDir(cwd, tsconfigPath)
-	for {
-		matches := make([]string, 0, 1)
-		for _, name := range []string{
-			"banner.config.js",
-			"banner.config.cjs",
-			"banner.config.mjs",
-			"banner.config.ts",
-			"banner.config.cts",
-			"banner.config.mts",
-		} {
-			candidate := filepath.Join(dir, name)
-			if stat, err := os.Stat(candidate); err == nil && !stat.IsDir() {
-				matches = append(matches, candidate)
-			}
-		}
-		if len(matches) > 1 {
-			return "", fmt.Errorf("@ttsc/banner: multiple banner.config.* files found in %s", dir)
-		}
-		if len(matches) == 1 {
-			return matches[0], nil
-		}
-		parent := filepath.Dir(dir)
-		if parent == dir {
-			return "", nil
-		}
-		dir = parent
-	}
+  dir := tsconfigBaseDir(cwd, tsconfigPath)
+  for {
+    matches := make([]string, 0, 1)
+    for _, name := range []string{
+      "banner.config.json",
+      "banner.config.js",
+      "banner.config.cjs",
+      "banner.config.mjs",
+      "banner.config.ts",
+      "banner.config.cts",
+      "banner.config.mts",
+    } {
+      candidate := filepath.Join(dir, name)
+      if stat, err := os.Stat(candidate); err == nil && !stat.IsDir() {
+        matches = append(matches, candidate)
+      }
+    }
+    if len(matches) > 1 {
+      names := make([]string, len(matches))
+      for i, match := range matches {
+        names[i] = filepath.Base(match)
+      }
+      return "", fmt.Errorf(
+        "@ttsc/banner: multiple banner config files found in %s (%s); set \"configFile\" explicitly in the tsconfig plugin entry",
+        dir, strings.Join(names, ", "),
+      )
+    }
+    if len(matches) == 1 {
+      return matches[0], nil
+    }
+    parent := filepath.Dir(dir)
+    if parent == dir {
+      return "", nil
+    }
+    dir = parent
+  }
 }
 
+// resolveBannerConfigPath resolves a config path from the plugin entry.
+// Absolute paths are returned as-is; relative paths are resolved against the
+// tsconfig directory (or cwd when no tsconfig is set).
 func resolveBannerConfigPath(configPath, cwd, tsconfigPath string) string {
-	if filepath.IsAbs(configPath) {
-		return configPath
-	}
-	return filepath.Join(tsconfigBaseDir(cwd, tsconfigPath), configPath)
+  if filepath.IsAbs(configPath) {
+    return configPath
+  }
+  return filepath.Join(tsconfigBaseDir(cwd, tsconfigPath), configPath)
 }
 
+// tsconfigBaseDir returns the directory that contains the tsconfig file, or cwd
+// when tsconfigPath is empty. It is the base both for resolving an explicit
+// `configFile` path and for starting the upward banner-config-file search.
 func tsconfigBaseDir(cwd, tsconfigPath string) string {
-	if tsconfigPath == "" {
-		return cwd
-	}
-	resolvedTsconfig := tsconfigPath
-	if !filepath.IsAbs(resolvedTsconfig) {
-		resolvedTsconfig = filepath.Join(cwd, resolvedTsconfig)
-	}
-	return filepath.Dir(resolvedTsconfig)
-}
-
-func discoveryConfigBaseDir(cwd, tsconfigPath string) string {
-	if tsconfigPath != "" {
-		resolvedTsconfig := tsconfigPath
-		if !filepath.IsAbs(resolvedTsconfig) {
-			resolvedTsconfig = filepath.Join(cwd, resolvedTsconfig)
-		}
-		return filepath.Dir(resolvedTsconfig)
-	}
-	return cwd
+  if tsconfigPath == "" {
+    return cwd
+  }
+  resolvedTsconfig := tsconfigPath
+  if !filepath.IsAbs(resolvedTsconfig) {
+    resolvedTsconfig = filepath.Join(cwd, resolvedTsconfig)
+  }
+  return filepath.Dir(resolvedTsconfig)
 }
 
+// loadBannerConfigFile loads and evaluates a banner config file, returning its
+// exported value as a Go any. A valid banner config exports an object with a
+// "text" string; the value is validated by bannerTextFromConfigValue. The file
+// must be named banner.config.{ts,cts,mts,js,cjs,mjs,json}; JS/CJS/MJS variants
+// run under Node, TypeScript variants compile and run via ttsx in a temp
+// directory, and JSON files are parsed natively.
 func loadBannerConfigFile(location string) (any, error) {
-	if !isBannerConfigFileName(filepath.Base(location)) {
-		return nil, fmt.Errorf("@ttsc/banner: config file must be named banner.config.{js,cjs,mjs,ts,mts,cts}: %s", location)
-	}
-	ext := strings.ToLower(filepath.Ext(location))
-	switch ext {
-	case ".js", ".cjs", ".mjs":
-		return loadBannerScriptConfigFile(location)
-	}
-	return loadBannerTypeScriptConfigFile(location)
+  if !isBannerConfigFileName(filepath.Base(location)) {
+    return nil, fmt.Errorf("@ttsc/banner: config file must be named banner.config.{ts,cts,mts,js,cjs,mjs,json}: %s", location)
+  }
+  ext := strings.ToLower(filepath.Ext(location))
+  switch ext {
+  case ".json":
+    return loadBannerJSONConfigFile(location)
+  case ".js", ".cjs", ".mjs":
+    return loadBannerScriptConfigFile(location)
+  }
+  return loadBannerTypeScriptConfigFile(location)
 }
 
+// isBannerConfigFileName reports whether name is an allowed banner config file name.
 func isBannerConfigFileName(name string) bool {
-	switch name {
-	case "banner.config.js",
-		"banner.config.cjs",
-		"banner.config.mjs",
-		"banner.config.ts",
-		"banner.config.cts",
-		"banner.config.mts":
-		return true
-	default:
-		return false
-	}
+  switch name {
+  case "banner.config.json",
+    "banner.config.js",
+    "banner.config.cjs",
+    "banner.config.mjs",
+    "banner.config.ts",
+    "banner.config.cts",
+    "banner.config.mts":
+    return true
+  default:
+    return false
+  }
+}
+
+// loadBannerJSONConfigFile reads and JSON-parses a banner config file. A leading
+// UTF-8 BOM is stripped before parsing so files saved by Windows editors are
+// accepted. The parsed value must be an object with a non-empty "text" string.
+func loadBannerJSONConfigFile(location string) (any, error) {
+  body, err := os.ReadFile(location)
+  if err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: read config file %s: %w", location, err)
+  }
+  // Strip a leading UTF-8 BOM so files saved by Windows editors round
+  // trip through json.Unmarshal without an opaque "invalid character" failure.
+  body = bytes.TrimPrefix(body, []byte{0xEF, 0xBB, 0xBF})
+  var out any
+  if err := json.Unmarshal(body, &out); err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: parse config file %s: %w", location, err)
+  }
+  return out, nil
 }
 
+// loadBannerScriptConfigFile evaluates a JS/CJS/MJS banner config file by
+// running a small Node.js loader script that dynamic-imports the file and
+// serializes its exported value to stdout as JSON.
 func loadBannerScriptConfigFile(location string) (any, error) {
-	const script = `
+  const script = `
 const { pathToFileURL } = require("node:url");
 
 (async () => {
@@ -223,108 +305,116 @@ const { pathToFileURL } = require("node:url");
 });
 
 function toSerializableBanner(value) {
-  if (typeof value === "string") {
-    return value;
-  }
   if (value !== null && typeof value === "object" && typeof value.text === "string") {
     return { text: value.text };
   }
-  throw new Error("config file must export a string or an object with a text string");
+  throw new Error("config file must export an object with a non-empty \"text\" string");
 }
 `
-	node := os.Getenv("TTSC_NODE_BINARY")
-	if node == "" {
-		node = "node"
-	}
-	cmd := exec.Command(node, "-e", script, location)
-	cmd.Env = nodeConfigLoaderEnv(location)
-	output, err := cmd.Output()
-	if err != nil {
-		stderr := ""
-		if exit, ok := err.(*exec.ExitError); ok {
-			stderr = strings.TrimSpace(string(exit.Stderr))
-		}
-		if stderr != "" {
-			return nil, fmt.Errorf("@ttsc/banner: load config file %s: %s", location, stderr)
-		}
-		return nil, fmt.Errorf("@ttsc/banner: load config file %s: %w", location, err)
-	}
-	var out any
-	if err := json.Unmarshal(output, &out); err != nil {
-		return nil, fmt.Errorf("@ttsc/banner: parse config file %s output: %w", location, err)
-	}
-	return out, nil
+  node := os.Getenv("TTSC_NODE_BINARY")
+  if node == "" {
+    node = "node"
+  }
+  cmd := exec.Command(node, "-e", script, location)
+  cmd.Env = nodeConfigLoaderEnv(location)
+  output, err := cmd.Output()
+  if err != nil {
+    stderr := ""
+    if exit, ok := err.(*exec.ExitError); ok {
+      stderr = strings.TrimSpace(string(exit.Stderr))
+    }
+    if stderr != "" {
+      return nil, fmt.Errorf("@ttsc/banner: load config file %s: %s", location, stderr)
+    }
+    return nil, fmt.Errorf("@ttsc/banner: load config file %s: %w", location, err)
+  }
+  var out any
+  if err := json.Unmarshal(output, &out); err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: parse config file %s output: %w", location, err)
+  }
+  return out, nil
 }
 
+// loadBannerTypeScriptConfigFile compiles and runs a TypeScript banner config
+// file using ttsx in a temp directory. A symlink to the nearest node_modules
+// is created so the config file can import its own dependencies. The ttsx
+// build runs with `--no-plugins` so evaluating the config never triggers the
+// host project's transform/check plugins against the loader tsconfig.
 func loadBannerTypeScriptConfigFile(location string) (any, error) {
-	tempDir, err := os.MkdirTemp("", "ttsc-banner-config-")
-	if err != nil {
-		return nil, fmt.Errorf("@ttsc/banner: create config loader tempdir: %w", err)
-	}
-	defer os.RemoveAll(tempDir)
-
-	if err := linkConfigNodeModules(tempDir, filepath.Dir(location)); err != nil {
-		return nil, err
-	}
-
-	loader := filepath.Join(tempDir, "loader.mts")
-	tsconfig := filepath.Join(tempDir, "tsconfig.json")
-	importSpecifier, err := relativeImportSpecifier(tempDir, location)
-	if err != nil {
-		return nil, err
-	}
-	importLiteral, _ := json.Marshal(importSpecifier)
-	if err := writeConfigLoaderFile(loader, []byte(bannerTypeScriptConfigLoaderSource(string(importLiteral))), 0o644); err != nil {
-		return nil, fmt.Errorf("@ttsc/banner: write config loader: %w", err)
-	}
-	if err := writeConfigLoaderFile(tsconfig, []byte(typeScriptConfigLoaderTsconfig(loader, location, tempDir)), 0o644); err != nil {
-		return nil, fmt.Errorf("@ttsc/banner: write config loader tsconfig: %w", err)
-	}
-
-	args := []string{
-		"--project", tsconfig,
-		"--cwd", tempDir,
-		"--cache-dir", filepath.Join(tempDir, "cache"),
-	}
-	if tsgo := os.Getenv("TTSC_TSGO_BINARY"); tsgo != "" {
-		args = append(args, "--binary", tsgo)
-	}
-	args = append(args, loader)
-
-	cmd := ttsxCommand(args...)
-	cmd.Env = nodeConfigLoaderEnv(location)
-	output, err := cmd.Output()
-	if err != nil {
-		stderr := ""
-		if exit, ok := err.(*exec.ExitError); ok {
-			stderr = strings.TrimSpace(string(exit.Stderr))
-		}
-		if stderr != "" {
-			return nil, fmt.Errorf("@ttsc/banner: load TypeScript config file %s: %s", location, stderr)
-		}
-		return nil, fmt.Errorf("@ttsc/banner: load TypeScript config file %s: %w", location, err)
-	}
-	var out any
-	if err := json.Unmarshal(output, &out); err != nil {
-		return nil, fmt.Errorf("@ttsc/banner: parse TypeScript config file %s output: %w", location, err)
-	}
-	return out, nil
+  tempDir, err := os.MkdirTemp("", "ttsc-banner-config-")
+  if err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: create config loader tempdir: %w", err)
+  }
+  defer os.RemoveAll(tempDir)
+
+  if err := linkConfigNodeModules(tempDir, filepath.Dir(location)); err != nil {
+    return nil, err
+  }
+
+  loader := filepath.Join(tempDir, "loader.mts")
+  tsconfig := filepath.Join(tempDir, "tsconfig.json")
+  importSpecifier, err := relativeImportSpecifier(tempDir, location)
+  if err != nil {
+    return nil, err
+  }
+  importLiteral, _ := json.Marshal(importSpecifier)
+  if err := writeConfigLoaderFile(loader, []byte(bannerTypeScriptConfigLoaderSource(string(importLiteral))), 0o644); err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: write config loader: %w", err)
+  }
+  if err := writeConfigLoaderFile(tsconfig, []byte(typeScriptConfigLoaderTsconfig(loader, location, tempDir)), 0o644); err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: write config loader tsconfig: %w", err)
+  }
+
+  args := []string{
+    "--project", tsconfig,
+    "--cwd", tempDir,
+    "--cache-dir", filepath.Join(tempDir, "cache"),
+    "--no-plugins",
+  }
+  if tsgo := os.Getenv("TTSC_TSGO_BINARY"); tsgo != "" {
+    args = append(args, "--binary", tsgo)
+  }
+  args = append(args, loader)
+
+  cmd := ttsxCommand(args...)
+  cmd.Env = nodeConfigLoaderEnv(location)
+  output, err := cmd.Output()
+  if err != nil {
+    stderr := ""
+    if exit, ok := err.(*exec.ExitError); ok {
+      stderr = strings.TrimSpace(string(exit.Stderr))
+    }
+    if stderr != "" {
+      return nil, fmt.Errorf("@ttsc/banner: load TypeScript config file %s: %s", location, stderr)
+    }
+    return nil, fmt.Errorf("@ttsc/banner: load TypeScript config file %s: %w", location, err)
+  }
+  var out any
+  if err := json.Unmarshal(output, &out); err != nil {
+    return nil, fmt.Errorf("@ttsc/banner: parse TypeScript config file %s output: %w", location, err)
+  }
+  return out, nil
 }
 
+// relativeImportSpecifier returns a "./" or "../"-prefixed slash-separated
+// import specifier for location relative to fromDir.
 func relativeImportSpecifier(fromDir, location string) (string, error) {
-	relative, err := filepath.Rel(fromDir, location)
-	if err != nil {
-		return "", fmt.Errorf("@ttsc/banner: resolve relative config import %s: %w", location, err)
-	}
-	relative = filepath.ToSlash(relative)
-	if strings.HasPrefix(relative, "../") || strings.HasPrefix(relative, "./") {
-		return relative, nil
-	}
-	return "./" + relative, nil
+  relative, err := filepath.Rel(fromDir, location)
+  if err != nil {
+    return "", fmt.Errorf("@ttsc/banner: resolve relative config import %s: %w", location, err)
+  }
+  relative = filepath.ToSlash(relative)
+  if strings.HasPrefix(relative, "../") || strings.HasPrefix(relative, "./") {
+    return relative, nil
+  }
+  return "./" + relative, nil
 }
 
+// bannerTypeScriptConfigLoaderSource returns the source of a TypeScript loader
+// module that imports the banner config file specified by importLiteral (a
+// JSON-encoded import specifier) and writes the serialized banner value to stdout.
 func bannerTypeScriptConfigLoaderSource(importLiteral string) string {
-	return fmt.Sprintf(`import * as importedConfig from %s;
+  return fmt.Sprintf(`import * as importedConfig from %s;
 
 declare const process: {
   stdout: { write(value: string): void };
@@ -364,116 +454,131 @@ function hasOwn(value: Record<string, unknown>, key: string): boolean {
 }
 
 function toSerializableBanner(value: unknown): unknown {
-  if (typeof value === "string") {
-    return value;
-  }
   if (isObject(value) && typeof value.text === "string") {
     return { text: value.text };
   }
-  throw new Error("config file must export a string or an object with a text string");
+  throw new Error("config file must export an object with a non-empty \"text\" string");
 }
 `, importLiteral)
 }
 
+// typeScriptConfigLoaderTsconfig returns the JSON content of a tsconfig that
+// compiles loader and location together so ttsx can execute the loader.
 func typeScriptConfigLoaderTsconfig(loader, location, outDir string) string {
-	content := map[string]any{
-		"compilerOptions": map[string]any{
-			"allowImportingTsExtensions":      true,
-			"module":                          "ESNext",
-			"moduleResolution":                "bundler",
-			"outDir":                          filepath.ToSlash(filepath.Join(outDir, "out")),
-			"rewriteRelativeImportExtensions": true,
-			"rootDir":                         "/",
-			"skipLibCheck":                    true,
-			"strict":                          true,
-			"target":                          "ES2022",
-		},
-		"files": []string{
-			filepath.ToSlash(loader),
-			filepath.ToSlash(location),
-		},
-	}
-	body, _ := json.MarshalIndent(content, "", "  ")
-	return string(body)
+  content := map[string]any{
+    "compilerOptions": map[string]any{
+      "allowImportingTsExtensions":      true,
+      "module":                          "ESNext",
+      "moduleResolution":                "bundler",
+      "outDir":                          filepath.ToSlash(filepath.Join(outDir, "out")),
+      "rewriteRelativeImportExtensions": true,
+      "rootDir":                         "/",
+      "skipLibCheck":                    true,
+      "strict":                          true,
+      "target":                          "ES2022",
+    },
+    "files": []string{
+      filepath.ToSlash(loader),
+      filepath.ToSlash(location),
+    },
+  }
+  body, _ := json.MarshalIndent(content, "", "  ")
+  return string(body)
 }
 
+// ttsxCommand builds an exec.Cmd that runs ttsx with the given args.
+// When TTSC_TTSX_BINARY has a script extension (.js, .ts, …) the binary is
+// invoked via the Node runtime so it is executed correctly on all platforms.
 func ttsxCommand(args ...string) *exec.Cmd {
-	ttsx := os.Getenv("TTSC_TTSX_BINARY")
-	if ttsx == "" {
-		ttsx = "ttsx"
-	}
-	if shouldRunTtsxThroughNode(ttsx) {
-		node := os.Getenv("TTSC_NODE_BINARY")
-		if node == "" {
-			node = "node"
-		}
-		return exec.Command(node, append([]string{ttsx}, args...)...)
-	}
-	return exec.Command(ttsx, args...)
+  ttsx := os.Getenv("TTSC_TTSX_BINARY")
+  if ttsx == "" {
+    ttsx = "ttsx"
+  }
+  if shouldRunTtsxThroughNode(ttsx) {
+    node := os.Getenv("TTSC_NODE_BINARY")
+    if node == "" {
+      node = "node"
+    }
+    return exec.Command(node, append([]string{ttsx}, args...)...)
+  }
+  return exec.Command(ttsx, args...)
 }
 
+// shouldRunTtsxThroughNode reports whether binary has a script file extension
+// and therefore must be launched via node rather than executed directly.
 func shouldRunTtsxThroughNode(binary string) bool {
-	switch strings.ToLower(filepath.Ext(binary)) {
-	case ".js", ".cjs", ".mjs", ".ts", ".cts", ".mts":
-		return true
-	default:
-		return false
-	}
+  switch strings.ToLower(filepath.Ext(binary)) {
+  case ".js", ".cjs", ".mjs", ".ts", ".cts", ".mts":
+    return true
+  default:
+    return false
+  }
 }
 
+// nodeConfigLoaderEnv builds an environment slice for the config-loader Node
+// process. It prepends the nearest node_modules directory to NODE_PATH so
+// the config file can resolve its own package dependencies.
 func nodeConfigLoaderEnv(location string) []string {
-	env := os.Environ()
-	parts := make([]string, 0, 2)
-	if nodeModules := findNearestNodeModules(filepath.Dir(location)); nodeModules != "" {
-		parts = append(parts, nodeModules)
-	}
-	if existing := os.Getenv("NODE_PATH"); existing != "" {
-		parts = append(parts, existing)
-	}
-	if len(parts) == 0 {
-		return env
-	}
-	return setEnv(env, "NODE_PATH", strings.Join(parts, string(os.PathListSeparator)))
+  env := os.Environ()
+  parts := make([]string, 0, 2)
+  if nodeModules := findNearestNodeModules(filepath.Dir(location)); nodeModules != "" {
+    parts = append(parts, nodeModules)
+  }
+  if existing := os.Getenv("NODE_PATH"); existing != "" {
+    parts = append(parts, existing)
+  }
+  if len(parts) == 0 {
+    return env
+  }
+  return setEnv(env, "NODE_PATH", strings.Join(parts, string(os.PathListSeparator)))
 }
 
+// linkNearestNodeModules creates a node_modules symlink inside tempDir pointing
+// to the nearest node_modules ancestor of sourceDir. Does nothing when none is found.
 func linkNearestNodeModules(tempDir, sourceDir string) error {
-	nodeModules := findNearestNodeModules(sourceDir)
-	if nodeModules == "" {
-		return nil
-	}
-	link := filepath.Join(tempDir, "node_modules")
-	if err := os.Symlink(nodeModules, link); err != nil {
-		return fmt.Errorf("@ttsc/banner: link config node_modules %s: %w", nodeModules, err)
-	}
-	return nil
+  nodeModules := findNearestNodeModules(sourceDir)
+  if nodeModules == "" {
+    return nil
+  }
+  link := filepath.Join(tempDir, "node_modules")
+  if err := os.Symlink(nodeModules, link); err != nil {
+    return fmt.Errorf("@ttsc/banner: link config node_modules %s: %w", nodeModules, err)
+  }
+  return nil
 }
 
+// findNearestNodeModules walks up from start looking for a node_modules directory.
+// Returns the absolute path of the first match, or "" when none is found.
 func findNearestNodeModules(start string) string {
-	dir := filepath.Clean(start)
-	for {
-		candidate := filepath.Join(dir, "node_modules")
-		if stat, err := os.Stat(candidate); err == nil && stat.IsDir() {
-			return candidate
-		}
-		parent := filepath.Dir(dir)
-		if parent == dir {
-			return ""
-		}
-		dir = parent
-	}
+  dir := filepath.Clean(start)
+  for {
+    candidate := filepath.Join(dir, "node_modules")
+    if stat, err := os.Stat(candidate); err == nil && stat.IsDir() {
+      return candidate
+    }
+    parent := filepath.Dir(dir)
+    if parent == dir {
+      return ""
+    }
+    dir = parent
+  }
 }
 
+// setEnv returns a copy of env with key=value. If key already exists in env,
+// its value is updated in-place; otherwise the entry is appended.
 func setEnv(env []string, key, value string) []string {
-	prefix := key + "="
-	for i, entry := range env {
-		if strings.HasPrefix(entry, prefix) {
-			env[i] = prefix + value
-			return env
-		}
-	}
-	return append(env, prefix+value)
+  prefix := key + "="
+  for i, entry := range env {
+    if strings.HasPrefix(entry, prefix) {
+      env[i] = prefix + value
+      return env
+    }
+  }
+  return append(env, prefix+value)
 }
 
+// sanitizeJSDocLine escapes any JSDoc-closing sequence in a banner text line
+// by replacing "*/" with "* /" so the generated block comment stays valid.
 func sanitizeJSDocLine(line string) string {
-	return strings.ReplaceAll(line, "*/", "* /")
+  return strings.ReplaceAll(line, "*/", "* /")
 }

package/lib/index.js

@@ -21,11 +21,40 @@ exports.default = createTtscBanner;
 const node_path_1 = __importDefault(require("node:path"));
 __exportStar(require("./structures/index"), exports);
 /**
+ * Keys that the ttsc plugin host injects into every plugin entry and are not
+ * owned by `@ttsc/banner`. These pass through the factory without validation so
+ * the host can freely add new framework keys in the future.
+ */
+const FRAMEWORK_KEYS = new Set([
+    "enabled",
+    "name",
+    "stage",
+    "transform",
+]);
+/**
+ * Plugin factory for `@ttsc/banner` — called by the ttsc host to obtain the
+ * plugin descriptor.
+ *
+ * The only banner-specific key accepted in the tsconfig plugin entry is
+ * `configFile`. Any other key that is not a known framework key is rejected
+ * with a specific error so users discover the correct configuration surface
+ * (the dedicated config file) rather than silently receiving no banner.
+ *
  * @internal
  */
-function createTtscBanner(_context) {
+function createTtscBanner(context) {
+    const entry = context.plugin;
+    for (const key of Object.keys(entry)) {
+        if (!FRAMEWORK_KEYS.has(key) && key !== "configFile") {
+            throw new Error(`@ttsc/banner: tsconfig plugin entry contains unsupported key ${JSON.stringify(key)}. ` +
+                `Banner options must be placed in a banner.config.{ts,cts,mts,js,cjs,mjs,json} file. ` +
+                `The only accepted key in the tsconfig entry is "configFile" (optional path to the config file).`);
+        }
+    }
     return {
         name: "@ttsc/banner",
+        // Point at the `driver/` directory one level above `lib/` in the
+        // installed package tree (where the Go sources live).
         source: node_path_1.default.resolve(__dirname, "..", "driver"),
         stage: "transform",
     };

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,0DAA6B;AAI7B,qDAAmC;AAgBnC;;GAEG;AACH,0BACE,QAA2D;IAE3D,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;QAC/C,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA,0DAA6B;AAI7B,qDAAmC;AA4CnC;;;;GAIG;AACH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAS;IACrC,SAAS;IACT,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,0BACE,OAA0D;IAE1D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAiC,CAAC;IACxD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,gEAAgE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI;gBACrF,sFAAsF;gBACtF,iGAAiG,CACpG,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc;QACpB,iEAAiE;QACjE,sDAAsD;QACtD,MAAM,EAAE,mBAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC;QAC/C,KAAK,EAAE,WAAW;KACnB,CAAC;AACJ,CAAC"}

package/lib/structures/{TtscBannerConfig.d.ts → ITtscBannerConfig.d.ts}

@@ -1,5 +1,5 @@
 /** Standalone `banner.config.*` file shape consumed by `@ttsc/banner`. */
-export type TtscBannerConfig = string | {
+export interface ITtscBannerConfig {
     /** Text inserted into the generated `@packageDocumentation` block. */
     text: string;
-};
+}

package/lib/structures/{TtscBannerConfig.js → ITtscBannerConfig.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=TtscBannerConfig.js.map
+//# sourceMappingURL=ITtscBannerConfig.js.map

package/lib/structures/ITtscBannerConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITtscBannerConfig.js","sourceRoot":"","sources":["../../src/structures/ITtscBannerConfig.ts"],"names":[],"mappings":""}

package/lib/structures/ITtscBannerPluginConfig.d.ts

@@ -4,10 +4,11 @@ export interface ITtscBannerPluginConfig {
     enabled?: boolean;
     /** Plugin module specifier. */
     transform?: string;
-    /** Inline banner text. */
-    text?: string;
-    /** Path to `banner.config.*`, resolved from the selected tsconfig directory. */
-    config?: string;
-    /** Extra plugin-owned fields are passed through unchanged. */
-    [key: string]: unknown;
+    /**
+     * Path to a `banner.config.*` file, resolved from the directory that contains
+     * the tsconfig. When omitted, `@ttsc/banner` walks up from that directory and
+     * uses the first `banner.config.{ts,cts,mts,js,cjs,mjs,json}` file it finds.
+     * Any other key in this entry is rejected with an error.
+     */
+    configFile?: string;
 }

package/lib/structures/index.d.ts

@@ -1,2 +1,2 @@
 export * from "./ITtscBannerPluginConfig";
-export * from "./TtscBannerConfig";
+export * from "./ITtscBannerConfig";

package/lib/structures/index.js

@@ -15,5 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ITtscBannerPluginConfig"), exports);
-__exportStar(require("./TtscBannerConfig"), exports);
+__exportStar(require("./ITtscBannerConfig"), exports);
 //# sourceMappingURL=index.js.map

package/lib/structures/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/structures/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAA0C;AAC1C,sDAAoC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttsc/banner",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "description": "First-party ttsc plugin that adds package-documentation JSDoc banners during emit.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -33,9 +33,9 @@
   ],
   "devDependencies": {
     "@types/node": "^25.3.0",
-    "@typescript/native-preview": "7.0.0-dev.20260518.1",
+    "@typescript/native-preview": "7.0.0-dev.20260522.1",
     "rimraf": "^6.1.2",
-    "ttsc": "0.12.3"
+    "ttsc": "0.13.0"
   },
   "repository": {
     "type": "git",

package/src/index.ts

@@ -4,28 +4,89 @@ import type { ITtscBannerPluginConfig } from "./structures";
 
 export * from "./structures/index";
 
+/**
+ * The shape returned by a ttsc plugin factory function.
+ *
+ * Mirrors the `driver.PluginDescriptor` contract in the Go host. The `source`
+ * field points to the Go source directory that the host will compile into a
+ * plugin binary (cached under `.ttsc/`).
+ */
 type TtscPluginDescriptor = {
+  /** Human-readable plugin name used in logs and error messages. */
   name: string;
+  /** Absolute path to the Go source directory for this plugin. */
   source: string;
+  /**
+   * Pipeline stage. `"transform"` plugins may rewrite source files; `"check"`
+   * plugins only produce diagnostics. Defaults to `"check"`.
+   */
   stage?: "check" | "transform";
 };
 
+/**
+ * Context object passed by the ttsc host to every plugin factory function.
+ *
+ * The factory may inspect the context to customise the descriptor — for example
+ * selecting a different Go source directory based on `plugin` config — but most
+ * factories ignore it.
+ */
 type TtscPluginFactoryContext<TConfig> = {
+  /**
+   * Absolute path to the compiled plugin binary (not yet built at factory
+   * time).
+   */
   binary: string;
+  /** Working directory of the ttsc invocation. */
   cwd: string;
+  /** The raw plugin entry from `compilerOptions.plugins[]`. */
   plugin: TConfig;
+  /** Absolute path to the project root (directory containing tsconfig). */
   projectRoot: string;
+  /** Absolute path to the resolved tsconfig. */
   tsconfig: string;
 };
 
 /**
+ * Keys that the ttsc plugin host injects into every plugin entry and are not
+ * owned by `@ttsc/banner`. These pass through the factory without validation so
+ * the host can freely add new framework keys in the future.
+ */
+const FRAMEWORK_KEYS = new Set<string>([
+  "enabled",
+  "name",
+  "stage",
+  "transform",
+]);
+
+/**
+ * Plugin factory for `@ttsc/banner` — called by the ttsc host to obtain the
+ * plugin descriptor.
+ *
+ * The only banner-specific key accepted in the tsconfig plugin entry is
+ * `configFile`. Any other key that is not a known framework key is rejected
+ * with a specific error so users discover the correct configuration surface
+ * (the dedicated config file) rather than silently receiving no banner.
+ *
  * @internal
  */
 export default function createTtscBanner(
-  _context: TtscPluginFactoryContext<ITtscBannerPluginConfig>,
+  context: TtscPluginFactoryContext<ITtscBannerPluginConfig>,
 ): TtscPluginDescriptor {
+  const entry = context.plugin as Record<string, unknown>;
+  for (const key of Object.keys(entry)) {
+    if (!FRAMEWORK_KEYS.has(key) && key !== "configFile") {
+      throw new Error(
+        `@ttsc/banner: tsconfig plugin entry contains unsupported key ${JSON.stringify(key)}. ` +
+          `Banner options must be placed in a banner.config.{ts,cts,mts,js,cjs,mjs,json} file. ` +
+          `The only accepted key in the tsconfig entry is "configFile" (optional path to the config file).`,
+      );
+    }
+  }
+
   return {
     name: "@ttsc/banner",
+    // Point at the `driver/` directory one level above `lib/` in the
+    // installed package tree (where the Go sources live).
     source: path.resolve(__dirname, "..", "driver"),
     stage: "transform",
   };

package/src/structures/ITtscBannerConfig.ts

@@ -0,0 +1,5 @@
+/** Standalone `banner.config.*` file shape consumed by `@ttsc/banner`. */
+export interface ITtscBannerConfig {
+  /** Text inserted into the generated `@packageDocumentation` block. */
+  text: string;
+}

package/src/structures/ITtscBannerPluginConfig.ts

@@ -6,12 +6,11 @@ export interface ITtscBannerPluginConfig {
   /** Plugin module specifier. */
   transform?: string;
 
-  /** Inline banner text. */
-  text?: string;
-
-  /** Path to `banner.config.*`, resolved from the selected tsconfig directory. */
-  config?: string;
-
-  /** Extra plugin-owned fields are passed through unchanged. */
-  [key: string]: unknown;
+  /**
+   * Path to a `banner.config.*` file, resolved from the directory that contains
+   * the tsconfig. When omitted, `@ttsc/banner` walks up from that directory and
+   * uses the first `banner.config.{ts,cts,mts,js,cjs,mjs,json}` file it finds.
+   * Any other key in this entry is rejected with an error.
+   */
+  configFile?: string;
 }

package/src/structures/index.ts

@@ -1,2 +1,2 @@
 export * from "./ITtscBannerPluginConfig";
-export * from "./TtscBannerConfig";
+export * from "./ITtscBannerConfig";

package/lib/structures/TtscBannerConfig.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"TtscBannerConfig.js","sourceRoot":"","sources":["../../src/structures/TtscBannerConfig.ts"],"names":[],"mappings":""}

package/src/structures/TtscBannerConfig.ts

@@ -1,7 +0,0 @@
-/** Standalone `banner.config.*` file shape consumed by `@ttsc/banner`. */
-export type TtscBannerConfig =
-  | string
-  | {
-      /** Text inserted into the generated `@packageDocumentation` block. */
-      text: string;
-    };