@fern-api/generator-cli 0.0.41 → 0.1.0

package/dist/cli.cjs

@@ -5148,14 +5148,14 @@ var require_common = __commonJS({
           }
         }
       }
-      function matchesTemplate(search, template) {
+      function matchesTemplate(search, template2) {
         let searchIndex = 0;
         let templateIndex = 0;
         let starIndex = -1;
         let matchIndex = 0;
         while (searchIndex < search.length) {
-          if (templateIndex < template.length && (template[templateIndex] === search[searchIndex] || template[templateIndex] === "*")) {
-            if (template[templateIndex] === "*") {
+          if (templateIndex < template2.length && (template2[templateIndex] === search[searchIndex] || template2[templateIndex] === "*")) {
+            if (template2[templateIndex] === "*") {
               starIndex = templateIndex;
               matchIndex = searchIndex;
               templateIndex++;
@@ -5171,10 +5171,10 @@ var require_common = __commonJS({
             return false;
           }
         }
-        while (templateIndex < template.length && template[templateIndex] === "*") {
+        while (templateIndex < template2.length && template2[templateIndex] === "*") {
           templateIndex++;
         }
-        return templateIndex === template.length;
+        return templateIndex === template2.length;
       }
       function disable() {
         const namespaces = [
@@ -12833,6 +12833,7 @@ var GitHub = class {
 };
 
 // src/readme/ReadmeGenerator.ts
+var import_compat = require("es-toolkit/compat");
 var import_string = require("es-toolkit/string");
 
 // src/configuration/generated/api/index.ts
@@ -12865,6 +12866,7 @@ var StructuredFeatureId = {
   Streaming: "STREAMING",
   Timeouts: "TIMEOUTS",
   CustomClient: "CUSTOM_CLIENT",
+  Contributing: "CONTRIBUTING",
   _visit: (value, visitor) => {
     switch (value) {
       case StructuredFeatureId.Authentication:
@@ -12885,6 +12887,8 @@ var StructuredFeatureId = {
         return visitor.timeouts();
       case StructuredFeatureId.CustomClient:
         return visitor.customClient();
+      case StructuredFeatureId.Contributing:
+        return visitor.contributing();
       default:
         return visitor._other();
     }
@@ -13213,9 +13217,9 @@ var BlockMerger = class {
         merged.addBlock(originalBlock);
       }
     }
-    for (const updatedBlock of this.updated) {
+    for (const [index, updatedBlock] of this.updated.reverse().entries()) {
       if (!processedUpdated.has(updatedBlock.id)) {
-        merged.addBlock(updatedBlock);
+        merged.insertBlock(updatedBlock, this.updated[index - 1]?.id);
       }
     }
     return merged.getBlocks();
@@ -13238,6 +13242,33 @@ var BlockList = class {
     this.ids.add(block.id);
     this.blocks.push(block);
   }
+  // private addBlockToFront(block: Block): void {
+  //   if (this.hasBlock(block.id)) {
+  //     throw new Error(`block with id "${block.id}" already exists`);
+  //   }
+  //   this.ids.add(block.id);
+  //   this.blocks.unshift(block);
+  // }
+  insertBlock(block, precedingBlockId) {
+    if (this.hasBlock(block.id)) {
+      throw new Error(`block with id "${block.id}" already exists`);
+    }
+    if (precedingBlockId === void 0) {
+      this.addBlock(block);
+      return;
+    }
+    if (!this.hasBlock(precedingBlockId)) {
+      throw new Error(
+        `preceding block with id "${precedingBlockId}" does not exist`
+      );
+    }
+    this.ids.add(block.id);
+    this.blocks.splice(
+      this.blocks.findIndex((b) => b.id === precedingBlockId),
+      0,
+      block
+    );
+  }
   hasBlock(id) {
     return this.ids.has(id);
   }
@@ -13259,6 +13290,7 @@ var ReadmeGenerator = class {
   originalReadme;
   languageTitle;
   organizationPascalCase;
+  apiName;
   constructor({
     readmeParser,
     readmeConfig,
@@ -13269,6 +13301,7 @@ var ReadmeGenerator = class {
     this.originalReadme = originalReadme;
     this.languageTitle = languageToTitle(this.readmeConfig.language);
     this.organizationPascalCase = pascalCase(this.readmeConfig.organization);
+    this.apiName = this.readmeConfig.apiName ?? this.organizationPascalCase;
   }
   async generateReadme({
     output
@@ -13312,6 +13345,19 @@ var ReadmeGenerator = class {
         })
       );
     }
+    if (this.readmeConfig.customSections != null) {
+      const templateOptions = this.getCustomSectionTemplateOptions();
+      for (const customSection of this.readmeConfig.customSections.filter(
+        (section) => section.language.toLowerCase() === this.readmeConfig.language.type.toLowerCase()
+      )) {
+        blocks.push(
+          await this.generateCustomSection({
+            customSection,
+            templateOptions
+          })
+        );
+      }
+    }
     const coreFeatures = this.readmeConfig.features?.filter((feat) => !this.isAdvanced(feat)) ?? [];
     const advancedFeatures = this.readmeConfig.features?.filter((feat) => this.isAdvanced(feat)) ?? [];
     for (const feature of coreFeatures) {
@@ -13331,9 +13377,14 @@ var ReadmeGenerator = class {
     if (advancedFeatureBlock != null) {
       blocks.push(advancedFeatureBlock);
     }
-    blocks.push(this.generateContributing());
+    if (!this.featureDisabled(api_exports.StructuredFeatureId.Contributing)) {
+      blocks.push(this.generateContributing());
+    }
     return blocks;
   }
+  featureDisabled(featureId) {
+    return this.readmeConfig.disabledFeatures?.includes(featureId) ?? false;
+  }
   isAdvanced(feat) {
     if (this.ADVANCED_FEATURES.has(feat.id)) {
       return true;
@@ -13427,9 +13478,7 @@ var ReadmeGenerator = class {
     }
   }
   async writeHeader({ writer }) {
-    await writer.writeLine(
-      `# ${this.organizationPascalCase} ${this.languageTitle} Library`
-    );
+    await writer.writeLine(`# ${this.apiName} ${this.languageTitle} Library`);
     await writer.writeLine();
     if (this.readmeConfig.bannerLink != null) {
       await this.writeBanner({
@@ -13437,7 +13486,9 @@ var ReadmeGenerator = class {
         bannerLink: this.readmeConfig.bannerLink
       });
     }
-    await this.writeFernShield({ writer });
+    if (!this.isWhiteLabel()) {
+      await this.writeFernShield({ writer });
+    }
     if (this.readmeConfig.language != null) {
       await this.writeShield({
         writer,
@@ -13447,6 +13498,9 @@ var ReadmeGenerator = class {
     await writer.writeLine();
     await this.writeIntro({ writer });
   }
+  isWhiteLabel() {
+    return this.readmeConfig.whiteLabel ?? false;
+  }
   async writeBanner({
     writer,
     bannerLink
@@ -13462,7 +13516,7 @@ var ReadmeGenerator = class {
   }
   async writeIntro({ writer }) {
     await writer.writeLine(
-      this.readmeConfig.introduction != null ? this.readmeConfig.introduction : `The ${this.organizationPascalCase} ${this.languageTitle} library provides convenient access to the ${this.organizationPascalCase} API from ${this.languageTitle}.`
+      this.readmeConfig.introduction != null ? this.readmeConfig.introduction : `The ${this.apiName} ${this.languageTitle} library provides convenient access to the ${this.apiName} APIs from ${this.languageTitle}.`
     );
     await writer.writeLine();
   }
@@ -13496,6 +13550,42 @@ var ReadmeGenerator = class {
       content: writer.toString()
     });
   }
+  getCustomSectionTemplateOptions() {
+    let options = {
+      apiName: this.apiName
+    };
+    if (this.readmeConfig.language.publishInfo != null) {
+      options = {
+        ...options,
+        ...this.readmeConfig.language.publishInfo
+      };
+    }
+    return options;
+  }
+  applyTemplateOptions(content, options) {
+    try {
+      return (0, import_compat.template)(content, { interpolate: /{{([^}]+)}}/g })(options);
+    } catch (error) {
+      console.error(`[templates] ${JSON.stringify(error)}`);
+      return content;
+    }
+  }
+  async generateCustomSection({
+    customSection,
+    templateOptions
+  }) {
+    const writer = new StringWriter();
+    await writer.writeLine(`## ${customSection.name}`);
+    await writer.writeLine();
+    await writer.writeLine(
+      this.applyTemplateOptions(customSection.content, templateOptions)
+    );
+    await writer.writeLine();
+    return new Block({
+      id: toScreamingSnakeCase(customSection.name),
+      content: writer.toString()
+    });
+  }
   async generateRequirements({
     requirements
   }) {
@@ -13938,7 +14028,7 @@ On the other hand, contributions to the README are always very welcome!
   shouldSkipFeature({
     feature
   }) {
-    return !feature.snippetsAreOptional && (feature.snippets == null || feature.snippets.length === 0);
+    return this.featureDisabled(feature.id) || !feature.snippetsAreOptional && (feature.snippets == null || feature.snippets.length === 0);
   }
   shouldGenerateFeatures({
     features
@@ -13982,6 +14072,9 @@ function getMajorVersion(version) {
 function assertNever(x) {
   throw new Error(`unexpected value: ${JSON.stringify(x)}`);
 }
+function toScreamingSnakeCase(s) {
+  return s.toUpperCase().replace(/ /g, "_");
+}
 
 // src/readme/ReadmeParser.ts
 var import_string2 = require("es-toolkit/string");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fern-api/generator-cli",
-  "version": "0.0.41",
+  "version": "0.1.0",
   "type": "module",
   "main": "dist/cli.cjs",
   "source": "src/index.ts",