@mui/docs 5.15.9 → 5.15.12

package/node/Link/Link.js

@@ -0,0 +1,113 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.Link = void 0;
+var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends"));
+var _objectWithoutPropertiesLoose2 = _interopRequireDefault(require("@babel/runtime/helpers/objectWithoutPropertiesLoose"));
+var React = _interopRequireWildcard(require("react"));
+var _clsx = _interopRequireDefault(require("clsx"));
+var _router = require("next/router");
+var _link = _interopRequireDefault(require("next/link"));
+var _Link = _interopRequireDefault(require("@mui/material/Link"));
+var _styles = require("@mui/material/styles");
+var _i18n = require("../i18n");
+var _DocsProvider = require("../DocsProvider");
+var _jsxRuntime = require("react/jsx-runtime");
+const _excluded = ["to", "linkAs", "replace", "scroll", "shallow", "prefetch", "legacyBehavior", "locale"],
+  _excluded2 = ["activeClassName", "as", "className", "href", "legacyBehavior", "linkAs", "locale", "noLinkStyle", "prefetch", "replace", "role", "scroll", "shallow"];
+/**
+ * File to keep in sync with:
+ *
+ * - /docs/src/modules/components/Link.tsx
+ * - /examples/material-ui-nextjs-pages-router/src/Link.js
+ * - /examples/material-ui-nextjs-pages-router-ts/src/Link.tsx
+ */
+// Add support for the sx prop for consistency with the other branches.
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const Anchor = (0, _styles.styled)('a')({});
+const NextLinkComposed = /*#__PURE__*/React.forwardRef(function NextLinkComposed(props, ref) {
+  const {
+      to,
+      linkAs,
+      replace,
+      scroll,
+      shallow,
+      prefetch,
+      legacyBehavior = true,
+      locale
+    } = props,
+    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_link.default, {
+    href: to,
+    prefetch: prefetch,
+    as: linkAs,
+    replace: replace,
+    scroll: scroll,
+    shallow: shallow,
+    passHref: true,
+    locale: locale,
+    legacyBehavior: legacyBehavior,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(Anchor, (0, _extends2.default)({
+      "data-no-markdown-link": "true",
+      ref: ref
+    }, other))
+  });
+});
+// A styled version of the Next.js Pages Router Link component:
+// https://nextjs.org/docs/pages/api-reference/components/link
+const Link = exports.Link = /*#__PURE__*/React.forwardRef(function Link(props, ref) {
+  const {
+      activeClassName = 'active',
+      as,
+      className: classNameProps,
+      href,
+      legacyBehavior,
+      linkAs: linkAsProp,
+      locale,
+      noLinkStyle,
+      prefetch,
+      replace,
+      // Link don't have roles.
+      scroll,
+      shallow
+    } = props,
+    other = (0, _objectWithoutPropertiesLoose2.default)(props, _excluded2);
+  const router = (0, _router.useRouter)();
+  const pathname = typeof href === 'string' ? href : href == null ? void 0 : href.pathname;
+  const routerPathname = router.pathname.replace('/[docsTab]', '');
+  const shouldBeActive = routerPathname === pathname;
+  const className = (0, _clsx.default)(classNameProps, shouldBeActive && activeClassName);
+  const userLanguage = (0, _i18n.useUserLanguage)();
+  const {
+    LANGUAGES_IGNORE_PAGES
+  } = (0, _DocsProvider.useDocsConfig)();
+  let linkAs = linkAsProp || as || href;
+  if (userLanguage !== 'en' && pathname && pathname.indexOf('/') === 0 && !LANGUAGES_IGNORE_PAGES(pathname) && !pathname.startsWith(`/${userLanguage}/`)) {
+    linkAs = `/${userLanguage}${linkAs}`;
+  }
+  const nextjsProps = {
+    to: href,
+    linkAs,
+    replace,
+    scroll,
+    shallow,
+    legacyBehavior,
+    prefetch,
+    locale
+  };
+  if (noLinkStyle) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(NextLinkComposed, (0, _extends2.default)({
+      className: className,
+      ref: ref
+    }, nextjsProps, other));
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_Link.default, (0, _extends2.default)({
+    component: NextLinkComposed,
+    className: className,
+    ref: ref
+  }, nextjsProps, other));
+});

package/node/Link/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _Link = require("./Link");
+Object.keys(_Link).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _Link[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _Link[key];
+    }
+  });
+});

package/node/i18n/i18n.js

@@ -0,0 +1,112 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UserLanguageProvider = UserLanguageProvider;
+exports.mapTranslations = mapTranslations;
+exports.useSetUserLanguage = useSetUserLanguage;
+exports.useTranslate = useTranslate;
+exports.useUserLanguage = useUserLanguage;
+var React = _interopRequireWildcard(require("react"));
+var _propTypes = _interopRequireDefault(require("prop-types"));
+var _utils = require("@mui/utils");
+var _translations = _interopRequireDefault(require("../translations"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+const TranslationsContext = /*#__PURE__*/React.createContext(_translations.default);
+function TranslationsProvider({
+  translations = {},
+  children
+}) {
+  const currentTranslations = React.useContext(TranslationsContext);
+  const mergedTranslations = React.useMemo(() => (0, _utils.deepmerge)(currentTranslations, translations), [currentTranslations, translations]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(TranslationsContext.Provider, {
+    value: mergedTranslations,
+    children: children
+  });
+}
+function getPath(obj, path) {
+  if (!path || typeof path !== 'string') {
+    return null;
+  }
+  return path.split('.').reduce((acc, item) => acc && acc[item] ? acc[item] : null, obj);
+}
+const UserLanguageContext = /*#__PURE__*/React.createContext({
+  userLanguage: '',
+  setUserLanguage: () => {}
+});
+if (process.env.NODE_ENV !== 'production') {
+  UserLanguageContext.displayName = 'UserLanguage';
+}
+function UserLanguageProvider(props) {
+  const {
+    children,
+    translations,
+    defaultUserLanguage
+  } = props;
+  const [userLanguage, setUserLanguage] = React.useState(defaultUserLanguage);
+  const contextValue = React.useMemo(() => {
+    return {
+      userLanguage,
+      setUserLanguage
+    };
+  }, [userLanguage]);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(TranslationsProvider, {
+    translations: translations,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(UserLanguageContext.Provider, {
+      value: contextValue,
+      children: children
+    })
+  });
+}
+process.env.NODE_ENV !== "production" ? UserLanguageProvider.propTypes = {
+  children: _propTypes.default.node.isRequired,
+  defaultUserLanguage: _propTypes.default.string
+} : void 0;
+function useUserLanguage() {
+  return React.useContext(UserLanguageContext).userLanguage;
+}
+function useSetUserLanguage() {
+  return React.useContext(UserLanguageContext).setUserLanguage;
+}
+const warnedOnce = {};
+function useTranslate() {
+  const userLanguage = useUserLanguage();
+  const translations = React.useContext(TranslationsContext);
+  return React.useMemo(() => function translate(key, options = {}) {
+    const {
+      ignoreWarning = false
+    } = options;
+    const wordings = translations[userLanguage];
+    if (!wordings) {
+      console.error(`Missing language: ${userLanguage}.`);
+      return '…';
+    }
+    const translation = getPath(wordings, key);
+    if (!translation) {
+      const fullKey = `${userLanguage}:${key}`;
+      // No warnings in CI env
+      if (!ignoreWarning && !warnedOnce[fullKey] && typeof window !== 'undefined') {
+        console.error(`Missing translation for ${fullKey}`);
+        warnedOnce[fullKey] = true;
+      }
+      return getPath(translations.en, key);
+    }
+    return translation;
+  }, [userLanguage, translations]);
+}
+function mapTranslations(req) {
+  const result = {};
+  req.keys().forEach(filename => {
+    const match = filename.match(/-([a-z]{2}).json$/);
+    if (match) {
+      result[match[1]] = req(filename);
+    } else {
+      result.en = req(filename);
+    }
+  });
+  return result;
+}

package/node/i18n/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _i18n = require("./i18n");
+Object.keys(_i18n).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _i18n[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _i18n[key];
+    }
+  });
+});

package/node/translations/index.js

@@ -0,0 +1,11 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _translations = _interopRequireDefault(require("./translations.json"));
+var _default = exports.default = {
+  en: _translations.default
+};

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@mui/docs",
-  "version": "5.15.9",
+  "version": "5.15.12",
   "private": false,
   "author": "MUI Team",
   "description": "MUI Docs - Documentation building blocks.",
-  "main": "./node/index.js",
+  "main": "./index.js",
   "keywords": [
     "react",
     "react-component",
@@ -24,15 +24,17 @@
   "homepage": "https://github.com/mui/material-ui/tree/master/packages/mui-docs",
   "dependencies": {
     "@babel/runtime": "^7.23.9",
+    "clsx": "^2.1.0",
     "nprogress": "^0.2.0",
     "prop-types": "^15.8.1",
-    "@mui/utils": "^5.15.9",
-    "@mui/base": "5.0.0-beta.36"
+    "@mui/base": "5.0.0-beta.38",
+    "@mui/utils": "^5.15.12"
   },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0",
+    "next": "^13.5.1",
     "react": "^17.0.0 || ^18.0.0",
-    "@mui/material": "^5.15.9"
+    "@mui/material": "^5.15.12"
   },
   "peerDependenciesMeta": {
     "@types/react": {
@@ -46,6 +48,5 @@
   "engines": {
     "node": ">=12.0.0"
   },
-  "module": "./index.js",
-  "types": "./index.d.ts"
+  "module": "./index.js"
 }

package/translations/index.d.ts

@@ -0,0 +1,3 @@
+import type { Translations } from '../i18n';
+declare const _default: Record<string, Translations>;
+export default _default;

package/translations/index.js

@@ -0,0 +1,4 @@
+import en from './translations.json';
+export default {
+  en
+};

package/translations/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "main": "../node/translations/index.js",
+  "types": "./index.d.ts"
+}