feat: add $dynamicRef / $dynamicAnchor schema resolution for OpenAPI 3.1

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/changelog.js

@@ -0,0 +1,107 @@
+import { getInfo, getInfoFromPullRequest } from '@changesets/get-github-info';
+
+/**
+ * @returns {string}
+ */
+function getRepo() {
+  return 'hey-api/openapi-ts';
+}
+
+/** @type {import("@changesets/types").ChangelogFunctions} */
+export default {
+  getDependencyReleaseLine: async (_, dependenciesUpdated) => {
+    if (!dependenciesUpdated.length) {
+      return '';
+    }
+
+    const list = dependenciesUpdated.map(
+      (dependency) => `  - ${dependency.name}@${dependency.newVersion}`,
+    );
+
+    return ['### Updated Dependencies:', ...list].join('\n');
+  },
+  getReleaseLine: async (changeset) => {
+    const repo = getRepo();
+
+    /** @type number | undefined */
+    let prFromSummary;
+    /** @type string | undefined */
+    let commitFromSummary;
+    /** @type string[] */
+    const usersFromSummary = [];
+
+    // Remove PR, commit, author/user lines from summary
+    const replacedChangelog = changeset.summary
+      .replace(/^\s*(?:pr|pull|pull\s+request):\s*#?(\d+)/im, (_, pr) => {
+        const num = Number(pr);
+        if (!Number.isNaN(num)) {
+          prFromSummary = num;
+        }
+        return '';
+      })
+      .replace(/^\s*commit:\s*([^\s]+)/im, (_, commit) => {
+        commitFromSummary = commit;
+        return '';
+      })
+      .replace(/^\s*(?:author|user):\s*@?([^\s]+)/gim, (_, user) => {
+        usersFromSummary.push(user);
+        return '';
+      })
+      .trim();
+
+    const links = await (async () => {
+      if (prFromSummary !== undefined) {
+        let { links } = await getInfoFromPullRequest({
+          pull: prFromSummary,
+          repo,
+        });
+        if (commitFromSummary) {
+          const shortCommitId = commitFromSummary.slice(0, 7);
+          links = {
+            ...links,
+            commit: `[\`${shortCommitId}\`](https://github.com/${repo}/commit/${commitFromSummary})`,
+          };
+        }
+        return links;
+      }
+      const commitToFetchFrom = commitFromSummary || changeset.commit;
+      if (commitToFetchFrom) {
+        let { links } = await getInfo({ commit: commitToFetchFrom, repo });
+        const shortCommitId = commitToFetchFrom.slice(0, 7);
+        links = {
+          ...links,
+          commit: `[\`${shortCommitId}\`](https://github.com/${repo}/commit/${commitToFetchFrom})`,
+        };
+        return links;
+      }
+      return {
+        commit: null,
+        pull: null,
+        user: null,
+      };
+    })();
+
+    const users = usersFromSummary.length
+      ? usersFromSummary
+          .map((userFromSummary) => `[@${userFromSummary}](https://github.com/${userFromSummary})`)
+          .join(', ')
+      : links.user;
+
+    const metadata = [
+      links.pull === null ? '' : ` (${links.pull})`,
+      links.commit === null ? '' : ` (${links.commit})`,
+      users === null ? '' : ` by ${users}`,
+    ].join('');
+
+    // Split summary into first line and the rest
+    const [firstLine, ...rest] = replacedChangelog.split('\n');
+    const restSummary = rest.join('\n').trim();
+
+    // No code block conversion: preserve original triple backtick code blocks and indentation
+    let releaseLine = `\n- ${firstLine}${metadata}`;
+    if (restSummary) {
+      releaseLine += '\n\n' + restSummary;
+    }
+    return releaseLine;
+  },
+};

.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+  "access": "public",
+  "baseBranch": "main",
+  "changelog": "./changelog.js",
+  "commit": false,
+  "fixed": [],
+  "ignore": [],
+  "linked": [],
+  "updateInternalDependencies": "minor",
+  "___experimentalUnsafeOptions_WILL_CHANGE_IN_PATCH": {
+    "onlyUpdatePeerDependentsWhenOutOfRange": true
+  }
+}

.changeset/cuddly-papayas-laugh.md

@@ -0,0 +1,5 @@
+---
+"@hey-api/shared": patch
+---
+
+**types**: export `ResolverNodes` type on `Plugin`

.changeset/dynamicref-support.md

@@ -0,0 +1,6 @@
+---
+"@hey-api/shared": minor
+"@hey-api/spec-types": minor
+---
+
+add `$dynamicRef` / `$dynamicAnchor` schema resolution for OpenAPI 3.1

.editorconfig

@@ -1,9 +1,9 @@
 root = true
 
 [*]
-end_of_line = lf
 charset = utf-8
-trim_trailing_whitespace = true
-insert_final_newline = true
+end_of_line = lf
+indent_size = 2
 indent_style = space
-indent_size = 4
+insert_final_newline = true
+trim_trailing_whitespace = true

.gitattributes

@@ -0,0 +1,5 @@
+* text=auto eol=lf
+bun.lockb linguist-generated=true
+package-lock.json linguist-generated=true
+pnpm-lock.yaml linguist-generated=true
+yarn.lock linguist-generated=true

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github:
+  - hey-api

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,42 @@
+name: Bug report
+description: Report an issue with the project.
+
+labels:
+  - bug 🔥
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report! Please do your best to fill out as much information as possible.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Please check if there is an existing bug report before creating a new issue. If you intend to submit a pull request to fix this issue, let us know in the description.
+      placeholder: Bug description
+    validations:
+      required: true
+
+  - type: textarea
+    id: config
+    attributes:
+      label: Reproducible example or configuration
+      description: Please provide a reproducible StackBlitz example, your configuration file, or CLI command used to recreate the issue.
+      placeholder: https://stackblitz.com/edit/hey-api-client-fetch-example
+      value: https://stackblitz.com/edit/hey-api-client-fetch-example
+
+  - type: textarea
+    id: openapi-spec
+    attributes:
+      label: OpenAPI specification (optional)
+      description: Minimal OpenAPI specification needed to recreate the issue.
+      placeholder: OpenAPI Specification
+
+  - type: textarea
+    id: system-info
+    attributes:
+      label: System information (optional)
+      description: Any additional relevant system information. This may include OS, browser, NPM version, Node.js version, etc.
+      placeholder: System information

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,21 @@
+name: Feature Request
+
+description: Suggest a new feature for the project.
+
+labels:
+  - feature 🚀
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to request a new feature! Please ensure your feature request has enough information so maintainers can decide if it will be worked on.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Please provide a clear and concise description of the proposed feature. The more information you can provide, the better.
+      placeholder: Feature description
+    validations:
+      required: true