@microbit/makecode-embed 0.0.0-alpha.2

package/dist/vanilla/makecode-render-blocks.js

@@ -0,0 +1,214 @@
+/**
+ * MakeCode handling that does not depend on React.
+ */
+const disposedMessage = 'Disposed';
+const makecodeFailedToLoadMessage = 'Failed to load MakeCode to render blocks.';
+const createMakeCodeRenderBlocks = (options) => {
+    const defaultedOptions = {
+        ...options,
+    };
+    const makecodeOrigin = 'https://makecode.microbit.org';
+    let iframe;
+    let status = 'loading';
+    const requestStatus = {
+        nextRequest: 0,
+        pendingRequests: {},
+    };
+    const pendingRequests = requestStatus.pendingRequests;
+    const failAllPending = (errorMessage) => {
+        Object.keys(requestStatus.pendingRequests).forEach((k) => {
+            const { promise } = pendingRequests[k];
+            delete pendingRequests[k];
+            promise.reject(errorMessage);
+        });
+    };
+    const sendPendingIfReady = () => {
+        if (status === 'ready') {
+            // Possible that dispose has been called by the time we process the message,
+            // in which case do nothing.
+            if (iframe) {
+                Object.values(pendingRequests).forEach((rr) => ensureMessageSent(rr));
+            }
+        }
+        else if (status === 'error') {
+            failAllPending(makecodeFailedToLoadMessage);
+        }
+        else if (status === 'disabled') {
+            failAllPending('renderBlocks will always fail when explicitly disabled');
+        }
+        else {
+            // We're loading, we'll send these when done.
+        }
+    };
+    const ensureMessageSent = (rr) => {
+        if (!rr.sent) {
+            rr.sent = true;
+            const { req } = rr;
+            iframe.contentWindow.postMessage(req, makecodeOrigin);
+        }
+    };
+    const findBestCode = (code, ignoreBlocks) => {
+        if (typeof code === 'string') {
+            return { code, type: 'text' };
+        }
+        if (code.text) {
+            const blocks = code.text['main.blocks'];
+            const text = code.text['main.ts'];
+            if (blocks && !ignoreBlocks) {
+                return {
+                    code: blocks,
+                    type: 'blocks',
+                };
+            }
+            if (text) {
+                return {
+                    code: text,
+                    type: 'text',
+                };
+            }
+        }
+        return { code: '', type: 'text' };
+    };
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let errorTimeout;
+    const handleMessage = (ev) => {
+        const msg = ev.data;
+        if (ev.source !== iframe?.contentWindow || msg.source !== 'makecode') {
+            return;
+        }
+        switch (msg.type) {
+            case 'renderready': {
+                window.clearTimeout(errorTimeout);
+                status = 'ready';
+                sendPendingIfReady();
+                break;
+            }
+            case 'renderblocks': {
+                const id = msg.id;
+                const matchingRequest = pendingRequests[id];
+                if (!matchingRequest) {
+                    return;
+                }
+                const result = msg;
+                // This currently happens for extension blocks.
+                // We retry with text based rendering.
+                // MakeCode beta appears to do this internally.
+                if (!result.error &&
+                    !result.width &&
+                    !result.height &&
+                    !result.svg &&
+                    !result.uri) {
+                    if (matchingRequest.type === 'blocks') {
+                        matchingRequest.sent = false;
+                        matchingRequest.type = 'text';
+                        matchingRequest.req.code = findBestCode(matchingRequest.input, true).code;
+                        ensureMessageSent(matchingRequest);
+                        return;
+                    }
+                    else {
+                        result.error = 'Internal MakeCode failure.';
+                    }
+                }
+                delete pendingRequests[id];
+                if (result.error) {
+                    matchingRequest.promise.reject(result.error);
+                }
+                else {
+                    matchingRequest.promise.resolve(msg);
+                }
+                break;
+            }
+        }
+    };
+    return {
+        initialize: () => {
+            if (options.disabled) {
+                return;
+            }
+            window.addEventListener('message', handleMessage);
+            iframe = createIframe(makecodeOrigin, defaultedOptions);
+            errorTimeout = setTimeout(() => {
+                failAllPending(makecodeFailedToLoadMessage);
+                status = 'error';
+            }, 30000);
+        },
+        dispose: () => {
+            window.clearTimeout(errorTimeout);
+            window.removeEventListener('message', handleMessage);
+            if (iframe && iframe.parentNode) {
+                iframe.parentNode.removeChild(iframe);
+            }
+            iframe = undefined;
+            failAllPending(disposedMessage);
+        },
+        renderBlocks: (req) => {
+            const id = requestStatus.nextRequest++ + '';
+            const { code, type } = findBestCode(req.code);
+            const makecodeRequest = {
+                id,
+                code,
+                type: 'renderblocks',
+                options: {
+                    ...req.options,
+                    // To include files to filesystem
+                    assets: typeof req.code === 'object' ? req.code.text : undefined,
+                    package: defaultPackageFromDependencies(req),
+                },
+            };
+            return new Promise((resolve, reject) => {
+                pendingRequests[id] = {
+                    type,
+                    input: req.code,
+                    sent: false,
+                    req: makecodeRequest,
+                    promise: { resolve, reject },
+                };
+                sendPendingIfReady();
+            });
+        },
+    };
+};
+function defaultPackageFromDependencies(req) {
+    // Package can encode the extensions used in a comma separated list in this format:
+    // automationbit=github:pimoroni/pxt-automationbit#v0.0.2
+    // We can find that list from the JSON passed (but not from blocks or text)
+    const _package = req.options && req.options.package ? req.options.package : undefined;
+    if (typeof _package === 'undefined' &&
+        typeof req.code === 'object' &&
+        req.code.text['pxt.json']) {
+        const parsed = JSON.parse(req.code.text['pxt.json']);
+        if (typeof parsed === 'object') {
+            // Cope with extensions with spaces in their names. Otherwise pxt rejects
+            // adding the dependency even if it would in normal usage.
+            // https://github.com/microbit-foundation/classroom-management-tool/issues/463
+            const sanitizedName = (s) => s.replace(/[^a-zA-Z0-9_-]/g, '_');
+            const dependencies = parsed.dependencies || {};
+            const result = Object.keys(dependencies)
+                .map((name) => `${sanitizedName(name)}=${dependencies[name]}`)
+                .join(',');
+            return result;
+        }
+    }
+    return _package;
+}
+function createIframe(makecodeOrigin, { lang, version }) {
+    const query = `?render=1${lang ? `&lang=${encodeURIComponent(lang)}` : ''}`;
+    const src = [makecodeOrigin, version, '--docs'].filter(Boolean).join('/') + query;
+    const f = document.createElement('iframe');
+    f.style.position = 'absolute';
+    f.style.width = '1px';
+    f.style.height = '1px';
+    f.style.border = '0';
+    f.style.clip = 'rect(0 0 0 0)';
+    f.style.margin = '-1px';
+    f.style.padding = '0';
+    f.style.overflow = 'hidden';
+    f.style.whiteSpace = 'nowrap';
+    f.setAttribute('loading', 'eager');
+    f.setAttribute('aria-hidden', 'true');
+    f.src = src;
+    document.body.appendChild(f);
+    return f;
+}
+export default createMakeCodeRenderBlocks;
+//# sourceMappingURL=makecode-render-blocks.js.map

package/dist/vanilla/makecode-render-blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"makecode-render-blocks.js","sourceRoot":"","sources":["../../src/vanilla/makecode-render-blocks.ts"],"names":[],"mappings":"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"}