@docusaurus/plugin-svgr 3.6.1

package/README.md

@@ -0,0 +1,7 @@
+# `@docusaurus/plugin-svgr`
+
+[SVGR](https://react-svgr.com/) plugin for Docusaurus.
+
+## Usage
+
+See [plugin-svgr documentation](https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-svgr).

package/lib/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { LoadContext, Plugin } from '@docusaurus/types';
+import type { PluginOptions, Options } from './options';
+export type { SVGRConfig, SVGOConfig } from './types';
+export default function pluginSVGR(context: LoadContext, options: PluginOptions): Plugin;
+export { validateOptions } from './options';
+export type { PluginOptions, Options };

package/lib/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateOptions = void 0;
+exports.default = pluginSVGR;
+const svgrLoader_1 = require("./svgrLoader");
+function pluginSVGR(context, options) {
+    return {
+        name: 'docusaurus-plugin-svgr',
+        configureWebpack: (config, isServer) => {
+            return {
+                module: {
+                    rules: [(0, svgrLoader_1.createLoader)({ isServer, svgrConfig: options.svgrConfig })],
+                },
+            };
+        },
+    };
+}
+var options_1 = require("./options");
+Object.defineProperty(exports, "validateOptions", { enumerable: true, get: function () { return options_1.validateOptions; } });

package/lib/options.d.ts

@@ -0,0 +1,10 @@
+import type { OptionValidationContext } from '@docusaurus/types';
+import type { Config as SVGRConfig } from '@svgr/core';
+export type PluginOptions = {
+    svgrConfig: SVGRConfig;
+};
+export type Options = {
+    svgrConfig?: Partial<SVGRConfig>;
+};
+export declare const DEFAULT_OPTIONS: Partial<PluginOptions>;
+export declare function validateOptions({ validate, options, }: OptionValidationContext<Options | undefined, PluginOptions>): PluginOptions;

package/lib/options.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_OPTIONS = void 0;
+exports.validateOptions = validateOptions;
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+const utils_validation_1 = require("@docusaurus/utils-validation");
+exports.DEFAULT_OPTIONS = {
+    svgrConfig: {},
+};
+const pluginOptionsSchema = utils_validation_1.Joi.object({
+    svgrConfig: utils_validation_1.Joi.object()
+        .pattern(utils_validation_1.Joi.string(), utils_validation_1.Joi.any())
+        .optional()
+        .default(exports.DEFAULT_OPTIONS.svgrConfig),
+}).default(exports.DEFAULT_OPTIONS);
+function validateOptions({ validate, options, }) {
+    return validate(pluginOptionsSchema, options);
+}

package/lib/svgrLoader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { SVGRConfig } from './types';
+import type { RuleSetRule } from 'webpack';
+type Params = {
+    isServer: boolean;
+    svgrConfig: SVGRConfig;
+};
+export declare function createLoader(params: Params): RuleSetRule;
+export {};

package/lib/svgrLoader.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLoader = createLoader;
+const utils_1 = require("@docusaurus/utils");
+// TODO Docusaurus v4: change these defaults?
+//  see https://github.com/facebook/docusaurus/issues/8297
+//  see https://github.com/facebook/docusaurus/pull/10205
+//  see https://github.com/facebook/docusaurus/pull/10211
+const DefaultSVGOConfig = {
+    plugins: [
+        {
+            name: 'preset-default',
+            params: {
+                overrides: {
+                    removeTitle: false,
+                    removeViewBox: false,
+                },
+            },
+        },
+    ],
+};
+const DefaultSVGRConfig = {
+    prettier: false,
+    svgo: true,
+    svgoConfig: DefaultSVGOConfig,
+    titleProp: true,
+};
+function createSVGRLoader(params) {
+    const options = {
+        ...DefaultSVGRConfig,
+        ...params.svgrConfig,
+    };
+    return {
+        loader: require.resolve('@svgr/webpack'),
+        options,
+    };
+}
+function createLoader(params) {
+    const utils = (0, utils_1.getFileLoaderUtils)(params.isServer);
+    return {
+        test: /\.svg$/i,
+        oneOf: [
+            {
+                use: [createSVGRLoader(params)],
+                // We don't want to use SVGR loader for non-React source code
+                // ie we don't want to use SVGR for CSS files...
+                issuer: {
+                    and: [/\.(?:tsx?|jsx?|mdx?)$/i],
+                },
+            },
+            {
+                use: [utils.loaders.url({ folder: 'images' })],
+            },
+        ],
+    };
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@docusaurus/plugin-svgr",
+  "version": "3.6.1",
+  "description": "SVGR plugin for Docusaurus.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "tsc --build",
+    "watch": "tsc --build --watch"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/facebook/docusaurus.git",
+    "directory": "packages/docusaurus-plugin-svgr"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@docusaurus/core": "3.6.1",
+    "@docusaurus/types": "3.6.1",
+    "@docusaurus/utils": "3.6.1",
+    "@docusaurus/utils-validation": "3.6.1",
+    "@svgr/core": "8.1.0",
+    "@svgr/webpack": "^8.1.0",
+    "tslib": "^2.6.0",
+    "webpack": "^5.88.1"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0"
+  },
+  "engines": {
+    "node": ">=18.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {createLoader} from './svgrLoader';
+import type {LoadContext, Plugin} from '@docusaurus/types';
+import type {PluginOptions, Options} from './options';
+
+export type {SVGRConfig, SVGOConfig} from './types';
+
+export default function pluginSVGR(
+  context: LoadContext,
+  options: PluginOptions,
+): Plugin {
+  return {
+    name: 'docusaurus-plugin-svgr',
+    configureWebpack: (config, isServer) => {
+      return {
+        module: {
+          rules: [createLoader({isServer, svgrConfig: options.svgrConfig})],
+        },
+      };
+    },
+  };
+}
+
+export {validateOptions} from './options';
+
+export type {PluginOptions, Options};

package/src/options.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import {Joi} from '@docusaurus/utils-validation';
+import type {OptionValidationContext} from '@docusaurus/types';
+import type {Config as SVGRConfig} from '@svgr/core';
+
+export type PluginOptions = {
+  svgrConfig: SVGRConfig;
+};
+
+export type Options = {
+  svgrConfig?: Partial<SVGRConfig>;
+};
+
+export const DEFAULT_OPTIONS: Partial<PluginOptions> = {
+  svgrConfig: {},
+};
+
+const pluginOptionsSchema = Joi.object<PluginOptions>({
+  svgrConfig: Joi.object()
+    .pattern(Joi.string(), Joi.any())
+    .optional()
+    .default(DEFAULT_OPTIONS.svgrConfig),
+}).default(DEFAULT_OPTIONS);
+
+export function validateOptions({
+  validate,
+  options,
+}: OptionValidationContext<Options | undefined, PluginOptions>): PluginOptions {
+  return validate(pluginOptionsSchema, options);
+}

package/src/svgrLoader.ts

@@ -0,0 +1,69 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import {getFileLoaderUtils} from '@docusaurus/utils';
+
+import type {SVGRConfig, SVGOConfig} from './types';
+import type {RuleSetRule} from 'webpack';
+
+// TODO Docusaurus v4: change these defaults?
+//  see https://github.com/facebook/docusaurus/issues/8297
+//  see https://github.com/facebook/docusaurus/pull/10205
+//  see https://github.com/facebook/docusaurus/pull/10211
+const DefaultSVGOConfig: SVGOConfig = {
+  plugins: [
+    {
+      name: 'preset-default',
+      params: {
+        overrides: {
+          removeTitle: false,
+          removeViewBox: false,
+        },
+      },
+    },
+  ],
+};
+
+const DefaultSVGRConfig: SVGRConfig = {
+  prettier: false,
+  svgo: true,
+  svgoConfig: DefaultSVGOConfig,
+  titleProp: true,
+};
+
+type Params = {isServer: boolean; svgrConfig: SVGRConfig};
+
+function createSVGRLoader(params: Params): RuleSetRule {
+  const options: SVGRConfig = {
+    ...DefaultSVGRConfig,
+    ...params.svgrConfig,
+  };
+  return {
+    loader: require.resolve('@svgr/webpack'),
+    options,
+  };
+}
+
+export function createLoader(params: Params): RuleSetRule {
+  const utils = getFileLoaderUtils(params.isServer);
+  return {
+    test: /\.svg$/i,
+    oneOf: [
+      {
+        use: [createSVGRLoader(params)],
+        // We don't want to use SVGR loader for non-React source code
+        // ie we don't want to use SVGR for CSS files...
+        issuer: {
+          and: [/\.(?:tsx?|jsx?|mdx?)$/i],
+        },
+      },
+      {
+        use: [utils.loaders.url({folder: 'images'})],
+      },
+    ],
+  };
+}

package/src/types.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+/// <reference types="@docusaurus/module-type-aliases" />
+
+export type {Config as SVGRConfig} from '@svgr/core';
+
+export type SVGOConfig = NonNullable<SVGRConfig['svgoConfig']>;