pxt-core 7.4.7 → 7.4.11

package/built/pxtblocks.d.ts

@@ -471,7 +471,7 @@ declare namespace pxtblockly {
         protected animateRef: any;
         protected asset: pxt.Animation;
         protected initInterval: number;
-        init(): void;
+        initView(): void;
         showEditor_(): void;
         render_(): void;
         protected getAssetType(): pxt.AssetType;
@@ -508,7 +508,7 @@ declare namespace pxtblockly {
         CURSOR: string;
         private type_;
         constructor(state: string, params: Blockly.FieldCustomOptions, opt_validator?: Function);
-        init(): void;
+        initView(): void;
         updateSize_(): void;
         /**
          * Return 'TRUE' if the toggle is ON, 'FALSE' otherwise.
@@ -1243,7 +1243,7 @@ declare namespace pxtblockly {
         protected blocksInfo: pxtc.BlocksInfo;
         protected transparent: TilesetDropdownOption;
         constructor(text: string, options: FieldImageDropdownOptions, validator?: Function);
-        init(): void;
+        initView(): void;
         getValue(): any;
         getText(): string;
         render_(): void;
@@ -1265,7 +1265,7 @@ declare namespace pxtblockly {
         CURSOR: string;
         private type_;
         constructor(state: string, params: Blockly.FieldCustomOptions, opt_validator?: Function);
-        init(): void;
+        initView(): void;
         getDisplayText_(): string;
         getTrueText(): string;
         getFalseText(): string;

package/built/pxtblocks.js

@@ -1497,7 +1497,7 @@ var pxt;
         function compileBlockAsync(b, blockInfo) {
             const w = b.workspace;
             const e = mkEnv(w, blockInfo);
-            infer(w && w.getAllBlocks(), e, w);
+            infer(w && w.getAllBlocks(false), e, w);
             const compiled = compileStatementBlock(e, b);
             removeAllPlaceholders();
             return tdASTtoTS(e, compiled);
@@ -1518,7 +1518,7 @@ var pxt;
         function compileWorkspace(e, w, blockInfo) {
             try {
                 // all compiled top level blocks are events
-                let allBlocks = w.getAllBlocks();
+                let allBlocks = w.getAllBlocks(false);
                 if (pxt.react.getTilemapProject) {
                     pxt.react.getTilemapProject().removeInactiveBlockAssets(allBlocks.map(b => b.id));
                 }
@@ -1788,13 +1788,11 @@ var pxt;
             });
         }
         function maybeAddComment(b, comments) {
-            if (b.comment) {
-                if ((typeof b.comment) === "string") {
-                    comments.push(b.comment);
-                }
-                else {
-                    comments.push(b.comment.getText());
-                }
+            var _a;
+            // Check if getCommentText exists, block may be placeholder
+            const text = (_a = b.getCommentText) === null || _a === void 0 ? void 0 : _a.call(b);
+            if (text) {
+                comments.push(text);
             }
         }
         function addCommentNodes(comments, r) {
@@ -2457,9 +2455,9 @@ var pxt;
                 }
             });
             // we'll ignore disabled blocks in the final output
-            const oldBlocks = oldWs.getAllBlocks().filter(b => b.isEnabled());
+            const oldBlocks = oldWs.getAllBlocks(false).filter(b => b.isEnabled());
             const oldTopBlocks = oldWs.getTopBlocks(false).filter(b => b.isEnabled());
-            const newBlocks = newWs.getAllBlocks().filter(b => b.isEnabled());
+            const newBlocks = newWs.getAllBlocks(false).filter(b => b.isEnabled());
             log(`blocks`, newBlocks.map(b => b.toDevString()));
             log(newBlocks);
             if (oldBlocks.length == 0 && newBlocks.length == 0) {
@@ -2481,11 +2479,11 @@ var pxt;
             const newXml = pxt.blocks.saveWorkspaceXml(newWs, true);
             pxt.blocks.domToWorkspaceNoEvents(Blockly.Xml.textToDom(newXml), ws);
             // delete disabled blocks from final workspace
-            ws.getAllBlocks().filter(b => !b.isEnabled()).forEach(b => {
+            ws.getAllBlocks(false).filter(b => !b.isEnabled()).forEach(b => {
                 log('disabled ', b.toDevString());
                 b.dispose(false);
             });
-            const todoBlocks = pxt.Util.toDictionary(ws.getAllBlocks(), b => b.id);
+            const todoBlocks = pxt.Util.toDictionary(ws.getAllBlocks(false), b => b.id);
             log(`todo blocks`, todoBlocks);
             logTodo('start');
             // 1. deleted top blocks
@@ -2495,7 +2493,7 @@ var pxt;
                     done(b);
                     const b2 = cloneIntoDiff(b);
                     done(b2);
-                    b2.setDisabled(true);
+                    b2.setEnabled(false);
                 });
                 logTodo('deleted top');
             }
@@ -2560,7 +2558,7 @@ var pxt;
             });
             logTodo('unmodified');
             // if nothing is left in the workspace, we "missed" change
-            if (!ws.getAllBlocks().length) {
+            if (!ws.getAllBlocks(false).length) {
                 pxt.tickEvent("blocks.diff", { missed: 1 });
                 return {
                     ws,
@@ -2593,7 +2591,7 @@ var pxt;
             function stitch(b) {
                 log(`stitching ${b.toDevString()}->${dids[b.id]}`);
                 const wb = ws.getBlockById(dids[b.id]);
-                wb.setDisabled(true);
+                wb.setEnabled(false);
                 markUsed(wb);
                 done(wb);
                 // connect previous connection to delted or existing block
@@ -2855,10 +2853,10 @@ var pxt;
         function applyMetaComments(workspace) {
             // process meta comments
             // @highlight -> highlight block
-            workspace.getAllBlocks()
-                .filter(b => !!b.comment && b.comment instanceof Blockly.Comment)
+            workspace.getAllBlocks(false)
+                .filter(b => !!b.getCommentText())
                 .forEach(b => {
-                const c = b.comment.getText();
+                const c = b.getCommentText();
                 if (/@highlight/.test(c)) {
                     const cc = c.replace(/@highlight/g, '').trim();
                     b.setCommentText(cc || null);
@@ -4343,7 +4341,7 @@ var pxt;
                                 }
                                 else if (pr.type == "number" && pr.shadowBlockId && pr.shadowBlockId == "value") {
                                     inputName = undefined;
-                                    fields.push(namedField(new Blockly.FieldTextInput("0", Blockly.FieldTextInput.numberValidator), defName));
+                                    fields.push(namedField(new Blockly.FieldNumber("0"), defName));
                                 }
                                 else if (pr.type == "string" && pr.shadowOptions && pr.shadowOptions.toString) {
                                     inputCheck = null;
@@ -5445,11 +5443,6 @@ var pxt;
                         let blockText = '<xml>' +
                             '<block type="variables_change" gap="' + gap + '">' +
                             Blockly.Variables.generateVariableFieldXmlString(mostRecentVariable) +
-                            '<value name="DELTA">' +
-                            '<shadow type="math_number">' +
-                            '<field name="NUM">1</field>' +
-                            '</shadow>' +
-                            '</value>' +
                             '</block>' +
                             '</xml>';
                         let block = Blockly.Xml.textToDom(blockText).firstChild;
@@ -7622,19 +7615,8 @@ var pxtblockly;
                 this.valueText = text;
         }
         init() {
-            if (this.isInitialized())
-                return;
-            // Build the DOM.
-            this.fieldGroup_ = Blockly.utils.dom.createSvgElement('g', {}, null);
-            if (!this.visible_) {
-                this.fieldGroup_.style.display = 'none';
-            }
+            super.init();
             this.onInit();
-            this.updateEditable();
-            this.sourceBlock_.getSvgRoot().appendChild(this.fieldGroup_);
-            // Force a render.
-            this.render_();
-            this.mouseDownWrapper_ = Blockly.bindEventWithChecks_(this.getClickTarget_(), "mousedown", this, this.onMouseDown_);
         }
         dispose() {
             this.onDispose();
@@ -7787,9 +7769,11 @@ var pxtblockly;
         }
         getDisplayText_() {
             // This is only used when isGreyBlock is true
-            const text = pxt.Util.htmlUnescape(this.valueText);
-            return text.substr(0, text.indexOf("(")) + "(...)";
-            ;
+            if (this.isGreyBlock) {
+                const text = pxt.Util.htmlUnescape(this.valueText);
+                return text.substr(0, text.indexOf("(")) + "(...)";
+            }
+            return "";
         }
         updateEditable() {
             if (this.isGreyBlock && this.fieldGroup_) {
@@ -8046,12 +8030,7 @@ var pxtblockly;
                 }
             };
         }
-        init() {
-            if (this.fieldGroup_) {
-                // Field has already been initialized once.
-                return;
-            }
-            super.init();
+        initView() {
             // Register mouseover events for animating preview
             this.sourceBlock_.getSvgRoot().addEventListener("mouseenter", this.onMouseEnter);
             this.sourceBlock_.getSvgRoot().addEventListener("mouseleave", this.onMouseLeave);
@@ -8257,16 +8236,10 @@ var pxtblockly;
             this.addArgType('toggle');
             this.type_ = params.type;
         }
-        init() {
-            if (this.fieldGroup_) {
-                // Field has already been initialized once.
+        initView() {
+            if (!this.fieldGroup_) {
                 return;
             }
-            // Build the DOM.
-            this.fieldGroup_ = Blockly.utils.dom.createSvgElement('g', {}, null);
-            if (!this.visible_) {
-                this.fieldGroup_.style.display = 'none';
-            }
             // Add an attribute to cassify the type of field.
             if (this.getArgTypes() !== null) {
                 if (this.sourceBlock_.isShadow()) {
@@ -8295,15 +8268,10 @@ var pxtblockly;
                 'dy': '0.6ex',
                 'y': size.height / 2
             }, this.fieldGroup_);
-            this.updateEditable();
-            this.sourceBlock_.getSvgRoot().appendChild(this.fieldGroup_);
             this.switchToggle(this.state_);
             this.setValue(this.getValue());
             // Force a render.
-            this.render_();
-            this.size_.width = 0;
-            this.mouseDownWrapper_ =
-                Blockly.bindEventWithChecks_(this.getClickTarget_(), 'mousedown', this, this.onMouseDown_);
+            this.markDirty();
         }
         updateSize_() {
             this.size_.width = 30;
@@ -9773,7 +9741,7 @@ var pxtblockly;
         }
         render_() {
             if (!this.visible_) {
-                this.size_.width = 0;
+                this.markDirty();
                 return;
             }
             if (!this.elt) {
@@ -11277,7 +11245,7 @@ var pxtblockly;
         dropdownCreate() {
             let functionList = [];
             if (this.sourceBlock_ && this.sourceBlock_.workspace) {
-                let blocks = this.sourceBlock_.workspace.getAllBlocks();
+                let blocks = this.sourceBlock_.workspace.getAllBlocks(false);
                 // Iterate through every block and check the name.
                 for (let i = 0; i < blocks.length; i++) {
                     if (blocks[i].getProcedureDef) {
@@ -11306,10 +11274,6 @@ var pxtblockly;
         }
         onItemSelected(menu, menuItem) {
             let itemText = menuItem.getValue();
-            if (this.sourceBlock_) {
-                // Call any validation function, and allow it to override.
-                itemText = this.callValidator(itemText);
-            }
             if (itemText !== null) {
                 this.setValue(itemText);
             }
@@ -11804,8 +11768,8 @@ var pxtblockly;
             }
             return FieldTileset.referencedTiles;
         }
-        init() {
-            super.init();
+        initView() {
+            super.initView();
             if (this.sourceBlock_ && this.sourceBlock_.isInFlyout) {
                 this.setValue(this.getOptions()[0][1]);
             }
@@ -11954,16 +11918,10 @@ var pxtblockly;
             this.addArgType('toggle');
             this.type_ = params.type;
         }
-        init() {
-            if (this.fieldGroup_) {
-                // Field has already been initialized once.
+        initView() {
+            if (!this.fieldGroup_) {
                 return;
             }
-            // Build the DOM.
-            this.fieldGroup_ = Blockly.utils.dom.createSvgElement('g', {}, null);
-            if (!this.visible_) {
-                this.fieldGroup_.style.display = 'none';
-            }
             // Add an attribute to cassify the type of field.
             if (this.getArgTypes() !== null) {
                 if (this.sourceBlock_.isShadow()) {
@@ -12035,10 +11993,7 @@ var pxtblockly;
             this.switchToggle(this.state_);
             this.setValue(this.getValue());
             // Force a render.
-            this.render_();
-            this.size_.width = 0;
-            this.mouseDownWrapper_ =
-                Blockly.bindEventWithChecks_(this.getClickTarget_(), 'mousedown', this, this.onMouseDown_);
+            this.markDirty();
         }
         getDisplayText_() {
             return this.state_ ? this.getTrueText() : this.getFalseText();

package/built/pxtlib.d.ts

@@ -57,6 +57,10 @@ declare namespace pxt.auth {
     type UserBadgeState = {
         badges: Badge[];
     };
+    type SetPrefResult = {
+        success: boolean;
+        res: UserPreferences;
+    };
     /**
      * User preference state that should be synced with the cloud.
      */
@@ -66,6 +70,7 @@ declare namespace pxt.auth {
         reader?: string;
         skillmap?: UserSkillmapState;
         badges?: UserBadgeState;
+        email?: boolean;
     };
     const DEFAULT_USER_PREFERENCES: () => UserPreferences;
     /**
@@ -124,8 +129,11 @@ declare namespace pxt.auth {
             username?: string;
             avatarUrl?: string;
         }): Promise<boolean>;
-        private prefPatchOps;
-        patchUserPreferencesAsync(ops: ts.pxtc.jsonPatch.PatchOperation | ts.pxtc.jsonPatch.PatchOperation[], immediate?: boolean): Promise<void>;
+        private patchQueue;
+        patchUserPreferencesAsync(patchOps: ts.pxtc.jsonPatch.PatchOperation | ts.pxtc.jsonPatch.PatchOperation[], opts?: {
+            immediate?: boolean;
+            filter?: (op: ts.pxtc.jsonPatch.PatchOperation) => boolean;
+        }): Promise<SetPrefResult>;
         hasUserId(): boolean;
         private fetchUserAsync;
         private setUserProfileAsync;
@@ -297,6 +305,7 @@ declare namespace ts.pxtc.Util {
     export function groupBy<T>(arr: T[], f: (t: T) => string): pxt.Map<T[]>;
     export function toDictionary<T>(arr: T[], f: (t: T) => string): pxt.Map<T>;
     export function toSet<T>(arr: T[], f: (t: T) => string): pxt.Map<boolean>;
+    export function deepCopy(src: any): any;
     export interface ArrayLike<T> {
         [index: number]: T;
         length: number;

package/built/pxtlib.js

@@ -185,7 +185,8 @@ var pxt;
             highContrast: false,
             language: pxt.appTarget.appTheme.defaultLocale,
             reader: "",
-            skillmap: { mapProgress: {}, completedTags: {} }
+            skillmap: { mapProgress: {}, completedTags: {} },
+            email: false
         });
         let _client;
         function client() { return _client; }
@@ -198,7 +199,7 @@ var pxt;
             constructor() {
                 this.initialUserPreferences_ = undefined;
                 this.initialAuthCheck_ = undefined;
-                this.prefPatchOps = [];
+                this.patchQueue = [];
                 pxt.Util.assert(!_client);
                 // Set global instance.
                 _client = this;
@@ -388,62 +389,86 @@ var pxt;
                 }
                 return result.success;
             }
-            async patchUserPreferencesAsync(ops, immediate = false) {
-                ops = Array.isArray(ops) ? ops : [ops];
-                ops = ops.filter(op => !!op);
-                if (!ops.length) {
-                    return;
-                }
+            async patchUserPreferencesAsync(patchOps, opts = {}) {
+                const defaultSuccessAsync = async () => ({ success: true, res: await this.userPreferencesAsync() });
+                patchOps = Array.isArray(patchOps) ? patchOps : [patchOps];
+                patchOps = patchOps.filter(op => !!op);
+                if (!patchOps.length) {
+                    return await defaultSuccessAsync();
+                }
+                const patchDiff = (pSrc, ops, filter) => {
+                    // Apply patches to pDst and return the diff as a set of new patch ops.
+                    const pDst = pxt.U.deepCopy(pSrc);
+                    ts.pxtc.jsonPatch.patchInPlace(pDst, ops);
+                    let diff = ts.pxtc.jsonPatch.diff(pSrc, pDst);
+                    // Run caller-provided filter
+                    if (diff.length && filter) {
+                        diff = diff.filter(filter);
+                    }
+                    return diff;
+                };
+                // Process incoming patch operations to produce a more fine-grained set of diffs. Incoming patches may be overly destructive
+                // Apply the patch in isolation and get the diff from original
                 const curPref = await this.userPreferencesAsync();
-                ts.pxtc.jsonPatch.patchInPlace(curPref, ops);
+                const diff = patchDiff(curPref, patchOps, opts.filter);
+                if (!diff.length) {
+                    return await defaultSuccessAsync();
+                }
+                // Apply the new diff to the current state
+                ts.pxtc.jsonPatch.patchInPlace(curPref, diff);
                 await this.setUserPreferencesAsync(curPref);
-                // If we're not logged in, non-persistent local state is all we'll use
+                // If the user is not logged in, non-persistent local state is all we'll use (no sync to cloud)
                 if (!await this.loggedInAsync()) {
-                    return;
+                    return await defaultSuccessAsync();
                 }
-                // If the user is logged in, save to cloud, but debounce the api call as this can be called frequently from skillmaps
-                // Replace matching patches in the queue
-                ops.forEach((incoming, iIncoming) => {
-                    this.prefPatchOps.some((existing, iExisting) => {
-                        if (!ts.pxtc.jsonPatch.opsAreEqual(existing, incoming))
-                            return false;
-                        // Patches are equivalent, replace in queue
-                        this.prefPatchOps[iExisting] = incoming;
-                        // Clear from incoming so we don't add it below
-                        ops[iIncoming] = null;
-                        return true;
-                    });
-                });
-                // Add remaining ops to the queue
-                ops.filter(op => !!op).forEach(op => this.prefPatchOps.push(op));
+                // If the user is logged in, sync to cloud, but debounce the api call as this can be called frequently from skillmaps
+                // Queue the patch for sync with backend
+                this.patchQueue.push({ ops: patchOps, filter: opts.filter });
                 clearTimeout(debouncePreferencesChangedTimeout);
-                const savePrefs = async () => {
+                const syncPrefs = async () => {
                     debouncePreferencesChangedStarted = 0;
-                    // Clear queued patch ops before send.
-                    const prefPatchOps = this.prefPatchOps;
-                    this.prefPatchOps = [];
-                    const result = await this.apiAsync('/api/user/preferences', prefPatchOps, 'PATCH');
-                    if (result.success) {
-                        pxt.debug("Updating local user preferences w/ cloud data after result of POST");
-                        // Set user profile from returned value so we stay in-sync
-                        this.setUserPreferencesAsync(result.resp);
+                    if (!this.patchQueue.length) {
+                        return await defaultSuccessAsync();
+                    }
+                    // Fetch latest prefs from remote
+                    const getResult = await this.apiAsync('/api/user/preferences');
+                    if (!getResult.success) {
+                        pxt.reportError("identity", "failed to fetch preferences for patch", getResult);
+                        return { success: false, res: undefined };
+                    }
+                    // Apply queued patches to the remote state in isolation and develop a final diff to send to the backend
+                    const remotePrefs = pxt.U.deepCopy(getResult.resp);
+                    const patchQueue = this.patchQueue;
+                    this.patchQueue = []; // Reset the queue
+                    patchQueue.forEach(patch => {
+                        const diff = patchDiff(remotePrefs, patch.ops, patch.filter);
+                        ts.pxtc.jsonPatch.patchInPlace(remotePrefs, diff);
+                    });
+                    // Diff the original and patched remote states to get a final set of patch operations
+                    const finalOps = pxtc.jsonPatch.diff(getResult.resp, remotePrefs);
+                    const patchResult = await this.apiAsync('/api/user/preferences', finalOps, 'PATCH');
+                    if (patchResult.success) {
+                        // Set user profile from returned value so we stay in sync
+                        this.setUserPreferencesAsync(patchResult.resp);
                     }
                     else {
-                        pxt.reportError("identity", "update preferences failed", result);
+                        pxt.reportError("identity", "failed to patch preferences", patchResult);
                     }
+                    return { success: patchResult.success, res: patchResult.resp };
                 };
-                if (immediate) {
-                    await savePrefs();
+                if (opts.immediate) {
+                    return await syncPrefs();
                 }
                 else {
                     if (!debouncePreferencesChangedStarted) {
                         debouncePreferencesChangedStarted = pxt.U.now();
                     }
                     if (PREFERENCES_DEBOUNCE_MAX_MS < pxt.U.now() - debouncePreferencesChangedStarted) {
-                        await savePrefs();
+                        return await syncPrefs();
                     }
                     else {
-                        debouncePreferencesChangedTimeout = setTimeout(savePrefs, PREFERENCES_DEBOUNCE_MS);
+                        debouncePreferencesChangedTimeout = setTimeout(syncPrefs, PREFERENCES_DEBOUNCE_MS);
+                        return { success: false, res: undefined }; // This needs to be implemented correctly to return a promise with the debouncer
                     }
                 }
             }
@@ -1525,6 +1550,18 @@ var ts;
                 return r;
             }
             Util.toSet = toSet;
+            function deepCopy(src) {
+                if (typeof src !== "object" || src === null) {
+                    return src;
+                }
+                const dst = Array.isArray(src) ? [] : {};
+                for (const key in src) {
+                    const value = src[key];
+                    dst[key] = deepCopy(value);
+                }
+                return dst;
+            }
+            Util.deepCopy = deepCopy;
             function toArray(a) {
                 if (Array.isArray(a)) {
                     return a;
@@ -3944,7 +3981,7 @@ var pxt;
                 'pxt_controls_for': {
                     name: pxt.Util.lf("a loop that repeats the number of times you say"),
                     tooltip: pxt.Util.lf("Have the variable '{0}' take on the values from 0 to the end number, counting by 1, and do the specified blocks."),
-                    url: 'blocks/loops/for',
+                    url: '/blocks/loops/for',
                     category: 'loops',
                     block: {
                         message0: pxt.Util.lf("for %1 from 0 to %2"),
@@ -3955,7 +3992,7 @@ var pxt;
                 'controls_simple_for': {
                     name: pxt.Util.lf("a loop that repeats the number of times you say"),
                     tooltip: pxt.Util.lf("Have the variable '{0}' take on the values from 0 to the end number, counting by 1, and do the specified blocks."),
-                    url: 'blocks/loops/for',
+                    url: '/blocks/loops/for',
                     category: 'loops',
                     block: {
                         message0: pxt.Util.lf("for %1 from 0 to %2"),
@@ -3966,7 +4003,7 @@ var pxt;
                 'pxt_controls_for_of': {
                     name: pxt.Util.lf("a loop that repeats for each value in an array"),
                     tooltip: pxt.Util.lf("Have the variable '{0}' take the value of each item in the array one by one, and do the specified blocks."),
-                    url: 'blocks/loops/for-of',
+                    url: '/blocks/loops/for-of',
                     category: 'loops',
                     block: {
                         message0: pxt.Util.lf("for element %1 of %2"),
@@ -3977,7 +4014,7 @@ var pxt;
                 'controls_for_of': {
                     name: pxt.Util.lf("a loop that repeats for each value in an array"),
                     tooltip: pxt.Util.lf("Have the variable '{0}' take the value of each item in the array one by one, and do the specified blocks."),
-                    url: 'blocks/loops/for-of',
+                    url: '/blocks/loops/for-of',
                     category: 'loops',
                     block: {
                         message0: pxt.Util.lf("for element %1 of %2"),
@@ -4262,7 +4299,7 @@ var pxt;
                 'text': {
                     name: pxt.Util.lf("a piece of text"),
                     tooltip: pxt.Util.lf("A letter, word, or line of text."),
-                    url: 'types/string',
+                    url: '/types/string',
                     category: 'text',
                     block: {
                         search: pxt.Util.lf("a piece of text") // Only used for search; this string is not surfaced in the block's text
@@ -4271,7 +4308,7 @@ var pxt;
                 'text_length': {
                     name: pxt.Util.lf("number of characters in the string"),
                     tooltip: pxt.Util.lf("Returns the number of letters (including spaces) in the provided text."),
-                    url: 'reference/text/length',
+                    url: '/reference/text/length',
                     category: 'text',
                     block: {
                         TEXT_LENGTH_TITLE: pxt.Util.lf("length of %1")
@@ -4280,7 +4317,7 @@ var pxt;
                 'text_join': {
                     name: pxt.Util.lf("join items to create text"),
                     tooltip: pxt.Util.lf("Create a piece of text by joining together any number of items."),
-                    url: 'reference/text/join',
+                    url: '/reference/text/join',
                     category: 'text',
                     block: {
                         TEXT_JOIN_TITLE_CREATEWITH: pxt.Util.lf("join")
@@ -4289,7 +4326,7 @@ var pxt;
                 'procedures_defnoreturn': {
                     name: pxt.Util.lf("define the function"),
                     tooltip: pxt.Util.lf("Create a function."),
-                    url: 'types/function/define',
+                    url: '/types/function/define',
                     category: 'functions',
                     block: {
                         PROCEDURES_DEFNORETURN_TITLE: pxt.Util.lf("function"),
@@ -4299,7 +4336,7 @@ var pxt;
                 'procedures_callnoreturn': {
                     name: pxt.Util.lf("call the function"),
                     tooltip: pxt.Util.lf("Call the user-defined function."),
-                    url: 'types/function/call',
+                    url: '/types/function/call',
                     category: 'functions',
                     block: {
                         PROCEDURES_CALLNORETURN_TITLE: pxt.Util.lf("call function")
@@ -4308,7 +4345,7 @@ var pxt;
                 'function_return': {
                     name: pxt.Util.lf("return a value from within a function"),
                     tooltip: pxt.Util.lf("Return a value from within a user-defined function."),
-                    url: 'types/function/return',
+                    url: '/types/function/return',
                     category: 'functions',
                     block: {
                         message_with_value: pxt.Util.lf("return %1"),
@@ -4318,7 +4355,7 @@ var pxt;
                 'function_definition': {
                     name: pxt.Util.lf("define the function"),
                     tooltip: pxt.Util.lf("Create a function."),
-                    url: 'types/function/define',
+                    url: '/types/function/define',
                     category: 'functions',
                     block: {
                         FUNCTIONS_EDIT_OPTION: pxt.Util.lf("Edit Function")
@@ -4327,7 +4364,7 @@ var pxt;
                 'function_call': {
                     name: pxt.Util.lf("call the function"),
                     tooltip: pxt.Util.lf("Call the user-defined function."),
-                    url: 'types/function/call',
+                    url: '/types/function/call',
                     category: 'functions',
                     block: {
                         FUNCTIONS_CALL_TITLE: pxt.Util.lf("call"),
@@ -4337,7 +4374,7 @@ var pxt;
                 'function_call_output': {
                     name: pxt.Util.lf("call the function with a return value"),
                     tooltip: pxt.Util.lf("Call the user-defined function with a return value."),
-                    url: 'types/function/call',
+                    url: '/types/function/call',
                     category: 'functions',
                     block: {}
                 }