fix: inline internal JSON Pointer refs under #/paths/ for OpenAPI bundling

- Add shouldInlineInternal helper to determine when internal refs should be copied inline
- Internal refs under #/paths/ are now dereferenced (copied) instead of left as
- Components/schemas, definitions, and declarations still preserved as refs

Author: carson2222

lib/bundle.ts

@@ -23,6 +23,24 @@ export interface InventoryEntry {
   value: any;
 }
 
+/**
+ * Determines whether an internal $ref should be inlined (copied) rather than left as a $ref.
+ * Currently inlines OpenAPI path items ("#/paths/..."), while keeping components/definitions/declarations as refs.
+ */
+const shouldInlineInternal = (entry: InventoryEntry) => {
+  if (entry.external) {
+    return false;
+  }
+  const h = entry.hash as string | undefined;
+  if (!h || h === "#") {
+    return false;
+  }
+  if (h.startsWith("#/components/schemas") || h.indexOf("/definitions") !== -1 || h.startsWith("#/declarations")) {
+    return false;
+  }
+  return h.startsWith("#/paths/");
+};
+
 /**
  * TODO
  */
@@ -300,7 +318,7 @@ function remap(inventory: InventoryEntry[]) {
   for (const entry of inventory) {
     // console.log('Re-mapping $ref pointer "%s" at %s', entry.$ref.$ref, entry.pathFromRoot);
 
-    if (!entry.external) {
+    if (!entry.external && !shouldInlineInternal(entry)) {
       // This $ref already resolves to the main JSON Schema file
       entry.$ref.$ref = entry.hash;
     } else if (entry.file === file && entry.hash === hash) {

package.json

@@ -42,6 +42,7 @@
   ],
   "scripts": {
     "build": "rimraf dist && tsc",
+    "dev": "rimraf dist && tsc --watch",
     "lint": "eslint lib",
     "prepublishOnly": "yarn build",
     "prettier": "prettier --write \"**/*.+(js|jsx|ts|tsx|har||json|css|md)\"",