@ts-for-gir/cli 4.0.0-rc.2 → 4.0.0-rc.4

package/bin/ts-for-gir

@@ -3346,7 +3346,7 @@ var require_lodash = __commonJS({
           }
           return mapped.length && mapped[0] === arrays[0] ? baseIntersection(mapped, undefined2, comparator) : [];
         });
-        function join16(array, separator) {
+        function join17(array, separator) {
           return array == null ? "" : nativeJoin.call(array, separator);
         }
         function last(array) {
@@ -4304,7 +4304,7 @@ var require_lodash = __commonJS({
           copyObject(source, keys(source), object, customizer);
         });
         var at = flatRest(baseAt);
-        function create(prototype, properties) {
+        function create2(prototype, properties) {
           var result2 = baseCreate(prototype);
           return properties == null ? result2 : baseAssign(result2, properties);
         }
@@ -5056,7 +5056,7 @@ var require_lodash = __commonJS({
         lodash2.conforms = conforms;
         lodash2.constant = constant;
         lodash2.countBy = countBy;
-        lodash2.create = create;
+        lodash2.create = create2;
         lodash2.curry = curry;
         lodash2.curryRight = curryRight;
         lodash2.debounce = debounce;
@@ -5270,7 +5270,7 @@ var require_lodash = __commonJS({
         lodash2.isUndefined = isUndefined;
         lodash2.isWeakMap = isWeakMap;
         lodash2.isWeakSet = isWeakSet;
-        lodash2.join = join16;
+        lodash2.join = join17;
         lodash2.kebabCase = kebabCase;
         lodash2.last = last;
         lodash2.lastIndexOf = lastIndexOf;
@@ -5532,17 +5532,17 @@ var require_lunr = __commonJS({
   "../../.yarn/cache/lunr-npm-2.3.9-fa3aa9c2d6-f2f6db34c0.zip/node_modules/lunr/lunr.js"(exports2, module) {
     (function() {
       var lunr2 = function(config) {
-        var builder7 = new lunr2.Builder();
-        builder7.pipeline.add(
+        var builder8 = new lunr2.Builder();
+        builder8.pipeline.add(
           lunr2.trimmer,
           lunr2.stopWordFilter,
           lunr2.stemmer
         );
-        builder7.searchPipeline.add(
+        builder8.searchPipeline.add(
           lunr2.stemmer
         );
-        config.call(builder7, builder7);
-        return builder7.build();
+        config.call(builder8, builder8);
+        return builder8.build();
       };
       lunr2.version = "2.3.9";
       lunr2.utils = {};
@@ -6218,12 +6218,12 @@ var require_lunr = __commonJS({
       };
       lunr2.TokenSet._nextId = 1;
       lunr2.TokenSet.fromArray = function(arr) {
-        var builder7 = new lunr2.TokenSet.Builder();
+        var builder8 = new lunr2.TokenSet.Builder();
         for (var i = 0, len = arr.length; i < len; i++) {
-          builder7.insert(arr[i]);
+          builder8.insert(arr[i]);
         }
-        builder7.finish();
-        return builder7.root;
+        builder8.finish();
+        return builder8.root;
       };
       lunr2.TokenSet.fromClause = function(clause) {
         if ("editDistance" in clause) {
@@ -7268,7 +7268,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 function getPackageVersion() {
   if (true) {
-    return "4.0.0-rc.2";
+    return "4.0.0-rc.4";
   }
   const currentModulePath = fileURLToPath(import.meta.url);
   const currentDir = dirname(currentModulePath);
@@ -7879,10 +7879,10 @@ ${"=".repeat(50)}`);
       if (statistics.typeStatistics.commonTypeConflicts.length > 0) {
         console.log(`
 \u2694\uFE0F  Type Conflicts:`);
-        statistics.typeStatistics.commonTypeConflicts.forEach(({ conflictType, count, examples: examples7 }) => {
+        statistics.typeStatistics.commonTypeConflicts.forEach(({ conflictType, count, examples: examples8 }) => {
           console.log(`  ${yellow(conflictType)}: ${count} conflicts`);
-          if (examples7.length > 0) {
-            console.log(`    \u2514\u2500 Examples: ${gray(examples7.join(", "))}`);
+          if (examples8.length > 0) {
+            console.log(`    \u2514\u2500 Examples: ${gray(examples8.join(", "))}`);
           }
         });
       }
@@ -8165,7 +8165,7 @@ import { fileURLToPath as fileURLToPath2 } from "node:url";
 var NEW_LINE_REG_EXP = /[\n\r]+/g;
 function getPackageVersion2() {
   if (true) {
-    return "4.0.0-rc.2";
+    return "4.0.0-rc.4";
   }
   const currentModulePath = fileURLToPath2(import.meta.url);
   const currentDir = dirname2(currentModulePath);
@@ -11113,13 +11113,22 @@ var DependencyManager = class _DependencyManager {
     return this.config.noNamespace ? `import type * as ${namespace} from '${importPath}'` : `import type ${namespace} from '${importPath}';`;
   }
   createPackageJsonImport(importPath, libraryVersion) {
+    const pinnedVersion = libraryVersion ? `${libraryVersion.toString()}-${APP_VERSION}` : APP_VERSION;
+    const format = this.config.depVersionFormat ?? (this.config.workspace ? "workspace" : "exact");
     let depVersion;
-    if (this.config.workspace) {
-      depVersion = "workspace:^";
-    } else if (libraryVersion) {
-      depVersion = `${libraryVersion.toString()}-${APP_VERSION}`;
-    } else {
-      depVersion = APP_VERSION;
+    switch (format) {
+      case "workspace":
+        depVersion = "workspace:^";
+        break;
+      case "caret":
+        depVersion = `^${pinnedVersion}`;
+        break;
+      case "any":
+        depVersion = "*";
+        break;
+      default:
+        depVersion = pinnedVersion;
+        break;
     }
     return `"${importPath}": "${depVersion}"`;
   }
@@ -12101,6 +12110,8 @@ function resolvePrimitiveType(name) {
     case "gint64":
     case "gssize":
     case "gsize":
+    case "guintptr":
+    // Integer of the same width as a pointer
     case "time_t":
     // C standard library time type (seconds since Unix epoch)
     case "ulong":
@@ -12113,8 +12124,6 @@ function resolvePrimitiveType(name) {
       return ObjectType;
     case "va_list":
       return AnyType;
-    case "guintptr":
-      return NeverType;
     case "never":
       return NeverType;
     case "unknown":
@@ -15202,16 +15211,16 @@ function transformBacktickTypeRefs(text, ctx) {
   });
   return text;
 }
-function transformGirDocHighlights(description7) {
-  return description7.replace(/(?<!\{)(?<!\w)@([A-Za-z_][A-Za-z0-9_]*)/g, "`$1`");
+function transformGirDocHighlights(description8) {
+  return description8.replace(/(?<!\{)(?<!\w)@([A-Za-z_][A-Za-z0-9_]*)/g, "`$1`");
 }
-function transformGirDocCodeBlocks(description7) {
-  description7 = description7.replaceAll(/```\s*\{\s*\.(\w+)[^}]*\}/gm, "```$1").replaceAll(/\|\[<!-- language="([^"]+)" -->/gm, (_match, lang) => {
+function transformGirDocCodeBlocks(description8) {
+  description8 = description8.replaceAll(/```\s*\{\s*\.(\w+)[^}]*\}/gm, "```$1").replaceAll(/\|\[<!-- language="([^"]+)" -->/gm, (_match, lang) => {
     if (lang === "plain" || lang === "text") return "\n```";
     return `
 \`\`\`${lang.toLowerCase()}`;
   }).replaceAll(/\|\[/gm, "\n```").replaceAll(/\]\|/gm, "```\n");
-  return description7;
+  return description8;
 }
 
 // ../lib/src/utils/objects.ts
@@ -18662,33 +18671,6 @@ var ClassVisitor = class extends GirVisitor {
   );
 };
 
-// ../lib/src/validators/function-parameters.ts
-var FunctionParametersVisitor = class extends GirVisitor {
-  makeEnumParamsNullable(node) {
-    return node.copy({
-      parameters: node.parameters.map((param) => {
-        const type = param.type.deepUnwrap();
-        if (type instanceof TypeIdentifier) {
-          const ns = node.namespace.assertInstalledImport(type.namespace);
-          const isEnumType = !!ns.getEnum(type.name);
-          if (isEnumType) {
-            return param.copy({
-              type: new NullableType(param.type)
-            });
-          }
-        }
-        return param;
-      })
-    });
-  }
-  visitFunction = (node) => {
-    return this.makeEnumParamsNullable(node);
-  };
-  visitClassFunction = (node) => {
-    return this.makeEnumParamsNullable(node);
-  };
-};
-
 // ../lib/src/validators/interface.ts
 var InterfaceVisitor = class extends GirVisitor {
   visitInterface = (node) => {
@@ -18783,8 +18765,6 @@ var NSRegistry = class {
     this.registerTransformation(interfaceVisitor);
     const classVisitor = new ClassVisitor();
     this.registerTransformation(classVisitor);
-    const enumParamsVisitor = new FunctionParametersVisitor();
-    this.registerTransformation(enumParamsVisitor);
     console.log("Adding generics...");
     generify(this, options2.inferGenerics);
     console.log("Injecting types...");
@@ -19534,6 +19514,11 @@ var options = {
     default: defaults.workspace,
     normalize: true
   },
+  depVersionFormat: {
+    type: "string",
+    description: "Dependency version spec format in generated package.json files. Defaults to 'workspace' when --workspace, else 'exact'",
+    choices: ["workspace", "caret", "any", "exact"]
+  },
   onlyVersionPrefix: {
     type: "boolean",
     description: "Only use the version prefix for the ambient module exports. This is useful if, for whatever reason, you want to use different library versions of the same library in your project.",
@@ -19586,6 +19571,7 @@ var generateOptions = {
   promisify: options.promisify,
   npmScope: options.npmScope,
   workspace: options.workspace,
+  depVersionFormat: options.depVersionFormat,
   onlyVersionPrefix: options.onlyVersionPrefix,
   noPrettyPrint: options.noPrettyPrint,
   noAdvancedVariants: options.noAdvancedVariants,
@@ -19641,6 +19627,25 @@ var docOptions = {
     description: "Directory containing pre-generated TypeDoc JSON files for merge mode (from 'ts-for-gir json')"
   }
 };
+var createOptions = {
+  template: {
+    type: "string",
+    alias: "t",
+    description: "Template to scaffold (types-locally, types-npm, types-workspace)",
+    choices: ["types-locally", "types-npm", "types-workspace"]
+  },
+  install: {
+    type: "boolean",
+    description: "Run npm install after scaffolding (use --no-install to skip)",
+    default: true
+  },
+  force: {
+    type: "boolean",
+    description: "Allow scaffolding into a non-empty target directory",
+    default: false
+  },
+  verbose: options.verbose
+};
 var analyzeOptions = {
   reportFile: {
     type: "string",
@@ -19807,6 +19812,7 @@ async function load(cliOptions) {
     const stringKeys = [
       ["npmScope", options.npmScope.default],
       ["reporterOutput", options.reporterOutput.default],
+      ["depVersionFormat", void 0],
       ["theme", docOptions.theme.default],
       ["sourceLinkTemplate", void 0],
       ["readme", void 0],
@@ -19845,13 +19851,13 @@ async function load(cliOptions) {
 }
 
 // src/commands/command-builder.ts
-function createBuilder(options2, examples7) {
+function createBuilder(options2, examples8) {
   return (yargs2) => {
     const optionNames = Object.keys(options2);
     for (const optionName of optionNames) {
       yargs2 = yargs2.option(optionName, options2[optionName]);
     }
-    return yargs2.example(examples7);
+    return yargs2.example(examples8);
   };
 }
 
@@ -20672,9 +20678,184 @@ var copy = {
   examples: examples2
 };
 
+// src/commands/create.ts
+import { spawnSync } from "node:child_process";
+import { cpSync, existsSync as existsSync3, mkdirSync, readdirSync, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname as dirname6, join as join9, resolve as resolve5 } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { input, select as select2 } from "@inquirer/prompts";
+var command3 = "create [name]";
+var description3 = "Scaffold a new GJS TypeScript project from a template";
+var examples3 = [
+  [`${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"]
+];
+var TEMPLATE_CHOICES = [
+  {
+    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/"
+  }
+];
+var PROJECT_NAME_PLACEHOLDER = "__PROJECT_NAME__";
+var TEXT_FILE_EXT = /* @__PURE__ */ new Set([".json", ".md", ".ts", ".tsx", ".js", ".mjs", ".cjs"]);
+var builder3 = createBuilder(createOptions, examples3);
+function findTemplatesRoot() {
+  const __filename2 = fileURLToPath4(import.meta.url);
+  const __dirname3 = dirname6(__filename2);
+  const candidates = [
+    // Bundled production binary (bin/ts-for-gir): ../dist-templates
+    resolve5(__dirname3, "..", "dist-templates"),
+    // Source layout (src/commands/create.ts): ../../dist-templates then ../../templates
+    resolve5(__dirname3, "..", "..", "dist-templates"),
+    resolve5(__dirname3, "..", "..", "templates")
+  ];
+  for (const path of candidates) {
+    if (existsSync3(path)) return path;
+  }
+  throw new Error(
+    `Could not locate templates directory. Looked in:
+  ${candidates.join("\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) {
+  const knownIds = TEMPLATE_CHOICES.map((c) => c.value);
+  return readdirSync(templatesRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => entry.name).filter((name) => knownIds.includes(name));
+}
+function sanitizeProjectName(raw) {
+  const trimmed = raw.trim();
+  if (!trimmed) throw new Error("Project name cannot be empty");
+  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) {
+  if (!existsSync3(path)) return true;
+  return readdirSync(path).length === 0;
+}
+function substituteInFile(filePath, projectName) {
+  const content = readFileSync4(filePath, "utf8");
+  if (!content.includes(PROJECT_NAME_PLACEHOLDER)) return;
+  writeFileSync2(filePath, content.replaceAll(PROJECT_NAME_PLACEHOLDER, projectName));
+}
+function walkAndSubstitute(rootDir, projectName) {
+  for (const entry of readdirSync(rootDir, { withFileTypes: true })) {
+    const full = join9(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);
+  }
+}
+var handler3 = async (args) => {
+  const opts = args;
+  const log3 = 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 template2 = opts.template;
+  if (template2 && !available.includes(template2)) {
+    throw new Error(`Unknown template "${template2}". Available: ${available.join(", ")}`);
+  }
+  if (!template2) {
+    if (!process.stdin.isTTY) {
+      throw new Error(`--template is required (non-TTY). Available: ${available.join(", ")}`);
+    }
+    template2 = await select2({
+      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 = resolve5(process.cwd(), projectName);
+  if (existsSync3(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 = join9(templatesRoot, template2);
+  cpSync(templateDir, targetDir, { recursive: true });
+  walkAndSubstitute(targetDir, projectName);
+  log3.success(`Scaffolded ${template2} into ${targetDir}`);
+  if (opts.install) {
+    log3.info("Running npm install...");
+    const result = spawnSync("npm", ["install", "--no-audit", "--no-fund"], {
+      cwd: targetDir,
+      stdio: "inherit"
+    });
+    if (result.status !== 0) {
+      log3.warn("npm install failed; you can re-run it manually in the project directory.");
+    }
+  }
+  log3.info("\nNext steps:");
+  log3.white(`  cd ${projectName}`);
+  if (!opts.install) log3.white("  npm install");
+  switch (template2) {
+    case "types-locally":
+      log3.white("  npm run generate");
+      log3.white("  npm run check:types");
+      log3.white("  npm run build && npm start");
+      break;
+    case "types-npm":
+      log3.white("  npm run check");
+      log3.white("  npm run build && npm start");
+      break;
+    case "types-workspace":
+      log3.white("  npm run build:types && npm install");
+      log3.white("  npm run build:app && npm start");
+      break;
+  }
+};
+var create = {
+  command: command3,
+  description: description3,
+  builder: builder3,
+  handler: handler3,
+  examples: examples3
+};
+
 // ../generator-html-doc/src/html-doc-generator.ts
 import { mkdir as mkdir4 } from "node:fs/promises";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 
 // ../generator-json/src/gir-metadata-deserializer.ts
 import { DeclarationReflection } from "typedoc";
@@ -20700,16 +20881,16 @@ var GirMetadataDeserializer = class {
 
 // ../generator-json/src/json-definition-generator.ts
 import { mkdir as mkdir3, writeFile as writeFile5 } from "node:fs/promises";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 
 // ../generator-json/src/typedoc-pipeline.ts
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync5 } from "node:fs";
 import { mkdtemp, rm } from "node:fs/promises";
 import { tmpdir } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 
 // ../generator-typescript/src/template-processor.ts
-import { dirname as dirname6, join as join9, relative } from "node:path";
+import { dirname as dirname7, join as join10, relative } from "node:path";
 var TemplateProcessor = class extends TemplateEngine {
   data;
   packageName;
@@ -20739,8 +20920,8 @@ var TemplateProcessor = class extends TemplateEngine {
       dep,
       deps,
       typeDir,
-      join: join9,
-      dirname: dirname6,
+      join: join10,
+      dirname: dirname7,
       ...this.config,
       packageName: this.packageName
     };
@@ -20810,10 +20991,10 @@ ${append}`;
     const rendered = await this.loadAll(templateDirname, fileExtension, ejsOptions, overrideTemplateData);
     const result = {};
     for (const filename of Object.keys(rendered)) {
-      const destPath = join9(baseOutputPath, outputDirname, filename);
+      const destPath = join10(baseOutputPath, outputDirname, filename);
       result[destPath] = `${rendered[filename]}
 ${append}`;
-      await this.write(result[destPath], baseOutputPath, join9(outputDirname, filename));
+      await this.write(result[destPath], baseOutputPath, join10(outputDirname, filename));
     }
     return result;
   }
@@ -20822,8 +21003,8 @@ ${append}`;
    * This is TypeScript-specific logic for handling package.json mode
    */
   getOutputPath(baseOutputPath, outputFilename) {
-    const filePath = this.config.package ? join9(this.data?.importName || this.packageName, outputFilename) : outputFilename;
-    const outputPath = join9(baseOutputPath, filePath);
+    const filePath = this.config.package ? join10(this.data?.importName || this.packageName, outputFilename) : outputFilename;
+    const outputPath = join10(baseOutputPath, filePath);
     return outputPath;
   }
   /**
@@ -24082,9 +24263,9 @@ var GirMetadataSerializer = class _GirMetadataSerializer {
     [IntrospectedAlias, (s, o) => s.buildBaseMetadata(o, "alias")]
   ];
   buildMetadata(girObj) {
-    for (const [ctor, handler7] of _GirMetadataSerializer.METADATA_DISPATCH) {
+    for (const [ctor, handler8] of _GirMetadataSerializer.METADATA_DISPATCH) {
       if (girObj instanceof ctor) {
-        return handler7(this, girObj);
+        return handler8(this, girObj);
       }
     }
     return null;
@@ -24209,7 +24390,7 @@ var TypeDocPipeline = class {
     return this._modules;
   }
   async start() {
-    this.tempDir = await mkdtemp(join10(tmpdir(), "ts-for-gir-typedoc-"));
+    this.tempDir = await mkdtemp(join11(tmpdir(), "ts-for-gir-typedoc-"));
     const tempConfig = {
       ...this.config,
       outdir: this.tempDir,
@@ -24236,10 +24417,10 @@ var TypeDocPipeline = class {
    * convert to ProjectReflection, and enrich with GIR metadata.
    */
   async createTypeDocApp(module) {
-    const moduleDir = join10(this.tempDir, module.importName);
-    const entryPoint = join10(moduleDir, `${module.importName}.d.ts`);
-    const tsconfigPath = join10(moduleDir, "tsconfig.json");
-    const readmePath = join10(moduleDir, "README.md");
+    const moduleDir = join11(this.tempDir, module.importName);
+    const entryPoint = join11(moduleDir, `${module.importName}.d.ts`);
+    const tsconfigPath = join11(moduleDir, "tsconfig.json");
+    const readmePath = join11(moduleDir, "README.md");
     const result = await this.bootstrapAndConvert(
       {
         entryPoints: [entryPoint],
@@ -24265,13 +24446,13 @@ var TypeDocPipeline = class {
    * Useful for TypeDoc's `projectToObject()` base path.
    */
   getModuleDir(module) {
-    return normalizePath(join10(this.tempDir, module.importName));
+    return normalizePath(join11(this.tempDir, module.importName));
   }
   /**
    * Get the normalized path to the GJS package temporary directory.
    */
   getGjsDir() {
-    return normalizePath(join10(this.tempDir, "gjs"));
+    return normalizePath(join11(this.tempDir, "gjs"));
   }
   /**
    * Bootstrap a TypeDoc Application for the GJS core types package.
@@ -24284,16 +24465,16 @@ var TypeDocPipeline = class {
    * Returns null if the GJS package was not generated (e.g. temp dir missing).
    */
   async createGjsTypeDocApp() {
-    const gjsDir = join10(this.tempDir, "gjs");
-    const tsconfigPath = join10(gjsDir, "tsconfig.json");
-    const readmePath = join10(gjsDir, "README.md");
+    const gjsDir = join11(this.tempDir, "gjs");
+    const tsconfigPath = join11(gjsDir, "tsconfig.json");
+    const readmePath = join11(gjsDir, "README.md");
     const entryPoints = [
-      join10(gjsDir, "gjs.d.ts"),
-      join10(gjsDir, "cairo.d.ts"),
-      join10(gjsDir, "gettext.d.ts"),
-      join10(gjsDir, "system.d.ts"),
-      join10(gjsDir, "dom.d.ts"),
-      join10(gjsDir, "console.d.ts")
+      join11(gjsDir, "gjs.d.ts"),
+      join11(gjsDir, "cairo.d.ts"),
+      join11(gjsDir, "gettext.d.ts"),
+      join11(gjsDir, "system.d.ts"),
+      join11(gjsDir, "dom.d.ts"),
+      join11(gjsDir, "console.d.ts")
     ];
     try {
       const result = await this.bootstrapAndConvert(
@@ -24322,7 +24503,7 @@ var TypeDocPipeline = class {
   async createCombinedTypeDocApp() {
     const result = await this.bootstrapAndConvert(
       {
-        entryPoints: [join10(this.tempDir, "*")],
+        entryPoints: [join11(this.tempDir, "*")],
         entryPointStrategy: "packages",
         name: "TypeScript API Documentation for GJS",
         ...this.sourceLinkOptions,
@@ -24348,7 +24529,7 @@ var TypeDocPipeline = class {
   async createMergedTypeDocApp(jsonDir) {
     const app = await this.bootstrapApp(
       {
-        entryPoints: [join10(jsonDir, "*.json")],
+        entryPoints: [join11(jsonDir, "*.json")],
         entryPointStrategy: "merge",
         name: "TypeScript API Documentation for GJS"
       },
@@ -24717,7 +24898,7 @@ var TypeDocPipeline = class {
   /** Try to read the generated package.json for a module from the temp directory. */
   readPackageJson(importName) {
     try {
-      const content = readFileSync4(join10(this.tempDir, importName, "package.json"), "utf8");
+      const content = readFileSync5(join11(this.tempDir, importName, "package.json"), "utf8");
       return JSON.parse(content);
     } catch {
       return null;
@@ -24784,7 +24965,7 @@ var JsonDefinitionGenerator = class _JsonDefinitionGenerator {
     const jsonStr = `${JSON.stringify(jsonOutput, null, pretty ? "	" : "")}
 `;
     if (this.config.outdir) {
-      const filepath = join11(this.config.outdir, "Gjs.json");
+      const filepath = join12(this.config.outdir, "Gjs.json");
       await writeFile5(filepath, jsonStr, "utf8");
       this.log.info(`Generated ${filepath}`);
     } else {
@@ -24799,7 +24980,7 @@ var JsonDefinitionGenerator = class _JsonDefinitionGenerator {
     const jsonStr = `${JSON.stringify(jsonOutput, null, pretty ? "	" : "")}
 `;
     if (this.config.outdir) {
-      const filepath = join11(this.config.outdir, `${module.packageName}.json`);
+      const filepath = join12(this.config.outdir, `${module.packageName}.json`);
       await writeFile5(filepath, jsonStr, "utf8");
       this.log.info(`Generated ${filepath}`);
     } else {
@@ -24809,9 +24990,9 @@ var JsonDefinitionGenerator = class _JsonDefinitionGenerator {
 };
 
 // ../typedoc-theme/src/theme.ts
-import { copyFileSync, existsSync as existsSync3, mkdirSync, readdirSync, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname8, join as join14 } from "node:path";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { copyFileSync, existsSync as existsSync4, mkdirSync as mkdirSync2, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname9, join as join15 } from "node:path";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 import { DefaultTheme, RendererEvent } from "typedoc";
 
 // ../typedoc-theme/src/context.ts
@@ -25084,8 +25265,8 @@ import { JSX as JSX3 } from "typedoc";
 
 // ../typedoc-theme/src/search-splitter.ts
 var import_lunr = __toESM(require_lunr(), 1);
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join12 } from "node:path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join13 } from "node:path";
 import { deflateSync, inflateSync } from "node:zlib";
 var KIND_MODULE = 2;
 function sanitizeModuleName(name) {
@@ -25102,20 +25283,20 @@ function getModuleName(row, moduleNames) {
   return void 0;
 }
 function buildChunk(rows) {
-  const builder7 = new import_lunr.default.Builder();
-  builder7.pipeline.add(import_lunr.default.trimmer);
-  builder7.ref("id");
-  builder7.field("name", { boost: 10 });
+  const builder8 = new import_lunr.default.Builder();
+  builder8.pipeline.add(import_lunr.default.trimmer);
+  builder8.ref("id");
+  builder8.field("name", { boost: 10 });
   for (let i = 0; i < rows.length; i++) {
-    builder7.add({ id: i, name: rows[i].name });
+    builder8.add({ id: i, name: rows[i].name });
   }
-  const index = builder7.build();
+  const index = builder8.build();
   const data = { rows, index };
   const compressed = deflateSync(Buffer.from(JSON.stringify(data)));
   return compressed.toString("base64");
 }
 function readSearchData(assetsDir) {
-  const raw = readFileSync5(join12(assetsDir, "search.js"), "utf-8");
+  const raw = readFileSync6(join13(assetsDir, "search.js"), "utf-8");
   const match = raw.match(/window\.searchData\s*=\s*"([^"]+)"/);
   if (!match?.[1]) {
     throw new Error("Could not extract searchData from search.js");
@@ -25125,7 +25306,7 @@ function readSearchData(assetsDir) {
   return JSON.parse(decompressed.toString("utf-8"));
 }
 async function splitSearchIndex(outputDir) {
-  const assetsDir = join12(outputDir, "assets");
+  const assetsDir = join13(outputDir, "assets");
   let searchData;
   try {
     searchData = readSearchData(assetsDir);
@@ -25157,11 +25338,11 @@ async function splitSearchIndex(outputDir) {
   for (const [moduleName, moduleRows] of moduleMap) {
     const chunk = buildChunk(moduleRows);
     const filename = `search-${sanitizeModuleName(moduleName)}.js`;
-    writeFileSync2(join12(assetsDir, filename), `window.searchData = "${chunk}";`);
+    writeFileSync3(join13(assetsDir, filename), `window.searchData = "${chunk}";`);
   }
   const modulesChunk = buildChunk(moduleEntries);
-  writeFileSync2(join12(assetsDir, "search-modules.js"), `window.searchData = "${modulesChunk}";`);
-  writeFileSync2(join12(assetsDir, "search.js"), "window.searchData = null;");
+  writeFileSync3(join13(assetsDir, "search-modules.js"), `window.searchData = "${modulesChunk}";`);
+  writeFileSync3(join13(assetsDir, "search.js"), "window.searchData = null;");
   const totalChunks = moduleMap.size + 1;
   console.log(`[search-splitter] Split ${rows.length} entries into ${totalChunks} chunks (${moduleMap.size} modules)`);
 }
@@ -25566,7 +25747,7 @@ function giDocgenModuleMemberSummary(context, member) {
   }
   const nsMeta = member.girNamespaceMetadata;
   const commentSummary = context.commentShortSummary(member);
-  const description7 = commentSummary || (nsMeta?.description ? JSX4.createElement("p", null, nsMeta.description) : null);
+  const description8 = commentSummary || (nsMeta?.description ? JSX4.createElement("p", null, nsMeta.description) : null);
   return JSX4.createElement(
     JSX4.Fragment,
     null,
@@ -25578,7 +25759,7 @@ function giDocgenModuleMemberSummary(context, member) {
     JSX4.createElement(
       "dd",
       { class: classNames({ "tsd-member-summary": true }, context.getReflectionClasses(member)) },
-      description7
+      description8
     )
   );
 }
@@ -25687,16 +25868,16 @@ import { JSX as JSX7 } from "typedoc";
 var giDocgenPageSidebar = (context, props) => JSX7.createElement(JSX7.Fragment, null, context.pageNavigation(props));
 
 // ../typedoc-theme/src/partials/sidebar.ts
-import { readFileSync as readFileSync6 } from "node:fs";
-import { dirname as dirname7, join as join13 } from "node:path";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
+import { readFileSync as readFileSync7 } from "node:fs";
+import { dirname as dirname8, join as join14 } from "node:path";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
 import { i18n, JSX as JSX8, ReflectionKind as ReflectionKind4 } from "typedoc";
 function getTsForGirVersion() {
   if (true) {
-    return "4.0.0-rc.2";
+    return "4.0.0-rc.4";
   }
-  const __dirname3 = dirname7(fileURLToPath4(import.meta.url));
-  return JSON.parse(readFileSync6(join13(__dirname3, "..", "..", "package.json"), "utf8")).version;
+  const __dirname3 = dirname8(fileURLToPath5(import.meta.url));
+  return JSON.parse(readFileSync7(join14(__dirname3, "..", "..", "package.json"), "utf8")).version;
 }
 var TSFOR_GIR_VERSION = getTsForGirVersion();
 function giDocgenModuleInfo(context, mod, nsMeta) {
@@ -26129,7 +26310,7 @@ var GiDocgenThemeRenderContext = class extends DefaultThemeRenderContext {
 };
 
 // ../typedoc-theme/src/theme.ts
-var __dirname2 = dirname8(fileURLToPath5(import.meta.url));
+var __dirname2 = dirname9(fileURLToPath6(import.meta.url));
 var FAVICON_FILES = [
   "favicon.ico",
   "favicon-96x96.png",
@@ -26152,21 +26333,21 @@ var GiDocgenTheme = class extends DefaultTheme {
   constructor(renderer) {
     super(renderer);
     this.owner.on(RendererEvent.END, (event) => {
-      const assetsDir = join14(event.outputDirectory, "assets");
-      copyFileSync(join14(__dirname2, "static", "style.css"), join14(assetsDir, "gi-docgen.css"));
-      copyFileSync(join14(__dirname2, "static", "gi-docgen-inherited.js"), join14(assetsDir, "gi-docgen-inherited.js"));
-      copyFileSync(join14(__dirname2, "static", "logo_x4.png"), join14(assetsDir, "logo_x4.png"));
-      const faviconDir = join14(__dirname2, "static", "favicon");
+      const assetsDir = join15(event.outputDirectory, "assets");
+      copyFileSync(join15(__dirname2, "static", "style.css"), join15(assetsDir, "gi-docgen.css"));
+      copyFileSync(join15(__dirname2, "static", "gi-docgen-inherited.js"), join15(assetsDir, "gi-docgen-inherited.js"));
+      copyFileSync(join15(__dirname2, "static", "logo_x4.png"), join15(assetsDir, "logo_x4.png"));
+      const faviconDir = join15(__dirname2, "static", "favicon");
       for (const file of FAVICON_FILES) {
-        copyFileSync(join14(faviconDir, file), join14(assetsDir, file));
+        copyFileSync(join15(faviconDir, file), join15(assetsDir, file));
       }
-      const iconsSourceDir = join14(__dirname2, "..", "..", "..", "refs", "library-icons", "library-icons");
-      const iconsOutputDir = join14(assetsDir, "library-icons");
-      if (existsSync3(iconsSourceDir)) {
-        mkdirSync(iconsOutputDir, { recursive: true });
-        for (const file of readdirSync(iconsSourceDir)) {
+      const iconsSourceDir = join15(__dirname2, "..", "..", "..", "refs", "library-icons", "library-icons");
+      const iconsOutputDir = join15(assetsDir, "library-icons");
+      if (existsSync4(iconsSourceDir)) {
+        mkdirSync2(iconsOutputDir, { recursive: true });
+        for (const file of readdirSync2(iconsSourceDir)) {
           if (file.endsWith("-r.svg")) {
-            copyFileSync(join14(iconsSourceDir, file), join14(iconsOutputDir, file));
+            copyFileSync(join15(iconsSourceDir, file), join15(iconsOutputDir, file));
           }
         }
       }
@@ -26182,7 +26363,7 @@ var GiDocgenTheme = class extends DefaultTheme {
         background_color: "#1e1e1e",
         display: "standalone"
       };
-      writeFileSync3(join14(assetsDir, "site.webmanifest"), JSON.stringify(manifest, null, 2));
+      writeFileSync4(join15(assetsDir, "site.webmanifest"), JSON.stringify(manifest, null, 2));
     });
   }
   getNavigation(project) {
@@ -26236,7 +26417,7 @@ var HtmlDocGenerator = class _HtmlDocGenerator {
       } else {
         for (const module of this.pipeline.modules) {
           const result = await this.pipeline.createTypeDocApp(module);
-          await this.generateDocsWithTheme(result, join15(outdir, module.packageName));
+          await this.generateDocsWithTheme(result, join16(outdir, module.packageName));
         }
       }
       this.log.success(`HTML documentation generated for ${this.pipeline.modules.length} modules in ${outdir}`);
@@ -26281,9 +26462,9 @@ var HtmlDocGenerator = class _HtmlDocGenerator {
 import prettier from "prettier";
 var logger4 = new Logger(false, "TypeScriptFormatter");
 var TypeScriptFormatter = class extends Formatter {
-  format(input) {
+  format(input2) {
     try {
-      return prettier.format(input, {
+      return prettier.format(input2, {
         singleQuote: true,
         parser: "typescript",
         printWidth: 120,
@@ -26291,7 +26472,7 @@ var TypeScriptFormatter = class extends Formatter {
       });
     } catch (error) {
       logger4.warn("Failed to format with prettier, returning original input", error);
-      return Promise.resolve(input);
+      return Promise.resolve(input2);
     }
   }
 };
@@ -26420,9 +26601,9 @@ async function runGenerationCommand(args, options2) {
 }
 
 // src/commands/doc.ts
-var command3 = "doc [modules..]";
-var description3 = "Generates HTML documentation from GIR files using TypeDoc";
-var examples3 = [
+var command4 = "doc [modules..]";
+var description4 = "Generates HTML documentation from GIR files using TypeDoc";
+var examples4 = [
   [`${APP_NAME} doc Gtk-4.0 --outdir ./docs`, "Generate HTML documentation for Gtk-4.0"],
   [`${APP_NAME} doc '*' --outdir ./docs`, "Generate documentation for all locally installed GIR modules"],
   [
@@ -26430,8 +26611,8 @@ var examples3 = [
     "Generate HTML from pre-generated JSON files (low memory)"
   ]
 ];
-var builder3 = createBuilder(docOptions, examples3);
-var handler3 = async (args) => {
+var builder4 = createBuilder(docOptions, examples4);
+var handler4 = async (args) => {
   const config = getOptionsGeneration(await load(args));
   if (config.merge) {
     if (!config.jsonDir) {
@@ -26450,17 +26631,17 @@ var handler3 = async (args) => {
   });
 };
 var doc = {
-  command: command3,
-  description: description3,
-  builder: builder3,
-  handler: handler3,
-  examples: examples3
+  command: command4,
+  description: description4,
+  builder: builder4,
+  handler: handler4,
+  examples: examples4
 };
 
 // src/commands/generate.ts
-var command4 = "generate [modules..]";
-var description4 = "Generates Typescript type definition .d.ts files from GIR for GJS";
-var examples4 = [
+var command5 = "generate [modules..]";
+var description5 = "Generates Typescript type definition .d.ts files from GIR for GJS";
+var examples5 = [
   [
     `${APP_NAME} generate`,
     `Run '${APP_NAME} generate' in your gjs project to generate typings for your project, pass the gir modules you need for your project`
@@ -26470,8 +26651,8 @@ var examples4 = [
   [`${APP_NAME} generate --configName='.ts-for-gir.gtk4.rc.js`, "Use a special config file"],
   [`${APP_NAME} generate --ignore=Gtk-4.0 xrandr-1.3`, "Generate .d.ts. files but not for Gtk-4.0 and xrandr-1.3"]
 ];
-var builder4 = createBuilder(generateOptions, examples4);
-var handler4 = async (args) => {
+var builder5 = createBuilder(generateOptions, examples5);
+var handler5 = async (args) => {
   await runGenerationCommand(args, {
     generatorType: 0 /* TYPES */,
     loggerName: "GenerateCommand",
@@ -26481,25 +26662,25 @@ var handler4 = async (args) => {
   });
 };
 var generate = {
-  command: command4,
-  description: description4,
-  builder: builder4,
-  handler: handler4,
-  examples: examples4
+  command: command5,
+  description: description5,
+  builder: builder5,
+  handler: handler5,
+  examples: examples5
 };
 
 // src/commands/json.ts
-var command5 = "json [modules..]";
-var description5 = "Generates JSON representation from GIR files for analysis and tooling";
-var examples5 = [
+var command6 = "json [modules..]";
+var description6 = "Generates JSON representation from GIR files for analysis and tooling";
+var examples6 = [
   [`${APP_NAME} json`, `Run '${APP_NAME} json' in your gjs project to generate JSON files for your project`],
   [`${APP_NAME} json 'Gtk*'`, "You can also use wild cards"],
   [`${APP_NAME} json '*'`, "If you want to parse all of your locally installed gir modules run"],
   [`${APP_NAME} json --configName='.ts-for-gir.gtk4.rc.js`, "Use a special config file"],
   [`${APP_NAME} json --ignore=Gtk-4.0 xrandr-1.3`, "Generate JSON files but not for Gtk-4.0 and xrandr-1.3"]
 ];
-var builder5 = createBuilder(generateOptions, examples5);
-var handler5 = async (args) => {
+var builder6 = createBuilder(generateOptions, examples6);
+var handler6 = async (args) => {
   await runGenerationCommand(args, {
     generatorType: 2 /* JSON */,
     loggerName: "JsonCommand",
@@ -26509,26 +26690,26 @@ var handler5 = async (args) => {
   });
 };
 var json2 = {
-  command: command5,
-  description: description5,
-  builder: builder5,
-  handler: handler5,
-  examples: examples5
+  command: command6,
+  description: description6,
+  builder: builder6,
+  handler: handler6,
+  examples: examples6
 };
 
 // src/commands/list.ts
-var command6 = "list [modules..]";
-var description6 = "Lists all available GIR modules";
+var command7 = "list [modules..]";
+var description7 = "Lists all available GIR modules";
 var logger5 = new Logger(true, "ListCommand");
-var examples6 = [
+var examples7 = [
   [`${APP_NAME} list -g ./vala-girs/gir-1.0`, "Lists all available GIR modules in ./vala-girs/gir-1.0"],
   [
     `${APP_NAME} list --ignore=Gtk-3.0 xrandr-1.3`,
     "Lists all available GIR modules in /usr/share/gir-1.0 but not Gtk-3.0 and xrandr-1.3"
   ]
 ];
-var builder6 = createBuilder(listOptions, examples6);
-var handler6 = async (args) => {
+var builder7 = createBuilder(listOptions, examples7);
+var handler7 = async (args) => {
   const config = await load(args);
   const generateConfig = getOptionsGeneration(config);
   const registry = new NSRegistry();
@@ -26569,15 +26750,15 @@ var handler6 = async (args) => {
   }
 };
 var list = {
-  command: command6,
-  description: description6,
-  builder: builder6,
-  handler: handler6,
-  examples: examples6
+  command: command7,
+  description: description7,
+  builder: builder7,
+  handler: handler7,
+  examples: examples7
 };
 
 // src/start.ts
-void yargs(hideBin(process.argv)).scriptName(APP_NAME).strict().usage(APP_USAGE).version(APP_VERSION).command(analyze).command(generate).command(json2).command(list).command(copy).command(doc).demandCommand(1).help().argv;
+void yargs(hideBin(process.argv)).scriptName(APP_NAME).strict().usage(APP_USAGE).version(APP_VERSION).command(analyze).command(create).command(generate).command(json2).command(list).command(copy).command(doc).demandCommand(1).help().argv;
 /*! Bundled license information:
 
 lodash/lodash.js: