openapi-sync 5.0.2 → 5.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -42,6 +42,8 @@ npm install -g openapi-sync
42
42
  npx openapi-sync
43
43
  ```
44
44
 
45
+ > ⚠️ **macOS Big Sur Users:** If you encounter an esbuild error (`Symbol not found: _SecTrustCopyCertificateChain`), install `esbuild@0.17.19` first. See [Troubleshooting](#troubleshooting) for details.
46
+
45
47
  ## Quick Start
46
48
 
47
49
  ### Option 1: Interactive Setup (Recommended) 🎯
@@ -337,6 +339,38 @@ For complete documentation including:
337
339
 
338
340
  ---
339
341
 
342
+ ## Troubleshooting
343
+
344
+ ### macOS Big Sur (11.x) - esbuild Installation Error
345
+
346
+ **Error:** `dyld: Symbol not found: _SecTrustCopyCertificateChain` when installing `openapi-sync`
347
+
348
+ **Cause:** The default esbuild version requires macOS 12.0+ APIs that aren't available in Big Sur.
349
+
350
+ **Solution:** Install a compatible esbuild version before installing openapi-sync:
351
+
352
+ ```bash
353
+ # Install compatible esbuild first
354
+ npm install esbuild@0.17.19
355
+
356
+ # Then install openapi-sync
357
+ npm install openapi-sync
358
+ ```
359
+
360
+ Alternatively, add an override to your `package.json`:
361
+
362
+ ```json
363
+ {
364
+ "overrides": {
365
+ "esbuild": "0.17.19"
366
+ }
367
+ }
368
+ ```
369
+
370
+ **Note:** This issue only affects macOS Big Sur (darwin 20.x). Users on macOS 12+ are not affected.
371
+
372
+ ---
373
+
340
374
  ## License
341
375
 
342
376
  ISC License - see [LICENSE](LICENSE) file for details.
package/dist/index.d.mts CHANGED
@@ -496,6 +496,7 @@ declare const JSONStringify: (obj: Record<string, any>, indent?: number) => stri
496
496
  * Render TypeScript type reference as markdown code block
497
497
  *
498
498
  * Formats a TypeScript type definition for inclusion in markdown documentation.
499
+ * Converts multiline/JSDoc comments to single-line comments to prevent breaking outer JSDoc.
499
500
  *
500
501
  * @param {string} typeRef - TypeScript type definition
501
502
  * @param {number} [indent=1] - Indentation level
package/dist/index.d.ts CHANGED
@@ -496,6 +496,7 @@ declare const JSONStringify: (obj: Record<string, any>, indent?: number) => stri
496
496
  * Render TypeScript type reference as markdown code block
497
497
  *
498
498
  * Formats a TypeScript type definition for inclusion in markdown documentation.
499
+ * Converts multiline/JSDoc comments to single-line comments to prevent breaking outer JSDoc.
499
500
  *
500
501
  * @param {string} typeRef - TypeScript type definition
501
502
  * @param {number} [indent=1] - Indentation level