@docusaurus/core 4.0.0-canary-6863 → 4.0.0-canary-6868

package/lib/client/ClientLifecyclesDispatcher.d.ts

@@ -4,7 +4,7 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import type { ReactElement, ReactNode } from 'react';
+import { type ReactElement, type ReactNode } from 'react';
 import type { ClientModule } from '@docusaurus/types';
 import type { Location } from 'history';
 export declare function dispatchLifecycleAction<K extends keyof ClientModule>(lifecycleAction: K, ...args: Parameters<NonNullable<ClientModule[K]>>): () => void;

package/lib/client/ClientLifecyclesDispatcher.js

@@ -4,8 +4,8 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
+import { useLayoutEffect } from 'react';
 import clientModules from '@generated/client-modules';
-import useIsomorphicLayoutEffect from './exports/useIsomorphicLayoutEffect';
 export function dispatchLifecycleAction(lifecycleAction, ...args) {
     const callbacks = clientModules.map((clientModule) => {
         const lifecycleFunction = (clientModule.default?.[lifecycleAction] ??
@@ -36,7 +36,7 @@ function scrollAfterNavigation({ location, previousLocation, }) {
     }
 }
 function ClientLifecyclesDispatcher({ children, location, previousLocation, }) {
-    useIsomorphicLayoutEffect(() => {
+    useLayoutEffect(() => {
         if (previousLocation !== location) {
             scrollAfterNavigation({ location, previousLocation });
             dispatchLifecycleAction('onRouteDidUpdate', { previousLocation, location });

package/lib/client/exports/useIsomorphicLayoutEffect.d.ts

@@ -6,16 +6,15 @@
  */
 import { useLayoutEffect } from 'react';
 /**
- * This hook is like `useLayoutEffect`, but without the SSR warning.
- * It seems hacky but it's used in many React libs (Redux, Formik...).
- * Also mentioned here: https://github.com/facebook/react/issues/16956
+ * This hook is now just React's `useLayoutEffect`.
  *
- * It is useful when you need to update a ref as soon as possible after a React
- * render (before `useEffect`).
+ * It used to fall back to `useEffect` on the server to avoid the
+ * `useLayoutEffect` SSR warning, which React 19 removed.
+ * See https://github.com/facebook/react/pull/26395
  *
- * TODO should become unnecessary in React v19?
- * https://github.com/facebook/react/pull/26395
- * This was added in core with Docusaurus v3 but kept undocumented on purpose
+ * It is unnecessary since React 19: use `useLayoutEffect` directly.
+ * We only keep it for retro-compatibility, because third-party code might
+ * import `@docusaurus/useIsomorphicLayoutEffect`.
  */
 declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
 export default useIsomorphicLayoutEffect;

package/lib/client/exports/useIsomorphicLayoutEffect.js

@@ -4,21 +4,17 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-import { useEffect, useLayoutEffect } from 'react';
-import ExecutionEnvironment from './ExecutionEnvironment';
+import { useLayoutEffect } from 'react';
 /**
- * This hook is like `useLayoutEffect`, but without the SSR warning.
- * It seems hacky but it's used in many React libs (Redux, Formik...).
- * Also mentioned here: https://github.com/facebook/react/issues/16956
+ * This hook is now just React's `useLayoutEffect`.
  *
- * It is useful when you need to update a ref as soon as possible after a React
- * render (before `useEffect`).
+ * It used to fall back to `useEffect` on the server to avoid the
+ * `useLayoutEffect` SSR warning, which React 19 removed.
+ * See https://github.com/facebook/react/pull/26395
  *
- * TODO should become unnecessary in React v19?
- * https://github.com/facebook/react/pull/26395
- * This was added in core with Docusaurus v3 but kept undocumented on purpose
+ * It is unnecessary since React 19: use `useLayoutEffect` directly.
+ * We only keep it for retro-compatibility, because third-party code might
+ * import `@docusaurus/useIsomorphicLayoutEffect`.
  */
-const useIsomorphicLayoutEffect = ExecutionEnvironment.canUseDOM
-    ? useLayoutEffect
-    : useEffect;
+const useIsomorphicLayoutEffect = useLayoutEffect;
 export default useIsomorphicLayoutEffect;

package/lib/commands/start/watcher.d.ts

@@ -16,6 +16,10 @@ export type FileWatchEvent = {
     name: FileWatchEventName;
     path: string;
 };
+export declare function getPluginPathsToWatch({ siteDir, plugin, }: {
+    siteDir: string;
+    plugin: LoadedPlugin;
+}): string[];
 export declare function setupSiteFileWatchers({ props, cliOptions, }: {
     props: Props;
     cliOptions: StartCLIOptions;

package/lib/commands/start/watcher.js

@@ -7,6 +7,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPollingOptions = createPollingOptions;
+exports.getPluginPathsToWatch = getPluginPathsToWatch;
 exports.setupSiteFileWatchers = setupSiteFileWatchers;
 const tslib_1 = require("tslib");
 const path_1 = tslib_1.__importDefault(require("path"));
@@ -28,7 +29,6 @@ function watchPaths(params, callback) {
     const { pathsToWatch, siteDir, ...options } = params;
     const watcher = (0, glob_1.watch)(pathsToWatch, {
         cwd: siteDir,
-        ignoreInitial: true,
         ...options,
     });
     watcher.on('all', (name, eventPath) => callback({ name, path: eventPath }));

package/lib/commands/swizzle/components.js

@@ -165,8 +165,8 @@ function handleInvalidComponentNameParam({ componentNameParam, themeComponents,
     logger_1.default.error `Component name=${componentNameParam} not found.`;
     const suggestion = (0, common_1.findClosestValue)(componentNameParam, themeComponents.all);
     if (suggestion) {
-        logger_1.default.info `Did you mean name=${suggestion}? ${themeComponents.hasAnySafeAction(suggestion)
-            ? `Note: this component is an unsafe internal component and can only be swizzled with code=${'--danger'} or explicit confirmation.`
+        logger_1.default.info `Did you mean name=${suggestion}? ${!themeComponents.hasAnySafeAction(suggestion)
+            ? `Note: this component is an unsafe internal component and can only be swizzled with ${logger_1.default.code('--danger')} or explicit confirmation.`
             : ''}`;
     }
     else {

package/lib/commands/utils/openBrowser/openBrowser.js

@@ -51,12 +51,9 @@ async function tryOpenWithAppleScript({ url, browser, }) {
             ];
             // Among all the supported browsers, retrieves to stdout the active ones
             const command = `ps cax -o command | grep -E "^(${supportedChromiumBrowsers.join('|')})$"`;
-            const result = await Promise
-                // TODO Docusaurus v4: use Promise.try()
-                // See why here https://github.com/facebook/docusaurus/issues/11204#issuecomment-3073480330
-                .resolve()
-                .then(() => execPromise(command))
-                .catch(() => {
+            // Promise.try() also catches errors thrown synchronously
+            // See https://github.com/facebook/docusaurus/issues/11204#issuecomment-3073480330
+            const result = await Promise.try(() => execPromise(command)).catch(() => {
                 // Ignore all errors
                 // In particular grep errors when macOS user has no Chromium-based browser open
                 // See https://github.com/facebook/docusaurus/issues/11204

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "4.0.0-canary-6863",
+  "version": "4.0.0-canary-6868",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -33,14 +33,14 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "4.0.0-canary-6863",
-    "@docusaurus/bundler": "4.0.0-canary-6863",
-    "@docusaurus/glob": "4.0.0-canary-6863",
-    "@docusaurus/logger": "4.0.0-canary-6863",
-    "@docusaurus/mdx-loader": "4.0.0-canary-6863",
-    "@docusaurus/utils": "4.0.0-canary-6863",
-    "@docusaurus/utils-common": "4.0.0-canary-6863",
-    "@docusaurus/utils-validation": "4.0.0-canary-6863",
+    "@docusaurus/babel": "4.0.0-canary-6868",
+    "@docusaurus/bundler": "4.0.0-canary-6868",
+    "@docusaurus/glob": "4.0.0-canary-6868",
+    "@docusaurus/logger": "4.0.0-canary-6868",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6868",
+    "@docusaurus/utils": "4.0.0-canary-6868",
+    "@docusaurus/utils-common": "4.0.0-canary-6868",
+    "@docusaurus/utils-validation": "4.0.0-canary-6868",
     "boxen": "^9.0.0",
     "cli-table3": "^0.6.5",
     "combine-promises": "^1.2.0",
@@ -74,8 +74,8 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "4.0.0-canary-6863",
-    "@docusaurus/types": "4.0.0-canary-6863",
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6868",
+    "@docusaurus/types": "4.0.0-canary-6868",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/escape-html": "^1.0.4",
     "@types/history": "^4.7.11",
@@ -90,7 +90,7 @@
     "utility-types": "^3.11.0"
   },
   "peerDependencies": {
-    "@docusaurus/faster": "4.0.0-canary-6863",
+    "@docusaurus/faster": "4.0.0-canary-6868",
     "@mdx-js/react": "^3.1.1",
     "react": "^19.3.0",
     "react-dom": "^19.3.0"
@@ -103,5 +103,5 @@
   "engines": {
     "node": ">=24.21"
   },
-  "gitHead": "dcf62792e7f4b7a7dcf4e9558665c93dd4e6da3e"
+  "gitHead": "e6df7e2a6fcc0b1b6899cc272588cf73a62765a9"
 }