dumi 2.3.0-beta.8 → 2.3.0

package/dist/client/theme-api/useRenderer.js

@@ -2,22 +2,41 @@ function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" =
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) keys.push(key); return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
 function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
-import { useEffect, useRef } from 'react';
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(arr, i) { var _i = null == arr ? null : "undefined" != typeof Symbol && arr[Symbol.iterator] || arr["@@iterator"]; if (null != _i) { var _s, _e, _x, _r, _arr = [], _n = !0, _d = !1; try { if (_x = (_i = _i.call(arr)).next, 0 === i) { if (Object(_i) !== _i) return; _n = !1; } else for (; !(_n = (_s = _x.call(_i)).done) && (_arr.push(_s.value), _arr.length !== i); _n = !0); } catch (err) { _d = !0, _e = err; } finally { try { if (!_n && null != _i.return && (_r = _i.return(), Object(_r) !== _r)) return; } finally { if (_d) throw _e; } } return _arr; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useEffect, useRef, useState } from 'react';
+import { getAgnosticComponentModule } from "./utils";
+
 // maintain all the mounted instance
 var map = new Map();
 export var useRenderer = function useRenderer(_ref) {
   var id = _ref.id,
     component = _ref.component,
-    renderOpts = _ref.renderOpts;
+    renderOpts = _ref.renderOpts,
+    onResolved = _ref.onResolved;
+  var _useState = useState(component ? getAgnosticComponentModule(component) : null),
+    _useState2 = _slicedToArray(_useState, 2),
+    deferedComponent = _useState2[0],
+    setComponent = _useState2[1];
   var canvasRef = useRef(null);
   var teardownRef = useRef(function () {});
-  var prevComponent = useRef(component);
-
-  // forcibly destroyed
-  if (prevComponent.current !== component) {
-    var teardown = map.get(id);
-    teardown === null || teardown === void 0 ? void 0 : teardown();
-    prevComponent.current = component;
+  var prevCanvas = useRef(canvasRef.current);
+  var resolving = useRef(false);
+  if (prevCanvas.current !== canvasRef.current) {
+    if (prevCanvas.current === null) {
+      // When first render, component maintained by the parent component userRenderer may be removed.
+      // The hosted element should be added back
+      var handler = map.get(id);
+      if (handler !== null && handler !== void 0 && handler.teardown && handler !== null && handler !== void 0 && handler.hostElement && canvasRef.current) {
+        canvasRef.current.appendChild(handler.hostElement);
+        teardownRef.current = handler.teardown;
+      }
+    }
+    prevCanvas.current = canvasRef.current;
   }
   var renderer = renderOpts === null || renderOpts === void 0 ? void 0 : renderOpts.renderer;
   useEffect(function () {
@@ -26,63 +45,77 @@ export var useRenderer = function useRenderer(_ref) {
     }
     function _resolveRender() {
       _resolveRender = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        var _module$default;
-        var module, teardown;
+        var legacyHandler, legacyTeardown, comp, hostElement, _legacyHandler$hostEl, teardown;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              if (!(!canvasRef.current || !renderer || !component)) {
+              if (!(!canvasRef.current || !renderer || !deferedComponent)) {
                 _context.next = 2;
                 break;
               }
               return _context.abrupt("return");
             case 2:
-              if (!map.get(id)) {
-                _context.next = 4;
+              legacyHandler = map.get(id);
+              if (!resolving.current) {
+                _context.next = 5;
                 break;
               }
               return _context.abrupt("return");
-            case 4:
-              map.set(id, function () {});
-              if (!(component instanceof Promise)) {
-                _context.next = 11;
-                break;
-              }
-              _context.next = 8;
-              return component;
-            case 8:
-              _context.t0 = _context.sent;
-              _context.next = 12;
-              break;
-            case 11:
-              _context.t0 = component;
-            case 12:
-              module = _context.t0;
-              module = (_module$default = module.default) !== null && _module$default !== void 0 ? _module$default : module;
-              _context.next = 16;
-              return renderer(canvasRef.current, module);
-            case 16:
+            case 5:
+              resolving.current = true;
+              legacyTeardown = legacyHandler === null || legacyHandler === void 0 ? void 0 : legacyHandler.teardown;
+              _context.next = 9;
+              return deferedComponent;
+            case 9:
+              comp = _context.sent;
+              hostElement = document.createElement('div');
+              _context.prev = 11;
+              canvasRef.current.appendChild(hostElement);
+              _context.next = 15;
+              return renderer(hostElement, comp);
+            case 15:
               teardown = _context.sent;
+              legacyTeardown === null || legacyTeardown === void 0 ? void 0 : legacyTeardown();
+              legacyHandler === null || legacyHandler === void 0 ? void 0 : (_legacyHandler$hostEl = legacyHandler.hostElement) === null || _legacyHandler$hostEl === void 0 ? void 0 : _legacyHandler$hostEl.remove();
               // remove instance when react component is unmounted
               teardownRef.current = function () {
                 teardown();
+                hostElement.remove();
                 map.delete(id);
               };
-              map.set(id, teardownRef.current);
-            case 19:
+              map.set(id, {
+                teardown: teardownRef.current,
+                hostElement: hostElement
+              });
+              _context.next = 26;
+              break;
+            case 22:
+              _context.prev = 22;
+              _context.t0 = _context["catch"](11);
+              hostElement.remove();
+              throw _context.t0;
+            case 26:
+              _context.prev = 26;
+              resolving.current = false;
+              onResolved === null || onResolved === void 0 ? void 0 : onResolved();
+              return _context.finish(26);
+            case 30:
             case "end":
               return _context.stop();
           }
-        }, _callee);
+        }, _callee, null, [[11, 22, 26, 30]]);
       }));
       return _resolveRender.apply(this, arguments);
     }
     resolveRender();
-  }, [canvasRef.current, component, renderer]);
+  }, [canvasRef.current, deferedComponent, renderer]);
   useEffect(function () {
     return function () {
       return teardownRef.current();
     };
   }, []);
-  return canvasRef;
+  return {
+    canvasRef: canvasRef,
+    setComponent: setComponent
+  };
 };

package/dist/client/theme-api/utils.d.ts

@@ -1,6 +1,6 @@
 import { PluginManager } from 'dumi';
-import { useEffect } from 'react';
-import type { ILocale, INav, INavItem, IRouteMeta, IRoutesById, IUserNavValue } from './types';
+import { useLayoutEffect } from 'react';
+import type { AgnosticComponentModule, IDemoData, ILocale, INav, INavItem, IRouteMeta, IRoutesById, IUserNavValue } from './types';
 /**
  * private instance, do not use it in your code
  */
@@ -13,7 +13,7 @@ export declare const useLocaleDocRoutes: () => IRoutesById;
  * @returns code string
  */
 export declare const genReactRenderCode: (version: string) => string;
-export declare const useIsomorphicLayoutEffect: typeof useEffect;
+export declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
 /**
  * common comparer for sidebar/nav items
  */
@@ -28,3 +28,4 @@ export declare const useRouteDataComparer: <T extends {
  */
 export declare const pickRouteSortMeta: (original: Partial<Pick<INavItem, 'order' | 'title'>>, field: 'nav' | 'nav.second' | 'group', fm: IRouteMeta['frontmatter']) => Partial<Pick<INavItem, "title" | "order">>;
 export declare function getLocaleNav(nav: IUserNavValue | INav, locale: ILocale): import("./types").IUserNavItems;
+export declare function getAgnosticComponentModule(component: IDemoData['component']): Promise<AgnosticComponentModule>;

package/dist/client/theme-api/utils.js

@@ -1,3 +1,6 @@
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) keys.push(key); return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -96,4 +99,37 @@ export var pickRouteSortMeta = function pickRouteSortMeta(original, field, fm) {
 };
 export function getLocaleNav(nav, locale) {
   return Array.isArray(nav) ? nav : nav[locale.id];
+}
+export function getAgnosticComponentModule(_x2) {
+  return _getAgnosticComponentModule.apply(this, arguments);
+}
+function _getAgnosticComponentModule() {
+  _getAgnosticComponentModule = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(component) {
+    var _mod$default;
+    var mod;
+    return _regeneratorRuntime().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          if (!(component instanceof Promise)) {
+            _context.next = 6;
+            break;
+          }
+          _context.next = 3;
+          return component;
+        case 3:
+          _context.t0 = _context.sent;
+          _context.next = 7;
+          break;
+        case 6:
+          _context.t0 = component;
+        case 7:
+          mod = _context.t0;
+          return _context.abrupt("return", (_mod$default = mod.default) !== null && _mod$default !== void 0 ? _mod$default : mod);
+        case 9:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return _getAgnosticComponentModule.apply(this, arguments);
 }

package/dist/features/compile/index.js

@@ -86,6 +86,9 @@ var compile_default = (api) => {
   api.chainWebpack(async (memo) => {
     const babelInUmi = memo.module.rule("src").use("babel-loader").entries();
     const loaderPath = require.resolve("../../loaders/markdown");
+    memo.resolve.merge({
+      conditionNames: ["require", "node", "import"]
+    });
     const loaderBaseOpts = {
       techStacks,
       cwd: api.cwd,

package/dist/features/locales.js

@@ -151,6 +151,10 @@ const LocalesContainer: FC<{ children: ReactNode }> = (props) => {
         api.config.themeConfig.editLink
       )};
 
+    localeMessages['$internal.api.sourceLink'] = ${JSON.stringify(
+        api.config.themeConfig.sourceLink
+      )};
+
     return createIntl({ locale, messages: localeMessages }, cache);
   }, []);
   const [intl, setIntl] = useState(() => getIntl());

package/dist/features/theme/index.js

@@ -161,7 +161,7 @@ var theme_default = (api) => {
     return memo;
   });
   api.modifyConfig((memo) => {
-    var _a, _b;
+    var _a, _b, _c;
     if (localThemeData) {
       themeMapKeys.forEach((key) => {
         Object.values(localThemeData[key] || {}).forEach((item) => {
@@ -180,7 +180,9 @@ var theme_default = (api) => {
       import_path.default.resolve(__dirname, "../../client/theme-api")
     );
     const repoUrl = ((_a = api.pkg.repository) == null ? void 0 : _a.url) || api.pkg.repository;
-    if (((_b = memo.themeConfig) == null ? void 0 : _b.editLink) !== false && typeof repoUrl === "string") {
+    const autoEditLink = (((_b = memo.themeConfig) == null ? void 0 : _b.editLink) ?? true) === true;
+    const autoSourceLink = (((_c = memo.themeConfig) == null ? void 0 : _c.sourceLink) ?? true) === true;
+    if ((autoEditLink || autoSourceLink) && typeof repoUrl === "string") {
       const hostedGitIns = import_hosted_git_info.default.fromUrl(repoUrl);
       let branch = "";
       try {
@@ -192,10 +194,24 @@ var theme_default = (api) => {
       }
       if (hostedGitIns) {
         memo.themeConfig ?? (memo.themeConfig = {});
-        memo.themeConfig.editLink = `${hostedGitIns.edit(
-          `${api.pkg.repository.directory || ""}/{filename}`,
-          { committish: branch }
-        )}`;
+        const directory = api.pkg.repository.directory || "";
+        if (autoSourceLink) {
+          let anchorPrefix = "L";
+          if (hostedGitIns.type.includes("bitbucket")) {
+            anchorPrefix = "lines-";
+          }
+          const sourceLinkTemplate = hostedGitIns.browse(
+            `${directory}/{fileName}#${anchorPrefix}{line}`,
+            { committish: branch }
+          );
+          memo.themeConfig.sourceLink = sourceLinkTemplate;
+        }
+        if (autoEditLink) {
+          memo.themeConfig.editLink = `${hostedGitIns.edit(
+            `${directory}/{filename}`,
+            { committish: branch }
+          )}`;
+        }
       }
     }
     return memo;

package/dist/loaders/markdown/index.js

@@ -35,13 +35,16 @@ module.exports = __toCommonJS(markdown_exports);
 var import_tabs = require("../../features/tabs");
 var import_utils = require("../../utils");
 var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
 var import_plugin_utils = require("umi/plugin-utils");
 var import_transformer = __toESM(require("./transformer"));
 var import_rehypeText = require("./transformer/rehypeText");
 function getDemoSourceFiles(demos = []) {
   return demos.reduce((ret, demo) => {
     if ("resolveMap" in demo) {
-      ret.push(...Object.values(demo.resolveMap));
+      ret.push(
+        ...Object.values(demo.resolveMap).filter((p) => import_path.default.isAbsolute(p))
+      );
     }
     return ret;
   }, []);
@@ -114,11 +117,11 @@ export const demos = {
           return "undefined";
         const entryFileName = Object.keys(this.asset.dependencies)[0];
         const context = Object.entries(this.resolveMap).reduce(
-          (acc, [key, path]) => ({
+          (acc, [key, path2]) => ({
             ...acc,
             // omit entry file
             ...key !== entryFileName ? {
-              [key]: `{{{require('${path}')}}}`
+              [key]: `{{{require('${path2}')}}}`
             } : {}
           }),
           {}
@@ -145,6 +148,12 @@ export const demos = {
             renderOpts.rendererPath
           )}')).default,`);
         }
+        if (renderOpts.preflightPath) {
+          propertyArray.push(`
+            preflight: (await import('${(0, import_plugin_utils.winPath)(
+            renderOpts.preflightPath
+          )}')).default,`);
+        }
         if (propertyArray.length === 0)
           return "undefined";
         return `{

package/dist/loaders/markdown/transformer/index.d.ts

@@ -1,6 +1,7 @@
 import type { IParsedBlockAsset } from "../../../assetParsers/block";
 import type { ILocalesConfig, IRouteMeta } from "../../../client/theme-api/types";
 import type { IApi, IDumiConfig, IDumiTechStack } from "../../../types";
+import { type ResolveOptions } from 'enhanced-resolve';
 import type { IRoute } from 'umi';
 import type { Data } from 'vfile';
 declare module 'hast' {
@@ -25,6 +26,7 @@ declare module 'vfile' {
             renderOpts: {
                 type?: string;
                 rendererPath?: string;
+                preflightPath?: string;
                 compilePath?: string;
             };
         } | {
@@ -33,6 +35,7 @@ declare module 'vfile' {
             renderOpts: {
                 type?: string;
                 rendererPath?: string;
+                preflightPath?: string;
                 compilePath?: string;
             };
         })[];
@@ -45,7 +48,7 @@ declare module 'vfile' {
 export interface IMdTransformerOptions {
     cwd: string;
     fileAbsPath: string;
-    alias: object;
+    alias: ResolveOptions['alias'];
     parentAbsPath?: string;
     techStacks: IDumiTechStack[];
     resolve: IDumiConfig['resolve'];

package/dist/loaders/markdown/transformer/rehypeDemo.d.ts

@@ -5,6 +5,7 @@ import type { IMdTransformerOptions } from '.';
 export declare const DEMO_PROP_VALUE_KEY = "$demo-prop-value-key";
 export declare const DUMI_DEMO_TAG = "DumiDemo";
 export declare const DUMI_DEMO_GRID_TAG = "DumiDemoGrid";
+export declare const SKIP_DEMO_PARSE = "pure";
 type IRehypeDemoOptions = Pick<IMdTransformerOptions, 'techStacks' | 'cwd' | 'fileAbsPath' | 'resolve'> & {
     resolver: typeof sync;
     fileLocaleLessPath: string;

package/dist/loaders/markdown/transformer/rehypeDemo.js

@@ -32,6 +32,7 @@ __export(rehypeDemo_exports, {
   DEMO_PROP_VALUE_KEY: () => DEMO_PROP_VALUE_KEY,
   DUMI_DEMO_GRID_TAG: () => DUMI_DEMO_GRID_TAG,
   DUMI_DEMO_TAG: () => DUMI_DEMO_TAG,
+  SKIP_DEMO_PARSE: () => SKIP_DEMO_PARSE,
   default: () => rehypeDemo
 });
 module.exports = __toCommonJS(rehypeDemo_exports);
@@ -48,6 +49,16 @@ var DEMO_NODE_CONTAINER = "$demo-container";
 var DEMO_PROP_VALUE_KEY = "$demo-prop-value-key";
 var DUMI_DEMO_TAG = "DumiDemo";
 var DUMI_DEMO_GRID_TAG = "DumiDemoGrid";
+var SKIP_DEMO_PARSE = "pure";
+var ALWAYS_DEMO_PARSE = "demo";
+var skipDemoRE = new RegExp(
+  /** 注意前面有空格 ==> */
+  ` ${SKIP_DEMO_PARSE}`
+);
+var alwaysDemoRE = new RegExp(
+  /** 注意前面有空格 ==> */
+  ` ${ALWAYS_DEMO_PARSE}`
+);
 (async () => {
   ({ visit, SKIP, EXIT } = await import("unist-util-visit"));
   ({ toString } = await import("hast-util-to-string"));
@@ -62,14 +73,18 @@ function getCodeLang(node, opts) {
       node.properties.src
     );
     lang = import_path.default.extname(node.properties.src).slice(1);
-  } else if (Array.isArray((_b = node.properties) == null ? void 0 : _b.className) && (opts.resolve.codeBlockMode === "passive" ? (
-    // passive mode
-    / demo/.test(String((_c = node.data) == null ? void 0 : _c.meta))
-  ) : (
+  } else if ([
+    // 插件开发者可配置 [SKIP_DEMO_PARSE_SIGN] 表示不解析 demo (优先级最高)
+    !Object.prototype.hasOwnProperty.call(node.data ?? {}, SKIP_DEMO_PARSE),
+    Array.isArray((_b = node.properties) == null ? void 0 : _b.className),
+    // 根据用户配置判断 pure 或者 demo
+    opts.resolve.codeBlockMode === "passive" ? alwaysDemoRE.test(String((_c = node.data) == null ? void 0 : _c.meta)) : !skipDemoRE.test(String((_d = node.data) == null ? void 0 : _d.meta))
     // active mode (default)
-    !/ pure/.test(String((_d = node.data) == null ? void 0 : _d.meta))
-  ))) {
-    lang = String(node.properties.className[0]).replace("language-", "");
+  ].every(Boolean)) {
+    lang = String(node.properties.className[0]).replace(
+      "language-",
+      ""
+    );
   }
   return lang;
 }
@@ -181,6 +196,7 @@ function rehypeDemo(opts) {
               refAtomIds: vFile.data.frontmatter.atomId ? [vFile.data.frontmatter.atomId] : [],
               fileAbsPath: "",
               lang: codeNode.data.lang,
+              fileLocale: opts.fileLocale,
               entryPointCode: codeType === "external" ? void 0 : codeValue,
               resolver: opts.resolver,
               techStack
@@ -278,7 +294,8 @@ function rehypeDemo(opts) {
                       id: asset.id,
                       component,
                       renderOpts: {
-                        rendererPath: runtimeOpts == null ? void 0 : runtimeOpts.rendererPath
+                        rendererPath: runtimeOpts == null ? void 0 : runtimeOpts.rendererPath,
+                        preflightPath: runtimeOpts == null ? void 0 : runtimeOpts.preflightPath
                       }
                     };
                   }
@@ -316,7 +333,8 @@ function rehypeDemo(opts) {
                     ) : resolveMap,
                     renderOpts: {
                       rendererPath: runtimeOpts == null ? void 0 : runtimeOpts.rendererPath,
-                      compilePath: runtimeOpts == null ? void 0 : runtimeOpts.compilePath
+                      compilePath: runtimeOpts == null ? void 0 : runtimeOpts.compilePath,
+                      preflightPath: runtimeOpts == null ? void 0 : runtimeOpts.preflightPath
                     }
                   };
                 }
@@ -364,5 +382,6 @@ function rehypeDemo(opts) {
 0 && (module.exports = {
   DEMO_PROP_VALUE_KEY,
   DUMI_DEMO_GRID_TAG,
-  DUMI_DEMO_TAG
+  DUMI_DEMO_TAG,
+  SKIP_DEMO_PARSE
 });

package/dist/loaders/markdown/transformer/rehypeEnhancedTag.js

@@ -40,10 +40,17 @@ var toString;
   ({ isElement } = await import("hast-util-is-element"));
   ({ toString } = await import("hast-util-to-string"));
 })();
+var rawMetaRE = /\[(.+)\]/;
+function rehypeCodeMeta(meta) {
+  if (typeof meta !== "string")
+    return {};
+  const [title] = (rawMetaRE.exec(meta.trim()) || []).slice(1);
+  return { title };
+}
 function rehypeEnhancedTag() {
   return async (tree) => {
     visit(tree, "element", (node, i, parent) => {
-      var _a, _b, _c, _d;
+      var _a, _b, _c, _d, _e;
       if (node.tagName === "pre" && isElement((_a = node.children) == null ? void 0 : _a[0]) && node.children[0].tagName === "code") {
         const className = ((_b = node.children[0].properties) == null ? void 0 : _b.className) || [];
         const lang = (_c = className.join("").match(/language-(\w+)(?:$| )/)) == null ? void 0 : _c[1];
@@ -51,7 +58,10 @@ function rehypeEnhancedTag() {
         parent.children.splice(i, 1, {
           type: "element",
           tagName: "SourceCode",
-          properties: { lang },
+          properties: {
+            ...rehypeCodeMeta((_e = node.children[0].data) == null ? void 0 : _e.meta),
+            lang
+          },
           data: node.children[0].data,
           JSXAttributes: [
             {

package/dist/loaders/markdown/transformer/remarkContainer.js

@@ -32,12 +32,19 @@ __export(remarkContainer_exports, {
   default: () => remarkContainer
 });
 module.exports = __toCommonJS(remarkContainer_exports);
+var import_rehypeDemo = require("./rehypeDemo");
 var visit;
 var SKIP;
+var CONTINUE;
 var VALID_CONTAINER_TYPES = ["info", "warning", "success", "error"];
+var CODE_GROUP_SPECIFIER = "code-group";
 (async () => {
-  ({ visit, SKIP } = await import("unist-util-visit"));
+  ({ visit, SKIP, CONTINUE } = await import("unist-util-visit"));
 })();
+var transformAttributes = (attributes) => Object.entries(attributes ?? {}).reduce(
+  (ret, [name, value]) => `${ret} ${value ? `${name}="${value}"` : name}`,
+  ""
+);
 function remarkContainer() {
   const data = this.data();
   const micromarkExtensions = data.micromarkExtensions.find(
@@ -47,11 +54,10 @@ function remarkContainer() {
   micromarkExtensions.flow["58"].splice(1, 1);
   return (tree) => {
     visit(tree, (node, i, parent) => {
-      if (node.type === "containerDirective" && VALID_CONTAINER_TYPES.includes(node.name)) {
-        const attrs = Object.entries(node.attributes || {}).reduce(
-          (ret, [name, value]) => `${ret} ${value ? `${name}="${value}"` : name}`,
-          ""
-        );
+      if (node.type !== "containerDirective")
+        return CONTINUE;
+      if (VALID_CONTAINER_TYPES.includes(node.name)) {
+        const attrs = transformAttributes(node.attributes);
         parent.children.splice(
           i,
           1,
@@ -67,6 +73,31 @@ function remarkContainer() {
         );
         return SKIP;
       }
+      if (node.name === CODE_GROUP_SPECIFIER) {
+        const codeChildren = node.children.filter(({ type }) => type === "code").map((child) => ({
+          ...child,
+          data: {
+            ...child.data,
+            //  dumi 默认会编译有关联技术栈的代码块, 标记为不需要编译
+            [import_rehypeDemo.SKIP_DEMO_PARSE]: true
+          }
+        }));
+        parent.children.splice(
+          i,
+          1,
+          {
+            type: "html",
+            value: `<CodeGroup>`,
+            position: node.position
+          },
+          ...codeChildren,
+          {
+            type: "html",
+            value: "</CodeGroup>"
+          }
+        );
+        return SKIP;
+      }
     });
   };
 }