fix: Generate valid types for referenced nested properties

Author: avaly

packages/openapi-typescript/src/lib/ts.ts

@@ -122,6 +122,11 @@ export function oapiRef(path: string): ts.TypeNode {
   );
   if (pointer.length > 1) {
     for (let i = 1; i < pointer.length; i++) {
+      // Skip `properties` items when in the middle of the pointer
+      // See: https://github.com/openapi-ts/openapi-typescript/issues/1742
+      if (i > 2 && i < pointer.length - 1 && pointer[i] === 'properties') {
+        continue;
+      }
       t = ts.factory.createIndexedAccessTypeNode(
         t,
         ts.factory.createLiteralTypeNode(

packages/openapi-typescript/test/transform/components-object.test.ts

@@ -503,6 +503,60 @@ describe("transformComponentsObject", () => {
         },
       },
     ],
+    [
+      "$ref nested properties",
+      {
+        given: {
+          parameters: {
+            direct: {
+              name: "direct",
+              in: "query",
+              required: true,
+              schema: {
+                $ref: "#/components/aaa"
+              },
+            },
+            nested: {
+              name: "nested",
+              in: "query",
+              required: true,
+              schema: {
+                $ref: "#/components/schemas/bbb/properties/ccc"
+              },
+            },
+          },
+          schemas: {
+            aaa: {
+              type: "string"
+            },
+            bbb: {
+              type: "object",
+              properties: {
+                ccc: {
+                  type: "string"
+                },
+              },
+            },
+          },
+        },
+        want: `{
+    schemas: {
+        aaa: string;
+        bbb: {
+            ccc?: string;
+        };
+    };
+    responses: never;
+    parameters: {
+        direct: components["aaa"];
+        nested: components["schemas"]["bbb"]["ccc"];
+    };
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}`,
+      },
+    ],
   ];
 
   for (const [testName, { given, want, options = DEFAULT_OPTIONS, ci }] of tests) {