@sdk-it/spec 0.28.0 → 0.30.0

package/dist/lib/overview-docs/doc-templates.d.ts

@@ -0,0 +1,51 @@
+export declare const docTemplates: {
+    readonly servers: {
+        readonly sectionTitle: "API Server";
+        readonly description: "The following {count} {isAre} available for this API:";
+    };
+    readonly authMethods: {
+        readonly sectionTitle: "Available Authentication Method";
+        readonly introText: "This API provides secure access through {countText} authentication {method}. Below you'll find details about {articleCount} available authentication {scheme} and how to use {pronoun}.";
+        readonly noAuthText: "This API does not require authentication.";
+    };
+    readonly apiClients: {
+        readonly sectionTitle: "Official API Client";
+        readonly description: "{apiTitle} provides official client SDK{sdkPlural} for {languageText}. We recommend using {clientText} to interact with all stable endpoints. You can find {pronoun} here:";
+    };
+    readonly needHelp: {
+        readonly sectionTitle: "Need Help?";
+    };
+};
+interface CountTextOptions {
+    count: number;
+    word: string;
+    includeCount?: boolean;
+}
+export declare function getCountText(options: CountTextOptions): string;
+export declare function getPronoun(count: number, type?: 'subject' | 'object'): string;
+export declare function getArticle(count: number, word: string): string;
+export declare function getIsAre(count: number): string;
+export declare function getThisThese(count: number): string;
+export declare function processTemplate(template: string, replacements: Record<string, string | number>): string;
+export declare function getServerText(count: number): {
+    title: string;
+    description: string;
+};
+export declare function getAuthMethodText(count: number): {
+    title: string;
+    intro: string;
+};
+export declare function getApiClientText(count: number, apiTitle: string): {
+    title: string;
+    description: string;
+};
+export declare function getAuthText(count: number): {
+    title: string;
+    intro: string;
+};
+export declare function getErrorsApiClientText(count: number, apiTitle: string, sdkList: string[]): {
+    title: string;
+    description: string;
+};
+export {};
+//# sourceMappingURL=doc-templates.d.ts.map

package/dist/lib/overview-docs/doc-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-templates.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/doc-templates.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAmBf,CAAC;AAEX,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAK9D;AAED,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,SAAS,GAAG,QAAmB,GACpC,MAAM,CAKR;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAC5C,MAAM,CAKR;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAQA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAeA;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GACf;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAkBA;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAeA;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EAAE,GAChB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAWA"}

package/dist/lib/overview-docs/doc-templates.js

@@ -0,0 +1,123 @@
+import pluralize from "pluralize";
+const docTemplates = {
+  servers: {
+    sectionTitle: "API Server",
+    description: "The following {count} {isAre} available for this API:"
+  },
+  authMethods: {
+    sectionTitle: "Available Authentication Method",
+    introText: "This API provides secure access through {countText} authentication {method}. Below you'll find details about {articleCount} available authentication {scheme} and how to use {pronoun}.",
+    noAuthText: "This API does not require authentication."
+  },
+  apiClients: {
+    sectionTitle: "Official API Client",
+    description: "{apiTitle} provides official client SDK{sdkPlural} for {languageText}. We recommend using {clientText} to interact with all stable endpoints. You can find {pronoun} here:"
+  },
+  needHelp: {
+    sectionTitle: "Need Help?"
+  }
+};
+function getCountText(options) {
+  const { count, word, includeCount = false } = options;
+  const pluralizedWord = count === 1 ? pluralize.singular(word) : pluralize.plural(word);
+  return includeCount ? `${count} ${pluralizedWord}` : pluralizedWord;
+}
+function getPronoun(count, type = "object") {
+  if (type === "subject") {
+    return count === 1 ? "it" : "they";
+  }
+  return count === 1 ? "it" : "them";
+}
+function getArticle(count, word) {
+  if (count === 1) {
+    const firstLetter = word.charAt(0).toLowerCase();
+    return ["a", "e", "i", "o", "u"].includes(firstLetter) ? "an" : "a";
+  }
+  return "";
+}
+function getIsAre(count) {
+  return count === 1 ? "is" : "are";
+}
+function getThisThese(count) {
+  return count === 1 ? "this" : "these";
+}
+function processTemplate(template, replacements) {
+  return template.replace(/\{([^}]+)\}/g, (match, key) => {
+    const value = replacements[key];
+    return value !== void 0 ? String(value) : match;
+  });
+}
+function getServerText(count) {
+  return {
+    title: `## ${getCountText({ count, word: "server", includeCount: false })}`,
+    description: processTemplate(docTemplates.servers.description, {
+      count: getCountText({ count, word: "server", includeCount: true }),
+      isAre: getIsAre(count)
+    })
+  };
+}
+function getAuthMethodText(count) {
+  const countText = count === 1 ? getArticle(count, "authentication method") : "various";
+  const articleCount = count === 1 ? "the" : "each";
+  return {
+    title: `## ${getCountText({ count, word: docTemplates.authMethods.sectionTitle })}`,
+    intro: processTemplate(docTemplates.authMethods.introText, {
+      countText,
+      method: getCountText({ count, word: "method" }),
+      articleCount,
+      scheme: getCountText({ count, word: "scheme" }),
+      pronoun: getPronoun(count)
+    })
+  };
+}
+function getApiClientText(count, apiTitle) {
+  const languageText = count === 1 ? "a programming language" : "multiple programming languages";
+  const clientText = count === 1 ? getThisThese(count) + " client" : getThisThese(count) + " clients";
+  return {
+    title: `## ${getCountText({ count, word: docTemplates.apiClients.sectionTitle })}`,
+    description: processTemplate(docTemplates.apiClients.description, {
+      apiTitle,
+      sdkPlural: count === 1 ? "" : "s",
+      languageText,
+      clientText,
+      pronoun: getPronoun(count)
+    })
+  };
+}
+function getAuthText(count) {
+  const countText = count === 1 ? getArticle(count, "authentication method") : "various";
+  const articleCount = count === 1 ? "the" : "each";
+  return {
+    title: `## ${getCountText({ count, word: docTemplates.authMethods.sectionTitle })}`,
+    intro: processTemplate(docTemplates.authMethods.introText, {
+      countText,
+      method: getCountText({ count, word: "method" }),
+      articleCount,
+      scheme: getCountText({ count, word: "scheme" }),
+      pronoun: getPronoun(count)
+    })
+  };
+}
+function getErrorsApiClientText(count, apiTitle, sdkList) {
+  const languageText = count === 1 ? sdkList[0] : sdkList.join(", ");
+  const clientText = count === 1 ? getThisThese(count) + " client" : getThisThese(count) + " clients";
+  return {
+    title: `## ${getCountText({ count, word: docTemplates.apiClients.sectionTitle })}`,
+    description: `${apiTitle} maintains official API ${getCountText({ count, word: "client" })}${count > 0 ? ` for ${languageText}` : ""}. We recommend using ${clientText} to interact with all stable endpoints. You can find ${getPronoun(count)} here:`
+  };
+}
+export {
+  docTemplates,
+  getApiClientText,
+  getArticle,
+  getAuthMethodText,
+  getAuthText,
+  getCountText,
+  getErrorsApiClientText,
+  getIsAre,
+  getPronoun,
+  getServerText,
+  getThisThese,
+  processTemplate
+};
+//# sourceMappingURL=doc-templates.js.map

package/dist/lib/overview-docs/doc-templates.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/overview-docs/doc-templates.ts"],
+  "sourcesContent": ["import pluralize from 'pluralize';\n\nexport const docTemplates = {\n  servers: {\n    sectionTitle: 'API Server',\n    description: 'The following {count} {isAre} available for this API:',\n  },\n  authMethods: {\n    sectionTitle: 'Available Authentication Method',\n    introText:\n      \"This API provides secure access through {countText} authentication {method}. Below you'll find details about {articleCount} available authentication {scheme} and how to use {pronoun}.\",\n    noAuthText: 'This API does not require authentication.',\n  },\n  apiClients: {\n    sectionTitle: 'Official API Client',\n    description:\n      '{apiTitle} provides official client SDK{sdkPlural} for {languageText}. We recommend using {clientText} to interact with all stable endpoints. You can find {pronoun} here:',\n  },\n  needHelp: {\n    sectionTitle: 'Need Help?',\n  },\n} as const;\n\ninterface CountTextOptions {\n  count: number;\n  word: string;\n  includeCount?: boolean;\n}\n\nexport function getCountText(options: CountTextOptions): string {\n  const { count, word, includeCount = false } = options;\n  const pluralizedWord =\n    count === 1 ? pluralize.singular(word) : pluralize.plural(word);\n  return includeCount ? `${count} ${pluralizedWord}` : pluralizedWord;\n}\n\nexport function getPronoun(\n  count: number,\n  type: 'subject' | 'object' = 'object',\n): string {\n  if (type === 'subject') {\n    return count === 1 ? 'it' : 'they';\n  }\n  return count === 1 ? 'it' : 'them';\n}\n\nexport function getArticle(count: number, word: string): string {\n  if (count === 1) {\n    const firstLetter = word.charAt(0).toLowerCase();\n    return ['a', 'e', 'i', 'o', 'u'].includes(firstLetter) ? 'an' : 'a';\n  }\n  return '';\n}\n\nexport function getIsAre(count: number): string {\n  return count === 1 ? 'is' : 'are';\n}\n\nexport function getThisThese(count: number): string {\n  return count === 1 ? 'this' : 'these';\n}\n\nexport function processTemplate(\n  template: string,\n  replacements: Record<string, string | number>,\n): string {\n  return template.replace(/\\{([^}]+)\\}/g, (match, key) => {\n    const value = replacements[key];\n    return value !== undefined ? String(value) : match;\n  });\n}\n\nexport function getServerText(count: number): {\n  title: string;\n  description: string;\n} {\n  return {\n    title: `## ${getCountText({ count, word: 'server', includeCount: false })}`,\n    description: processTemplate(docTemplates.servers.description, {\n      count: getCountText({ count, word: 'server', includeCount: true }),\n      isAre: getIsAre(count),\n    }),\n  };\n}\n\nexport function getAuthMethodText(count: number): {\n  title: string;\n  intro: string;\n} {\n  const countText =\n    count === 1 ? getArticle(count, 'authentication method') : 'various';\n  const articleCount = count === 1 ? 'the' : 'each';\n\n  return {\n    title: `## ${getCountText({ count, word: docTemplates.authMethods.sectionTitle })}`,\n    intro: processTemplate(docTemplates.authMethods.introText, {\n      countText,\n      method: getCountText({ count, word: 'method' }),\n      articleCount,\n      scheme: getCountText({ count, word: 'scheme' }),\n      pronoun: getPronoun(count),\n    }),\n  };\n}\n\nexport function getApiClientText(\n  count: number,\n  apiTitle: string,\n): {\n  title: string;\n  description: string;\n} {\n  const languageText =\n    count === 1 ? 'a programming language' : 'multiple programming languages';\n  const clientText =\n    count === 1\n      ? getThisThese(count) + ' client'\n      : getThisThese(count) + ' clients';\n\n  return {\n    title: `## ${getCountText({ count, word: docTemplates.apiClients.sectionTitle })}`,\n    description: processTemplate(docTemplates.apiClients.description, {\n      apiTitle,\n      sdkPlural: count === 1 ? '' : 's',\n      languageText,\n      clientText,\n      pronoun: getPronoun(count),\n    }),\n  };\n}\n\nexport function getAuthText(count: number): {\n  title: string;\n  intro: string;\n} {\n  const countText =\n    count === 1 ? getArticle(count, 'authentication method') : 'various';\n  const articleCount = count === 1 ? 'the' : 'each';\n\n  return {\n    title: `## ${getCountText({ count, word: docTemplates.authMethods.sectionTitle })}`,\n    intro: processTemplate(docTemplates.authMethods.introText, {\n      countText,\n      method: getCountText({ count, word: 'method' }),\n      articleCount,\n      scheme: getCountText({ count, word: 'scheme' }),\n      pronoun: getPronoun(count),\n    }),\n  };\n}\n\nexport function getErrorsApiClientText(\n  count: number,\n  apiTitle: string,\n  sdkList: string[],\n): {\n  title: string;\n  description: string;\n} {\n  const languageText = count === 1 ? sdkList[0] : sdkList.join(', ');\n  const clientText =\n    count === 1\n      ? getThisThese(count) + ' client'\n      : getThisThese(count) + ' clients';\n\n  return {\n    title: `## ${getCountText({ count, word: docTemplates.apiClients.sectionTitle })}`,\n    description: `${apiTitle} maintains official API ${getCountText({ count, word: 'client' })}${count > 0 ? ` for ${languageText}` : ''}. We recommend using ${clientText} to interact with all stable endpoints. You can find ${getPronoun(count)} here:`,\n  };\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/lib/overview-docs/doc-text-utils.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Preset documentation text templates for consistent singular/plural handling
+ */
+export declare const presetDocs: {
+    readonly auth: {
+        readonly section: {
+            readonly singular: "Available Authentication Method";
+            readonly plural: "Available Authentication Methods";
+        };
+        readonly description: {
+            readonly singular: "an authentication method";
+            readonly plural: "various authentication methods";
+        };
+        readonly scheme: {
+            readonly singular: "the available authentication scheme";
+            readonly plural: "each available authentication scheme";
+        };
+        readonly intro: {
+            readonly template: (count: number, methods: string, schemes: string, pronoun: string) => string;
+        };
+    };
+    readonly server: {
+        readonly section: {
+            readonly singular: "API Server";
+            readonly plural: "API Servers";
+        };
+        readonly description: {
+            readonly singular: "The following server is available for this API:";
+            readonly plural: "The following servers are available for this API:";
+        };
+    };
+    readonly client: {
+        readonly section: {
+            readonly singular: "Official API Client";
+            readonly plural: "Official API Clients";
+        };
+        readonly sdk: {
+            readonly singular: "SDK";
+            readonly plural: "SDKs";
+        };
+        readonly language: {
+            readonly singular: "a programming language";
+            readonly plural: "multiple programming languages";
+        };
+        readonly recommendation: {
+            readonly singular: "this client";
+            readonly plural: "these clients";
+        };
+        readonly location: {
+            readonly singular: "it";
+            readonly plural: "them";
+        };
+        readonly intro: {
+            readonly template: (apiTitle: string, count: number, sdks: string, languages: string, recommendation: string, location: string) => string;
+        };
+    };
+};
+/**
+ * Common pronouns and determiners based on count
+ */
+export declare const pronouns: {
+    readonly pronoun: (count: number) => "it" | "them";
+    readonly determiner: (count: number) => "this" | "these";
+    readonly article: (count: number) => "" | "a";
+};
+/**
+ * Get the appropriate text based on count (singular/plural)
+ */
+export declare function getTextByCount<T extends Record<'singular' | 'plural', string>>(count: number, textOptions: T): string;
+/**
+ * Automatically pluralize a word based on count using the pluralize library
+ */
+export declare function pluralizeWord(word: string, count: number): string;
+/**
+ * Helper function to get common text variations based on count
+ */
+export declare function getCommonText(count: number): {
+    pronoun: string;
+    determiner: string;
+    article: string;
+    isAre: string;
+    hasHave: string;
+};
+export declare function getAuthIntroText(count: number): string;
+export declare function getClientIntroText(apiTitle: string, count: number): string;
+//# sourceMappingURL=doc-text-utils.d.ts.map

package/dist/lib/overview-docs/doc-text-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-text-utils.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/doc-text-utils.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;uCAgBR,MAAM,WACJ,MAAM,WACN,MAAM,WACN,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0CAsCL,MAAM,SACT,MAAM,QACP,MAAM,aACD,MAAM,kBACD,MAAM,YACZ,MAAM;;;CAKd,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,QAAQ;8BACF,MAAM;iCACH,MAAM;8BACT,MAAM;CACf,CAAC;AAEX;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,UAAU,GAAG,QAAQ,EAAE,MAAM,CAAC,EAC5E,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,CAAC,GACb,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM;;;;;;EAQ1C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB1E"}

package/dist/lib/overview-docs/doc-text-utils.js

@@ -0,0 +1,108 @@
+import pluralize from "pluralize";
+const presetDocs = {
+  auth: {
+    section: {
+      singular: "Available Authentication Method",
+      plural: "Available Authentication Methods"
+    },
+    description: {
+      singular: "an authentication method",
+      plural: "various authentication methods"
+    },
+    scheme: {
+      singular: "the available authentication scheme",
+      plural: "each available authentication scheme"
+    },
+    intro: {
+      template: (count, methods, schemes, pronoun) => `This API provides secure access through ${methods}. Below you'll find details about ${schemes} and how to use ${pronoun}.`
+    }
+  },
+  server: {
+    section: {
+      singular: "API Server",
+      plural: "API Servers"
+    },
+    description: {
+      singular: "The following server is available for this API:",
+      plural: "The following servers are available for this API:"
+    }
+  },
+  client: {
+    section: {
+      singular: "Official API Client",
+      plural: "Official API Clients"
+    },
+    sdk: {
+      singular: "SDK",
+      plural: "SDKs"
+    },
+    language: {
+      singular: "a programming language",
+      plural: "multiple programming languages"
+    },
+    recommendation: {
+      singular: "this client",
+      plural: "these clients"
+    },
+    location: {
+      singular: "it",
+      plural: "them"
+    },
+    intro: {
+      template: (apiTitle, count, sdks, languages, recommendation, location) => `${apiTitle} provides official client ${sdks} for ${languages}. We recommend using ${recommendation} to interact with all stable endpoints. You can find ${location} here:`
+    }
+  }
+};
+const pronouns = {
+  pronoun: (count) => count === 1 ? "it" : "them",
+  determiner: (count) => count === 1 ? "this" : "these",
+  article: (count) => count === 1 ? "a" : ""
+};
+function getTextByCount(count, textOptions) {
+  return count === 1 ? textOptions.singular : textOptions.plural;
+}
+function pluralizeWord(word, count) {
+  return pluralize(word, count);
+}
+function getCommonText(count) {
+  return {
+    pronoun: pronouns.pronoun(count),
+    determiner: pronouns.determiner(count),
+    article: pronouns.article(count),
+    isAre: count === 1 ? "is" : "are",
+    hasHave: count === 1 ? "has" : "have"
+  };
+}
+function getAuthIntroText(count) {
+  const methods = getTextByCount(count, presetDocs.auth.description);
+  const schemes = getTextByCount(count, presetDocs.auth.scheme);
+  const pronoun = pronouns.pronoun(count);
+  return presetDocs.auth.intro.template(count, methods, schemes, pronoun);
+}
+function getClientIntroText(apiTitle, count) {
+  const sdks = getTextByCount(count, presetDocs.client.sdk);
+  const languages = getTextByCount(count, presetDocs.client.language);
+  const recommendation = getTextByCount(
+    count,
+    presetDocs.client.recommendation
+  );
+  const location = getTextByCount(count, presetDocs.client.location);
+  return presetDocs.client.intro.template(
+    apiTitle,
+    count,
+    sdks,
+    languages,
+    recommendation,
+    location
+  );
+}
+export {
+  getAuthIntroText,
+  getClientIntroText,
+  getCommonText,
+  getTextByCount,
+  pluralizeWord,
+  presetDocs,
+  pronouns
+};
+//# sourceMappingURL=doc-text-utils.js.map

package/dist/lib/overview-docs/doc-text-utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/overview-docs/doc-text-utils.ts"],
+  "sourcesContent": ["import pluralize from 'pluralize';\n\n/**\n * Preset documentation text templates for consistent singular/plural handling\n */\nexport const presetDocs = {\n  auth: {\n    section: {\n      singular: 'Available Authentication Method',\n      plural: 'Available Authentication Methods',\n    },\n    description: {\n      singular: 'an authentication method',\n      plural: 'various authentication methods',\n    },\n    scheme: {\n      singular: 'the available authentication scheme',\n      plural: 'each available authentication scheme',\n    },\n    intro: {\n      template: (\n        count: number,\n        methods: string,\n        schemes: string,\n        pronoun: string,\n      ) =>\n        `This API provides secure access through ${methods}. Below you'll find details about ${schemes} and how to use ${pronoun}.`,\n    },\n  },\n  server: {\n    section: {\n      singular: 'API Server',\n      plural: 'API Servers',\n    },\n    description: {\n      singular: 'The following server is available for this API:',\n      plural: 'The following servers are available for this API:',\n    },\n  },\n  client: {\n    section: {\n      singular: 'Official API Client',\n      plural: 'Official API Clients',\n    },\n    sdk: {\n      singular: 'SDK',\n      plural: 'SDKs',\n    },\n    language: {\n      singular: 'a programming language',\n      plural: 'multiple programming languages',\n    },\n    recommendation: {\n      singular: 'this client',\n      plural: 'these clients',\n    },\n    location: {\n      singular: 'it',\n      plural: 'them',\n    },\n    intro: {\n      template: (\n        apiTitle: string,\n        count: number,\n        sdks: string,\n        languages: string,\n        recommendation: string,\n        location: string,\n      ) =>\n        `${apiTitle} provides official client ${sdks} for ${languages}. We recommend using ${recommendation} to interact with all stable endpoints. You can find ${location} here:`,\n    },\n  },\n} as const;\n\n/**\n * Common pronouns and determiners based on count\n */\nexport const pronouns = {\n  pronoun: (count: number) => (count === 1 ? 'it' : 'them'),\n  determiner: (count: number) => (count === 1 ? 'this' : 'these'),\n  article: (count: number) => (count === 1 ? 'a' : ''),\n} as const;\n\n/**\n * Get the appropriate text based on count (singular/plural)\n */\nexport function getTextByCount<T extends Record<'singular' | 'plural', string>>(\n  count: number,\n  textOptions: T,\n): string {\n  return count === 1 ? textOptions.singular : textOptions.plural;\n}\n\n/**\n * Automatically pluralize a word based on count using the pluralize library\n */\nexport function pluralizeWord(word: string, count: number): string {\n  return pluralize(word, count);\n}\n\n/**\n * Helper function to get common text variations based on count\n */\nexport function getCommonText(count: number) {\n  return {\n    pronoun: pronouns.pronoun(count),\n    determiner: pronouns.determiner(count),\n    article: pronouns.article(count),\n    isAre: count === 1 ? 'is' : 'are',\n    hasHave: count === 1 ? 'has' : 'have',\n  };\n}\n\nexport function getAuthIntroText(count: number): string {\n  const methods = getTextByCount(count, presetDocs.auth.description);\n  const schemes = getTextByCount(count, presetDocs.auth.scheme);\n  const pronoun = pronouns.pronoun(count);\n\n  return presetDocs.auth.intro.template(count, methods, schemes, pronoun);\n}\n\nexport function getClientIntroText(apiTitle: string, count: number): string {\n  const sdks = getTextByCount(count, presetDocs.client.sdk);\n  const languages = getTextByCount(count, presetDocs.client.language);\n  const recommendation = getTextByCount(\n    count,\n    presetDocs.client.recommendation,\n  );\n  const location = getTextByCount(count, presetDocs.client.location);\n\n  return presetDocs.client.intro.template(\n    apiTitle,\n    count,\n    sdks,\n    languages,\n    recommendation,\n    location,\n  );\n}\n"],
+  "mappings": "AAAA,OAAO,eAAe;AAKf,MAAM,aAAa;AAAA,EACxB,MAAM;AAAA,IACJ,SAAS;AAAA,MACP,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,aAAa;AAAA,MACX,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,QAAQ;AAAA,MACN,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,OAAO;AAAA,MACL,UAAU,CACR,OACA,SACA,SACA,YAEA,2CAA2C,OAAO,qCAAqC,OAAO,mBAAmB,OAAO;AAAA,IAC5H;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,SAAS;AAAA,MACP,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,aAAa;AAAA,MACX,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,SAAS;AAAA,MACP,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,KAAK;AAAA,MACH,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,UAAU;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,UAAU;AAAA,MACR,UAAU;AAAA,MACV,QAAQ;AAAA,IACV;AAAA,IACA,OAAO;AAAA,MACL,UAAU,CACR,UACA,OACA,MACA,WACA,gBACA,aAEA,GAAG,QAAQ,6BAA6B,IAAI,QAAQ,SAAS,wBAAwB,cAAc,wDAAwD,QAAQ;AAAA,IACvK;AAAA,EACF;AACF;AAKO,MAAM,WAAW;AAAA,EACtB,SAAS,CAAC,UAAmB,UAAU,IAAI,OAAO;AAAA,EAClD,YAAY,CAAC,UAAmB,UAAU,IAAI,SAAS;AAAA,EACvD,SAAS,CAAC,UAAmB,UAAU,IAAI,MAAM;AACnD;AAKO,SAAS,eACd,OACA,aACQ;AACR,SAAO,UAAU,IAAI,YAAY,WAAW,YAAY;AAC1D;AAKO,SAAS,cAAc,MAAc,OAAuB;AACjE,SAAO,UAAU,MAAM,KAAK;AAC9B;AAKO,SAAS,cAAc,OAAe;AAC3C,SAAO;AAAA,IACL,SAAS,SAAS,QAAQ,KAAK;AAAA,IAC/B,YAAY,SAAS,WAAW,KAAK;AAAA,IACrC,SAAS,SAAS,QAAQ,KAAK;AAAA,IAC/B,OAAO,UAAU,IAAI,OAAO;AAAA,IAC5B,SAAS,UAAU,IAAI,QAAQ;AAAA,EACjC;AACF;AAEO,SAAS,iBAAiB,OAAuB;AACtD,QAAM,UAAU,eAAe,OAAO,WAAW,KAAK,WAAW;AACjE,QAAM,UAAU,eAAe,OAAO,WAAW,KAAK,MAAM;AAC5D,QAAM,UAAU,SAAS,QAAQ,KAAK;AAEtC,SAAO,WAAW,KAAK,MAAM,SAAS,OAAO,SAAS,SAAS,OAAO;AACxE;AAEO,SAAS,mBAAmB,UAAkB,OAAuB;AAC1E,QAAM,OAAO,eAAe,OAAO,WAAW,OAAO,GAAG;AACxD,QAAM,YAAY,eAAe,OAAO,WAAW,OAAO,QAAQ;AAClE,QAAM,iBAAiB;AAAA,IACrB;AAAA,IACA,WAAW,OAAO;AAAA,EACpB;AACA,QAAM,WAAW,eAAe,OAAO,WAAW,OAAO,QAAQ;AAEjE,SAAO,WAAW,OAAO,MAAM;AAAA,IAC7B;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/lib/overview-docs/overview-auth.d.ts

@@ -1,4 +1,4 @@
 import type { NavItem } from '../sidebar.js';
-import type { OurOpenAPIObject } from '../types.js';
-export declare function generateAuthOverview(spec: OurOpenAPIObject): NavItem;
+import type { IR } from '../types.js';
+export declare function generateAuthOverview(spec: IR): NavItem;
 //# sourceMappingURL=overview-auth.d.ts.map

package/dist/lib/overview-docs/overview-auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overview-auth.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AA+GpD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAsDpE"}
+{"version":3,"file":"overview-auth.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-auth.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AA2FtC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAmDtD"}

package/dist/lib/overview-docs/overview-auth.js

@@ -1,4 +1,9 @@
 import { resolveRef } from "@sdk-it/core";
+import {
+  getAuthIntroText,
+  getTextByCount,
+  presetDocs
+} from "./doc-text-utils.js";
 function getSecuritySchemeDescription(scheme) {
   switch (scheme.type) {
     case "apiKey": {
@@ -77,85 +82,62 @@ function getFlowDisplayName(flowType) {
   };
   return flowNames[flowType] || flowType;
 }
-function formatSecurityRequirements(requirements) {
-  if (!requirements || requirements.length === 0) return "";
-  let result = "";
-  requirements.forEach((req, index) => {
-    const schemes = Object.entries(req);
-    if (schemes.length === 0) {
-      result += `${index + 1}. No authentication required
-`;
-    } else {
-      result += `${index + 1}. Requires: `;
-      const schemeDescriptions = schemes.map(([scheme, scopes]) => {
-        const scopeArray = scopes;
-        if (scopeArray && scopeArray.length > 0) {
-          return `\`${scheme}\` with scopes: ${scopeArray.map((s) => `\`${s}\``).join(", ")}`;
-        }
-        return `\`${scheme}\``;
-      });
-      result += schemeDescriptions.join(" AND ") + "\n";
-    }
-  });
-  return result;
-}
 function generateAuthOverview(spec) {
-  let markdown = `# Authorization
+  let markdown = `# Authentication
 
 `;
-  const securitySchemes = spec.components?.securitySchemes || {};
+  const securitySchemes = spec.components.securitySchemes;
   const globalSecurity = spec.security || [];
-  if (Object.keys(securitySchemes).length === 0 && globalSecurity.length === 0) {
+  const authMethodCount = Object.keys(securitySchemes).length;
+  if (!authMethodCount && !globalSecurity.length) {
     markdown += `This API does not require authentication.
 
 `;
   } else {
-    markdown += `This API provides secure access through various authentication methods. Below you'll find details about each available authentication scheme and how to use them.
+    if (authMethodCount > 1) {
+      markdown += `${getAuthIntroText(authMethodCount)}
 
 `;
-    if (Object.keys(securitySchemes).length > 0) {
-      markdown += `## Available Authentication Methods
+      markdown += `## ${getTextByCount(authMethodCount, presetDocs.auth.section)}
 
 `;
-      for (const [name, scheme] of Object.entries(securitySchemes)) {
-        const schemeObj = resolveRef(spec, scheme);
+    }
+    for (const [name, scheme] of Object.entries(securitySchemes)) {
+      const schemeObj = resolveRef(spec, scheme);
+      if (authMethodCount > 1) {
         markdown += `### ${name}
 
 `;
-        const description = schemeObj.description || getSecuritySchemeDescription(schemeObj);
-        markdown += `${description}
+      }
+      const description = schemeObj.description || getSecuritySchemeDescription(schemeObj);
+      markdown += `${description}
 
 `;
-        if (schemeObj.type === "apiKey") {
-          markdown += `**Details:**
+      if (schemeObj.type === "apiKey") {
+        markdown += `**Details:**
 `;
-          markdown += `- Parameter Name: \`${schemeObj.name}\`
+        markdown += `- Parameter Name: \`${schemeObj.name}\`
 `;
-          markdown += `- Location: ${schemeObj.in === "header" ? "HTTP Header" : schemeObj.in === "query" ? "Query Parameter" : "Cookie"}
+        markdown += `- Location: ${schemeObj.in === "header" ? "HTTP Header" : schemeObj.in === "query" ? "Query Parameter" : "Cookie"}
 
 `;
-        } else if (schemeObj.type === "http") {
-          markdown += `**Details:**
-`;
-          markdown += `- Scheme: \`${schemeObj.scheme}\`
+      } else if (schemeObj.type === "http") {
+        if (schemeObj.bearerFormat) {
+          markdown += `- Token Format: \`${schemeObj.bearerFormat}\`
 `;
-          if (schemeObj.bearerFormat) {
-            markdown += `- Token Format: \`${schemeObj.bearerFormat}\`
-`;
-          }
-          markdown += "\n";
-        } else if (schemeObj.type === "oauth2" && schemeObj.flows) {
-          markdown += `**OAuth 2.0 Flows:**
+        }
+        markdown += "\n";
+      } else if (schemeObj.type === "oauth2" && schemeObj.flows) {
+        markdown += `**OAuth 2.0 Flows:**
 
 `;
-          markdown += formatOAuth2Flows(schemeObj.flows);
-        } else if (schemeObj.type === "openIdConnect") {
-          markdown += `**Details:**
+        markdown += formatOAuth2Flows(schemeObj.flows);
+      } else if (schemeObj.type === "openIdConnect") {
+        markdown += `**Details:**
 `;
-          markdown += `- Discovery URL: \`${schemeObj.openIdConnectUrl}\`
+        markdown += `- Discovery URL: \`${schemeObj.openIdConnectUrl}\`
 
 `;
-        }
       }
     }
   }

package/dist/lib/overview-docs/overview-auth.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/overview-docs/overview-auth.ts"],
-  "sourcesContent": ["import type { OAuthFlowsObject, SecuritySchemeObject } from 'openapi3-ts/oas31';\n\nimport { resolveRef } from '@sdk-it/core';\n\nimport type { NavItem } from '../sidebar.js';\nimport type { OurOpenAPIObject } from '../types.js';\n\nfunction getSecuritySchemeDescription(scheme: SecuritySchemeObject): string {\n  switch (scheme.type) {\n    case 'apiKey': {\n      const location =\n        scheme.in === 'header'\n          ? 'HTTP header'\n          : scheme.in === 'query'\n            ? 'query parameter'\n            : 'cookie';\n      return `API Key authentication requires you to provide an API key in the ${location} named \\`${scheme.name}\\`.`;\n    }\n    case 'http':\n      if (scheme.scheme === 'bearer') {\n        const format = scheme.bearerFormat\n          ? ` The expected token format is \\`${scheme.bearerFormat}\\`.`\n          : '';\n        return `Bearer token authentication requires you to include a bearer token in the \\`Authorization\\` header of your requests.${format}`;\n      }\n      if (scheme.scheme === 'basic') {\n        return `Basic authentication requires you to provide a username and password, encoded in base64 format in the \\`Authorization\\` header.`;\n      }\n      return `HTTP ${scheme.scheme} authentication is required for accessing this API.`;\n    case 'oauth2': {\n      const flows = Object.keys(scheme.flows || {});\n      const flowDescriptions = flows.map((flow) => {\n        switch (flow) {\n          case 'authorizationCode':\n            return 'Authorization Code (for server-side applications)';\n          case 'implicit':\n            return 'Implicit (for browser-based applications)';\n          case 'password':\n            return 'Resource Owner Password Credentials';\n          case 'clientCredentials':\n            return 'Client Credentials (for machine-to-machine authentication)';\n          default:\n            return flow;\n        }\n      });\n      return `OAuth 2.0 authentication is supported with the following grant type(s): ${flowDescriptions.join(', ')}.`;\n    }\n    case 'openIdConnect':\n      return `OpenID Connect authentication is used for this API. You will need to authenticate through the OpenID provider to obtain access tokens.`;\n    default:\n      return 'This API uses a custom authentication scheme. Please refer to the API documentation for specific details.';\n  }\n}\n\nfunction formatOAuth2Flows(flows: OAuthFlowsObject): string {\n  let result = '';\n\n  for (const [flowType, flow] of Object.entries(flows || {})) {\n    result += `#### ${getFlowDisplayName(flowType)}\\n\\n`;\n\n    if (flow.authorizationUrl) {\n      result += `- **Authorization URL:** \\`${flow.authorizationUrl}\\`\\n`;\n    }\n    if (flow.tokenUrl) {\n      result += `- **Token URL:** \\`${flow.tokenUrl}\\`\\n`;\n    }\n    if (flow.refreshUrl) {\n      result += `- **Refresh URL:** \\`${flow.refreshUrl}\\`\\n`;\n    }\n    if (flow.scopes && Object.keys(flow.scopes).length > 0) {\n      result += `- **Available Scopes:**\\n`;\n      for (const [scope, description] of Object.entries(flow.scopes)) {\n        result += `  - \\`${scope}\\`: ${description}\\n`;\n      }\n    }\n    result += '\\n';\n  }\n\n  return result;\n}\n\nfunction getFlowDisplayName(flowType: string): string {\n  const flowNames: Record<string, string> = {\n    authorizationCode: 'Authorization Code Flow',\n    implicit: 'Implicit Flow',\n    password: 'Resource Owner Password Flow',\n    clientCredentials: 'Client Credentials Flow',\n  };\n  return flowNames[flowType] || flowType;\n}\n\nfunction formatSecurityRequirements(\n  requirements: Array<Record<string, string[]>>,\n): string {\n  if (!requirements || requirements.length === 0) return '';\n\n  let result = '';\n  requirements.forEach((req, index) => {\n    const schemes = Object.entries(req);\n    if (schemes.length === 0) {\n      result += `${index + 1}. No authentication required\\n`;\n    } else {\n      result += `${index + 1}. Requires: `;\n      const schemeDescriptions = schemes.map(([scheme, scopes]) => {\n        const scopeArray = scopes as string[];\n        if (scopeArray && scopeArray.length > 0) {\n          return `\\`${scheme}\\` with scopes: ${scopeArray.map((s) => `\\`${s}\\``).join(', ')}`;\n        }\n        return `\\`${scheme}\\``;\n      });\n      result += schemeDescriptions.join(' AND ') + '\\n';\n    }\n  });\n  return result;\n}\n\nexport function generateAuthOverview(spec: OurOpenAPIObject): NavItem {\n  let markdown = `# Authorization\\n\\n`;\n\n  const securitySchemes = spec.components?.securitySchemes || {};\n  const globalSecurity = spec.security || [];\n\n  if (\n    Object.keys(securitySchemes).length === 0 &&\n    globalSecurity.length === 0\n  ) {\n    markdown += `This API does not require authentication.\\n\\n`;\n  } else {\n    markdown += `This API provides secure access through various authentication methods. Below you'll find details about each available authentication scheme and how to use them.\\n\\n`;\n\n    if (Object.keys(securitySchemes).length > 0) {\n      markdown += `## Available Authentication Methods\\n\\n`;\n\n      for (const [name, scheme] of Object.entries(securitySchemes)) {\n        const schemeObj = resolveRef<SecuritySchemeObject>(spec, scheme);\n        markdown += `### ${name}\\n\\n`;\n\n        const description =\n          schemeObj.description || getSecuritySchemeDescription(schemeObj);\n        markdown += `${description}\\n\\n`;\n\n        if (schemeObj.type === 'apiKey') {\n          markdown += `**Details:**\\n`;\n          markdown += `- Parameter Name: \\`${schemeObj.name}\\`\\n`;\n          markdown += `- Location: ${schemeObj.in === 'header' ? 'HTTP Header' : schemeObj.in === 'query' ? 'Query Parameter' : 'Cookie'}\\n\\n`;\n        } else if (schemeObj.type === 'http') {\n          markdown += `**Details:**\\n`;\n          markdown += `- Scheme: \\`${schemeObj.scheme}\\`\\n`;\n          if (schemeObj.bearerFormat) {\n            markdown += `- Token Format: \\`${schemeObj.bearerFormat}\\`\\n`;\n          }\n          markdown += '\\n';\n        } else if (schemeObj.type === 'oauth2' && schemeObj.flows) {\n          markdown += `**OAuth 2.0 Flows:**\\n\\n`;\n          markdown += formatOAuth2Flows(schemeObj.flows);\n        } else if (schemeObj.type === 'openIdConnect') {\n          markdown += `**Details:**\\n`;\n          markdown += `- Discovery URL: \\`${schemeObj.openIdConnectUrl}\\`\\n\\n`;\n        }\n      }\n    }\n  }\n\n  return {\n    id: 'authorization',\n    url: '/authorization',\n    title: 'Authorization',\n    description: 'Authentication methods and security schemes',\n    content: markdown,\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { OAuthFlowsObject, SecuritySchemeObject } from 'openapi3-ts/oas31';\n\nimport { resolveRef } from '@sdk-it/core';\n\nimport type { NavItem } from '../sidebar.js';\nimport type { IR } from '../types.js';\nimport {\n  getAuthIntroText,\n  getTextByCount,\n  presetDocs,\n} from './doc-text-utils.js';\n\nfunction getSecuritySchemeDescription(scheme: SecuritySchemeObject): string {\n  switch (scheme.type) {\n    case 'apiKey': {\n      const location =\n        scheme.in === 'header'\n          ? 'HTTP header'\n          : scheme.in === 'query'\n            ? 'query parameter'\n            : 'cookie';\n      return `API Key authentication requires you to provide an API key in the ${location} named \\`${scheme.name}\\`.`;\n    }\n    case 'http':\n      if (scheme.scheme === 'bearer') {\n        const format = scheme.bearerFormat\n          ? ` The expected token format is \\`${scheme.bearerFormat}\\`.`\n          : '';\n        return `Bearer token authentication requires you to include a bearer token in the \\`Authorization\\` header of your requests.${format}`;\n      }\n      if (scheme.scheme === 'basic') {\n        return `Basic authentication requires you to provide a username and password, encoded in base64 format in the \\`Authorization\\` header.`;\n      }\n      return `HTTP ${scheme.scheme} authentication is required for accessing this API.`;\n    case 'oauth2': {\n      const flows = Object.keys(scheme.flows || {});\n      const flowDescriptions = flows.map((flow) => {\n        switch (flow) {\n          case 'authorizationCode':\n            return 'Authorization Code (for server-side applications)';\n          case 'implicit':\n            return 'Implicit (for browser-based applications)';\n          case 'password':\n            return 'Resource Owner Password Credentials';\n          case 'clientCredentials':\n            return 'Client Credentials (for machine-to-machine authentication)';\n          default:\n            return flow;\n        }\n      });\n      return `OAuth 2.0 authentication is supported with the following grant type(s): ${flowDescriptions.join(', ')}.`;\n    }\n    case 'openIdConnect':\n      return `OpenID Connect authentication is used for this API. You will need to authenticate through the OpenID provider to obtain access tokens.`;\n    default:\n      return 'This API uses a custom authentication scheme. Please refer to the API documentation for specific details.';\n  }\n}\n\nfunction formatOAuth2Flows(flows: OAuthFlowsObject): string {\n  let result = '';\n\n  for (const [flowType, flow] of Object.entries(flows || {})) {\n    result += `#### ${getFlowDisplayName(flowType)}\\n\\n`;\n\n    if (flow.authorizationUrl) {\n      result += `- **Authorization URL:** \\`${flow.authorizationUrl}\\`\\n`;\n    }\n    if (flow.tokenUrl) {\n      result += `- **Token URL:** \\`${flow.tokenUrl}\\`\\n`;\n    }\n    if (flow.refreshUrl) {\n      result += `- **Refresh URL:** \\`${flow.refreshUrl}\\`\\n`;\n    }\n    if (flow.scopes && Object.keys(flow.scopes).length > 0) {\n      result += `- **Available Scopes:**\\n`;\n      for (const [scope, description] of Object.entries(flow.scopes)) {\n        result += `  - \\`${scope}\\`: ${description}\\n`;\n      }\n    }\n    result += '\\n';\n  }\n\n  return result;\n}\n\nfunction getFlowDisplayName(flowType: string): string {\n  const flowNames: Record<string, string> = {\n    authorizationCode: 'Authorization Code Flow',\n    implicit: 'Implicit Flow',\n    password: 'Resource Owner Password Flow',\n    clientCredentials: 'Client Credentials Flow',\n  };\n  return flowNames[flowType] || flowType;\n}\n\nexport function generateAuthOverview(spec: IR): NavItem {\n  let markdown = `# Authentication\\n\\n`;\n\n  const securitySchemes = spec.components.securitySchemes;\n  const globalSecurity = spec.security || [];\n\n  const authMethodCount = Object.keys(securitySchemes).length;\n  if (!authMethodCount && !globalSecurity.length) {\n    markdown += `This API does not require authentication.\\n\\n`;\n  } else {\n    if (authMethodCount > 1) {\n      markdown += `${getAuthIntroText(authMethodCount)}\\n\\n`;\n      markdown += `## ${getTextByCount(authMethodCount, presetDocs.auth.section)}\\n\\n`;\n    }\n\n    for (const [name, scheme] of Object.entries(securitySchemes)) {\n      const schemeObj = resolveRef<SecuritySchemeObject>(spec, scheme);\n      if (authMethodCount > 1) {\n        markdown += `### ${name}\\n\\n`;\n      }\n\n      const description =\n        schemeObj.description || getSecuritySchemeDescription(schemeObj);\n      markdown += `${description}\\n\\n`;\n\n      if (schemeObj.type === 'apiKey') {\n        markdown += `**Details:**\\n`;\n        markdown += `- Parameter Name: \\`${schemeObj.name}\\`\\n`;\n        markdown += `- Location: ${schemeObj.in === 'header' ? 'HTTP Header' : schemeObj.in === 'query' ? 'Query Parameter' : 'Cookie'}\\n\\n`;\n      } else if (schemeObj.type === 'http') {\n        if (schemeObj.bearerFormat) {\n          markdown += `- Token Format: \\`${schemeObj.bearerFormat}\\`\\n`;\n        }\n        markdown += '\\n';\n      } else if (schemeObj.type === 'oauth2' && schemeObj.flows) {\n        markdown += `**OAuth 2.0 Flows:**\\n\\n`;\n        markdown += formatOAuth2Flows(schemeObj.flows);\n      } else if (schemeObj.type === 'openIdConnect') {\n        markdown += `**Details:**\\n`;\n        markdown += `- Discovery URL: \\`${schemeObj.openIdConnectUrl}\\`\\n\\n`;\n      }\n    }\n  }\n\n  return {\n    id: 'authorization',\n    url: '/authorization',\n    title: 'Authorization',\n    description: 'Authentication methods and security schemes',\n    content: markdown,\n  };\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/overview-docs/overview-docs.d.ts

@@ -1,4 +1,4 @@
 import type { SidebarData } from '../sidebar.js';
-import type { OurOpenAPIObject } from '../types.js';
-export declare function extractOverviewDocs(spec: OurOpenAPIObject, availableSdks?: string[]): SidebarData;
+import type { IR } from '../types.js';
+export declare function extractOverviewDocs(spec: IR, availableSdks?: string[]): SidebarData;
 //# sourceMappingURL=overview-docs.d.ts.map

package/dist/lib/overview-docs/overview-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overview-docs.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,gBAAgB,EACtB,aAAa,GAAE,MAAM,EAAmB,GACvC,WAAW,CAYb"}
+{"version":3,"file":"overview-docs.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAKtC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,EAAE,EACR,aAAa,GAAE,MAAM,EAAmB,GACvC,WAAW,CAYb"}

package/dist/lib/overview-docs/overview-docs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/overview-docs/overview-docs.ts"],
-  "sourcesContent": ["import type { SidebarData } from '../sidebar.js';\nimport type { OurOpenAPIObject } from '../types.js';\nimport { generateAuthOverview } from './overview-auth.js';\nimport { generateErrorsOverview } from './overview-errors.js';\nimport { generateIntroOverview } from './overview-intro.js';\n\nexport function extractOverviewDocs(\n  spec: OurOpenAPIObject,\n  availableSdks: string[] = ['typescript'],\n): SidebarData {\n  return [\n    {\n      id: 'overview',\n      category: 'Overview',\n      items: [\n        generateIntroOverview(spec, availableSdks),\n        generateAuthOverview(spec),\n        generateErrorsOverview(spec),\n      ],\n    },\n  ];\n}\n"],
+  "sourcesContent": ["import type { SidebarData } from '../sidebar.js';\nimport type { IR } from '../types.js';\nimport { generateAuthOverview } from './overview-auth.js';\nimport { generateErrorsOverview } from './overview-errors.js';\nimport { generateIntroOverview } from './overview-intro.js';\n\nexport function extractOverviewDocs(\n  spec: IR,\n  availableSdks: string[] = ['typescript'],\n): SidebarData {\n  return [\n    {\n      id: 'overview',\n      category: 'Overview',\n      items: [\n        generateIntroOverview(spec, availableSdks),\n        generateAuthOverview(spec),\n        generateErrorsOverview(spec),\n      ],\n    },\n  ];\n}\n"],
   "mappings": "AAEA,SAAS,4BAA4B;AACrC,SAAS,8BAA8B;AACvC,SAAS,6BAA6B;AAE/B,SAAS,oBACd,MACA,gBAA0B,CAAC,YAAY,GAC1B;AACb,SAAO;AAAA,IACL;AAAA,MACE,IAAI;AAAA,MACJ,UAAU;AAAA,MACV,OAAO;AAAA,QACL,sBAAsB,MAAM,aAAa;AAAA,QACzC,qBAAqB,IAAI;AAAA,QACzB,uBAAuB,IAAI;AAAA,MAC7B;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []
 }