@docusaurus/core 4.0.0-canary-6966 → 4.0.0-canary-6968

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

@@ -12,9 +12,10 @@ import { useLayoutEffect } from 'react';
  * `useLayoutEffect` SSR warning, which React 19 removed.
  * See https://github.com/facebook/react/pull/26395
  *
- * It is unnecessary since React 19: use `useLayoutEffect` directly.
  * We only keep it for retro-compatibility, because third-party code might
  * import `@docusaurus/useIsomorphicLayoutEffect`.
+ *
+ * @deprecated Use React's `useLayoutEffect` instead.
  */
 declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
 export default useIsomorphicLayoutEffect;

package/lib/client/exports/useIsomorphicLayoutEffect.js

@@ -5,6 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 import { useLayoutEffect } from 'react';
+// TODO Docusaurus v5: remove this deprecated hook
 /**
  * This hook is now just React's `useLayoutEffect`.
  *
@@ -12,9 +13,10 @@ import { useLayoutEffect } from 'react';
  * `useLayoutEffect` SSR warning, which React 19 removed.
  * See https://github.com/facebook/react/pull/26395
  *
- * It is unnecessary since React 19: use `useLayoutEffect` directly.
  * We only keep it for retro-compatibility, because third-party code might
  * import `@docusaurus/useIsomorphicLayoutEffect`.
+ *
+ * @deprecated Use React's `useLayoutEffect` instead.
  */
 const useIsomorphicLayoutEffect = useLayoutEffect;
 export default useIsomorphicLayoutEffect;

package/lib/commands/cli.js

@@ -112,9 +112,9 @@ async function createCLIProgram({ cli, cliArgs, siteDir, config, }) {
         .option('--no-open', 'do not open page in the browser (default: false)')
         .option('--poll [interval]', 'use polling rather than watching for reload (default: false). Can specify a poll interval in milliseconds', normalizePollValue)
         .option('--no-minify', 'build website without minimizing JS bundles (default: false)')
-        .option('--https', 'serve the dev site over HTTPS using a self-signed cert (default: false). Preferred over the HTTPS=true env var. Implied when both --ssl-cert and --ssl-key are provided.')
-        .option('--ssl-cert <path>', 'path to a TLS certificate file (implies HTTPS). Preferred over the SSL_CRT_FILE env var; CLI takes precedence if both are set.')
-        .option('--ssl-key <path>', 'path to a TLS private key file (implies HTTPS). Preferred over the SSL_KEY_FILE env var; CLI takes precedence if both are set.')
+        .option('--https', 'serve the dev site over HTTPS using a self-signed cert (default: false). Implied when both --ssl-cert and --ssl-key are provided. Takes precedence over the DOCUSAURUS_HTTPS env var.')
+        .option('--ssl-cert <path>', 'path to a TLS certificate file (implies HTTPS). Takes precedence over the DOCUSAURUS_SSL_CRT_FILE env var.')
+        .option('--ssl-key <path>', 'path to a TLS private key file (implies HTTPS). Takes precedence over the DOCUSAURUS_SSL_KEY_FILE env var.')
         .action(start_1.start);
     cli
         .command('serve [siteDir]')

package/lib/webpack/utils/getHttpsConfig.js

@@ -41,9 +41,6 @@ function getExplicitHttps(options) {
     return (options.https ??
         (typeof process.env.DOCUSAURUS_HTTPS !== 'undefined'
             ? process.env.DOCUSAURUS_HTTPS == 'true'
-            : undefined) ??
-        (typeof process.env.HTTPS !== 'undefined'
-            ? process.env.HTTPS == 'true'
             : undefined));
 }
 async function readCryptoFile(filepath, source) {
@@ -68,9 +65,6 @@ function getCert(options, cwd) {
     if (process.env.DOCUSAURUS_SSL_CRT_FILE) {
         return readCryptoFile(node_path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_CRT_FILE), 'env DOCUSAURUS_SSL_CRT_FILE');
     }
-    if (process.env.SSL_CRT_FILE) {
-        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.SSL_CRT_FILE), 'env SSL_CRT_FILE');
-    }
     return null;
 }
 function getKeyFile(options, cwd) {
@@ -80,9 +74,6 @@ function getKeyFile(options, cwd) {
     if (process.env.DOCUSAURUS_SSL_KEY_FILE) {
         return readCryptoFile(node_path_1.default.resolve(cwd, process.env.DOCUSAURUS_SSL_KEY_FILE), 'env DOCUSAURUS_SSL_KEY_FILE');
     }
-    if (process.env.SSL_KEY_FILE) {
-        return readCryptoFile(node_path_1.default.resolve(cwd, process.env.SSL_KEY_FILE), 'env SSL_KEY_FILE');
-    }
     return null;
 }
 function ensureCertKeyBothProvided(cert, key) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@docusaurus/core",
   "description": "Easy to Maintain Open Source Documentation Websites",
-  "version": "4.0.0-canary-6966",
+  "version": "4.0.0-canary-6968",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -27,15 +27,15 @@
     "url": "https://github.com/facebook/docusaurus/issues"
   },
   "dependencies": {
-    "@docusaurus/babel": "4.0.0-canary-6966",
-    "@docusaurus/bundler": "4.0.0-canary-6966",
-    "@docusaurus/fs": "4.0.0-canary-6966",
-    "@docusaurus/glob": "4.0.0-canary-6966",
-    "@docusaurus/logger": "4.0.0-canary-6966",
-    "@docusaurus/mdx-loader": "4.0.0-canary-6966",
-    "@docusaurus/utils": "4.0.0-canary-6966",
-    "@docusaurus/utils-common": "4.0.0-canary-6966",
-    "@docusaurus/utils-validation": "4.0.0-canary-6966",
+    "@docusaurus/babel": "4.0.0-canary-6968",
+    "@docusaurus/bundler": "4.0.0-canary-6968",
+    "@docusaurus/fs": "4.0.0-canary-6968",
+    "@docusaurus/glob": "4.0.0-canary-6968",
+    "@docusaurus/logger": "4.0.0-canary-6968",
+    "@docusaurus/mdx-loader": "4.0.0-canary-6968",
+    "@docusaurus/utils": "4.0.0-canary-6968",
+    "@docusaurus/utils-common": "4.0.0-canary-6968",
+    "@docusaurus/utils-validation": "4.0.0-canary-6968",
     "@rspack/core": "^2.2.3",
     "@rspack/dev-server": "^2.2.1",
     "boxen": "^9.0.0",
@@ -68,8 +68,8 @@
     "webpack-merge": "^6.0.1"
   },
   "devDependencies": {
-    "@docusaurus/module-type-aliases": "4.0.0-canary-6966",
-    "@docusaurus/types": "4.0.0-canary-6966",
+    "@docusaurus/module-type-aliases": "4.0.0-canary-6968",
+    "@docusaurus/types": "4.0.0-canary-6968",
     "@total-typescript/shoehorn": "^0.1.2",
     "@types/escape-html": "^1.0.4",
     "@types/history": "^4.7.11",