@sdk-it/spec 0.46.4 → 0.46.5

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from './lib/options.js';
 export * from './lib/processing-plugins/index.js';
 export * from './lib/processing.js';
 export * from './lib/overview-docs/overview-errors.js';
+export * from './lib/overview-docs/types.js';
 export * from './lib/reserved-keywords.js';
 export * from './lib/sidebar.js';
 export * from './lib/tag.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,oCAAoC,CAAC;AACnD,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,aAAa,CAAC;AAC5B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mCAAmC,CAAC;AAClD,cAAc,qBAAqB,CAAC;AACpC,cAAc,wCAAwC,CAAC;AACvD,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -15,6 +15,7 @@ export * from "./lib/options.js";
 export * from "./lib/processing-plugins/index.js";
 export * from "./lib/processing.js";
 export * from "./lib/overview-docs/overview-errors.js";
+export * from "./lib/overview-docs/types.js";
 export * from "./lib/reserved-keywords.js";
 export * from "./lib/sidebar.js";
 export * from "./lib/tag.js";

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["export * from './lib/create-operation.js';\nexport * from './lib/find-polymorphic-varients.js';\nexport * from './lib/find-unique-schema-name.js';\nexport * from './lib/for-each-operation.js';\nexport * from './lib/format-name.js';\nexport * from './lib/get-ref-usage.js';\nexport * from './lib/ir.js';\nexport * from './lib/is-primitive-schema.js';\nexport * from './lib/is.js';\nexport * from './lib/loaders/load-spec.js';\nexport * from './lib/loaders/local-loader.js';\nexport * from './lib/loaders/remote-loader.js';\nexport * from './lib/metadata.js';\nexport * from './lib/options.js';\nexport * from './lib/processing-plugins/index.js';\nexport * from './lib/processing.js';\nexport * from './lib/overview-docs/overview-errors.js';\nexport * from './lib/reserved-keywords.js';\nexport * from './lib/sidebar.js';\nexport * from './lib/tag.js';\nexport * from './lib/types.js';\nexport * from './lib/walk-schemas.js';\n"],
-  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "sourcesContent": ["export * from './lib/create-operation.js';\nexport * from './lib/find-polymorphic-varients.js';\nexport * from './lib/find-unique-schema-name.js';\nexport * from './lib/for-each-operation.js';\nexport * from './lib/format-name.js';\nexport * from './lib/get-ref-usage.js';\nexport * from './lib/ir.js';\nexport * from './lib/is-primitive-schema.js';\nexport * from './lib/is.js';\nexport * from './lib/loaders/load-spec.js';\nexport * from './lib/loaders/local-loader.js';\nexport * from './lib/loaders/remote-loader.js';\nexport * from './lib/metadata.js';\nexport * from './lib/options.js';\nexport * from './lib/processing-plugins/index.js';\nexport * from './lib/processing.js';\nexport * from './lib/overview-docs/overview-errors.js';\nexport * from './lib/overview-docs/types.js';\nexport * from './lib/reserved-keywords.js';\nexport * from './lib/sidebar.js';\nexport * from './lib/tag.js';\nexport * from './lib/types.js';\nexport * from './lib/walk-schemas.js';\n"],
+  "mappings": "AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
   "names": []
 }

package/dist/lib/options.d.ts

@@ -26,6 +26,10 @@ export declare function coeraceConfig(config: GenerateSdkConfig): {
         enabled: boolean;
     };
     responses: ResponsesConfig;
+    docs: {
+        entries: unknown;
+        sdks: unknown;
+    };
     spec: IR;
     operationId: (operation: OperationObject, path: string, method: string) => string;
     tag: (operation: OperationObject, path: string) => string;

package/dist/lib/options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/lib/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;IACtC,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,KACX,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AACD,MAAM,WAAW,eAAe;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AACF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,UAEnD;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAC/C,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,KAAK,CAAC,CAkBxD,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB;;;;;;;6BAzCxC,eAAe,QACpB,MAAM,UACJ,MAAM,KACX,MAAM;qBACO,eAAe,QAAQ,MAAM,KAAK,MAAM;EAuE3D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,KAAK;;;EAmB9C"}
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/lib/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE9E,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,YAAY,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,UAAU,CAAC,EAAE,gBAAgB,GAAG,KAAK,CAAC;IACtC,WAAW,CAAC,EAAE,CACZ,SAAS,EAAE,eAAe,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,KACX,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC3D,OAAO,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACtC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AACD,MAAM,WAAW,eAAe;IAC9B,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AACF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,UAEnD;AAED,eAAO,MAAM,QAAQ,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAC/C,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,aAAa,GAAG,KAAK,CAAC,CAkBxD,CAAC;AAEF,wBAAgB,aAAa,CAAC,MAAM,EAAE,iBAAiB;;;;;;;iBAkCf,OAAO;cACV,OAAO;;;6BA5E7B,eAAe,QACpB,MAAM,UACJ,MAAM,KACX,MAAM;qBACO,eAAe,QAAQ,MAAM,KAAK,MAAM;EA8E3D;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,gBAAgB,GAAG,SAAS,GAAG,KAAK;;;EAmB9C"}

package/dist/lib/options.js

@@ -36,6 +36,7 @@ function coeraceConfig(config) {
     },
     paths: config.spec.paths ?? {},
     "x-docs": [],
+    "x-sdks": [],
     "x-tagGroups": config.spec["x-tagGroups"] ?? [
       {
         name: "API",
@@ -48,6 +49,12 @@ function coeraceConfig(config) {
   return {
     pagination: coercePaginationConfig(config.pagination),
     responses: config.responses ?? {},
+    // Authored `x-docs` / `x-sdks` change shape during processing, so they are
+    // handed to the overview plugin as raw input instead of living on the IR.
+    docs: {
+      entries: config.spec["x-docs"],
+      sdks: config.spec["x-sdks"]
+    },
     spec,
     operationId: config.operationId ?? defaults.operationId,
     tag: config.tag ?? defaults.tag

package/dist/lib/options.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/options.ts"],
-  "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\n\nimport {\n  type OpenAPIDocument,\n  type OpenAPISecuritySchemeObject,\n  camelcase,\n  resolveRef,\n} from '@sdk-it/core';\n\nimport type { ProcessingDiagnostic, ProcessingPlugin } from './processing.js';\nimport { determineGenericTag, sanitizeTag } from './tag.js';\nimport type { IR } from './types.js';\n\nexport interface GenerateSdkConfig {\n  spec: OpenAPIDocument;\n  responses?: ResponsesConfig;\n  pagination?: PaginationConfig | false;\n  operationId?: (\n    operation: OperationObject,\n    path: string,\n    method: string,\n  ) => string;\n  tag?: (operation: OperationObject, path: string) => string;\n  plugins?: readonly ProcessingPlugin[];\n  signal?: AbortSignal;\n  onDiagnostic?: (diagnostic: ProcessingDiagnostic) => void;\n}\nexport interface ResponsesConfig {\n  flattenErrorResponses?: boolean;\n}\n\nexport type PaginationConfig = {\n  guess?: boolean;\n};\nexport function cleanOperationId(operationId: string) {\n  return camelcase(operationId.split('#').pop()!);\n}\n\nexport const defaults: Partial<GenerateSdkConfig> &\n  Required<Pick<GenerateSdkConfig, 'operationId' | 'tag'>> = {\n  operationId: (operation, path, method) => {\n    if (operation.operationId) {\n      return cleanOperationId(operation.operationId);\n    }\n\n    return camelcase(\n      [method, ...path.replace(/[\\\\/\\\\{\\\\}]/g, ' ').split(' ')]\n        .filter(Boolean)\n        .join(' ')\n        .trim(),\n    );\n  },\n  tag: (operation, path) => {\n    return operation.tags?.[0]\n      ? sanitizeTag(operation.tags?.[0])\n      : determineGenericTag(path, operation);\n  },\n};\n\nexport function coeraceConfig(config: GenerateSdkConfig) {\n  const spec: IR = {\n    ...config.spec,\n    components: {\n      ...config.spec.components,\n      schemas: config.spec.components?.schemas ?? {},\n      securitySchemes: Object.fromEntries(\n        Object.entries(config.spec.components?.securitySchemes ?? {}).map(\n          ([name, schema]) => [\n            name,\n            resolveRef<OpenAPISecuritySchemeObject>(config.spec, schema),\n          ],\n        ),\n      ),\n    },\n    paths: config.spec.paths ?? {},\n    'x-docs': [],\n    'x-tagGroups': config.spec['x-tagGroups'] ?? [\n      {\n        name: 'API',\n        tags: config.spec.tags?.map((tag) => tag.name) ?? [],\n      },\n    ],\n    servers: config.spec.servers ?? [],\n    tags: config.spec.tags ?? [],\n  };\n\n  return {\n    pagination: coercePaginationConfig(config.pagination),\n    responses: config.responses ?? {},\n    spec,\n    operationId: config.operationId ?? defaults.operationId,\n    tag: config.tag ?? defaults.tag,\n  };\n}\n\nexport function coercePaginationConfig(\n  options: PaginationConfig | undefined | false,\n) {\n  if (options === undefined) {\n    return {\n      guess: true,\n      enabled: true,\n    };\n  }\n  if (options === false) {\n    return {\n      enabled: false,\n      guess: false,\n    };\n  }\n  // If options is true, we assume pagination is enabled with guessing\n  return {\n    guess: options.guess ?? true,\n    enabled: true,\n  };\n}\n"],
-  "mappings": "AAEA;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AAGP,SAAS,qBAAqB,mBAAmB;AAwB1C,SAAS,iBAAiB,aAAqB;AACpD,SAAO,UAAU,YAAY,MAAM,GAAG,EAAE,IAAI,CAAE;AAChD;AAEO,MAAM,WACgD;AAAA,EAC3D,aAAa,CAAC,WAAW,MAAM,WAAW;AACxC,QAAI,UAAU,aAAa;AACzB,aAAO,iBAAiB,UAAU,WAAW;AAAA,IAC/C;AAEA,WAAO;AAAA,MACL,CAAC,QAAQ,GAAG,KAAK,QAAQ,gBAAgB,GAAG,EAAE,MAAM,GAAG,CAAC,EACrD,OAAO,OAAO,EACd,KAAK,GAAG,EACR,KAAK;AAAA,IACV;AAAA,EACF;AAAA,EACA,KAAK,CAAC,WAAW,SAAS;AACxB,WAAO,UAAU,OAAO,CAAC,IACrB,YAAY,UAAU,OAAO,CAAC,CAAC,IAC/B,oBAAoB,MAAM,SAAS;AAAA,EACzC;AACF;AAEO,SAAS,cAAc,QAA2B;AACvD,QAAM,OAAW;AAAA,IACf,GAAG,OAAO;AAAA,IACV,YAAY;AAAA,MACV,GAAG,OAAO,KAAK;AAAA,MACf,SAAS,OAAO,KAAK,YAAY,WAAW,CAAC;AAAA,MAC7C,iBAAiB,OAAO;AAAA,QACtB,OAAO,QAAQ,OAAO,KAAK,YAAY,mBAAmB,CAAC,CAAC,EAAE;AAAA,UAC5D,CAAC,CAAC,MAAM,MAAM,MAAM;AAAA,YAClB;AAAA,YACA,WAAwC,OAAO,MAAM,MAAM;AAAA,UAC7D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO,OAAO,KAAK,SAAS,CAAC;AAAA,IAC7B,UAAU,CAAC;AAAA,IACX,eAAe,OAAO,KAAK,aAAa,KAAK;AAAA,MAC3C;AAAA,QACE,MAAM;AAAA,QACN,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,IACA,SAAS,OAAO,KAAK,WAAW,CAAC;AAAA,IACjC,MAAM,OAAO,KAAK,QAAQ,CAAC;AAAA,EAC7B;AAEA,SAAO;AAAA,IACL,YAAY,uBAAuB,OAAO,UAAU;AAAA,IACpD,WAAW,OAAO,aAAa,CAAC;AAAA,IAChC;AAAA,IACA,aAAa,OAAO,eAAe,SAAS;AAAA,IAC5C,KAAK,OAAO,OAAO,SAAS;AAAA,EAC9B;AACF;AAEO,SAAS,uBACd,SACA;AACA,MAAI,YAAY,QAAW;AACzB,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,IACX;AAAA,EACF;AACA,MAAI,YAAY,OAAO;AACrB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,QAAQ,SAAS;AAAA,IACxB,SAAS;AAAA,EACX;AACF;",
+  "sourcesContent": ["import type { OperationObject } from 'openapi3-ts/oas31';\n\nimport {\n  type OpenAPIDocument,\n  type OpenAPISecuritySchemeObject,\n  camelcase,\n  resolveRef,\n} from '@sdk-it/core';\n\nimport type { ProcessingDiagnostic, ProcessingPlugin } from './processing.js';\nimport { determineGenericTag, sanitizeTag } from './tag.js';\nimport type { IR } from './types.js';\n\nexport interface GenerateSdkConfig {\n  spec: OpenAPIDocument;\n  responses?: ResponsesConfig;\n  pagination?: PaginationConfig | false;\n  operationId?: (\n    operation: OperationObject,\n    path: string,\n    method: string,\n  ) => string;\n  tag?: (operation: OperationObject, path: string) => string;\n  plugins?: readonly ProcessingPlugin[];\n  signal?: AbortSignal;\n  onDiagnostic?: (diagnostic: ProcessingDiagnostic) => void;\n}\nexport interface ResponsesConfig {\n  flattenErrorResponses?: boolean;\n}\n\nexport type PaginationConfig = {\n  guess?: boolean;\n};\nexport function cleanOperationId(operationId: string) {\n  return camelcase(operationId.split('#').pop()!);\n}\n\nexport const defaults: Partial<GenerateSdkConfig> &\n  Required<Pick<GenerateSdkConfig, 'operationId' | 'tag'>> = {\n  operationId: (operation, path, method) => {\n    if (operation.operationId) {\n      return cleanOperationId(operation.operationId);\n    }\n\n    return camelcase(\n      [method, ...path.replace(/[\\\\/\\\\{\\\\}]/g, ' ').split(' ')]\n        .filter(Boolean)\n        .join(' ')\n        .trim(),\n    );\n  },\n  tag: (operation, path) => {\n    return operation.tags?.[0]\n      ? sanitizeTag(operation.tags?.[0])\n      : determineGenericTag(path, operation);\n  },\n};\n\nexport function coeraceConfig(config: GenerateSdkConfig) {\n  const spec: IR = {\n    ...config.spec,\n    components: {\n      ...config.spec.components,\n      schemas: config.spec.components?.schemas ?? {},\n      securitySchemes: Object.fromEntries(\n        Object.entries(config.spec.components?.securitySchemes ?? {}).map(\n          ([name, schema]) => [\n            name,\n            resolveRef<OpenAPISecuritySchemeObject>(config.spec, schema),\n          ],\n        ),\n      ),\n    },\n    paths: config.spec.paths ?? {},\n    'x-docs': [],\n    'x-sdks': [],\n    'x-tagGroups': config.spec['x-tagGroups'] ?? [\n      {\n        name: 'API',\n        tags: config.spec.tags?.map((tag) => tag.name) ?? [],\n      },\n    ],\n    servers: config.spec.servers ?? [],\n    tags: config.spec.tags ?? [],\n  };\n\n  return {\n    pagination: coercePaginationConfig(config.pagination),\n    responses: config.responses ?? {},\n    // Authored `x-docs` / `x-sdks` change shape during processing, so they are\n    // handed to the overview plugin as raw input instead of living on the IR.\n    docs: {\n      entries: config.spec['x-docs'] as unknown,\n      sdks: config.spec['x-sdks'] as unknown,\n    },\n    spec,\n    operationId: config.operationId ?? defaults.operationId,\n    tag: config.tag ?? defaults.tag,\n  };\n}\n\nexport function coercePaginationConfig(\n  options: PaginationConfig | undefined | false,\n) {\n  if (options === undefined) {\n    return {\n      guess: true,\n      enabled: true,\n    };\n  }\n  if (options === false) {\n    return {\n      enabled: false,\n      guess: false,\n    };\n  }\n  // If options is true, we assume pagination is enabled with guessing\n  return {\n    guess: options.guess ?? true,\n    enabled: true,\n  };\n}\n"],
+  "mappings": "AAEA;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AAGP,SAAS,qBAAqB,mBAAmB;AAwB1C,SAAS,iBAAiB,aAAqB;AACpD,SAAO,UAAU,YAAY,MAAM,GAAG,EAAE,IAAI,CAAE;AAChD;AAEO,MAAM,WACgD;AAAA,EAC3D,aAAa,CAAC,WAAW,MAAM,WAAW;AACxC,QAAI,UAAU,aAAa;AACzB,aAAO,iBAAiB,UAAU,WAAW;AAAA,IAC/C;AAEA,WAAO;AAAA,MACL,CAAC,QAAQ,GAAG,KAAK,QAAQ,gBAAgB,GAAG,EAAE,MAAM,GAAG,CAAC,EACrD,OAAO,OAAO,EACd,KAAK,GAAG,EACR,KAAK;AAAA,IACV;AAAA,EACF;AAAA,EACA,KAAK,CAAC,WAAW,SAAS;AACxB,WAAO,UAAU,OAAO,CAAC,IACrB,YAAY,UAAU,OAAO,CAAC,CAAC,IAC/B,oBAAoB,MAAM,SAAS;AAAA,EACzC;AACF;AAEO,SAAS,cAAc,QAA2B;AACvD,QAAM,OAAW;AAAA,IACf,GAAG,OAAO;AAAA,IACV,YAAY;AAAA,MACV,GAAG,OAAO,KAAK;AAAA,MACf,SAAS,OAAO,KAAK,YAAY,WAAW,CAAC;AAAA,MAC7C,iBAAiB,OAAO;AAAA,QACtB,OAAO,QAAQ,OAAO,KAAK,YAAY,mBAAmB,CAAC,CAAC,EAAE;AAAA,UAC5D,CAAC,CAAC,MAAM,MAAM,MAAM;AAAA,YAClB;AAAA,YACA,WAAwC,OAAO,MAAM,MAAM;AAAA,UAC7D;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IACA,OAAO,OAAO,KAAK,SAAS,CAAC;AAAA,IAC7B,UAAU,CAAC;AAAA,IACX,UAAU,CAAC;AAAA,IACX,eAAe,OAAO,KAAK,aAAa,KAAK;AAAA,MAC3C;AAAA,QACE,MAAM;AAAA,QACN,MAAM,OAAO,KAAK,MAAM,IAAI,CAAC,QAAQ,IAAI,IAAI,KAAK,CAAC;AAAA,MACrD;AAAA,IACF;AAAA,IACA,SAAS,OAAO,KAAK,WAAW,CAAC;AAAA,IACjC,MAAM,OAAO,KAAK,QAAQ,CAAC;AAAA,EAC7B;AAEA,SAAO;AAAA,IACL,YAAY,uBAAuB,OAAO,UAAU;AAAA,IACpD,WAAW,OAAO,aAAa,CAAC;AAAA;AAAA;AAAA,IAGhC,MAAM;AAAA,MACJ,SAAS,OAAO,KAAK,QAAQ;AAAA,MAC7B,MAAM,OAAO,KAAK,QAAQ;AAAA,IAC5B;AAAA,IACA;AAAA,IACA,aAAa,OAAO,eAAe,SAAS;AAAA,IAC5C,KAAK,OAAO,OAAO,SAAS;AAAA,EAC9B;AACF;AAEO,SAAS,uBACd,SACA;AACA,MAAI,YAAY,QAAW;AACzB,WAAO;AAAA,MACL,OAAO;AAAA,MACP,SAAS;AAAA,IACX;AAAA,EACF;AACA,MAAI,YAAY,OAAO;AACrB,WAAO;AAAA,MACL,SAAS;AAAA,MACT,OAAO;AAAA,IACT;AAAA,EACF;AAEA,SAAO;AAAA,IACL,OAAO,QAAQ,SAAS;AAAA,IACxB,SAAS;AAAA,EACX;AACF;",
   "names": []
 }

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

@@ -34,25 +34,6 @@ export declare const presetDocs: {
             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;
-        };
     };
 };
 /**
@@ -82,5 +63,4 @@ export declare function getCommonText(count: number): {
     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

@@ -1 +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"}
+{"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;;;;;;;;;;;;;;;;;;;CAqBb,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"}

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

@@ -31,25 +31,6 @@ const presetDocs = {
     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:`
     }
   }
 };
@@ -79,26 +60,8 @@ function getAuthIntroText(count) {
   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,

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

@@ -1,7 +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;",
+  "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  },\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"],
+  "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,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;",
   "names": []
 }

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

@@ -1,4 +1,11 @@
 import type { SidebarData } from '../sidebar.js';
 import type { IR } from '../types.js';
-export declare function extractOverviewDocs(spec: IR, availableSdks?: string[]): SidebarData;
+import type { ResolvedDoc, SdkDoc } from './types.js';
+export interface OverviewDocsInput {
+    entries: ResolvedDoc[];
+    sdks: SdkDoc[];
+}
+/** Ids of the pages SDK-IT generates; an authored entry with one of these ids seeds that page. */
+export declare const GENERATED_DOC_IDS: ReadonlySet<string>;
+export declare function extractOverviewDocs(spec: IR, input: OverviewDocsInput): 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,EAAE,EAAE,MAAM,aAAa,CAAC;AAKtC,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,EAAE,EACR,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,EAAW,WAAW,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAItC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,kGAAkG;AAClG,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAIhD,CAAC;AAEH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,EAAE,EACR,KAAK,EAAE,iBAAiB,GACvB,WAAW,CAyBb"}

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

@@ -1,20 +1,45 @@
 import { generateAuthOverview } from "./overview-auth.js";
 import { generateErrorsOverview } from "./overview-errors.js";
-import { generateIntroOverview } from "./overview-intro.js";
-function extractOverviewDocs(spec, availableSdks = ["typescript"]) {
-  return [
-    {
-      id: "overview",
-      category: "Overview",
-      items: [
-        generateIntroOverview(spec, availableSdks),
-        generateAuthOverview(spec),
-        generateErrorsOverview(spec)
-      ]
-    }
+import { generateOverviewPage } from "./overview-page.js";
+const GENERATED_DOC_IDS = /* @__PURE__ */ new Set([
+  "overview",
+  "authorization",
+  "errors"
+]);
+function extractOverviewDocs(spec, input) {
+  const generated = [
+    generateOverviewPage(spec, input.sdks),
+    generateAuthOverview(spec),
+    generateErrorsOverview(spec)
   ];
+  const seeds = new Map(input.entries.map((entry) => [entry.id, entry]));
+  const items = generated.map((page) => {
+    const seed = seeds.get(page.id);
+    seeds.delete(page.id);
+    return seed ? seedPage(page, seed) : page;
+  });
+  for (const entry of seeds.values()) {
+    items.push({
+      id: entry.id,
+      title: entry.title,
+      description: entry.description,
+      url: `/${entry.id}`,
+      content: entry.content ?? entry.description
+    });
+  }
+  return [{ id: "overview", category: "Overview", items }];
+}
+function seedPage(page, seed) {
+  const body = page.content?.replace(/^#\s[^\n]*\n+/, "") ?? "";
+  return {
+    ...page,
+    title: seed.title,
+    description: seed.description ?? page.description,
+    content: [`# ${seed.title}`, seed.description, seed.content, body].filter(Boolean).join("\n\n")
+  };
 }
 export {
+  GENERATED_DOC_IDS,
   extractOverviewDocs
 };
 //# sourceMappingURL=overview-docs.js.map

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 { 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;",
+  "sourcesContent": ["import type { NavItem, SidebarData } from '../sidebar.js';\nimport type { IR } from '../types.js';\nimport { generateAuthOverview } from './overview-auth.js';\nimport { generateErrorsOverview } from './overview-errors.js';\nimport { generateOverviewPage } from './overview-page.js';\nimport type { ResolvedDoc, SdkDoc } from './types.js';\n\nexport interface OverviewDocsInput {\n  entries: ResolvedDoc[];\n  sdks: SdkDoc[];\n}\n\n/** Ids of the pages SDK-IT generates; an authored entry with one of these ids seeds that page. */\nexport const GENERATED_DOC_IDS: ReadonlySet<string> = new Set([\n  'overview',\n  'authorization',\n  'errors',\n]);\n\nexport function extractOverviewDocs(\n  spec: IR,\n  input: OverviewDocsInput,\n): SidebarData {\n  const generated = [\n    generateOverviewPage(spec, input.sdks),\n    generateAuthOverview(spec),\n    generateErrorsOverview(spec),\n  ];\n  const seeds = new Map(input.entries.map((entry) => [entry.id, entry]));\n\n  const items = generated.map((page) => {\n    const seed = seeds.get(page.id);\n    seeds.delete(page.id);\n    return seed ? seedPage(page, seed) : page;\n  });\n\n  for (const entry of seeds.values()) {\n    items.push({\n      id: entry.id,\n      title: entry.title,\n      description: entry.description,\n      url: `/${entry.id}`,\n      content: entry.content ?? entry.description,\n    });\n  }\n\n  return [{ id: 'overview', category: 'Overview', items }];\n}\n\nfunction seedPage(page: NavItem, seed: ResolvedDoc): NavItem {\n  const body = page.content?.replace(/^#\\s[^\\n]*\\n+/, '') ?? '';\n  return {\n    ...page,\n    title: seed.title,\n    description: seed.description ?? page.description,\n    content: [`# ${seed.title}`, seed.description, seed.content, body]\n      .filter(Boolean)\n      .join('\\n\\n'),\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,4BAA4B;AACrC,SAAS,8BAA8B;AACvC,SAAS,4BAA4B;AAS9B,MAAM,oBAAyC,oBAAI,IAAI;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAEM,SAAS,oBACd,MACA,OACa;AACb,QAAM,YAAY;AAAA,IAChB,qBAAqB,MAAM,MAAM,IAAI;AAAA,IACrC,qBAAqB,IAAI;AAAA,IACzB,uBAAuB,IAAI;AAAA,EAC7B;AACA,QAAM,QAAQ,IAAI,IAAI,MAAM,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC;AAErE,QAAM,QAAQ,UAAU,IAAI,CAAC,SAAS;AACpC,UAAM,OAAO,MAAM,IAAI,KAAK,EAAE;AAC9B,UAAM,OAAO,KAAK,EAAE;AACpB,WAAO,OAAO,SAAS,MAAM,IAAI,IAAI;AAAA,EACvC,CAAC;AAED,aAAW,SAAS,MAAM,OAAO,GAAG;AAClC,UAAM,KAAK;AAAA,MACT,IAAI,MAAM;AAAA,MACV,OAAO,MAAM;AAAA,MACb,aAAa,MAAM;AAAA,MACnB,KAAK,IAAI,MAAM,EAAE;AAAA,MACjB,SAAS,MAAM,WAAW,MAAM;AAAA,IAClC,CAAC;AAAA,EACH;AAEA,SAAO,CAAC,EAAE,IAAI,YAAY,UAAU,YAAY,MAAM,CAAC;AACzD;AAEA,SAAS,SAAS,MAAe,MAA4B;AAC3D,QAAM,OAAO,KAAK,SAAS,QAAQ,iBAAiB,EAAE,KAAK;AAC3D,SAAO;AAAA,IACL,GAAG;AAAA,IACH,OAAO,KAAK;AAAA,IACZ,aAAa,KAAK,eAAe,KAAK;AAAA,IACtC,SAAS,CAAC,KAAK,KAAK,KAAK,IAAI,KAAK,aAAa,KAAK,SAAS,IAAI,EAC9D,OAAO,OAAO,EACd,KAAK,MAAM;AAAA,EAChB;AACF;",
   "names": []
 }

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

@@ -0,0 +1,5 @@
+import type { NavItem } from '../sidebar.js';
+import type { IR } from '../types.js';
+import type { SdkDoc } from './types.js';
+export declare function generateOverviewPage(spec: IR, sdks: SdkDoc[]): NavItem;
+//# sourceMappingURL=overview-page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overview-page.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzC,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CA0EtE"}

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

@@ -0,0 +1,60 @@
+import { getTextByCount, presetDocs } from "./doc-text-utils.js";
+import { generateSdkSection } from "./overview-sdks.js";
+function generateOverviewPage(spec, sdks) {
+  const info = spec.info;
+  const apiTitle = info.title || "API Reference";
+  const markdown = [`# ${apiTitle}`];
+  if (info.description) {
+    markdown.push(info.description);
+  }
+  if (info.version) {
+    markdown.push(`**Version:** ${info.version}`);
+  }
+  if (info.license) {
+    const license = info.license.url ? `${info.license.name} ([${info.license.url}](${info.license.url}))` : info.license.name;
+    markdown.push(`**License:** ${license}`);
+  }
+  if (spec.servers.length > 0) {
+    const serverCount = spec.servers.length;
+    markdown.push(
+      `## ${getTextByCount(serverCount, presetDocs.server.section)}`
+    );
+    markdown.push(getTextByCount(serverCount, presetDocs.server.description));
+    markdown.push(
+      spec.servers.map(
+        (server) => server.description ? `- **${server.url}** - ${server.description}` : `- **${server.url}**`
+      ).join("\n")
+    );
+  }
+  markdown.push(...generateSdkSection(apiTitle, sdks));
+  const supportDocs = spec.externalDocs?.url && spec.externalDocs.description?.toLowerCase().includes("support") ? spec.externalDocs : void 0;
+  if (info.contact?.email || info.contact?.url || supportDocs) {
+    markdown.push(`## Need Help?`);
+    if (info.contact?.email) {
+      markdown.push(
+        `For support, reach out to us at [${info.contact.email}](mailto:${info.contact.email}).`
+      );
+    }
+    if (info.contact?.url) {
+      markdown.push(
+        `Visit our support page: [${info.contact.url}](${info.contact.url})`
+      );
+    }
+    if (supportDocs) {
+      markdown.push(
+        `For additional support, visit our [${supportDocs.description}](${supportDocs.url}).`
+      );
+    }
+  }
+  return {
+    id: "overview",
+    url: "/",
+    title: "Overview",
+    description: "API overview and getting started guide",
+    content: markdown.join("\n\n")
+  };
+}
+export {
+  generateOverviewPage
+};
+//# sourceMappingURL=overview-page.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/overview-docs/overview-page.ts"],
+  "sourcesContent": ["import type { NavItem } from '../sidebar.js';\nimport type { IR } from '../types.js';\nimport { getTextByCount, presetDocs } from './doc-text-utils.js';\nimport { generateSdkSection } from './overview-sdks.js';\nimport type { SdkDoc } from './types.js';\n\nexport function generateOverviewPage(spec: IR, sdks: SdkDoc[]): NavItem {\n  const info = spec.info;\n  const apiTitle = info.title || 'API Reference';\n  const markdown: string[] = [`# ${apiTitle}`];\n\n  if (info.description) {\n    markdown.push(info.description);\n  }\n\n  if (info.version) {\n    markdown.push(`**Version:** ${info.version}`);\n  }\n\n  if (info.license) {\n    const license = info.license.url\n      ? `${info.license.name} ([${info.license.url}](${info.license.url}))`\n      : info.license.name;\n    markdown.push(`**License:** ${license}`);\n  }\n\n  if (spec.servers.length > 0) {\n    const serverCount = spec.servers.length;\n    markdown.push(\n      `## ${getTextByCount(serverCount, presetDocs.server.section)}`,\n    );\n    markdown.push(getTextByCount(serverCount, presetDocs.server.description));\n    markdown.push(\n      spec.servers\n        .map((server) =>\n          server.description\n            ? `- **${server.url}** - ${server.description}`\n            : `- **${server.url}**`,\n        )\n        .join('\\n'),\n    );\n  }\n\n  markdown.push(...generateSdkSection(apiTitle, sdks));\n\n  const supportDocs =\n    spec.externalDocs?.url &&\n    spec.externalDocs.description?.toLowerCase().includes('support')\n      ? spec.externalDocs\n      : undefined;\n\n  if (info.contact?.email || info.contact?.url || supportDocs) {\n    markdown.push(`## Need Help?`);\n\n    if (info.contact?.email) {\n      markdown.push(\n        `For support, reach out to us at [${info.contact.email}](mailto:${info.contact.email}).`,\n      );\n    }\n\n    if (info.contact?.url) {\n      markdown.push(\n        `Visit our support page: [${info.contact.url}](${info.contact.url})`,\n      );\n    }\n\n    if (supportDocs) {\n      markdown.push(\n        `For additional support, visit our [${supportDocs.description}](${supportDocs.url}).`,\n      );\n    }\n  }\n\n  return {\n    id: 'overview',\n    url: '/',\n    title: 'Overview',\n    description: 'API overview and getting started guide',\n    content: markdown.join('\\n\\n'),\n  };\n}\n"],
+  "mappings": "AAEA,SAAS,gBAAgB,kBAAkB;AAC3C,SAAS,0BAA0B;AAG5B,SAAS,qBAAqB,MAAU,MAAyB;AACtE,QAAM,OAAO,KAAK;AAClB,QAAM,WAAW,KAAK,SAAS;AAC/B,QAAM,WAAqB,CAAC,KAAK,QAAQ,EAAE;AAE3C,MAAI,KAAK,aAAa;AACpB,aAAS,KAAK,KAAK,WAAW;AAAA,EAChC;AAEA,MAAI,KAAK,SAAS;AAChB,aAAS,KAAK,gBAAgB,KAAK,OAAO,EAAE;AAAA,EAC9C;AAEA,MAAI,KAAK,SAAS;AAChB,UAAM,UAAU,KAAK,QAAQ,MACzB,GAAG,KAAK,QAAQ,IAAI,MAAM,KAAK,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG,OAC/D,KAAK,QAAQ;AACjB,aAAS,KAAK,gBAAgB,OAAO,EAAE;AAAA,EACzC;AAEA,MAAI,KAAK,QAAQ,SAAS,GAAG;AAC3B,UAAM,cAAc,KAAK,QAAQ;AACjC,aAAS;AAAA,MACP,MAAM,eAAe,aAAa,WAAW,OAAO,OAAO,CAAC;AAAA,IAC9D;AACA,aAAS,KAAK,eAAe,aAAa,WAAW,OAAO,WAAW,CAAC;AACxE,aAAS;AAAA,MACP,KAAK,QACF;AAAA,QAAI,CAAC,WACJ,OAAO,cACH,OAAO,OAAO,GAAG,QAAQ,OAAO,WAAW,KAC3C,OAAO,OAAO,GAAG;AAAA,MACvB,EACC,KAAK,IAAI;AAAA,IACd;AAAA,EACF;AAEA,WAAS,KAAK,GAAG,mBAAmB,UAAU,IAAI,CAAC;AAEnD,QAAM,cACJ,KAAK,cAAc,OACnB,KAAK,aAAa,aAAa,YAAY,EAAE,SAAS,SAAS,IAC3D,KAAK,eACL;AAEN,MAAI,KAAK,SAAS,SAAS,KAAK,SAAS,OAAO,aAAa;AAC3D,aAAS,KAAK,eAAe;AAE7B,QAAI,KAAK,SAAS,OAAO;AACvB,eAAS;AAAA,QACP,oCAAoC,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,KAAK;AAAA,MACtF;AAAA,IACF;AAEA,QAAI,KAAK,SAAS,KAAK;AACrB,eAAS;AAAA,QACP,4BAA4B,KAAK,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG;AAAA,MACnE;AAAA,IACF;AAEA,QAAI,aAAa;AACf,eAAS;AAAA,QACP,sCAAsC,YAAY,WAAW,KAAK,YAAY,GAAG;AAAA,MACnF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,KAAK;AAAA,IACL,OAAO;AAAA,IACP,aAAa;AAAA,IACb,SAAS,SAAS,KAAK,MAAM;AAAA,EAC/B;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,3 @@
+import type { SdkDoc } from './types.js';
+export declare function generateSdkSection(apiTitle: string, sdks: SdkDoc[]): string[];
+//# sourceMappingURL=overview-sdks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"overview-sdks.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-sdks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,YAAY,CAAC;AA4BtD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAqB7E"}

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

@@ -0,0 +1,42 @@
+import { getTextByCount, presetDocs } from "./doc-text-utils.js";
+const sdkLanguages = {
+  typescript: {
+    title: "TypeScript",
+    install: (packageName) => `npm install ${packageName}`,
+    registry: (packageName) => `https://www.npmjs.com/package/${packageName}`
+  },
+  python: {
+    title: "Python",
+    install: (packageName) => `pip install ${packageName}`,
+    registry: (packageName) => `https://pypi.org/project/${packageName}`
+  },
+  dart: {
+    title: "Dart",
+    install: (packageName) => `dart pub add ${packageName}`,
+    registry: (packageName) => `https://pub.dev/packages/${packageName}`
+  }
+};
+const listFormat = new Intl.ListFormat("en", { type: "conjunction" });
+function generateSdkSection(apiTitle, sdks) {
+  if (sdks.length === 0) return [];
+  const languages = listFormat.format(
+    sdks.map((sdk) => sdkLanguages[sdk.language].title)
+  );
+  const markdown = [
+    `## ${getTextByCount(sdks.length, presetDocs.client.section)}`,
+    `${apiTitle} provides ${sdks.length === 1 ? "an official client SDK" : "official client SDKs"} for ${languages}. Install ${sdks.length === 1 ? "it" : "one"} to get started:`
+  ];
+  for (const sdk of sdks) {
+    const language = sdkLanguages[sdk.language];
+    markdown.push(`### ${language.title}`);
+    markdown.push(["```bash", language.install(sdk.package), "```"].join("\n"));
+    markdown.push(
+      `[${sdk.package}](${sdk.url ?? language.registry(sdk.package)})`
+    );
+  }
+  return markdown;
+}
+export {
+  generateSdkSection
+};
+//# sourceMappingURL=overview-sdks.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/overview-docs/overview-sdks.ts"],
+  "sourcesContent": ["import { getTextByCount, presetDocs } from './doc-text-utils.js';\nimport type { SdkDoc, SdkLanguage } from './types.js';\n\ninterface SdkLanguageDocs {\n  title: string;\n  install(packageName: string): string;\n  registry(packageName: string): string;\n}\n\nconst sdkLanguages: Record<SdkLanguage, SdkLanguageDocs> = {\n  typescript: {\n    title: 'TypeScript',\n    install: (packageName) => `npm install ${packageName}`,\n    registry: (packageName) => `https://www.npmjs.com/package/${packageName}`,\n  },\n  python: {\n    title: 'Python',\n    install: (packageName) => `pip install ${packageName}`,\n    registry: (packageName) => `https://pypi.org/project/${packageName}`,\n  },\n  dart: {\n    title: 'Dart',\n    install: (packageName) => `dart pub add ${packageName}`,\n    registry: (packageName) => `https://pub.dev/packages/${packageName}`,\n  },\n};\n\nconst listFormat = new Intl.ListFormat('en', { type: 'conjunction' });\n\nexport function generateSdkSection(apiTitle: string, sdks: SdkDoc[]): string[] {\n  if (sdks.length === 0) return [];\n\n  const languages = listFormat.format(\n    sdks.map((sdk) => sdkLanguages[sdk.language].title),\n  );\n  const markdown: string[] = [\n    `## ${getTextByCount(sdks.length, presetDocs.client.section)}`,\n    `${apiTitle} provides ${sdks.length === 1 ? 'an official client SDK' : 'official client SDKs'} for ${languages}. Install ${sdks.length === 1 ? 'it' : 'one'} to get started:`,\n  ];\n\n  for (const sdk of sdks) {\n    const language = sdkLanguages[sdk.language];\n    markdown.push(`### ${language.title}`);\n    markdown.push(['```bash', language.install(sdk.package), '```'].join('\\n'));\n    markdown.push(\n      `[${sdk.package}](${sdk.url ?? language.registry(sdk.package)})`,\n    );\n  }\n\n  return markdown;\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB,kBAAkB;AAS3C,MAAM,eAAqD;AAAA,EACzD,YAAY;AAAA,IACV,OAAO;AAAA,IACP,SAAS,CAAC,gBAAgB,eAAe,WAAW;AAAA,IACpD,UAAU,CAAC,gBAAgB,iCAAiC,WAAW;AAAA,EACzE;AAAA,EACA,QAAQ;AAAA,IACN,OAAO;AAAA,IACP,SAAS,CAAC,gBAAgB,eAAe,WAAW;AAAA,IACpD,UAAU,CAAC,gBAAgB,4BAA4B,WAAW;AAAA,EACpE;AAAA,EACA,MAAM;AAAA,IACJ,OAAO;AAAA,IACP,SAAS,CAAC,gBAAgB,gBAAgB,WAAW;AAAA,IACrD,UAAU,CAAC,gBAAgB,4BAA4B,WAAW;AAAA,EACpE;AACF;AAEA,MAAM,aAAa,IAAI,KAAK,WAAW,MAAM,EAAE,MAAM,cAAc,CAAC;AAE7D,SAAS,mBAAmB,UAAkB,MAA0B;AAC7E,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAE/B,QAAM,YAAY,WAAW;AAAA,IAC3B,KAAK,IAAI,CAAC,QAAQ,aAAa,IAAI,QAAQ,EAAE,KAAK;AAAA,EACpD;AACA,QAAM,WAAqB;AAAA,IACzB,MAAM,eAAe,KAAK,QAAQ,WAAW,OAAO,OAAO,CAAC;AAAA,IAC5D,GAAG,QAAQ,aAAa,KAAK,WAAW,IAAI,2BAA2B,sBAAsB,QAAQ,SAAS,aAAa,KAAK,WAAW,IAAI,OAAO,KAAK;AAAA,EAC7J;AAEA,aAAW,OAAO,MAAM;AACtB,UAAM,WAAW,aAAa,IAAI,QAAQ;AAC1C,aAAS,KAAK,OAAO,SAAS,KAAK,EAAE;AACrC,aAAS,KAAK,CAAC,WAAW,SAAS,QAAQ,IAAI,OAAO,GAAG,KAAK,EAAE,KAAK,IAAI,CAAC;AAC1E,aAAS;AAAA,MACP,IAAI,IAAI,OAAO,KAAK,IAAI,OAAO,SAAS,SAAS,IAAI,OAAO,CAAC;AAAA,IAC/D;AAAA,EACF;AAEA,SAAO;AACT;",
+  "names": []
+}

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

@@ -0,0 +1,23 @@
+export type AuthoredDoc = {
+    id?: string;
+    title: string;
+    description?: string;
+    content?: string;
+};
+/** An authored doc whose id has been normalized to a url-safe slug. */
+export type ResolvedDoc = AuthoredDoc & {
+    id: string;
+};
+export type SdkLanguage = 'typescript' | 'python' | 'dart';
+export type SdkDoc = {
+    language: SdkLanguage;
+    package: string;
+    url?: string;
+};
+export declare const SDK_LANGUAGES: readonly SdkLanguage[];
+/** Doc ids the apiref reserves for its own routes. */
+export declare const RESERVED_DOC_IDS: ReadonlySet<string>;
+export declare function isAuthoredDoc(value: unknown): value is AuthoredDoc;
+export declare function isSdkDoc(value: unknown): value is SdkDoc;
+export declare function slugify(value: string): string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE3D,MAAM,MAAM,MAAM,GAAG;IACnB,QAAQ,EAAE,WAAW,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,WAAW,EAI/C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAsB,CAAC;AAUxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CASlE;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CASxD;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAK7C"}

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

@@ -0,0 +1,29 @@
+const SDK_LANGUAGES = [
+  "typescript",
+  "python",
+  "dart"
+];
+const RESERVED_DOC_IDS = /* @__PURE__ */ new Set(["embed"]);
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isOptionalString(value) {
+  return value === void 0 || typeof value === "string";
+}
+function isAuthoredDoc(value) {
+  return isRecord(value) && typeof value.title === "string" && value.title.trim() !== "" && isOptionalString(value.id) && isOptionalString(value.description) && isOptionalString(value.content);
+}
+function isSdkDoc(value) {
+  return isRecord(value) && typeof value.language === "string" && SDK_LANGUAGES.includes(value.language) && typeof value.package === "string" && value.package.trim() !== "" && isOptionalString(value.url);
+}
+function slugify(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+export {
+  RESERVED_DOC_IDS,
+  SDK_LANGUAGES,
+  isAuthoredDoc,
+  isSdkDoc,
+  slugify
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/overview-docs/types.ts"],
+  "sourcesContent": ["export type AuthoredDoc = {\n  id?: string;\n  title: string;\n  description?: string;\n  content?: string;\n};\n\n/** An authored doc whose id has been normalized to a url-safe slug. */\nexport type ResolvedDoc = AuthoredDoc & { id: string };\n\nexport type SdkLanguage = 'typescript' | 'python' | 'dart';\n\nexport type SdkDoc = {\n  language: SdkLanguage;\n  package: string;\n  url?: string;\n};\n\nexport const SDK_LANGUAGES: readonly SdkLanguage[] = [\n  'typescript',\n  'python',\n  'dart',\n];\n\n/** Doc ids the apiref reserves for its own routes. */\nexport const RESERVED_DOC_IDS: ReadonlySet<string> = new Set(['embed']);\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isOptionalString(value: unknown): value is string | undefined {\n  return value === undefined || typeof value === 'string';\n}\n\nexport function isAuthoredDoc(value: unknown): value is AuthoredDoc {\n  return (\n    isRecord(value) &&\n    typeof value.title === 'string' &&\n    value.title.trim() !== '' &&\n    isOptionalString(value.id) &&\n    isOptionalString(value.description) &&\n    isOptionalString(value.content)\n  );\n}\n\nexport function isSdkDoc(value: unknown): value is SdkDoc {\n  return (\n    isRecord(value) &&\n    typeof value.language === 'string' &&\n    (SDK_LANGUAGES as readonly string[]).includes(value.language) &&\n    typeof value.package === 'string' &&\n    value.package.trim() !== '' &&\n    isOptionalString(value.url)\n  );\n}\n\nexport function slugify(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '');\n}\n"],
+  "mappings": "AAkBO,MAAM,gBAAwC;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AACF;AAGO,MAAM,mBAAwC,oBAAI,IAAI,CAAC,OAAO,CAAC;AAEtE,SAAS,SAAS,OAAkD;AAClE,SAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAC5E;AAEA,SAAS,iBAAiB,OAA6C;AACrE,SAAO,UAAU,UAAa,OAAO,UAAU;AACjD;AAEO,SAAS,cAAc,OAAsC;AAClE,SACE,SAAS,KAAK,KACd,OAAO,MAAM,UAAU,YACvB,MAAM,MAAM,KAAK,MAAM,MACvB,iBAAiB,MAAM,EAAE,KACzB,iBAAiB,MAAM,WAAW,KAClC,iBAAiB,MAAM,OAAO;AAElC;AAEO,SAAS,SAAS,OAAiC;AACxD,SACE,SAAS,KAAK,KACd,OAAO,MAAM,aAAa,YACzB,cAAoC,SAAS,MAAM,QAAQ,KAC5D,OAAO,MAAM,YAAY,YACzB,MAAM,QAAQ,KAAK,MAAM,MACzB,iBAAiB,MAAM,GAAG;AAE9B;AAEO,SAAS,QAAQ,OAAuB;AAC7C,SAAO,MACJ,YAAY,EACZ,QAAQ,eAAe,GAAG,EAC1B,QAAQ,YAAY,EAAE;AAC3B;",
+  "names": []
+}

package/dist/lib/processing-plugins/extract-overview-docs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extract-overview-docs.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/extract-overview-docs.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,wBAAgB,yBAAyB,IAAI,gBAAgB,CAO5D"}
+{"version":3,"file":"extract-overview-docs.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/extract-overview-docs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAqB,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE5E,wBAAgB,yBAAyB,IAAI,gBAAgB,CAa5D"}

package/dist/lib/processing-plugins/extract-overview-docs.js

@@ -1,12 +1,105 @@
-import { extractOverviewDocs } from "../overview-docs/overview-docs.js";
+import {
+  GENERATED_DOC_IDS,
+  extractOverviewDocs
+} from "../overview-docs/overview-docs.js";
+import {
+  RESERVED_DOC_IDS,
+  isAuthoredDoc,
+  isSdkDoc,
+  slugify
+} from "../overview-docs/types.js";
 function extractOverviewDocsPlugin() {
   return {
     name: "extract-overview-docs",
-    process({ spec }) {
-      spec["x-docs"] = extractOverviewDocs(spec);
+    process(context) {
+      const sdks = collectSdks(context);
+      const entries = collectDocs(context);
+      context.spec["x-sdks"] = sdks;
+      context.spec["x-docs"] = extractOverviewDocs(context.spec, {
+        entries,
+        sdks
+      });
     }
   };
 }
+function collectSdks({ options, report }) {
+  const raw = options.docs.sdks;
+  if (raw === void 0) return [];
+  if (!Array.isArray(raw)) {
+    report({
+      severity: "warning",
+      code: "invalid-x-sdks",
+      message: "x-sdks must be an array of { language, package, url? }.",
+      path: "/x-sdks"
+    });
+    return [];
+  }
+  return raw.filter((entry, index) => {
+    if (isSdkDoc(entry)) return true;
+    report({
+      severity: "warning",
+      code: "invalid-x-sdks",
+      message: "x-sdks entries need a language of typescript, python, or dart and a package name.",
+      path: `/x-sdks/${index}`
+    });
+    return false;
+  });
+}
+function collectDocs({ options, report }) {
+  const raw = options.docs.entries;
+  if (raw === void 0) return [];
+  if (!Array.isArray(raw)) {
+    report({
+      severity: "warning",
+      code: "invalid-x-docs",
+      message: "x-docs must be an array of { id?, title, description?, content? }.",
+      path: "/x-docs"
+    });
+    return [];
+  }
+  const docs = [];
+  const seen = /* @__PURE__ */ new Set();
+  raw.forEach((entry, index) => {
+    const path = `/x-docs/${index}`;
+    const invalid = (message) => report({ severity: "warning", code: "invalid-x-docs", message, path });
+    if (!isAuthoredDoc(entry)) {
+      invalid(
+        "x-docs entries need a title; id, description, and content must be strings."
+      );
+      return;
+    }
+    const id = slugify(entry.id ?? entry.title);
+    if (!id) {
+      invalid(`Cannot derive a url-safe id from "${entry.id ?? entry.title}".`);
+      return;
+    }
+    if (RESERVED_DOC_IDS.has(id)) {
+      report({
+        severity: "warning",
+        code: "reserved-x-docs-id",
+        message: `"${id}" is reserved by the API reference and cannot be used as a doc id.`,
+        path
+      });
+      return;
+    }
+    if (seen.has(id)) {
+      report({
+        severity: "warning",
+        code: "duplicate-x-docs-id",
+        message: `Doc id "${id}" is used more than once; later entries are ignored.`,
+        path
+      });
+      return;
+    }
+    if (!GENERATED_DOC_IDS.has(id) && !entry.content && !entry.description) {
+      invalid(`Custom doc "${id}" needs content or a description to render.`);
+      return;
+    }
+    seen.add(id);
+    docs.push({ ...entry, id });
+  });
+  return docs;
+}
 export {
   extractOverviewDocsPlugin
 };

package/dist/lib/processing-plugins/extract-overview-docs.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/processing-plugins/extract-overview-docs.ts"],
-  "sourcesContent": ["import { extractOverviewDocs } from '../overview-docs/overview-docs.js';\nimport type { ProcessingPlugin } from '../processing.js';\n\nexport function extractOverviewDocsPlugin(): ProcessingPlugin {\n  return {\n    name: 'extract-overview-docs',\n    process({ spec }) {\n      spec['x-docs'] = extractOverviewDocs(spec);\n    },\n  };\n}\n"],
-  "mappings": "AAAA,SAAS,2BAA2B;AAG7B,SAAS,4BAA8C;AAC5D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,EAAE,KAAK,GAAG;AAChB,WAAK,QAAQ,IAAI,oBAAoB,IAAI;AAAA,IAC3C;AAAA,EACF;AACF;",
+  "sourcesContent": ["import {\n  GENERATED_DOC_IDS,\n  extractOverviewDocs,\n} from '../overview-docs/overview-docs.js';\nimport {\n  RESERVED_DOC_IDS,\n  type ResolvedDoc,\n  type SdkDoc,\n  isAuthoredDoc,\n  isSdkDoc,\n  slugify,\n} from '../overview-docs/types.js';\nimport type { ProcessingContext, ProcessingPlugin } from '../processing.js';\n\nexport function extractOverviewDocsPlugin(): ProcessingPlugin {\n  return {\n    name: 'extract-overview-docs',\n    process(context) {\n      const sdks = collectSdks(context);\n      const entries = collectDocs(context);\n      context.spec['x-sdks'] = sdks;\n      context.spec['x-docs'] = extractOverviewDocs(context.spec, {\n        entries,\n        sdks,\n      });\n    },\n  };\n}\n\nfunction collectSdks({ options, report }: ProcessingContext): SdkDoc[] {\n  const raw = options.docs.sdks;\n  if (raw === undefined) return [];\n  if (!Array.isArray(raw)) {\n    report({\n      severity: 'warning',\n      code: 'invalid-x-sdks',\n      message: 'x-sdks must be an array of { language, package, url? }.',\n      path: '/x-sdks',\n    });\n    return [];\n  }\n  return raw.filter((entry: unknown, index): entry is SdkDoc => {\n    if (isSdkDoc(entry)) return true;\n    report({\n      severity: 'warning',\n      code: 'invalid-x-sdks',\n      message:\n        'x-sdks entries need a language of typescript, python, or dart and a package name.',\n      path: `/x-sdks/${index}`,\n    });\n    return false;\n  });\n}\n\nfunction collectDocs({ options, report }: ProcessingContext): ResolvedDoc[] {\n  const raw = options.docs.entries;\n  if (raw === undefined) return [];\n  if (!Array.isArray(raw)) {\n    report({\n      severity: 'warning',\n      code: 'invalid-x-docs',\n      message:\n        'x-docs must be an array of { id?, title, description?, content? }.',\n      path: '/x-docs',\n    });\n    return [];\n  }\n\n  const docs: ResolvedDoc[] = [];\n  const seen = new Set<string>();\n  raw.forEach((entry: unknown, index) => {\n    const path = `/x-docs/${index}`;\n    const invalid = (message: string) =>\n      report({ severity: 'warning', code: 'invalid-x-docs', message, path });\n\n    if (!isAuthoredDoc(entry)) {\n      invalid(\n        'x-docs entries need a title; id, description, and content must be strings.',\n      );\n      return;\n    }\n    const id = slugify(entry.id ?? entry.title);\n    if (!id) {\n      invalid(`Cannot derive a url-safe id from \"${entry.id ?? entry.title}\".`);\n      return;\n    }\n    if (RESERVED_DOC_IDS.has(id)) {\n      report({\n        severity: 'warning',\n        code: 'reserved-x-docs-id',\n        message: `\"${id}\" is reserved by the API reference and cannot be used as a doc id.`,\n        path,\n      });\n      return;\n    }\n    if (seen.has(id)) {\n      report({\n        severity: 'warning',\n        code: 'duplicate-x-docs-id',\n        message: `Doc id \"${id}\" is used more than once; later entries are ignored.`,\n        path,\n      });\n      return;\n    }\n    if (!GENERATED_DOC_IDS.has(id) && !entry.content && !entry.description) {\n      invalid(`Custom doc \"${id}\" needs content or a description to render.`);\n      return;\n    }\n    seen.add(id);\n    docs.push({ ...entry, id });\n  });\n  return docs;\n}\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,OACK;AACP;AAAA,EACE;AAAA,EAGA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGA,SAAS,4BAA8C;AAC5D,SAAO;AAAA,IACL,MAAM;AAAA,IACN,QAAQ,SAAS;AACf,YAAM,OAAO,YAAY,OAAO;AAChC,YAAM,UAAU,YAAY,OAAO;AACnC,cAAQ,KAAK,QAAQ,IAAI;AACzB,cAAQ,KAAK,QAAQ,IAAI,oBAAoB,QAAQ,MAAM;AAAA,QACzD;AAAA,QACA;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEA,SAAS,YAAY,EAAE,SAAS,OAAO,GAAgC;AACrE,QAAM,MAAM,QAAQ,KAAK;AACzB,MAAI,QAAQ,OAAW,QAAO,CAAC;AAC/B,MAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;AACvB,WAAO;AAAA,MACL,UAAU;AAAA,MACV,MAAM;AAAA,MACN,SAAS;AAAA,MACT,MAAM;AAAA,IACR,CAAC;AACD,WAAO,CAAC;AAAA,EACV;AACA,SAAO,IAAI,OAAO,CAAC,OAAgB,UAA2B;AAC5D,QAAI,SAAS,KAAK,EAAG,QAAO;AAC5B,WAAO;AAAA,MACL,UAAU;AAAA,MACV,MAAM;AAAA,MACN,SACE;AAAA,MACF,MAAM,WAAW,KAAK;AAAA,IACxB,CAAC;AACD,WAAO;AAAA,EACT,CAAC;AACH;AAEA,SAAS,YAAY,EAAE,SAAS,OAAO,GAAqC;AAC1E,QAAM,MAAM,QAAQ,KAAK;AACzB,MAAI,QAAQ,OAAW,QAAO,CAAC;AAC/B,MAAI,CAAC,MAAM,QAAQ,GAAG,GAAG;AACvB,WAAO;AAAA,MACL,UAAU;AAAA,MACV,MAAM;AAAA,MACN,SACE;AAAA,MACF,MAAM;AAAA,IACR,CAAC;AACD,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,OAAsB,CAAC;AAC7B,QAAM,OAAO,oBAAI,IAAY;AAC7B,MAAI,QAAQ,CAAC,OAAgB,UAAU;AACrC,UAAM,OAAO,WAAW,KAAK;AAC7B,UAAM,UAAU,CAAC,YACf,OAAO,EAAE,UAAU,WAAW,MAAM,kBAAkB,SAAS,KAAK,CAAC;AAEvE,QAAI,CAAC,cAAc,KAAK,GAAG;AACzB;AAAA,QACE;AAAA,MACF;AACA;AAAA,IACF;AACA,UAAM,KAAK,QAAQ,MAAM,MAAM,MAAM,KAAK;AAC1C,QAAI,CAAC,IAAI;AACP,cAAQ,qCAAqC,MAAM,MAAM,MAAM,KAAK,IAAI;AACxE;AAAA,IACF;AACA,QAAI,iBAAiB,IAAI,EAAE,GAAG;AAC5B,aAAO;AAAA,QACL,UAAU;AAAA,QACV,MAAM;AAAA,QACN,SAAS,IAAI,EAAE;AAAA,QACf;AAAA,MACF,CAAC;AACD;AAAA,IACF;AACA,QAAI,KAAK,IAAI,EAAE,GAAG;AAChB,aAAO;AAAA,QACL,UAAU;AAAA,QACV,MAAM;AAAA,QACN,SAAS,WAAW,EAAE;AAAA,QACtB;AAAA,MACF,CAAC;AACD;AAAA,IACF;AACA,QAAI,CAAC,kBAAkB,IAAI,EAAE,KAAK,CAAC,MAAM,WAAW,CAAC,MAAM,aAAa;AACtE,cAAQ,eAAe,EAAE,6CAA6C;AACtE;AAAA,IACF;AACA,SAAK,IAAI,EAAE;AACX,SAAK,KAAK,EAAE,GAAG,OAAO,GAAG,CAAC;AAAA,EAC5B,CAAC;AACD,SAAO;AACT;",
   "names": []
 }

package/dist/lib/processing-plugins/normalize-schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-schemas.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAmLzD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD"}
+{"version":3,"file":"normalize-schemas.d.ts","sourceRoot":"","sources":["../../../src/lib/processing-plugins/normalize-schemas.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AA2LzD,wBAAgB,gBAAgB,IAAI,gBAAgB,CAOnD"}

package/dist/lib/processing-plugins/normalize-schemas.js

@@ -4,6 +4,7 @@ import { isEmpty, isRef, notRef, resolveRef, snakecase } from "@sdk-it/core";
 import { findVarients } from "../find-polymorphic-varients.js";
 import { formatName } from "../format-name.js";
 import { isPrimitiveSchema } from "../is-primitive-schema.js";
+import { coerceTypes } from "../is.js";
 function normalizeSchemaObjects(spec, schemas, visited = /* @__PURE__ */ new Set()) {
   for (const schema of schemas) {
     if (isRef(schema)) continue;
@@ -145,8 +146,16 @@ function normalizeSchemaObjects(spec, schemas, visited = /* @__PURE__ */ new Set
           (item) => resolveRef(spec, item).type !== "null"
         );
         if (otherTypes.length === 1) {
-          Object.assign(schema, otherTypes[0]);
+          const [only] = otherTypes;
+          const droppedNull = otherTypes.length !== schema[kind].length;
+          Object.assign(schema, only);
           delete schema[kind];
+          if (droppedNull && notRef(only)) {
+            const types = coerceTypes(only, false);
+            if (types.length) {
+              schema.type = uniq([...types, "null"]);
+            }
+          }
           continue;
         }
         schema["x-varients"] = findVarients(spec, schema[kind]);

package/dist/lib/processing-plugins/normalize-schemas.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/processing-plugins/normalize-schemas.ts"],
-  "sourcesContent": ["import { merge, uniq } from 'lodash-es';\nimport assert from 'node:assert';\nimport type { ReferenceObject, SchemaObject } from 'openapi3-ts/oas31';\n\nimport { isEmpty, isRef, notRef, resolveRef, snakecase } from '@sdk-it/core';\n\nimport { findVarients } from '../find-polymorphic-varients.js';\nimport { formatName } from '../format-name.js';\nimport { isPrimitiveSchema } from '../is-primitive-schema.js';\nimport type { ProcessingPlugin } from '../processing.js';\nimport type { IR } from '../types.js';\n\nfunction normalizeSchemaObjects(\n  spec: IR,\n  schemas: (SchemaObject | ReferenceObject)[],\n  visited = new Set<string>(),\n) {\n  for (const schema of schemas) {\n    if (isRef(schema)) continue;\n\n    if (!isEmpty(schema.properties)) {\n      schema.type = 'object';\n      delete schema.oneOf;\n      delete schema.anyOf;\n      normalizeSchemaObjects(spec, Object.values(schema.properties), visited);\n      for (const [key, value] of Object.entries(schema.properties)) {\n        if (notRef(value) && isPrimitiveSchema(value)) {\n          value.default ??= schema.default?.[key];\n          delete schema.default?.[key];\n        }\n      }\n      delete schema.default;\n    }\n\n    if (!isEmpty(schema['x-properties'])) {\n      normalizeSchemaObjects(\n        spec,\n        Object.values(schema['x-properties']),\n        visited,\n      );\n    }\n\n    if (!isEmpty(schema.items)) {\n      delete schema.oneOf;\n      delete schema.anyOf;\n      schema.type = 'array';\n      normalizeSchemaObjects(spec, [schema.items], visited);\n      const items = resolveRef<SchemaObject>(spec, schema.items);\n      if (Array.isArray(items.default)) {\n        schema.default ??= structuredClone(items.default);\n      }\n      delete items.default;\n    }\n\n    if (!isEmpty(schema.anyOf) && !isEmpty(schema.oneOf)) {\n      delete schema.anyOf;\n    }\n\n    if (isEmpty(schema.enum)) {\n      delete schema.enum;\n    }\n\n    if (!isEmpty(schema.enum)) {\n      if (schema.enum.length === 1) {\n        schema.const = schema.enum[0];\n        delete schema.enum;\n      } else {\n        const valuesSet = new Set<string>();\n        const valuesList = [];\n        for (const value of schema.enum) {\n          const formattedValue = formatName(snakecase(formatName(value)));\n          if (!valuesSet.has(formattedValue)) {\n            valuesSet.add(formattedValue);\n            valuesList.push(value);\n          }\n        }\n        schema.enum = valuesList;\n      }\n      delete schema.allOf;\n    }\n\n    if (schema.const !== undefined) {\n      schema.default = schema.const;\n    }\n\n    if (!isEmpty(schema.allOf)) {\n      const schemas = schema.allOf;\n      const resolved = schemas.map((item) =>\n        resolveRef<SchemaObject>(spec, item),\n      );\n      const hasObjects = resolved.some((item) => item.type === 'object');\n      const hasOtherTypes = resolved.some(\n        (item) => item.type && item.type !== 'object',\n      );\n      if (hasObjects && hasOtherTypes) {\n        assert(false, `allOf must be an object`);\n      }\n      merge(\n        schema,\n        ...resolved.map((resolvedSchema, index) => {\n          const sourceSchema = schemas[index];\n          if (isRef(sourceSchema)) {\n            if (visited.has(sourceSchema.$ref)) {\n              throw new Error(\n                `Circular allOf reference detected: ${[\n                  ...visited,\n                  sourceSchema.$ref,\n                ].join(' -> ')}`,\n              );\n            }\n            normalizeSchemaObjects(\n              spec,\n              [resolvedSchema],\n              new Set(visited).add(sourceSchema.$ref),\n            );\n          } else {\n            normalizeSchemaObjects(spec, [resolvedSchema], visited);\n          }\n          return resolvedSchema;\n        }),\n      );\n      delete schema.allOf;\n    } else {\n      delete schema.allOf;\n    }\n\n    if (\n      schema.type === 'object' &&\n      isEmpty(schema.properties) &&\n      typeof schema.additionalProperties === 'object' &&\n      !isEmpty(schema.additionalProperties) &&\n      notRef(schema.additionalProperties) &&\n      !isEmpty(schema.additionalProperties.properties)\n    ) {\n      normalizeSchemaObjects(\n        spec,\n        Object.values(schema.additionalProperties.properties),\n        visited,\n      );\n    }\n\n    for (const kind of ['oneOf', 'anyOf'] as const) {\n      if (!isEmpty(schema[kind])) {\n        delete schema.type;\n        normalizeSchemaObjects(spec, schema[kind], visited);\n        if (isEmpty(schema[kind])) {\n          continue;\n        }\n\n        let enumSchemaIndex = -1;\n        const enumValues: string[] = [];\n        for (let index = 0; index < schema[kind].length; index++) {\n          const item = schema[kind][index];\n          if (notRef(item) && item.type === 'string') {\n            if (item.enum && item.enum.length > 1) {\n              enumValues.push(...item.enum);\n              if (enumSchemaIndex === -1) {\n                enumSchemaIndex = index;\n              }\n            }\n          }\n        }\n        if (enumSchemaIndex !== -1) {\n          const enumSchema = schema[kind][enumSchemaIndex];\n          if (notRef(enumSchema)) {\n            enumSchema.enum = uniq(enumValues);\n          }\n          schema[kind] = schema[kind].filter(\n            (item, index) => index === enumSchemaIndex || isRef(item),\n          );\n        }\n        const otherTypes = schema[kind].filter(\n          (item) => resolveRef<SchemaObject>(spec, item).type !== 'null',\n        );\n        if (otherTypes.length === 1) {\n          Object.assign(schema, otherTypes[0]);\n          delete schema[kind];\n          continue;\n        }\n\n        schema['x-varients'] = findVarients(spec, schema[kind]);\n      } else {\n        delete schema[kind];\n      }\n    }\n  }\n}\n\nexport function normalizeSchemas(): ProcessingPlugin {\n  return {\n    name: 'normalize-schemas',\n    process({ spec }) {\n      normalizeSchemaObjects(spec, Object.values(spec.components.schemas));\n    },\n  };\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { merge, uniq } from 'lodash-es';\nimport assert from 'node:assert';\nimport type { ReferenceObject, SchemaObject } from 'openapi3-ts/oas31';\n\nimport { isEmpty, isRef, notRef, resolveRef, snakecase } from '@sdk-it/core';\n\nimport { findVarients } from '../find-polymorphic-varients.js';\nimport { formatName } from '../format-name.js';\nimport { isPrimitiveSchema } from '../is-primitive-schema.js';\nimport { coerceTypes } from '../is.js';\nimport type { ProcessingPlugin } from '../processing.js';\nimport type { IR } from '../types.js';\n\nfunction normalizeSchemaObjects(\n  spec: IR,\n  schemas: (SchemaObject | ReferenceObject)[],\n  visited = new Set<string>(),\n) {\n  for (const schema of schemas) {\n    if (isRef(schema)) continue;\n\n    if (!isEmpty(schema.properties)) {\n      schema.type = 'object';\n      delete schema.oneOf;\n      delete schema.anyOf;\n      normalizeSchemaObjects(spec, Object.values(schema.properties), visited);\n      for (const [key, value] of Object.entries(schema.properties)) {\n        if (notRef(value) && isPrimitiveSchema(value)) {\n          value.default ??= schema.default?.[key];\n          delete schema.default?.[key];\n        }\n      }\n      delete schema.default;\n    }\n\n    if (!isEmpty(schema['x-properties'])) {\n      normalizeSchemaObjects(\n        spec,\n        Object.values(schema['x-properties']),\n        visited,\n      );\n    }\n\n    if (!isEmpty(schema.items)) {\n      delete schema.oneOf;\n      delete schema.anyOf;\n      schema.type = 'array';\n      normalizeSchemaObjects(spec, [schema.items], visited);\n      const items = resolveRef<SchemaObject>(spec, schema.items);\n      if (Array.isArray(items.default)) {\n        schema.default ??= structuredClone(items.default);\n      }\n      delete items.default;\n    }\n\n    if (!isEmpty(schema.anyOf) && !isEmpty(schema.oneOf)) {\n      delete schema.anyOf;\n    }\n\n    if (isEmpty(schema.enum)) {\n      delete schema.enum;\n    }\n\n    if (!isEmpty(schema.enum)) {\n      if (schema.enum.length === 1) {\n        schema.const = schema.enum[0];\n        delete schema.enum;\n      } else {\n        const valuesSet = new Set<string>();\n        const valuesList = [];\n        for (const value of schema.enum) {\n          const formattedValue = formatName(snakecase(formatName(value)));\n          if (!valuesSet.has(formattedValue)) {\n            valuesSet.add(formattedValue);\n            valuesList.push(value);\n          }\n        }\n        schema.enum = valuesList;\n      }\n      delete schema.allOf;\n    }\n\n    if (schema.const !== undefined) {\n      schema.default = schema.const;\n    }\n\n    if (!isEmpty(schema.allOf)) {\n      const schemas = schema.allOf;\n      const resolved = schemas.map((item) =>\n        resolveRef<SchemaObject>(spec, item),\n      );\n      const hasObjects = resolved.some((item) => item.type === 'object');\n      const hasOtherTypes = resolved.some(\n        (item) => item.type && item.type !== 'object',\n      );\n      if (hasObjects && hasOtherTypes) {\n        assert(false, `allOf must be an object`);\n      }\n      merge(\n        schema,\n        ...resolved.map((resolvedSchema, index) => {\n          const sourceSchema = schemas[index];\n          if (isRef(sourceSchema)) {\n            if (visited.has(sourceSchema.$ref)) {\n              throw new Error(\n                `Circular allOf reference detected: ${[\n                  ...visited,\n                  sourceSchema.$ref,\n                ].join(' -> ')}`,\n              );\n            }\n            normalizeSchemaObjects(\n              spec,\n              [resolvedSchema],\n              new Set(visited).add(sourceSchema.$ref),\n            );\n          } else {\n            normalizeSchemaObjects(spec, [resolvedSchema], visited);\n          }\n          return resolvedSchema;\n        }),\n      );\n      delete schema.allOf;\n    } else {\n      delete schema.allOf;\n    }\n\n    if (\n      schema.type === 'object' &&\n      isEmpty(schema.properties) &&\n      typeof schema.additionalProperties === 'object' &&\n      !isEmpty(schema.additionalProperties) &&\n      notRef(schema.additionalProperties) &&\n      !isEmpty(schema.additionalProperties.properties)\n    ) {\n      normalizeSchemaObjects(\n        spec,\n        Object.values(schema.additionalProperties.properties),\n        visited,\n      );\n    }\n\n    for (const kind of ['oneOf', 'anyOf'] as const) {\n      if (!isEmpty(schema[kind])) {\n        delete schema.type;\n        normalizeSchemaObjects(spec, schema[kind], visited);\n        if (isEmpty(schema[kind])) {\n          continue;\n        }\n\n        let enumSchemaIndex = -1;\n        const enumValues: string[] = [];\n        for (let index = 0; index < schema[kind].length; index++) {\n          const item = schema[kind][index];\n          if (notRef(item) && item.type === 'string') {\n            if (item.enum && item.enum.length > 1) {\n              enumValues.push(...item.enum);\n              if (enumSchemaIndex === -1) {\n                enumSchemaIndex = index;\n              }\n            }\n          }\n        }\n        if (enumSchemaIndex !== -1) {\n          const enumSchema = schema[kind][enumSchemaIndex];\n          if (notRef(enumSchema)) {\n            enumSchema.enum = uniq(enumValues);\n          }\n          schema[kind] = schema[kind].filter(\n            (item, index) => index === enumSchemaIndex || isRef(item),\n          );\n        }\n        const otherTypes = schema[kind].filter(\n          (item) => resolveRef<SchemaObject>(spec, item).type !== 'null',\n        );\n        if (otherTypes.length === 1) {\n          const [only] = otherTypes;\n          const droppedNull = otherTypes.length !== schema[kind].length;\n          Object.assign(schema, only);\n          delete schema[kind];\n          if (droppedNull && notRef(only)) {\n            const types = coerceTypes(only, false);\n            if (types.length) {\n              schema.type = uniq([...types, 'null']);\n            }\n          }\n          continue;\n        }\n\n        schema['x-varients'] = findVarients(spec, schema[kind]);\n      } else {\n        delete schema[kind];\n      }\n    }\n  }\n}\n\nexport function normalizeSchemas(): ProcessingPlugin {\n  return {\n    name: 'normalize-schemas',\n    process({ spec }) {\n      normalizeSchemaObjects(spec, Object.values(spec.components.schemas));\n    },\n  };\n}\n"],
+  "mappings": "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",
   "names": ["schemas"]
 }

package/dist/lib/sidebar.js

@@ -2,7 +2,7 @@ import { camelcase } from "stringcase";
 import { notNullOrUndefined } from "@sdk-it/core/file-system.js";
 import { forEachOperation } from "./for-each-operation.js";
 function toSidebar(spec) {
-  const sidebar = spec["x-docs"];
+  const sidebar = [...spec["x-docs"]];
   for (const tagGroup of spec["x-tagGroups"]) {
     sidebar.push({
       id: camelcase(tagGroup.name),

package/dist/lib/sidebar.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/sidebar.ts"],
-  "sourcesContent": ["import { camelcase } from 'stringcase';\n\nimport { notNullOrUndefined } from '@sdk-it/core/file-system.js';\n\nimport { forEachOperation } from './for-each-operation.js';\nimport type { IR } from './types.js';\n\nexport type ChildNavItem = {\n  id: string;\n  title: string;\n  url: string;\n};\n\nexport type NavItem = {\n  id: string;\n  title: string;\n  description?: string;\n  url?: string;\n  items?: ChildNavItem[];\n  content?: string; // Markdown content\n};\n\nexport type CategoryItem = {\n  id: string;\n  category: string;\n  description?: string;\n  items: NavItem[];\n};\n\nexport type SidebarData = CategoryItem[];\n\nexport interface TagGroups {\n  name: string;\n  tags: string[];\n}\n\nexport function toSidebar(spec: IR) {\n  const sidebar: SidebarData = spec['x-docs'];\n  for (const tagGroup of spec['x-tagGroups']) {\n    sidebar.push({\n      id: camelcase(tagGroup.name),\n      category: tagGroup.name,\n      items: tagGroup.tags.map((tag) => {\n        const tagSpec = spec.tags?.find((t) => t.name === tag);\n        return {\n          id: crypto.randomUUID(),\n          description: tagSpec?.description,\n          title: tagSpec\n            ? tagSpec['x-displayName'] || tagSpec.name || tag\n            : tag,\n          items: forEachOperation(spec, (entry, operation) => {\n            if (operation.tags.includes(tag)) {\n              const title = operation.summary || operation.operationId;\n              return {\n                id: operation.operationId,\n                title,\n                url: `${camelcase(tag)}/${camelcase(operation.operationId)}`,\n              };\n            }\n            return null;\n          }).filter(notNullOrUndefined),\n        };\n      }),\n    });\n  }\n  return sidebar;\n}\n"],
-  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B;AAEnC,SAAS,wBAAwB;AAgC1B,SAAS,UAAU,MAAU;AAClC,QAAM,UAAuB,KAAK,QAAQ;AAC1C,aAAW,YAAY,KAAK,aAAa,GAAG;AAC1C,YAAQ,KAAK;AAAA,MACX,IAAI,UAAU,SAAS,IAAI;AAAA,MAC3B,UAAU,SAAS;AAAA,MACnB,OAAO,SAAS,KAAK,IAAI,CAAC,QAAQ;AAChC,cAAM,UAAU,KAAK,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG;AACrD,eAAO;AAAA,UACL,IAAI,OAAO,WAAW;AAAA,UACtB,aAAa,SAAS;AAAA,UACtB,OAAO,UACH,QAAQ,eAAe,KAAK,QAAQ,QAAQ,MAC5C;AAAA,UACJ,OAAO,iBAAiB,MAAM,CAAC,OAAO,cAAc;AAClD,gBAAI,UAAU,KAAK,SAAS,GAAG,GAAG;AAChC,oBAAM,QAAQ,UAAU,WAAW,UAAU;AAC7C,qBAAO;AAAA,gBACL,IAAI,UAAU;AAAA,gBACd;AAAA,gBACA,KAAK,GAAG,UAAU,GAAG,CAAC,IAAI,UAAU,UAAU,WAAW,CAAC;AAAA,cAC5D;AAAA,YACF;AACA,mBAAO;AAAA,UACT,CAAC,EAAE,OAAO,kBAAkB;AAAA,QAC9B;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
+  "sourcesContent": ["import { camelcase } from 'stringcase';\n\nimport { notNullOrUndefined } from '@sdk-it/core/file-system.js';\n\nimport { forEachOperation } from './for-each-operation.js';\nimport type { IR } from './types.js';\n\nexport type ChildNavItem = {\n  id: string;\n  title: string;\n  url: string;\n};\n\nexport type NavItem = {\n  id: string;\n  title: string;\n  description?: string;\n  url?: string;\n  items?: ChildNavItem[];\n  content?: string; // Markdown content\n};\n\nexport type CategoryItem = {\n  id: string;\n  category: string;\n  description?: string;\n  items: NavItem[];\n};\n\nexport type SidebarData = CategoryItem[];\n\nexport interface TagGroups {\n  name: string;\n  tags: string[];\n}\n\nexport function toSidebar(spec: IR) {\n  const sidebar: SidebarData = [...spec['x-docs']];\n  for (const tagGroup of spec['x-tagGroups']) {\n    sidebar.push({\n      id: camelcase(tagGroup.name),\n      category: tagGroup.name,\n      items: tagGroup.tags.map((tag) => {\n        const tagSpec = spec.tags?.find((t) => t.name === tag);\n        return {\n          id: crypto.randomUUID(),\n          description: tagSpec?.description,\n          title: tagSpec\n            ? tagSpec['x-displayName'] || tagSpec.name || tag\n            : tag,\n          items: forEachOperation(spec, (entry, operation) => {\n            if (operation.tags.includes(tag)) {\n              const title = operation.summary || operation.operationId;\n              return {\n                id: operation.operationId,\n                title,\n                url: `${camelcase(tag)}/${camelcase(operation.operationId)}`,\n              };\n            }\n            return null;\n          }).filter(notNullOrUndefined),\n        };\n      }),\n    });\n  }\n  return sidebar;\n}\n"],
+  "mappings": "AAAA,SAAS,iBAAiB;AAE1B,SAAS,0BAA0B;AAEnC,SAAS,wBAAwB;AAgC1B,SAAS,UAAU,MAAU;AAClC,QAAM,UAAuB,CAAC,GAAG,KAAK,QAAQ,CAAC;AAC/C,aAAW,YAAY,KAAK,aAAa,GAAG;AAC1C,YAAQ,KAAK;AAAA,MACX,IAAI,UAAU,SAAS,IAAI;AAAA,MAC3B,UAAU,SAAS;AAAA,MACnB,OAAO,SAAS,KAAK,IAAI,CAAC,QAAQ;AAChC,cAAM,UAAU,KAAK,MAAM,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG;AACrD,eAAO;AAAA,UACL,IAAI,OAAO,WAAW;AAAA,UACtB,aAAa,SAAS;AAAA,UACtB,OAAO,UACH,QAAQ,eAAe,KAAK,QAAQ,QAAQ,MAC5C;AAAA,UACJ,OAAO,iBAAiB,MAAM,CAAC,OAAO,cAAc;AAClD,gBAAI,UAAU,KAAK,SAAS,GAAG,GAAG;AAChC,oBAAM,QAAQ,UAAU,WAAW,UAAU;AAC7C,qBAAO;AAAA,gBACL,IAAI,UAAU;AAAA,gBACd;AAAA,gBACA,KAAK,GAAG,UAAU,GAAG,CAAC,IAAI,UAAU,UAAU,WAAW,CAAC;AAAA,cAC5D;AAAA,YACF;AACA,mBAAO;AAAA,UACT,CAAC,EAAE,OAAO,kBAAkB;AAAA,QAC9B;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AACA,SAAO;AACT;",
   "names": []
 }

package/dist/lib/types.d.ts

@@ -1,5 +1,6 @@
 import type { MediaTypeObject, OperationObject, ParameterObject, PathsObject, ReferenceObject, RequestBodyObject, ResponseObject, SchemaObject, ServerObject, TagObject } from 'openapi3-ts/oas31';
 import type { OpenAPIComponentsObject, OpenAPIDocument, OpenAPISecuritySchemeObject } from '@sdk-it/core';
+import type { SdkDoc } from './overview-docs/types.js';
 import type { PaginationGuess } from './pagination/guess-pagination.js';
 import type { SidebarData, TagGroups } from './sidebar.js';
 export type IR = Omit<OpenAPIDocument, 'components' | 'paths' | 'servers' | 'tags'> & {
@@ -9,6 +10,7 @@ export type IR = Omit<OpenAPIDocument, 'components' | 'paths' | 'servers' | 'tag
         configuration: string;
     };
     'x-docs': SidebarData;
+    'x-sdks': SdkDoc[];
     'x-tagGroups': TagGroups[];
     components: Omit<OpenAPIComponentsObject, 'schemas' | 'securitySchemes'> & {
         schemas: Record<string, SchemaObject | ReferenceObject>;

package/dist/lib/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,MAAM,EAAE,GAAG,IAAI,CACnB,eAAe,EACf,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAC5C,GAAG;IACF,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,WAAW,CAAC;IACtB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,iBAAiB,CAAC,GAAG;QACzE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;QACxD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;KAC9D,CAAC;IACF,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,MAAM,CACb,MAAM,EACN,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG;QAAE,MAAM,EAAE,eAAe,CAAA;KAAE,CAC9D,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,eAAe,EACf,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAC7E,GAAG;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CACf,MAAM,EACN,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CACF,CAAC;IACF,WAAW,EAAE,oBAAoB,CAAC;CACnC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EACf,WAAW,EACX,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,SAAS,EACV,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EACV,uBAAuB,EACvB,eAAe,EACf,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,MAAM,EAAE,GAAG,IAAI,CACnB,eAAe,EACf,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAC5C,GAAG;IACF,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,kBAAkB,CAAC,EAAE;QACnB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,SAAS,EAAE,CAAC;IAC3B,UAAU,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,iBAAiB,CAAC,GAAG;QACzE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAAC,CAAC;QACxD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;KAC9D,CAAC;IACF,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,SAAS,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D,OAAO,EAAE,MAAM,CACb,MAAM,EACN,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,GAAG;QAAE,MAAM,EAAE,eAAe,CAAA;KAAE,CAC9D,CAAC;CACH;AAED,MAAM,MAAM,oBAAoB,GAAG,IAAI,CACrC,eAAe,EACf,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,CAC7E,GAAG;IACF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IACtB,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CACf,MAAM,EACN,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;QAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;KAC1C,CACF,CAAC;IACF,WAAW,EAAE,oBAAoB,CAAC;CACnC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AACD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAC;IACtB,SAAS,EAAE,oBAAoB,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sdk-it/spec",
-  "version": "0.46.4",
+  "version": "0.46.5",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -27,7 +27,7 @@
     "!**/*.test.*"
   ],
   "dependencies": {
-    "@sdk-it/core": "0.46.4",
+    "@sdk-it/core": "0.46.5",
     "openapi3-ts": "4.5.0",
     "pluralize": "^8.0.0",
     "stringcase": "^4.3.1",

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

@@ -1,51 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,123 +0,0 @@
-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

@@ -1,7 +0,0 @@
-{
-  "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/overview-intro.d.ts

@@ -1,4 +0,0 @@
-import type { NavItem } from '../sidebar.js';
-import type { IR } from '../types.js';
-export declare function generateIntroOverview(spec: IR, availablesdks: string[]): NavItem;
-//# sourceMappingURL=overview-intro.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"overview-intro.d.ts","sourceRoot":"","sources":["../../../src/lib/overview-docs/overview-intro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAOtC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,EAAE,EACR,aAAa,EAAE,MAAM,EAAE,GACtB,OAAO,CA2FT"}

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

@@ -1,82 +0,0 @@
-import {
-  getClientIntroText,
-  getTextByCount,
-  presetDocs
-} from "./doc-text-utils.js";
-function generateIntroOverview(spec, availablesdks) {
-  const info = spec.info;
-  const markdown = [];
-  if (spec.info.title) {
-    markdown.push(`# ${spec.info.title || "API Reference"}
-`);
-  }
-  if (spec.info.description) {
-    markdown.push(`${spec.info.description}
-`);
-  }
-  if (spec.info.version) {
-    markdown.push(`**Version:** ${spec.info.version}
-`);
-  }
-  if (info.license) {
-    let licenseString = `**License:** ${info.license.name}`;
-    if (info.license.url) {
-      licenseString += ` ([${info.license.url}](${info.license.url}))`;
-    }
-    markdown.push(`${licenseString}
-`);
-  }
-  if (spec.servers && spec.servers.length > 0) {
-    const serverCount = spec.servers.length;
-    markdown.push(
-      `## ${getTextByCount(serverCount, presetDocs.server.section)}`
-    );
-    markdown.push(getTextByCount(serverCount, presetDocs.server.description));
-    markdown.push("");
-    for (const server of spec.servers) {
-      let serverLine = `- **${server.url}**`;
-      if (server.description) {
-        serverLine += ` - ${server.description}`;
-      }
-      markdown.push(serverLine);
-    }
-    markdown.push("");
-  }
-  const sdkCount = availablesdks.length;
-  markdown.push(`## ${getTextByCount(sdkCount, presetDocs.client.section)}`);
-  markdown.push(getClientIntroText(info.title || "This API", sdkCount));
-  for (const link of availablesdks) {
-    const sdkName = link.replace("/", "").replace("-sdk", "").toUpperCase();
-    markdown.push(`- [${sdkName} SDK](${link})`);
-  }
-  const hasSupportInfo = info.contact?.email || info.contact?.url || spec.externalDocs?.url && spec.externalDocs?.description?.toLowerCase().includes("support");
-  if (hasSupportInfo) {
-    markdown.push(`## Need Help?`);
-    if (info.contact?.email) {
-      markdown.push(
-        `For support, reach out to us at [${info.contact.email}](mailto:${info.contact.email}).`
-      );
-    }
-    if (info.contact?.url) {
-      markdown.push(
-        `Visit our support page: [${info.contact.url}](${info.contact.url})`
-      );
-    }
-    if (spec.externalDocs?.url && spec.externalDocs?.description?.toLowerCase().includes("support")) {
-      markdown.push(
-        `For additional support, visit our [${spec.externalDocs.description}](${spec.externalDocs.url}).`
-      );
-    }
-  }
-  return {
-    id: "generated-introduction",
-    title: "Introduction",
-    url: "/introduction",
-    description: "API overview and getting started guide",
-    content: markdown.join("\n\n")
-  };
-}
-export {
-  generateIntroOverview
-};
-//# sourceMappingURL=overview-intro.js.map

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

@@ -1,7 +0,0 @@
-{
-  "version": 3,
-  "sources": ["../../../src/lib/overview-docs/overview-intro.ts"],
-  "sourcesContent": ["import type { NavItem } from '../sidebar.js';\nimport type { IR } from '../types.js';\nimport {\n  getClientIntroText,\n  getTextByCount,\n  presetDocs,\n} from './doc-text-utils.js';\n\nexport function generateIntroOverview(\n  spec: IR,\n  availablesdks: string[],\n): NavItem {\n  const info = spec.info;\n  const markdown: string[] = [];\n\n  if (spec.info.title) {\n    markdown.push(`# ${spec.info.title || 'API Reference'}\\n`);\n  }\n\n  if (spec.info.description) {\n    markdown.push(`${spec.info.description}\\n`);\n  }\n\n  if (spec.info.version) {\n    markdown.push(`**Version:** ${spec.info.version}\\n`);\n  }\n\n  if (info.license) {\n    let licenseString = `**License:** ${info.license.name}`;\n    if (info.license.url) {\n      licenseString += ` ([${info.license.url}](${info.license.url}))`;\n    }\n    markdown.push(`${licenseString}\\n`);\n  }\n\n  if (spec.servers && spec.servers.length > 0) {\n    const serverCount = spec.servers.length;\n\n    markdown.push(\n      `## ${getTextByCount(serverCount, presetDocs.server.section)}`,\n    );\n    markdown.push(getTextByCount(serverCount, presetDocs.server.description));\n    markdown.push('');\n\n    for (const server of spec.servers) {\n      let serverLine = `- **${server.url}**`;\n      if (server.description) {\n        serverLine += ` - ${server.description}`;\n      }\n      markdown.push(serverLine);\n    }\n    markdown.push('');\n  }\n\n  const sdkCount = availablesdks.length;\n  markdown.push(`## ${getTextByCount(sdkCount, presetDocs.client.section)}`);\n  markdown.push(getClientIntroText(info.title || 'This API', sdkCount));\n\n  for (const link of availablesdks) {\n    const sdkName = link.replace('/', '').replace('-sdk', '').toUpperCase();\n    markdown.push(`- [${sdkName} SDK](${link})`);\n  }\n\n  // Add \"Need Help?\" section if support information is available\n  const hasSupportInfo =\n    info.contact?.email ||\n    info.contact?.url ||\n    (spec.externalDocs?.url &&\n      spec.externalDocs?.description?.toLowerCase().includes('support'));\n\n  if (hasSupportInfo) {\n    markdown.push(`## Need Help?`);\n\n    if (info.contact?.email) {\n      markdown.push(\n        `For support, reach out to us at [${info.contact.email}](mailto:${info.contact.email}).`,\n      );\n    }\n\n    if (info.contact?.url) {\n      markdown.push(\n        `Visit our support page: [${info.contact.url}](${info.contact.url})`,\n      );\n    }\n\n    if (\n      spec.externalDocs?.url &&\n      spec.externalDocs?.description?.toLowerCase().includes('support')\n    ) {\n      markdown.push(\n        `For additional support, visit our [${spec.externalDocs.description}](${spec.externalDocs.url}).`,\n      );\n    }\n  }\n\n  return {\n    id: 'generated-introduction',\n    title: 'Introduction',\n    url: '/introduction',\n    description: 'API overview and getting started guide',\n    content: markdown.join('\\n\\n'),\n  };\n}\n"],
-  "mappings": "AAEA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,SAAS,sBACd,MACA,eACS;AACT,QAAM,OAAO,KAAK;AAClB,QAAM,WAAqB,CAAC;AAE5B,MAAI,KAAK,KAAK,OAAO;AACnB,aAAS,KAAK,KAAK,KAAK,KAAK,SAAS,eAAe;AAAA,CAAI;AAAA,EAC3D;AAEA,MAAI,KAAK,KAAK,aAAa;AACzB,aAAS,KAAK,GAAG,KAAK,KAAK,WAAW;AAAA,CAAI;AAAA,EAC5C;AAEA,MAAI,KAAK,KAAK,SAAS;AACrB,aAAS,KAAK,gBAAgB,KAAK,KAAK,OAAO;AAAA,CAAI;AAAA,EACrD;AAEA,MAAI,KAAK,SAAS;AAChB,QAAI,gBAAgB,gBAAgB,KAAK,QAAQ,IAAI;AACrD,QAAI,KAAK,QAAQ,KAAK;AACpB,uBAAiB,MAAM,KAAK,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG;AAAA,IAC9D;AACA,aAAS,KAAK,GAAG,aAAa;AAAA,CAAI;AAAA,EACpC;AAEA,MAAI,KAAK,WAAW,KAAK,QAAQ,SAAS,GAAG;AAC3C,UAAM,cAAc,KAAK,QAAQ;AAEjC,aAAS;AAAA,MACP,MAAM,eAAe,aAAa,WAAW,OAAO,OAAO,CAAC;AAAA,IAC9D;AACA,aAAS,KAAK,eAAe,aAAa,WAAW,OAAO,WAAW,CAAC;AACxE,aAAS,KAAK,EAAE;AAEhB,eAAW,UAAU,KAAK,SAAS;AACjC,UAAI,aAAa,OAAO,OAAO,GAAG;AAClC,UAAI,OAAO,aAAa;AACtB,sBAAc,MAAM,OAAO,WAAW;AAAA,MACxC;AACA,eAAS,KAAK,UAAU;AAAA,IAC1B;AACA,aAAS,KAAK,EAAE;AAAA,EAClB;AAEA,QAAM,WAAW,cAAc;AAC/B,WAAS,KAAK,MAAM,eAAe,UAAU,WAAW,OAAO,OAAO,CAAC,EAAE;AACzE,WAAS,KAAK,mBAAmB,KAAK,SAAS,YAAY,QAAQ,CAAC;AAEpE,aAAW,QAAQ,eAAe;AAChC,UAAM,UAAU,KAAK,QAAQ,KAAK,EAAE,EAAE,QAAQ,QAAQ,EAAE,EAAE,YAAY;AACtE,aAAS,KAAK,MAAM,OAAO,SAAS,IAAI,GAAG;AAAA,EAC7C;AAGA,QAAM,iBACJ,KAAK,SAAS,SACd,KAAK,SAAS,OACb,KAAK,cAAc,OAClB,KAAK,cAAc,aAAa,YAAY,EAAE,SAAS,SAAS;AAEpE,MAAI,gBAAgB;AAClB,aAAS,KAAK,eAAe;AAE7B,QAAI,KAAK,SAAS,OAAO;AACvB,eAAS;AAAA,QACP,oCAAoC,KAAK,QAAQ,KAAK,YAAY,KAAK,QAAQ,KAAK;AAAA,MACtF;AAAA,IACF;AAEA,QAAI,KAAK,SAAS,KAAK;AACrB,eAAS;AAAA,QACP,4BAA4B,KAAK,QAAQ,GAAG,KAAK,KAAK,QAAQ,GAAG;AAAA,MACnE;AAAA,IACF;AAEA,QACE,KAAK,cAAc,OACnB,KAAK,cAAc,aAAa,YAAY,EAAE,SAAS,SAAS,GAChE;AACA,eAAS;AAAA,QACP,sCAAsC,KAAK,aAAa,WAAW,KAAK,KAAK,aAAa,GAAG;AAAA,MAC/F;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,OAAO;AAAA,IACP,KAAK;AAAA,IACL,aAAa;AAAA,IACb,SAAS,SAAS,KAAK,MAAM;AAAA,EAC/B;AACF;",
-  "names": []
-}