@ts-for-gir/cli 4.0.0-rc.3 → 4.0.0-rc.5

package/dist-templates/types-locally/.ts-for-girrc.js

@@ -0,0 +1,6 @@
+export default {
+	modules: ["Adw-1", "Gtk-4.0"],
+	outdir: "./@types",
+	package: false,
+	ignoreVersionConflicts: true,
+};

package/dist-templates/types-locally/README.md

@@ -0,0 +1,15 @@
+# __PROJECT_NAME__
+
+GJS + TypeScript starter that generates GObject Introspection types **locally** into `./@types/`, without using the `@girs/*` NPM packages.
+
+## Setup
+
+```sh
+npm install
+npm run generate     # writes types into ./@types/
+npm run check:types  # tsc --noEmit
+npm run build        # bundles main.ts to dist/ via esbuild
+npm start            # runs dist/main.js with gjs
+```
+
+`@types/index.d.ts` is regenerated each time you run `npm run generate`. Add or remove modules in `.ts-for-girrc.js`.

package/dist-templates/types-locally/esbuild.ts

@@ -0,0 +1,10 @@
+import { build } from "esbuild";
+
+await build({
+	entryPoints: ["main.ts"],
+	outdir: "dist",
+	bundle: true,
+	target: "firefox128",
+	format: "esm",
+	external: ["gi://*", "resource://*", "gettext", "system", "cairo"],
+});

package/dist-templates/types-locally/main.ts

@@ -0,0 +1,21 @@
+/// <reference path="./@types/index.d.ts" />
+
+import Adw from "gi://Adw?version=1";
+import Gio from "gi://Gio?version=2.0";
+import Gtk from "gi://Gtk?version=4.0";
+
+const app = new Adw.Application({
+	applicationId: "com.example.__PROJECT_NAME__",
+	flags: Gio.ApplicationFlags.FLAGS_NONE,
+});
+
+app.connect("activate", (app: Adw.Application) => {
+	const label = new Gtk.Label({ label: "Hello from __PROJECT_NAME__" });
+	const window = new Gtk.ApplicationWindow({ application: app });
+	window.set_title("__PROJECT_NAME__");
+	window.set_default_size(320, 120);
+	window.set_child(label);
+	window.present();
+});
+
+app.run([imports.system.programInvocationName].concat(ARGV));

package/dist-templates/types-locally/package.json

@@ -0,0 +1,18 @@
+{
+	"name": "__PROJECT_NAME__",
+	"version": "0.1.0",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"generate": "ts-for-gir generate",
+		"check:types": "tsc --noEmit",
+		"build": "node --experimental-strip-types --experimental-transform-types --no-warnings esbuild.ts",
+		"start": "gjs -m dist/main.js",
+		"clear": "rm -rf dist @types"
+	},
+	"devDependencies": {
+		"@ts-for-gir/cli": "^4.0.0-rc.5",
+		"esbuild": "^0.28.0",
+		"typescript": "^6.0.2"
+	}
+}

package/dist-templates/types-locally/tsconfig.json

@@ -0,0 +1,17 @@
+{
+	"compilerOptions": {
+		"target": "ESNext",
+		"module": "ESNext",
+		"lib": ["ESNext"],
+		"moduleResolution": "bundler",
+		"skipLibCheck": false,
+		"types": [],
+		"strict": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"noImplicitThis": true,
+		"alwaysStrict": true
+	},
+	"include": ["main.ts", "@types/index.d.ts"],
+	"exclude": []
+}

package/dist-templates/types-npm/README.md

@@ -0,0 +1,14 @@
+# __PROJECT_NAME__
+
+GJS + TypeScript starter that consumes pre-generated GObject Introspection types from the [`@girs/*`](https://www.npmjs.com/org/girs) NPM packages.
+
+## Setup
+
+```sh
+npm install
+npm run check   # tsc --noEmit
+npm run build   # bundles main.ts to dist/ via esbuild
+npm start       # runs dist/main.js with gjs
+```
+
+To add another GIR module, install the matching `@girs/<name>-<version>` package and add it to `tsconfig.json`'s `types` array.

package/dist-templates/types-npm/esbuild.ts

@@ -0,0 +1,10 @@
+import { build } from "esbuild";
+
+await build({
+	entryPoints: ["main.ts"],
+	outdir: "dist",
+	bundle: true,
+	target: "firefox128",
+	format: "esm",
+	external: ["gi://*", "resource://*", "gettext", "system", "cairo"],
+});

package/dist-templates/types-npm/main.ts

@@ -0,0 +1,19 @@
+import Adw from "gi://Adw?version=1";
+import Gio from "gi://Gio?version=2.0";
+import Gtk from "gi://Gtk?version=4.0";
+
+const app = new Adw.Application({
+	applicationId: "com.example.__PROJECT_NAME__",
+	flags: Gio.ApplicationFlags.FLAGS_NONE,
+});
+
+app.connect("activate", (app: Adw.Application) => {
+	const label = new Gtk.Label({ label: "Hello from __PROJECT_NAME__" });
+	const window = new Gtk.ApplicationWindow({ application: app });
+	window.set_title("__PROJECT_NAME__");
+	window.set_default_size(320, 120);
+	window.set_child(label);
+	window.present();
+});
+
+app.run([imports.system.programInvocationName].concat(ARGV));

package/dist-templates/types-npm/package.json

@@ -0,0 +1,23 @@
+{
+	"name": "__PROJECT_NAME__",
+	"version": "0.1.0",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"check": "tsc --noEmit",
+		"build": "node --experimental-strip-types --experimental-transform-types --no-warnings esbuild.ts",
+		"start": "gjs -m dist/main.js",
+		"clear": "rm -rf dist"
+	},
+	"devDependencies": {
+		"esbuild": "^0.28.0",
+		"typescript": "^6.0.2"
+	},
+	"dependencies": {
+		"@girs/adw-1": "^1.10.0-4.0.0-rc.4",
+		"@girs/gio-2.0": "^2.88.0-4.0.0-rc.4",
+		"@girs/gjs": "^4.0.0-rc.4",
+		"@girs/glib-2.0": "^2.88.0-4.0.0-rc.4",
+		"@girs/gtk-4.0": "^4.23.0-4.0.0-rc.4"
+	}
+}

package/dist-templates/types-npm/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"lib": ["ESNext"],
+		"types": ["@girs/gjs", "@girs/adw-1"],
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"noImplicitThis": true,
+		"alwaysStrict": true
+	},
+	"files": ["main.ts"]
+}

package/dist-templates/types-workspace/.ts-for-girrc.js

@@ -0,0 +1,12 @@
+export default {
+	modules: ["Adw-1", "Gtk-4.0"],
+	outdir: "./@girs",
+	package: true,
+	// npm does not support the workspace: protocol. `caret` emits ^<version>
+	// which npm, yarn and pnpm all resolve to the local workspace when the ref
+	// matches, falling back to the registry otherwise — the most portable
+	// default for a generated monorepo. Falls back to "exact" on CLI versions
+	// that predate this option, which is also npm-compatible.
+	depVersionFormat: "caret",
+	ignoreVersionConflicts: true,
+};

package/dist-templates/types-workspace/README.md

@@ -0,0 +1,26 @@
+# __PROJECT_NAME__
+
+GJS + TypeScript starter that uses an **npm workspace** with the `@girs/*` types generated locally as workspace packages. Useful when you want pinned, hermetic types under version control without depending on the published `@girs/*` packages on NPM.
+
+## Setup
+
+```sh
+npm install
+npm run build:types   # generates @girs/* packages into ./@girs/
+npm install           # picks up the freshly generated @girs/* workspace packages
+npm run build:app
+npm start
+```
+
+Or shorthand: `npm run build` runs all three steps in order.
+
+The application lives in [`packages/app/`](./packages/app/). Its dependencies on `@girs/*` are written as `"*"` which works across all three package managers — npm, yarn, pnpm all resolve to the locally generated workspace packages in `./@girs/`.
+
+### About the dependency version format
+
+Two deliberate choices keep the template portable:
+
+1. **Generated `@girs/*` packages** reference each other via `^<version>` (not `workspace:^`). Controlled by `depVersionFormat: "caret"` in [`.ts-for-girrc.js`](./.ts-for-girrc.js). npm and yarn/pnpm all prefer the local workspace match; the registry serves as fallback for transitive GIR packages outside your `modules` set.
+2. **Sub-package deps** (`packages/app/package.json`) use `"*"`. Same reasoning — all managers resolve to the local workspace.
+
+If you run yarn or pnpm exclusively and want strict workspace-only resolution, switch both: add `workspace: true` and `depVersionFormat: "workspace"` in `.ts-for-girrc.js`, plus `"workspace:^"` specs in `packages/app/package.json`. npm does **not** support the `workspace:` protocol.

package/dist-templates/types-workspace/package.json

@@ -0,0 +1,22 @@
+{
+	"name": "__PROJECT_NAME__",
+	"version": "0.1.0",
+	"type": "module",
+	"private": true,
+	"workspaces": [
+		"packages/*",
+		"@girs/*"
+	],
+	"scripts": {
+		"build:types": "ts-for-gir generate --package --outdir=./@girs",
+		"build:app": "npm run --workspace=@__PROJECT_NAME__/app build",
+		"build": "npm run build:types && npm install && npm run build:app",
+		"check": "npm run --workspaces --if-present check",
+		"start": "npm run --workspace=@__PROJECT_NAME__/app start",
+		"clear": "rm -rf @girs packages/*/dist"
+	},
+	"devDependencies": {
+		"@ts-for-gir/cli": "^4.0.0-rc.5",
+		"typescript": "^6.0.2"
+	}
+}

package/dist-templates/types-workspace/packages/app/esbuild.ts

@@ -0,0 +1,10 @@
+import { build } from "esbuild";
+
+await build({
+	entryPoints: ["main.ts"],
+	outdir: "dist",
+	bundle: true,
+	target: "firefox128",
+	format: "esm",
+	external: ["gi://*", "resource://*", "gettext", "system", "cairo"],
+});

package/dist-templates/types-workspace/packages/app/main.ts

@@ -0,0 +1,19 @@
+import Adw from "gi://Adw?version=1";
+import Gio from "gi://Gio?version=2.0";
+import Gtk from "gi://Gtk?version=4.0";
+
+const app = new Adw.Application({
+	applicationId: "com.example.__PROJECT_NAME__",
+	flags: Gio.ApplicationFlags.FLAGS_NONE,
+});
+
+app.connect("activate", (app: Adw.Application) => {
+	const label = new Gtk.Label({ label: "Hello from __PROJECT_NAME__" });
+	const window = new Gtk.ApplicationWindow({ application: app });
+	window.set_title("__PROJECT_NAME__");
+	window.set_default_size(320, 120);
+	window.set_child(label);
+	window.present();
+});
+
+app.run([imports.system.programInvocationName].concat(ARGV));

package/dist-templates/types-workspace/packages/app/package.json

@@ -0,0 +1,23 @@
+{
+	"name": "@__PROJECT_NAME__/app",
+	"version": "0.1.0",
+	"type": "module",
+	"private": true,
+	"scripts": {
+		"check": "tsc --noEmit",
+		"build": "node --experimental-strip-types --experimental-transform-types --no-warnings esbuild.ts",
+		"start": "gjs -m dist/main.js",
+		"clear": "rm -rf dist"
+	},
+	"devDependencies": {
+		"esbuild": "^0.28.0",
+		"typescript": "^6.0.2"
+	},
+	"dependencies": {
+		"@girs/adw-1": "*",
+		"@girs/gio-2.0": "*",
+		"@girs/gjs": "*",
+		"@girs/glib-2.0": "*",
+		"@girs/gtk-4.0": "*"
+	}
+}

package/dist-templates/types-workspace/packages/app/tsconfig.json

@@ -0,0 +1,15 @@
+{
+	"compilerOptions": {
+		"lib": ["ESNext"],
+		"types": ["@girs/gjs", "@girs/adw-1"],
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"noImplicitAny": true,
+		"strictNullChecks": true,
+		"noImplicitThis": true,
+		"alwaysStrict": true
+	},
+	"files": ["main.ts"]
+}

package/dist-templates/types-workspace/tsconfig.json

@@ -0,0 +1,11 @@
+{
+	"compilerOptions": {
+		"lib": ["ESNext"],
+		"target": "ESNext",
+		"module": "ESNext",
+		"moduleResolution": "bundler",
+		"strict": true,
+		"noEmit": true
+	},
+	"references": [{ "path": "./packages/app" }]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ts-for-gir/cli",
-  "version": "4.0.0-rc.3",
+  "version": "4.0.0-rc.5",
   "description": "TypeScript type definition generator for GObject introspection GIR files",
   "main": "src/index.ts",
   "module": "src/index.ts",
@@ -17,6 +17,8 @@
     "start": "node bin/ts-for-gir-dev",
     "start:prod": "node bin/ts-for-gir",
     "build": "node --experimental-specifier-resolution=node --experimental-strip-types --experimental-transform-types --no-warnings esbuild.ts && chmod +x bin/ts-for-gir-dev && chmod +x bin/ts-for-gir",
+    "build:templates": "node scripts/process-templates.mjs",
+    "prepack": "node scripts/process-templates.mjs",
     "check:types": "tsc --noEmit",
     "check": "yarn check:types"
   },
@@ -27,7 +29,8 @@
   "author": "Pascal Garber <pascal@mailfreun.de>",
   "files": [
     "src",
-    "bin"
+    "bin",
+    "dist-templates"
   ],
   "license": "Apache-2.0",
   "bugs": {
@@ -52,31 +55,31 @@
     ".": "./src/index.ts"
   },
   "devDependencies": {
-    "@gi.ts/parser": "^4.0.0-rc.3",
-    "@ts-for-gir/generator-base": "^4.0.0-rc.3",
-    "@ts-for-gir/generator-html-doc": "^4.0.0-rc.3",
-    "@ts-for-gir/generator-json": "^4.0.0-rc.3",
-    "@ts-for-gir/generator-typescript": "^4.0.0-rc.3",
-    "@ts-for-gir/lib": "^4.0.0-rc.3",
-    "@ts-for-gir/reporter": "^4.0.0-rc.3",
-    "@ts-for-gir/tsconfig": "^4.0.0-rc.3",
+    "@gi.ts/parser": "^4.0.0-rc.5",
+    "@ts-for-gir/generator-base": "^4.0.0-rc.5",
+    "@ts-for-gir/generator-html-doc": "^4.0.0-rc.5",
+    "@ts-for-gir/generator-json": "^4.0.0-rc.5",
+    "@ts-for-gir/generator-typescript": "^4.0.0-rc.5",
+    "@ts-for-gir/lib": "^4.0.0-rc.5",
+    "@ts-for-gir/reporter": "^4.0.0-rc.5",
+    "@ts-for-gir/tsconfig": "^4.0.0-rc.5",
     "@types/ejs": "^3.1.5",
     "@types/inquirer": "^9.0.9",
-    "@types/node": "^24.12.2",
+    "@types/node": "^25.6.0",
     "@types/yargs": "^17.0.35",
     "esbuild": "^0.28.0",
-    "typescript": "^6.0.2"
+    "typescript": "^6.0.3"
   },
   "dependencies": {
-    "@inquirer/prompts": "^8.3.2",
-    "@ts-for-gir/templates": "^4.0.0-rc.3",
+    "@inquirer/prompts": "^8.4.2",
+    "@ts-for-gir/templates": "^4.0.0-rc.5",
     "colorette": "^2.0.20",
     "cosmiconfig": "^9.0.1",
-    "ejs": "^5.0.1",
+    "ejs": "^5.0.2",
     "glob": "^13.0.6",
-    "inquirer": "^13.3.2",
-    "prettier": "^3.8.1",
-    "typedoc": "^0.28.18",
+    "inquirer": "^13.4.2",
+    "prettier": "^3.8.3",
+    "typedoc": "^0.28.19",
     "yargs": "^18.0.0"
   }
 }

package/src/commands/create.ts

@@ -0,0 +1,214 @@
+/**
+ * Everything you need for the `ts-for-gir create` command is located here
+ */
+
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { input, select } from "@inquirer/prompts";
+import { APP_NAME, type ConfigFlags, Logger } from "@ts-for-gir/lib";
+
+import { createOptions } from "../config.ts";
+import type { CreateCommandArgs, CreateTemplateId } from "../types/index.ts";
+import { createBuilder } from "./command-builder.ts";
+
+const command = "create [name]";
+
+const description = "Scaffold a new GJS TypeScript project from a template";
+
+const examples: ReadonlyArray<[string, string?]> = [
+	[`${APP_NAME} create my-app --template types-npm`, "Scaffold using the @girs/* NPM types"],
+	[`${APP_NAME} create my-app --template types-locally`, "Scaffold and generate types into ./@types/ locally"],
+	[
+		`${APP_NAME} create my-app --template types-workspace`,
+		"Scaffold an npm workspace with types as workspace packages",
+	],
+	[`${APP_NAME} create`, "Interactive: prompts for name and template"],
+];
+
+const TEMPLATE_CHOICES: ReadonlyArray<{ value: CreateTemplateId; name: string; description: string }> = [
+	{
+		value: "types-locally",
+		name: "types-locally",
+		description: "Generate GIR types directly into ./@types/ (no package format, no @girs/* deps)",
+	},
+	{
+		value: "types-npm",
+		name: "types-npm",
+		description: "Use pre-generated types from the @girs/* NPM packages",
+	},
+	{
+		value: "types-workspace",
+		name: "types-workspace",
+		description: "npm workspace; generate @girs/* as workspace packages under ./@girs/",
+	},
+];
+
+const PROJECT_NAME_PLACEHOLDER = "__PROJECT_NAME__";
+
+const TEXT_FILE_EXT = new Set([".json", ".md", ".ts", ".tsx", ".js", ".mjs", ".cjs"]);
+
+const builder = createBuilder<CreateCommandArgs>(createOptions, examples);
+
+function findTemplatesRoot(): string {
+	const __filename = fileURLToPath(import.meta.url);
+	const __dirname = dirname(__filename);
+	const candidates = [
+		// Bundled production binary (bin/ts-for-gir): ../dist-templates
+		resolve(__dirname, "..", "dist-templates"),
+		// Source layout (src/commands/create.ts): ../../dist-templates then ../../templates
+		resolve(__dirname, "..", "..", "dist-templates"),
+		resolve(__dirname, "..", "..", "templates"),
+	];
+	for (const path of candidates) {
+		if (existsSync(path)) return path;
+	}
+	throw new Error(
+		`Could not locate templates directory. Looked in:\n  ${candidates.join("\n  ")}\n` +
+			"If you are running from source, make sure packages/cli/templates/ exists. " +
+			"If you are running the published CLI, make sure dist-templates/ was packed.",
+	);
+}
+
+function listTemplates(templatesRoot: string): CreateTemplateId[] {
+	const knownIds = TEMPLATE_CHOICES.map((c) => c.value) as readonly string[];
+	return readdirSync(templatesRoot, { withFileTypes: true })
+		.filter((entry) => entry.isDirectory())
+		.map((entry) => entry.name)
+		.filter((name): name is CreateTemplateId => knownIds.includes(name));
+}
+
+function sanitizeProjectName(raw: string): string {
+	const trimmed = raw.trim();
+	if (!trimmed) throw new Error("Project name cannot be empty");
+	// npm package name rules: lowercase letters, digits, dashes, underscores, dots; no leading dot/underscore
+	const cleaned = trimmed
+		.toLowerCase()
+		.replace(/[^a-z0-9._-]+/g, "-")
+		.replace(/^[._-]+/, "")
+		.replace(/[._-]+$/, "");
+	if (!cleaned) throw new Error(`"${raw}" is not a valid npm package name`);
+	return cleaned;
+}
+
+function isDirEmpty(path: string): boolean {
+	if (!existsSync(path)) return true;
+	return readdirSync(path).length === 0;
+}
+
+function substituteInFile(filePath: string, projectName: string): void {
+	const content = readFileSync(filePath, "utf8");
+	if (!content.includes(PROJECT_NAME_PLACEHOLDER)) return;
+	writeFileSync(filePath, content.replaceAll(PROJECT_NAME_PLACEHOLDER, projectName));
+}
+
+function walkAndSubstitute(rootDir: string, projectName: string): void {
+	for (const entry of readdirSync(rootDir, { withFileTypes: true })) {
+		const full = join(rootDir, entry.name);
+		if (entry.isDirectory()) {
+			if (entry.name === "node_modules") continue;
+			walkAndSubstitute(full, projectName);
+			continue;
+		}
+		if (!entry.isFile()) continue;
+		const ext = entry.name.slice(entry.name.lastIndexOf("."));
+		if (!TEXT_FILE_EXT.has(ext)) continue;
+		substituteInFile(full, projectName);
+	}
+}
+
+const handler = async (args: ConfigFlags) => {
+	const opts = args as unknown as CreateCommandArgs;
+	const log = new Logger(opts.verbose ?? false, "CreateCommand");
+
+	const templatesRoot = findTemplatesRoot();
+	const available = listTemplates(templatesRoot);
+	if (available.length === 0) {
+		throw new Error(`No templates found in ${templatesRoot}`);
+	}
+
+	let template: CreateTemplateId | undefined = opts.template;
+	if (template && !available.includes(template)) {
+		throw new Error(`Unknown template "${template}". Available: ${available.join(", ")}`);
+	}
+	if (!template) {
+		if (!process.stdin.isTTY) {
+			throw new Error(`--template is required (non-TTY). Available: ${available.join(", ")}`);
+		}
+		template = await select<CreateTemplateId>({
+			message: "Choose a template:",
+			choices: TEMPLATE_CHOICES.filter((c) => available.includes(c.value)).map((c) => ({
+				value: c.value,
+				name: c.name,
+				description: c.description,
+			})),
+		});
+	}
+
+	let nameRaw = opts.name;
+	if (!nameRaw) {
+		if (!process.stdin.isTTY) {
+			throw new Error("Project name is required (non-TTY). Pass it as the first positional argument.");
+		}
+		nameRaw = await input({
+			message: "Project name:",
+			default: "my-gjs-app",
+			validate: (v) => (v.trim().length > 0 ? true : "Project name cannot be empty"),
+		});
+	}
+	const projectName = sanitizeProjectName(nameRaw);
+
+	const targetDir = resolve(process.cwd(), projectName);
+	if (existsSync(targetDir) && !isDirEmpty(targetDir) && !opts.force) {
+		throw new Error(
+			`Target directory ${targetDir} exists and is not empty. Use --force to scaffold into a non-empty directory.`,
+		);
+	}
+	mkdirSync(targetDir, { recursive: true });
+
+	const templateDir = join(templatesRoot, template);
+	cpSync(templateDir, targetDir, { recursive: true });
+	walkAndSubstitute(targetDir, projectName);
+
+	log.success(`Scaffolded ${template} into ${targetDir}`);
+
+	if (opts.install) {
+		log.info("Running npm install...");
+		const result = spawnSync("npm", ["install", "--no-audit", "--no-fund"], {
+			cwd: targetDir,
+			stdio: "inherit",
+		});
+		if (result.status !== 0) {
+			log.warn("npm install failed; you can re-run it manually in the project directory.");
+		}
+	}
+
+	log.info("\nNext steps:");
+	log.white(`  cd ${projectName}`);
+	if (!opts.install) log.white("  npm install");
+	switch (template) {
+		case "types-locally":
+			log.white("  npm run generate");
+			log.white("  npm run check:types");
+			log.white("  npm run build && npm start");
+			break;
+		case "types-npm":
+			log.white("  npm run check");
+			log.white("  npm run build && npm start");
+			break;
+		case "types-workspace":
+			log.white("  npm run build:types && npm install");
+			log.white("  npm run build:app && npm start");
+			break;
+	}
+};
+
+export const create = {
+	command,
+	description,
+	builder,
+	handler,
+	examples,
+};

package/src/commands/index.ts

@@ -1,5 +1,6 @@
 export * from "./analyze.ts";
 export * from "./copy.ts";
+export * from "./create.ts";
 export * from "./doc.ts";
 export * from "./generate.ts";
 export * from "./json.ts";

package/src/config/config-loader.ts

@@ -141,6 +141,7 @@ export async function load(cliOptions: ConfigFlags): Promise<UserConfig> {
 		const stringKeys: Array<[keyof UserConfig, unknown]> = [
 			["npmScope", options.npmScope.default],
 			["reporterOutput", options.reporterOutput.default],
+			["depVersionFormat", undefined],
 			["theme", docOptions.theme.default],
 			["sourceLinkTemplate", undefined],
 			["readme", undefined],

package/src/config/index.ts

@@ -5,4 +5,12 @@
 export { getOptionsGeneration, load, validate } from "./config-loader.ts";
 export { addToConfig, configFilePath } from "./config-writer.ts";
 export { defaults } from "./defaults.ts";
-export { analyzeOptions, copyOptions, docOptions, generateOptions, listOptions, options } from "./options.ts";
+export {
+	analyzeOptions,
+	copyOptions,
+	createOptions,
+	docOptions,
+	generateOptions,
+	listOptions,
+	options,
+} from "./options.ts";