Merge branch 'main' into initial-usage-docs

Author: langsamu

src/AuthorizationCodeFlow.ts

@@ -62,7 +62,6 @@ const html = `
  *
  * @example Minimal usage
  * ```html
- * <script src="https://unpkg.com/@solid/reactive-authentication/dist/registerElements.js"></script>
  * <authorization-code-flow></authorization-code-flow>
  * ```
  *
@@ -141,7 +140,7 @@ export class AuthorizationCodeFlow extends HTMLElement {
     }
 
     /**
-     * a {@link GetCodeCallback} that provides an authorization code by directing the user to the {@link authorizationUri authorization endpoint URI} in a popup and waiting for the code in a redirect back.
+     * a {@link GetCodeCallback} that provides an authorization code by directing the user to the authorization endpoint URI in a popup and waiting for the code in a redirect back.
      *
      * @remarks Only one flow runs at a time. Any number of calls
      *

src/IdpPicker.ts

@@ -38,12 +38,21 @@ const html = `
 </dialog>
 `
 
+/**
+ * A web component (custom HTML element) that prompts the user for the URI of the authorization server (identity provider) to use for a request.
+ *
+ * @remarks
+ * This element is not {@link customElements.define defined} when importing the module. Import {@link registerElements} to define it.
+ *
+ * See the {@link getIssuer} method for integrating this element into your application.
+ */
 export class IdpPicker extends HTMLElement {
     readonly #mutex = new Mutex
     #dialog!: HTMLDialogElement
     #input!: HTMLInputElement
     #code!: HTMLElement
 
+    /** @ignore */
     connectedCallback() {
         const template = this.ownerDocument.createElement("template")
         template.innerHTML = html

src/mod.ts

@@ -8,6 +8,7 @@ export * from "./ReactiveAuthenticationError.js"
 export * from "./ClientCredentialsTokenProvider.js"
 export * from "./GetCodeCallback.js"
 export * from "./issuerFrom.js"
+export * from "./TokenProvider.js"
 export * from "./GetIssuerCallback.js"
 export * from "./IdpPicker.js"
 export * from "./IssuerRequestCancelledError.js"

typedoc.json

@@ -4,7 +4,8 @@
         "ts",
         "javascript",
         "html",
-        "css"
+        "css",
+        "batch"
     ],
     "plugin": [
         "typedoc-plugin-mdn-links"