chore(repo,types): Update billing-related types; hide "Type declaration" heading from typedoc output (#6801)

Co-authored-by: panteliselef <[email protected]>

Author: alexisintech

.changeset/bitter-books-drop.md

@@ -0,0 +1,2 @@
+---
+---

.typedoc/__tests__/__snapshots__/file-structure.test.ts.snap

@@ -59,6 +59,7 @@ exports[`Typedoc output > should have a deliberate file structure 1`] = `
   "types/confirm-checkout-params.mdx",
   "types/create-checkout-params.mdx",
   "types/create-organization-params.mdx",
+  "types/deleted-object-resource.mdx",
   "types/element-object-key.mdx",
   "types/elements-config.mdx",
   "types/errors.mdx",

.typedoc/custom-plugin.mjs

@@ -54,8 +54,6 @@ const LINK_REPLACEMENTS = [
   ['web3-wallet', '/docs/references/backend/types/backend-web3-wallet'],
   ['verify-token-options', '#verify-token-options'],
   ['localization-resource', '/docs/customization/localization'],
-  ['commerce-subscription-item-resource', '/docs/references/javascript/types/commerce-subscription-item-resource'],
-  ['commerce-money-amount', '/docs/references/javascript/types/commerce-money-amount'],
 ];
 
 /**

.typedoc/custom-theme.mjs

@@ -289,7 +289,7 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
         return superPartials.member(model, options);
       },
       /**
-       * This hides the "Type parameters" section and the declaration title from the output
+       * This hides the "Type parameters" section, the declaration title, and the "Type declaration" heading from the output
        * @param {import('typedoc').DeclarationReflection} model
        * @param {{ headingLevel: number, nested?: boolean }} options
        */
@@ -309,7 +309,11 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
         const output = superPartials.declaration(customizedModel, options);
         this.partials = originalPartials;
 
-        return output;
+        // Remove the "Type declaration" heading from the output
+        // This heading is generated by the original declaration partial
+        const filteredOutput = output.replace(/^## Type declaration$/gm, '');
+
+        return filteredOutput;
       },
       /**
        * This ensures that everything is wrapped in a single codeblock
@@ -452,7 +456,7 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
         const items = headings.map(i => `'${i}'`).join(', ');
         const tabs = md.map(i => `<Tab>${i}</Tab>`).join('\n');
 
-        return `This function returns a discriminated union type. There are multiple variants of this type available which you can select by clicking on one of the tabs.
+        return `There are multiple variants of this type available which you can select by clicking on one of the tabs.
 
 <Tabs items={[${items}]}>
 ${tabs}

packages/backend/src/api/resources/CommercePlan.ts

@@ -4,7 +4,7 @@ import { Feature } from './Feature';
 import type { CommercePlanJSON } from './JSON';
 
 /**
- * The `CommercePlan` object is similar to the [`CommercePlanResource`](/docs/references/javascript/types/commerce-plan-resource) object as it holds information about a plan, as well as methods for managing it. However, the `CommercePlan` object is different in that it is used in the [Backend API](https://clerk.com/docs/reference/backend-api/tag/commerce/get/commerce/plans) and is not directly accessible from the Frontend API.
+ * The `CommercePlan` object is similar to the [`BillingPlanResource`](/docs/references/javascript/types/billing-plan-resource) object as it holds information about a plan, as well as methods for managing it. However, the `CommercePlan` object is different in that it is used in the [Backend API](https://clerk.com/docs/reference/backend-api/tag/commerce/get/commerce/plans) and is not directly accessible from the Frontend API.
  *
  * @experimental This is an experimental API for the Billing feature that is available under a public beta, and the API is subject to change. It is advised to [pin](https://clerk.com/docs/pinning) the SDK version and the clerk-js version to avoid breaking changes.
  */

packages/types/src/clerk.ts

@@ -1577,9 +1577,9 @@ export type UserButtonProps = UserButtonProfileMode & {
   /**
    * If true the `<UserButton />` will only render the popover.
    * Enables developers to implement a custom dialog.
-   * This API is experimental and may change at any moment.
-   * @experimental
+   *
    * @default undefined
+   * @experimental This API is experimental and may change at any moment.
    */
   __experimental_asStandalone?: boolean | ((opened: boolean) => void);
 
@@ -1647,9 +1647,9 @@ export type OrganizationSwitcherProps = CreateOrganizationMode &
     /**
      * If true, `<OrganizationSwitcher />` will only render the popover.
      * Enables developers to implement a custom dialog.
-     * This API is experimental and may change at any moment.
-     * @experimental
+     *
      * @default undefined
+     * @experimental This API is experimental and may change at any moment.
      */
     __experimental_asStandalone?: boolean | ((opened: boolean) => void);