Merge branch 'main' into jw/electron-package-scaffold

Author: wobsoriano

.changeset/calm-aliens-care.md

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

.changeset/expo-bump-clerk-ios-1-2-3.md

@@ -0,0 +1,5 @@
+---
+'@clerk/expo': patch
+---
+
+Bump the bundled `clerk-ios` SDK from `1.2.2` to `1.2.3`. See the Clerk iOS release: https://github.com/clerk/clerk-ios/releases/tag/1.2.3.

.changeset/headless-load-issatellite-type.md

@@ -0,0 +1,7 @@
+---
+'@clerk/shared': patch
+'@clerk/astro': patch
+'@clerk/vue': patch
+---
+
+Align the `HeadlessBrowserClerk.load()` parameter type with the runtime behavior by accepting the full `ClerkOptions`, including `isSatellite`. The clerk-js implementation has always accepted and used `isSatellite` from `load()` options — it's the only way to configure a satellite app when using `@clerk/clerk-js` directly — but the type previously excluded it, producing a contradictory generated API reference and type errors for direct consumers.

.changeset/olive-falcons-applaud.md

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

.changeset/silver-poems-repeat.md

@@ -0,0 +1,5 @@
+---
+'@clerk/shared': patch
+---
+
+Clarify the `isSatellite` JSDoc to note it must be set in `load()`, unlike `domain`, which is set in the `Clerk` constructor. This corrects the generated API reference for direct `@clerk/clerk-js` and `<script>` consumers, where `load()` is the only way to configure a satellite app.

.github/workflows/api-changes.yml

@@ -107,7 +107,7 @@ jobs:
 
       - name: Generate API snapshot
         run: |
-          npx --yes "@clerk/break-check@0.4.0" snapshot \
+          npx --yes "@clerk/break-check@0.5.0" snapshot \
             --output "$GITHUB_WORKSPACE/.api-snapshots-baseline"
 
       - name: Upload baseline artifact
@@ -172,9 +172,9 @@ jobs:
         run: echo "BREAK_CHECK_FILTERS=$BREAK_CHECK_FILTERS" >> "$GITHUB_ENV"
 
       - name: Break Check
-        uses: clerk/break-check@703a7d9a6829b3ce164af20e5dbac37b7acb1725 # v0.4.0
+        uses: clerk/break-check@28f2635be18aa1127189f088a564645efb3aad90 # v0.5.0
         with:
-          break-check-version: '0.4.0'
+          break-check-version: '0.5.0'
           # The PR head is already checked out, so build it in place rather than
           # in a second head worktree.
           head-ref: ''

break-check.config.json

@@ -20,6 +20,7 @@
     "packages/ui",
     "packages/vue"
   ],
+  "ignoreSubpaths": ["@clerk/astro#./env"],
   "snapshotDir": ".api-snapshots",
   "mainBranch": "main",
   "checkVersionBump": true,

packages/astro/src/types.ts

@@ -72,7 +72,7 @@ export type InternalRuntimeOptions = {
 
 // Copied from `@clerk/react`
 export interface HeadlessBrowserClerk extends Clerk {
-  load: (opts?: Without<ClerkOptions, 'isSatellite'>) => Promise<void>;
+  load: (opts?: ClerkOptions) => Promise<void>;
   updateClient: (client: ClientResource) => void;
 }
 

packages/expo/app.plugin.js

@@ -20,7 +20,7 @@ const path = require('path');
 const fs = require('fs');
 
 const CLERK_IOS_REPO = 'https://github.com/clerk/clerk-ios.git';
-const CLERK_IOS_VERSION = '1.2.2';
+const CLERK_IOS_VERSION = '1.2.3';
 
 const CLERK_MIN_IOS_VERSION = '17.0';
 

packages/headless/src/primitives/tabs/tabs-panel.tsx

@@ -1,12 +1,22 @@
 'use client';
 
 import { useMergeRefs } from '@floating-ui/react';
-import React, { useRef } from 'react';
+import React, { useRef, version } from 'react';
 
 import { useTransition } from '../../hooks/use-transition';
 import { type ComponentProps, mergeProps, renderElement } from '../../utils/render-element';
 import { useTabsContext } from './tabs-context';
 
+const major = parseInt(version, 10);
+const isModernReact = major >= 19 || major === 0;
+
+export function inertProps(active: boolean): Record<string, unknown> {
+  if (!active) {
+    return {};
+  }
+  return { inert: isModernReact ? true : '' };
+}
+
 export interface TabsPanelProps extends ComponentProps<'div'> {
   value: string;
   /** When true, removes `hidden` so the panel stays in layout flow. */
@@ -51,11 +61,7 @@ export const TabsPanel = React.forwardRef<HTMLDivElement, TabsPanelProps>(functi
     role: 'tabpanel' as const,
     'aria-labelledby': tabId,
     tabIndex: 0,
-    // `inert` must be a truthy string, not a boolean or empty string, to stay
-    // correct across React 18 and 19: React 18 drops a boolean `true` and React
-    // 19 treats `''` as falsy. `'true'` renders the (presence-based) attribute in
-    // both. Matches the existing pattern in packages/ui PricingTableMatrix.
-    inert: !isSelected ? 'true' : undefined,
+    ...inertProps(!isSelected),
     hidden: !isSelected && !shouldForceMount ? true : undefined,
     ref: combinedRef,
     ...(shouldForceMount