dumi 2.3.0-beta.8 → 2.3.0

package/dist/assetParsers/block.d.ts

@@ -15,6 +15,7 @@ export interface IParsedBlockAsset {
 }
 declare function parseBlockAsset(opts: {
     fileAbsPath: string;
+    fileLocale?: string;
     id: string;
     refAtomIds: string[];
     entryPointCode?: string;

package/dist/assetParsers/block.js

@@ -83,7 +83,7 @@ async function parseBlockAsset(opts) {
                   type: "NPM",
                   value: pkg.version
                 };
-                result.resolveMap[args.path] = resolved;
+                result.resolveMap[args.path] = args.path;
               }
               return { path: args.path, external: true };
             }
@@ -136,15 +136,19 @@ async function parseBlockAsset(opts) {
                 asset.entry = filename;
                 if (frontmatter) {
                   file.value = code;
-                  result.frontmatter = frontmatter;
+                  asset.dependencies[filename].value = code;
                   ["description", "title", "snapshot", "keywords"].forEach(
                     (key) => {
                       asset[key] = frontmatter == null ? void 0 : frontmatter[key];
                     }
                   );
+                  ["description", "title"].forEach((key) => {
+                    frontmatter[key] || (frontmatter[key] = frontmatter[`${key}.${opts.fileLocale}`]);
+                  });
+                  result.frontmatter = frontmatter;
                 }
               }
-              if (!isEntryPoint || !opts.entryPointCode) {
+              if (opts.techStack.runtimeOpts && (!isEntryPoint || !opts.entryPointCode)) {
                 result.resolveMap[filename] = args.path;
               }
               return {

package/dist/client/pages/Demo/index.js

@@ -3,17 +3,23 @@ import { createElement, useEffect } from 'react';
 import { useRenderer } from "../../theme-api/useRenderer";
 import "./index.less";
 var DemoRenderPage = function DemoRenderPage() {
-  var _useParams = useParams(),
-    id = _useParams.id;
+  var params = useParams();
+  var id = params.id;
   var demo = useDemo(id);
-  var canvasRef = useRenderer(demo);
+  var _useRenderer = useRenderer({
+      id: id,
+      component: demo.component,
+      renderOpts: demo.renderOpts
+    }),
+    canvasRef = _useRenderer.canvasRef;
   var _ref = demo || {},
     component = _ref.component,
     renderOpts = _ref.renderOpts;
   var _useLiveDemo = useLiveDemo(id),
     liveDemoNode = _useLiveDemo.node,
     setSource = _useLiveDemo.setSource,
-    liveDemoError = _useLiveDemo.error;
+    liveDemoError = _useLiveDemo.error,
+    loading = _useLiveDemo.loading;
   var finalNode = liveDemoNode || (renderOpts !== null && renderOpts !== void 0 && renderOpts.renderer ? /*#__PURE__*/createElement('div', {
     ref: canvasRef
   }) : component && /*#__PURE__*/createElement(component));
@@ -33,7 +39,7 @@ var DemoRenderPage = function DemoRenderPage() {
 
   // notify parent window that compile done
   useEffect(function () {
-    if (liveDemoNode || liveDemoError) {
+    if (!loading && (liveDemoError || liveDemoNode)) {
       window.postMessage({
         type: 'dumi.liveDemo.compileDone',
         value: {
@@ -41,7 +47,7 @@ var DemoRenderPage = function DemoRenderPage() {
         }
       });
     }
-  }, [liveDemoNode, liveDemoError]);
+  }, [liveDemoError, liveDemoNode, loading]);
   return finalNode;
 };
 export default DemoRenderPage;

package/dist/client/theme-api/DumiDemo/index.js

@@ -15,9 +15,12 @@ var InternalDumiDemo = function InternalDumiDemo(props) {
   var component = demo.component,
     asset = demo.asset,
     renderOpts = demo.renderOpts;
-  var canvasRef = useRenderer(Object.assign(demo, {
-    id: id
-  }));
+  var _useRenderer = useRenderer({
+      id: id,
+      renderOpts: demo.renderOpts,
+      component: demo.component
+    }),
+    canvasRef = _useRenderer.canvasRef;
 
   // hide debug demo in production
   if (process.env.NODE_ENV === 'production' && props.previewerProps.debug) return null;

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

@@ -49,6 +49,10 @@ export interface IPreviewerProps {
      * react node of current demo
      */
     children: ReactNode;
+    /**
+     * private field, do not use it in your code
+     */
+    _live_in_iframe: boolean;
     [key: string]: any;
 }
 export interface IRouteMeta {
@@ -208,6 +212,7 @@ export interface IThemeConfig {
         [key in SocialTypes]?: string;
     };
     editLink?: boolean | string;
+    sourceLink?: boolean | string;
     lastUpdated?: boolean;
     [key: string]: any;
 }
@@ -228,6 +233,7 @@ export type IDemoCompileFn = (code: string, opts: {
     filename: string;
 }) => Promise<string>;
 export type IDemoCancelableFn = (canvas: HTMLElement, component: AgnosticComponentModule) => (() => void) | Promise<() => void>;
+export type IDemoPreflightFn = (component: AgnosticComponentModule) => Promise<void>;
 export type IDemoData = {
     component: ReactComponentType | AgnosticComponentType;
     asset: IPreviewerProps['asset'];
@@ -238,7 +244,15 @@ export type IDemoData = {
          * provide a runtime compile function for compile demo code for live preview
          */
         compile?: IDemoCompileFn;
+        /**
+         * Component rendering function, used to manage the creation and unmount of components
+         */
         renderer?: IDemoCancelableFn;
+        /**
+         * Used to detect initialization errors of components in advance
+         * (if there is an error, the component will not be mounted)
+         */
+        preflight?: IDemoPreflightFn;
     };
 };
 export {};

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

@@ -2,11 +2,6 @@ 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); }); }; }
-function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
-function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
-function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
 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); }
@@ -18,6 +13,7 @@ import throttle from 'lodash.throttle';
 import { createElement, useCallback, useRef, useState } from 'react';
 import DemoErrorBoundary from "./DumiDemo/DemoErrorBoundary";
 import { useRenderer } from "./useRenderer";
+import { getAgnosticComponentModule } from "./utils";
 var THROTTLE_WAIT = 500;
 function evalCommonJS(js, _ref) {
   var module = _ref.module,
@@ -33,40 +29,38 @@ export var useLiveDemo = function useLiveDemo(id, opts) {
     setLoading = _useState2[1];
   var loadingTimer = useRef();
   var taskToken = useRef();
+  function resetLoadingStatus() {
+    clearTimeout(loadingTimer.current);
+    setLoading(false);
+  }
   var _demo$context = demo.context,
     context = _demo$context === void 0 ? {} : _demo$context,
     asset = demo.asset,
     renderOpts = demo.renderOpts;
-  var _useState3 = useState(),
+  var _useState3 = useState(null),
     _useState4 = _slicedToArray(_useState3, 2),
-    component = _useState4[0],
-    setComponent = _useState4[1];
-  var ref = useRenderer(component ? _objectSpread(_objectSpread({
-    id: id
-  }, demo), {}, {
-    component: component
-  }) : Object.assign(demo, {
-    id: id
-  }));
+    error = _useState4[0],
+    setError = _useState4[1];
+  var _useRenderer = useRenderer({
+      id: id,
+      renderOpts: demo.renderOpts,
+      onResolved: function onResolved() {
+        resetLoadingStatus();
+      }
+    }),
+    ref = _useRenderer.canvasRef,
+    setComponent = _useRenderer.setComponent;
   var _useState5 = useState(),
     _useState6 = _slicedToArray(_useState5, 2),
     demoNode = _useState6[0],
     setDemoNode = _useState6[1];
-  var _useState7 = useState(null),
-    _useState8 = _slicedToArray(_useState7, 2),
-    error = _useState8[0],
-    setError = _useState8[1];
   var setSource = useCallback(throttle( /*#__PURE__*/function () {
     var _ref2 = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(source) {
       var _opts$containerRef;
-      var resetLoadingStatus, iframeWindow, entryFileName, require, token, entryFileCode, exports, module, renderToStaticMarkupDeferred, _exports, _module, newDemoNode, oError;
+      var iframeWindow, entryFileName, require, token, entryFileCode, exports, module, component, renderToStaticMarkupDeferred, _exports, _module, newDemoNode, oError, shouldSkipError;
       return _regeneratorRuntime().wrap(function _callee$(_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
-            resetLoadingStatus = function _resetLoadingStatus() {
-              clearTimeout(loadingTimer.current);
-              setLoading(false);
-            };
             // set loading status if still compiling after 499ms
             loadingTimer.current = window.setTimeout(function () {
               setLoading(true);
@@ -74,11 +68,11 @@ export var useLiveDemo = function useLiveDemo(id, opts) {
             // make sure timer be fired before next throttle
             THROTTLE_WAIT - 1);
             if (!(opts !== null && opts !== void 0 && opts.iframe && opts !== null && opts !== void 0 && (_opts$containerRef = opts.containerRef) !== null && _opts$containerRef !== void 0 && _opts$containerRef.current)) {
-              _context.next = 8;
+              _context.next = 7;
               break;
             }
             iframeWindow = opts.containerRef.current.querySelector('iframe').contentWindow;
-            _context.next = 6;
+            _context.next = 5;
             return new Promise(function (resolve) {
               var handler = function handler(ev) {
                 if (ev.data.type.startsWith('dumi.liveDemo.compileDone')) {
@@ -93,10 +87,10 @@ export var useLiveDemo = function useLiveDemo(id, opts) {
                 value: source
               });
             });
-          case 6:
-            _context.next = 50;
+          case 5:
+            _context.next = 74;
             break;
-          case 8:
+          case 7:
             entryFileName = Object.keys(asset.dependencies).find(function (k) {
               return asset.dependencies[k].type === 'FILE';
             });
@@ -107,62 +101,77 @@ export var useLiveDemo = function useLiveDemo(id, opts) {
             token = taskToken.current = Math.random();
             entryFileCode = source[entryFileName];
             if (!(renderOpts !== null && renderOpts !== void 0 && renderOpts.compile)) {
-              _context.next = 24;
+              _context.next = 23;
               break;
             }
-            _context.prev = 13;
-            _context.next = 16;
+            _context.prev = 12;
+            _context.next = 15;
             return renderOpts.compile(entryFileCode, {
               filename: entryFileName
             });
-          case 16:
+          case 15:
             entryFileCode = _context.sent;
-            _context.next = 24;
+            _context.next = 23;
             break;
-          case 19:
-            _context.prev = 19;
-            _context.t0 = _context["catch"](13);
+          case 18:
+            _context.prev = 18;
+            _context.t0 = _context["catch"](12);
             setError(_context.t0);
             resetLoadingStatus();
             return _context.abrupt("return");
-          case 24:
+          case 23:
             if (!(renderOpts !== null && renderOpts !== void 0 && renderOpts.renderer && renderOpts !== null && renderOpts !== void 0 && renderOpts.compile)) {
-              _context.next = 28;
+              _context.next = 44;
               break;
             }
-            try {
-              exports = {};
-              module = {
-                exports: exports
-              };
-              evalCommonJS(entryFileCode, {
-                exports: exports,
-                module: module,
-                require: require
-              });
-              setComponent(exports);
-              setDemoNode( /*#__PURE__*/createElement('div', {
-                ref: ref
-              }));
-              setError(null);
-            } catch (err) {
-              setError(err);
+            _context.prev = 24;
+            exports = {};
+            module = {
+              exports: exports
+            };
+            evalCommonJS(entryFileCode, {
+              exports: exports,
+              module: module,
+              require: require
+            });
+            _context.next = 30;
+            return getAgnosticComponentModule(exports);
+          case 30:
+            component = _context.sent;
+            if (!renderOpts.preflight) {
+              _context.next = 34;
+              break;
             }
+            _context.next = 34;
+            return renderOpts.preflight(component);
+          case 34:
+            setComponent(component);
+            setDemoNode( /*#__PURE__*/createElement('div', {
+              ref: ref
+            }));
+            setError(null);
+            _context.next = 43;
+            break;
+          case 39:
+            _context.prev = 39;
+            _context.t1 = _context["catch"](24);
+            setError(_context.t1);
             resetLoadingStatus();
+          case 43:
             return _context.abrupt("return");
-          case 28:
-            _context.prev = 28;
+          case 44:
+            _context.prev = 44;
             // load renderToStaticMarkup in async way
             renderToStaticMarkupDeferred = import('react-dom/server').then(function (_ref3) {
               var renderToStaticMarkup = _ref3.renderToStaticMarkup;
               return renderToStaticMarkup;
             }); // skip current task if another task is running
             if (!(token !== taskToken.current)) {
-              _context.next = 32;
+              _context.next = 48;
               break;
             }
             return _context.abrupt("return");
-          case 32:
+          case 48:
             _exports = {};
             _module = {
               exports: _exports
@@ -182,29 +191,42 @@ export var useLiveDemo = function useLiveDemo(id, opts) {
             };
 
             // check component is able to render, to avoid show react overlay error
-            _context.next = 40;
+            _context.prev = 54;
+            _context.next = 57;
             return renderToStaticMarkupDeferred;
-          case 40:
-            _context.t1 = _context.sent;
-            (0, _context.t1)(newDemoNode);
+          case 57:
+            _context.t2 = _context.sent;
+            (0, _context.t2)(newDemoNode);
+            _context.next = 66;
+            break;
+          case 61:
+            _context.prev = 61;
+            _context.t3 = _context["catch"](54);
+            shouldSkipError = _context.t3.message.includes('Unable to find node on an unmounted component') || _context.t3.message.includes('Portals are not currently supported by the server renderer');
+            if (shouldSkipError) {
+              _context.next = 66;
+              break;
+            }
+            throw _context.t3;
+          case 66:
             console.error = oError;
 
             // set new demo node with passing source
             setDemoNode(newDemoNode);
             setError(null);
-            _context.next = 50;
+            _context.next = 74;
             break;
-          case 47:
-            _context.prev = 47;
-            _context.t2 = _context["catch"](28);
-            setError(_context.t2);
-          case 50:
+          case 71:
+            _context.prev = 71;
+            _context.t4 = _context["catch"](44);
+            setError(_context.t4);
+          case 74:
             resetLoadingStatus();
-          case 51:
+          case 75:
           case "end":
             return _context.stop();
         }
-      }, _callee, null, [[13, 19], [28, 47]]);
+      }, _callee, null, [[12, 18], [24, 39], [44, 71], [54, 61]]);
     }));
     return function (_x2) {
       return _ref2.apply(this, arguments);

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

@@ -1,5 +1,12 @@
 /// <reference types="react" />
-import type { IDemoData } from './types';
-export declare const useRenderer: ({ id, component, renderOpts, }: IDemoData & {
+import type { AgnosticComponentType, IDemoData } from './types';
+export interface UseRendererOptions {
     id: string;
-}) => import("react").RefObject<HTMLDivElement>;
+    component?: AgnosticComponentType;
+    renderOpts: IDemoData['renderOpts'];
+    onResolved?: () => void;
+}
+export declare const useRenderer: ({ id, component, renderOpts, onResolved, }: UseRendererOptions) => {
+    canvasRef: import("react").RefObject<HTMLDivElement>;
+    setComponent: import("react").Dispatch<import("react").SetStateAction<AgnosticComponentType | null>>;
+};