@fern-api/fern-api-dev 5.23.3-1908-g908f2e99679 → 5.23.3-1914-gc2c69d7cf16

package/cli.cjs

@@ -622452,7 +622452,7 @@ var require_ReadmeGenerator = __commonJS({
             docsLink: this.readmeConfig.apiReferenceLink
           }));
         }
-        if (this.readmeConfig.requirements != null) {
+        if (this.readmeConfig.requirements != null && this.readmeConfig.requirements.length > 0) {
           blocks2.push(await this.generateRequirements({
             requirements: this.readmeConfig.requirements
           }));
@@ -702935,7 +702935,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.23.3-1908-g908f2e99679",
+          version: "5.23.3-1914-gc2c69d7cf16",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -703001,7 +703001,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.23.3-1908-g908f2e99679",
+        version: "5.23.3-1914-gc2c69d7cf16",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -884383,7 +884383,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.23.3-1908-g908f2e99679";
+  const version7 = "5.23.3-1914-gc2c69d7cf16";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -909703,7 +909703,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.23.3-1908-g908f2e99679",
+        cliVersion: "5.23.3-1914-gc2c69d7cf16",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -914820,7 +914820,7 @@ function buildSnippetTestGeneratorConfig(config5) {
 }
 
 // ../../../generators/csharp/codegen/lib/ast/core/Writer.js
-var Writer = class extends AbstractWriter {
+var Writer = class _Writer extends AbstractWriter {
   /* Import statements */
   references = {};
   /* The namespace that is being written to */
@@ -914869,6 +914869,30 @@ var Writer = class extends AbstractWriter {
   popTypeScope() {
     this.typeScopeStack.pop();
   }
+  /* Renders the node in isolation and returns the result instead of appending it to this
+     writer's buffer. References collected while rendering are forwarded to this writer so
+     that the imports the node depends on are still emitted. */
+  renderNodeToString(node4) {
+    const scratch = new _Writer({
+      namespace: this.namespace,
+      allNamespaceSegments: this.allNamespaceSegments,
+      allTypeClassReferences: this.allTypeClassReferences,
+      generation: this.generation,
+      skipImports: this.skipImports,
+      skipGlobalQualifier: this.skipGlobalQualifier
+    });
+    for (const enclosingType of this.typeScopeStack) {
+      scratch.pushTypeScope(enclosingType);
+    }
+    scratch.writeNode(node4);
+    for (const [namespace, references] of Object.entries(scratch.references)) {
+      this.addNamespace(namespace);
+      for (const reference4 of references) {
+        this.addReference(reference4);
+      }
+    }
+    return scratch.toString(true);
+  }
   addNamespace(namespace) {
     const foundNamespace = this.references[namespace];
     if (foundNamespace == null) {
@@ -924309,6 +924333,30 @@ var XmlDocWriter = class _XmlDocWriter {
     "thead",
     "tbody"
   ]);
+  // Matches an ampersand that does not already begin a character or entity reference
+  static BARE_AMPERSAND_PATTERN = /&(?!(?:[a-zA-Z][a-zA-Z0-9]*|#[0-9]+|#x[0-9a-fA-F]+);)/g;
+  // A (possibly namespace-qualified) type name, optionally followed by generic arguments
+  static TYPE_NAME_PATTERN = /^([A-Za-z_][A-Za-z0-9_.]*)(?:<(.+)>)?$/;
+  static IDENTIFIER_PATTERN = /^[A-Za-z_][A-Za-z0-9_.]*$/;
+  // Generic arguments in a cref must be identifiers, so keyword aliases are replaced by the
+  // framework type they alias
+  static KEYWORD_ALIASES = {
+    bool: "Boolean",
+    byte: "Byte",
+    char: "Char",
+    decimal: "Decimal",
+    double: "Double",
+    float: "Single",
+    int: "Int32",
+    long: "Int64",
+    object: "Object",
+    sbyte: "SByte",
+    short: "Int16",
+    string: "String",
+    uint: "UInt32",
+    ulong: "UInt64",
+    ushort: "UInt16"
+  };
   writer;
   wrotePrefixOnCurrentLine = false;
   constructor(writer2) {
@@ -924362,6 +924410,73 @@ var XmlDocWriter = class _XmlDocWriter {
   writeNode(node4) {
     this.writer.writeNode(node4);
   }
+  /**
+   * Writes a documentation reference to a type. Types that can be expressed as a
+   * documentation comment identifier are written as `<see cref="..."/>` so that the
+   * compiler resolves them and IDEs link them; anything else falls back to inline code.
+   */
+  writeSeeType(type7) {
+    const rendered = this.writer.renderNodeToString(type7);
+    const crefTarget = _XmlDocWriter.toCrefTarget(rendered);
+    if (crefTarget != null) {
+      this.write(`<see cref="${crefTarget}"/>`);
+      return;
+    }
+    this.write(`<c>${this.escapeXmlDocContent(rendered)}</c>`);
+  }
+  /**
+   * Converts C# source syntax for a type into a documentation comment identifier, or returns
+   * undefined when the type cannot be expressed as one.
+   *
+   * Nullable annotations are dropped (`object?` -> `object`) because they are not part of a
+   * type's identifier, and generic arguments use brace syntax (`List<Foo>` -> `List{Foo}`)
+   * because crefs are resolved by the compiler rather than rendered as text. Generic arguments
+   * must be identifiers, so keyword aliases become framework type names
+   * (`List<string>` -> `List{String}`) and arrays or nested generic arguments are rejected.
+   */
+  static toCrefTarget(renderedType) {
+    const type7 = renderedType.trim().replaceAll("?", "");
+    const match3 = _XmlDocWriter.TYPE_NAME_PATTERN.exec(type7);
+    if (match3 == null) {
+      return void 0;
+    }
+    const [, name2, genericArguments] = match3;
+    if (name2 == null) {
+      return void 0;
+    }
+    if (genericArguments == null) {
+      return name2;
+    }
+    const crefArguments = [];
+    for (const argument of _XmlDocWriter.splitGenericArguments(genericArguments)) {
+      const identifier2 = _XmlDocWriter.KEYWORD_ALIASES[argument] ?? argument;
+      if (!_XmlDocWriter.IDENTIFIER_PATTERN.test(identifier2)) {
+        return void 0;
+      }
+      crefArguments.push(identifier2);
+    }
+    return crefArguments.length === 0 ? void 0 : `${name2}{${crefArguments.join(", ")}}`;
+  }
+  static splitGenericArguments(genericArguments) {
+    const arguments_ = [];
+    let depth = 0;
+    let current3 = "";
+    for (const character of genericArguments) {
+      if (character === "," && depth === 0) {
+        arguments_.push(current3.trim());
+        current3 = "";
+        continue;
+      }
+      if (character === "<") {
+        depth++;
+      } else if (character === ">") {
+        depth--;
+      }
+      current3 += character;
+    }
+    arguments_.push(current3.trim());
+    return arguments_;
+  }
   writeXmlNode(nodeName, text9) {
     this.writePrefix();
     this.writeOpenXmlNode(nodeName);
@@ -924411,7 +924526,7 @@ var XmlDocWriter = class _XmlDocWriter {
       }
       return match3;
     });
-    const escaped = withPlaceholders.replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+    const escaped = withPlaceholders.replace(_XmlDocWriter.BARE_AMPERSAND_PATTERN, "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
     return escaped.replace(/\uE000(\d+)\uE000/g, (_5, index3) => tags[parseInt(index3, 10)] ?? "");
   }
   convertHtmlToXmlDoc(text9) {
@@ -924475,7 +924590,7 @@ var XmlDocWriter = class _XmlDocWriter {
       case "a": {
         const href = el.attribs.href;
         if (href) {
-          return `<see href="${href}">${children2}</see>`;
+          return `<see href="${_XmlDocWriter.escapeXmlAttributeValue(href)}">${children2}</see>`;
         }
         return children2;
       }
@@ -924505,7 +924620,7 @@ var XmlDocWriter = class _XmlDocWriter {
         return children2;
       default: {
         if (_XmlDocWriter.SAFE_XML_DOC_TAGS.has(tag2)) {
-          const attrs = Object.entries(el.attribs).map(([k4, v3]) => ` ${k4}="${v3}"`).join("");
+          const attrs = Object.entries(el.attribs).map(([k4, v3]) => ` ${k4}="${_XmlDocWriter.escapeXmlAttributeValue(v3)}"`).join("");
           if (el.children.length === 0) {
             return `<${el.name}${attrs}/>`;
           }
@@ -924515,6 +924630,14 @@ var XmlDocWriter = class _XmlDocWriter {
       }
     }
   }
+  /**
+   * Escapes the markup characters that are not allowed raw inside an XML attribute value.
+   * Ampersands that already begin a character or entity reference are left alone so that
+   * values such as `?a=1&amp;b=2` are not double escaped.
+   */
+  static escapeXmlAttributeValue(value2) {
+    return value2.replace(_XmlDocWriter.BARE_AMPERSAND_PATTERN, "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;");
+  }
   decodeHtmlEntities(text9) {
     const entityMap = {
       "&plus;": "+",
@@ -929508,6 +929631,10 @@ var Generation = class {
     rootNamespaceForCoreClasses: () => this.customConfig["root-namespace-for-core-classes"] ?? true,
     /** Custom NuGet package identifier. Default: "" (uses root namespace). */
     packageId: () => this.customConfig["package-id"] ?? "",
+    /** When true, the generated csproj emits XML documentation so the nupkg ships `<Namespace>.xml`. Default: true. */
+    generateDocumentationFile: () => this.customConfig["generate-documentation-file"] ?? true,
+    /** NuGet package metadata (description, authors, tags, icon, urls, SourceLink, symbols) for the generated csproj. Default: {}. */
+    packageMetadata: () => this.customConfig["package-metadata"] ?? {},
     /** When true, generates enums that can handle unknown/future values gracefully. Default: true. */
     isForwardCompatibleEnumsEnabled: () => this.customConfig["enable-forward-compatible-enums"] ?? this.customConfig["experimental-enable-forward-compatible-enums"] ?? true,
     /** Mapping of websocket environment configurations. Default: {}. */
@@ -976947,7 +977074,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.23.3-1908-g908f2e99679"
+    cli_version: "5.23.3-1914-gc2c69d7cf16"
   };
 }
 function isAutomationMode() {
@@ -977779,7 +977906,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.23.3-1908-g908f2e99679";
+    return "5.23.3-1914-gc2c69d7cf16";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.23.3-1908-g908f2e99679",
+  "version": "5.23.3-1914-gc2c69d7cf16",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",