@breakside/jskit 2026.9.0 → 2026.11.0

package/Node/Docs/DocEnumOption.js

@@ -35,6 +35,9 @@
     },
 
     getTitle: function(){
+        if (this.parent.kind === "extension"){
+            return "%s.%s".sprintf(this.parent.extends, this.name);
+        }
         var title = "%s.%s".sprintf(this.parent.name, this.name);
         if (this.parent.parent && this.parent.parent.kind == 'class' || this.parent.parent.kind == 'protocol'){
             title = "%s.%s".sprintf(this.parent.parent.name, title);
@@ -57,7 +60,7 @@
                 elements.splice(index++, 0, params);
                 params.setAttribute("class", "parameters");
                 let header = params.appendChild(document.createElement("header"));
-                let h1 = header.appendChild(document.createElement("h1"));
+                let h1 = header.appendChild(document.createElement("h2"));
                 h1.setAttribute("outline-level", "1");
                 h1.appendChild(document.createTextNode("Parameters"));
                 let dl = fn.argumentListElement(document, this);
@@ -69,7 +72,7 @@
                 elements.splice(index++, 0, returnSection);
                 returnSection.setAttribute("class", "return");
                 let header = returnSection.appendChild(document.createElement("header"));
-                let h1 = header.appendChild(document.createElement("h1"));
+                let h1 = header.appendChild(document.createElement("h2"));
                 h1.setAttribute("outline-level", "1");
                 h1.appendChild(document.createTextNode("Return Value"));
 

package/Node/Docs/DocExtension.js

@@ -0,0 +1,130 @@
+// Copyright 2020 Breakside Inc.
+//
+// Licensed under the Breakside Public License, Version 1.0 (the "License");
+// you may not use this file except in compliance with the License.
+// If a copy of the License was not distributed with this file, you may
+// obtain a copy at
+//
+//     http://breakside.io/licenses/LICENSE-1.0.txt
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+// #import "DocTopicBasedComponent.js"
+'use strict';
+
+ JSClass("DocExtension", DocTopicBasedComponent, {
+
+    kind: 'extension',
+    defaultChildKind: 'property',
+
+    // --------------------------------------------------------------------
+    // MARK: - Creating and populating
+
+    extractPropertiesFromInfo: async function(info, documentation){
+        await DocExtension.$super.extractPropertiesFromInfo.call(this, info, documentation);
+        let i = this.name.indexOf("+");
+        if (i < 0){
+            i = this.name.indexOf("(");
+            if (i < 0){
+                throw new Error("Extension %s name must include a +".sprintf(this.name));
+            }
+        }
+        if (this.name[i] === "("){
+            this.extends = info.extends || this.name.substr(0, i).trim();
+            i += 1;
+            this.extensionName = this.name.substr(i, this.name.length - 1 - i);
+        }else{
+            this.extends = info.extends || this.name.substr(0, i);
+            this.extensionName = this.name.substr(i + 1);
+        }
+    },
+
+    populateRelationships: function(){
+        DocExtension.$super.populateRelationships.call(this);
+        var parts = this.extends.split('.');
+        this.extendsComponent = this.componentForName(parts.shift());
+        while (parts.length > 0 && this.extendsComponent !== null){
+            this.extendsComponent = this.extendsComponent.childForName(parts.shift());
+        }
+        if (this.extendsComponent !== null){
+            if (this.extendsComponent.kind === "class"){
+                this.extendsComponent.addExtension(this);
+            }else if (this.extendsComponent.kind === "enum"){
+                this.extendsComponent.addExtension(this);
+            }
+        }
+    },
+    
+    extends: null,
+    extensionName: null,
+    extendsComponent: null,
+
+    // --------------------------------------------------------------------
+    // MARK: - Naming
+
+    getDisplayNameForKind: function(){
+        return 'Extension';
+    },
+
+    // --------------------------------------------------------------------
+    // MARK: - Generating HTML
+
+    htmlArticleElements: function(document){
+        var elements = DocExtension.$super.htmlArticleElements.call(this, document);
+        var declaration = this.codeSectionElement(document, "Declaration", this.declarationCode(document));
+        declaration.setAttribute("class", "declaration");
+        elements.splice(1, 0, declaration);
+
+        let extension = document.createElement('section');
+        elements.push(extension);
+        extension.setAttribute("class", "extension");
+        let header = extension.appendChild(document.createElement("header"));
+        let h1 = header.appendChild(document.createElement("h2"));
+        h1.setAttribute("outline-level", "1");
+        h1.appendChild(document.createTextNode("Adds To"));
+        let p = extension.appendChild(document.createElement("p"));
+        let code = p.appendChild(document.createElement("code"));
+        let url = this.urlForCode(this.extends);
+        if (url !== null){
+            let a = code.appendChild(document.createElement("a"));
+            a.setAttribute("href", url.encodedString);
+            if (url.isAbsolute){
+                a.setAttribute("target", "_blank");
+                a.setAttribute("rel", "noopener noreferrer");
+            }
+            a.appendChild(document.createTextNode(this.extends));   
+        }else{
+            code.appendChild(document.createTextNode(this.extends));
+        }
+
+        return elements;
+    },
+
+    declarationCode: function(document){
+        var tokens = [];
+        if (this.extendsComponent !== null){
+            if (this.extendsComponent.kind === "enum"){
+                tokens.push({value: this.extends, link: true});
+                tokens.push({value: "+= { ... }"});
+            }else if (this.extendsComponent.kind === "class"){
+                if (this.extendsComponent.inherits){
+                    tokens.push({value: this.extends, link: true});
+                    tokens.push({value: ".definePropertiesFromExtensions({ ... })"});
+                }else{
+                }
+            }
+        }
+        if (tokens.length === 0){
+            tokens.push({value: this.extends, link: true});
+            tokens.push({value: "+= { ... }"});
+        }
+        var lines = [];
+        lines.push(this.codeLineFromTokens(document, tokens));
+        return lines;
+    },
+
+ });

package/Node/Docs/DocFunction.js

@@ -66,7 +66,7 @@
             elements.splice(index++, 0, params);
             params.setAttribute("class", "parameters");
             let header = params.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.setAttribute("outline-level", "1");
             h1.appendChild(document.createTextNode("Parameters"));
             let dl = this.argumentListElement(document, this);
@@ -78,7 +78,7 @@
             elements.splice(index++, 0, returnSection);
             returnSection.setAttribute("class", "return");
             let header = returnSection.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.setAttribute("outline-level", "1");
             h1.appendChild(document.createTextNode("Return Value"));
             if (this.valueType){
@@ -88,6 +88,10 @@
                 if (url){
                     let a = code.appendChild(document.createElement("a"));
                     a.setAttribute("href", url.encodedString);
+                    if (url.isAbsolute){
+                        a.setAttribute("target", "_blank");
+                        a.setAttribute("rel", "noopener noreferrer");
+                    }
                     a.appendChild(document.createTextNode(this.valueType));
                 }else{
                     code.appendChild(document.createTextNode(this.valueType));
@@ -149,6 +153,10 @@
                 if (url !== null){
                     let a = code.appendChild(document.createElement("a"));
                     a.setAttribute("href", url.encodedString);
+                    if (url.isAbsolute){
+                        a.setAttribute("target", "_blank");
+                        a.setAttribute("rel", "noopener noreferrer");
+                    }
                     a.appendChild(document.createTextNode(arg.type));
                 }else{
                     code.appendChild(document.createTextNode(arg.type));

package/Node/Docs/DocMethod.js

@@ -37,6 +37,9 @@
     
     getTitle: function(){
         if (this.isStatic){
+            if (this.parent.kind == "extension"){
+                return "%s.%s".sprintf(this.parent.extends, this.name);    
+            }
             return "%s.%s".sprintf(this.parent.name, this.name);
         }
         return this.name;

package/Node/Docs/DocProperty.js

@@ -45,6 +45,9 @@
 
     getTitle: function(){
         if (this.isStatic){
+            if (this.parent.kind === "extension"){
+                return "%s.%s".sprintf(this.parent.extends, this.name);    
+            }
             return "%s.%s".sprintf(this.parent.name, this.name);
         }
         return this.name;
@@ -62,7 +65,7 @@
             elements.splice(index++, 0, typeSection);
             typeSection.setAttribute("class", "return");
             let header = typeSection.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.appendChild(document.createTextNode("Value Type"));
             let p = typeSection.appendChild(document.createElement("p"));
             let code = p.appendChild(document.createElement("code"));
@@ -70,6 +73,10 @@
             if (url){
                 let a = code.appendChild(document.createElement("a"));
                 a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
                 a.appendChild(document.createTextNode(this.valueType));
             }else{
                 code.appendChild(document.createTextNode(this.valueType));
@@ -85,7 +92,7 @@
             section.setAttribute("class", "variations");
             elements.push(section);
             let header = section.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.appendChild(document.createTextNode("Alternate Forms"));
 
             let ul = section.appendChild(document.createElement("ul"));
@@ -97,6 +104,10 @@
                 li.setAttribute("class", variation.kind);
                 let a = document.createElement("a");
                 a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
                 let code = li.appendChild(document.createElement('code'));
                 code.appendChild(a);
                 a.appendChild(document.createTextNode(variation.name));

package/Node/Docs/DocProtocol.js

@@ -54,7 +54,7 @@
             elements.push(inherits);
             inherits.setAttribute("class", "inherits");
             let header = inherits.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.appendChild(document.createTextNode("Inherits From"));
             let p = inherits.appendChild(document.createElement("p"));
             let code = p.appendChild(document.createElement("code"));
@@ -62,6 +62,10 @@
             if (url !== null){
                 let a = code.appendChild(document.createElement("a"));
                 a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
                 a.appendChild(document.createTextNode(this.inherits));   
             }else{
                 code.appendChild(document.createTextNode(this.inherits));

package/Node/Docs/DocSpec.js

@@ -57,12 +57,16 @@
                     elements.push(inherits);
                     inherits.setAttribute("class", "inherits");
                     let header = inherits.appendChild(document.createElement("header"));
-                    let h1 = header.appendChild(document.createElement("h1"));
+                    let h1 = header.appendChild(document.createElement("h2"));
                     h1.appendChild(document.createTextNode("Inherits From"));
                     let p = inherits.appendChild(document.createElement("p"));
                     let code = p.appendChild(document.createElement("code"));
                     let a = code.appendChild(document.createElement("a"));
                     a.setAttribute("href", url.encodedString);
+                    if (url.isAbsolute){
+                        a.setAttribute("target", "_blank");
+                        a.setAttribute("rel", "noopener noreferrer");
+                    }
                     a.appendChild(document.createTextNode(inheritedSpec.title));
                 }
             }

package/Node/Docs/DocSpecProperty.js

@@ -42,7 +42,7 @@
             elements.splice(index++, 0, typeSection);
             typeSection.setAttribute("class", "return");
             let header = typeSection.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.appendChild(document.createTextNode("Resolved Value Type"));
             let p = typeSection.appendChild(document.createElement("p"));
             let code = p.appendChild(document.createElement("code"));
@@ -53,6 +53,10 @@
             if (url){
                 let a = code.appendChild(document.createElement("a"));
                 a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
                 a.appendChild(document.createTextNode(this.valueType));
             }else{
                 code.appendChild(document.createTextNode(this.valueType));
@@ -65,7 +69,7 @@
             section.setAttribute("class", "variations");
             elements.push(section);
             let header = section.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
+            let h1 = header.appendChild(document.createElement("h2"));
             h1.appendChild(document.createTextNode("Alternate Forms"));
 
             let ul = section.appendChild(document.createElement("ul"));
@@ -77,6 +81,10 @@
                 li.setAttribute("class", variation.kind);
                 let a = document.createElement("a");
                 a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
                 let code = li.appendChild(document.createElement('code'));
                 code.appendChild(a);
                 a.appendChild(document.createTextNode(variation.name));

package/Node/Docs/DocTopicBasedComponent.js

@@ -17,7 +17,7 @@
 /* global DocFunction */
 'use strict';
 
- JSClass("DocTopicBasedComponent", DocComponent, {
+JSClass("DocTopicBasedComponent", DocComponent, {
 
     topics: null,
     defaultChildKind: null,
@@ -75,73 +75,83 @@
     htmlArticleElements: function(document){
         var elements = DocTopicBasedComponent.$super.htmlArticleElements.call(this, document);
         if (this.topics.length > 0){
-            var topicsSection = document.createElement("section");
-            elements.push(topicsSection);
-            topicsSection.setAttribute("class", "topics");
-            let header = topicsSection.appendChild(document.createElement("header"));
-            let h1 = header.appendChild(document.createElement("h1"));
-            h1.setAttribute("outline-level", "1");
-            h1.appendChild(document.createTextNode("Topics"));
-            for (let i = 0, l = this.topics.length; i < l; ++i){
-                let topic = this.topics[i];
-                if (topic.members.length === 0) continue;
-                let section = topicsSection.appendChild(document.createElement("section"));
-                section.setAttribute("class", "topic");
-                let header = section.appendChild(document.createElement("header"));
-                let h1 = header.appendChild(document.createElement("h1"));
-                h1.appendChild(document.createTextNode(topic.name));
-                h1.setAttribute("outline-level", "2");
-                let div = section.appendChild(document.createElement('div'));
-                if (topic.summary){
-                    let markdown = this.createMarkdownWithString(topic.summary);
-                    let children = markdown.htmlElementsForDocument(document);
-                    for (let j = 0, k = children.length; j < k; ++j){
-                        div.appendChild(children[j]);
-                    }
+            elements = elements.concat(this.htmlArticleTopicsElements(document, "Topics", this.topics));
+        }
+        return elements;
+    },
+
+    htmlArticleTopicsElements: function(document, title, topics){
+        let elements = [];
+        var topicsSection = document.createElement("section");
+        elements.push(topicsSection);
+        topicsSection.setAttribute("class", "topics");
+        let header = topicsSection.appendChild(document.createElement("header"));
+        let h1 = header.appendChild(document.createElement("h2"));
+        h1.setAttribute("outline-level", "1");
+        h1.appendChild(document.createTextNode(title));
+        for (let i = 0, l = topics.length; i < l; ++i){
+            let topic = topics[i];
+            if (topic.members.length === 0) continue;
+            let section = topicsSection.appendChild(document.createElement("section"));
+            section.setAttribute("class", "topic");
+            let header = section.appendChild(document.createElement("header"));
+            let h1 = header.appendChild(document.createElement("h3"));
+            h1.appendChild(document.createTextNode(topic.name));
+            h1.setAttribute("outline-level", "2");
+            let div = section.appendChild(document.createElement('div'));
+            if (topic.summary){
+                let markdown = this.createMarkdownWithString(topic.summary);
+                let children = markdown.htmlElementsForDocument(document);
+                for (let j = 0, k = children.length; j < k; ++j){
+                    div.appendChild(children[j]);
                 }
-                let list = div.appendChild(document.createElement("ul"));
-                list.setAttribute("class", "members");
-                for (let j = 0, k = topic.members.length; j < k; ++j){
-                    let member = topic.members[j];
-                    let item = list.appendChild(document.createElement("li"));
-                    item.setAttribute("class", member.kind);
-                    let a = document.createElement("a");
-                    let url = this.urlForComponent(member);
-                    a.setAttribute("href", url.encodedString);
-                    if (member.kind == 'framework' || member.kind == 'document'){
-                        item.appendChild(a);
-                    }else{
-                        let code = item.appendChild(document.createElement('code'));
-                        let prefix = null;
-                        if (member.kind == 'method' || member.kind == 'property'){
-                            if (member.isStatic){
-                                prefix = 'static ';
-                            }
-                        }
-                        if (prefix === null){
-                            prefix = this.prefixForMember(member);
-                        }
-                        if (prefix !== null){
-                            code.appendChild(document.createTextNode(prefix));
-                            // let span = a.appendChild(document.createElement('span'));
-                            // span.setAttribute("class", "prefix");
-                            // span.appendChild(document.createTextNode(prefix + ' '));
-                        }
-                        code.appendChild(a);
-                        let suffix = this.suffixForMember(member);
-                        if (suffix !== null){
-                            code.appendChild(document.createTextNode(suffix));
+            }
+            let list = div.appendChild(document.createElement("ul"));
+            list.setAttribute("class", "members");
+            for (let j = 0, k = topic.members.length; j < k; ++j){
+                let member = topic.members[j];
+                let item = list.appendChild(document.createElement("li"));
+                item.setAttribute("class", member.kind);
+                let a = document.createElement("a");
+                let url = this.urlForComponent(member);
+                a.setAttribute("href", url.encodedString);
+                if (url.isAbsolute){
+                    a.setAttribute("target", "_blank");
+                    a.setAttribute("rel", "noopener noreferrer");
+                }
+                if (member.kind == 'framework' || member.kind == 'document'){
+                    item.appendChild(a);
+                }else{
+                    let code = item.appendChild(document.createElement('code'));
+                    let prefix = null;
+                    if (member.kind == 'method' || member.kind == 'property'){
+                        if (member.isStatic){
+                            prefix = 'static ';
                         }
                     }
-                    a.appendChild(document.createTextNode(this.nameForMember(member)));
-                    if (member.summary){
-                        let markdown = this.createMarkdownWithString(member.summary);
-                        let children = markdown.htmlElementsForDocument(document);
-                        for (let j = 0, k = children.length; j < k; ++j){
-                            item.appendChild(children[j]);
-                        }
-
+                    if (prefix === null){
+                        prefix = this.prefixForMember(member);
+                    }
+                    if (prefix !== null){
+                        code.appendChild(document.createTextNode(prefix));
+                        // let span = a.appendChild(document.createElement('span'));
+                        // span.setAttribute("class", "prefix");
+                        // span.appendChild(document.createTextNode(prefix + ' '));
                     }
+                    code.appendChild(a);
+                    let suffix = this.suffixForMember(member);
+                    if (suffix !== null){
+                        code.appendChild(document.createTextNode(suffix));
+                    }
+                }
+                a.appendChild(document.createTextNode(this.nameForMember(member)));
+                if (member.summary){
+                    let markdown = this.createMarkdownWithString(member.summary);
+                    let children = markdown.htmlElementsForDocument(document);
+                    for (let j = 0, k = children.length; j < k; ++j){
+                        item.appendChild(children[j]);
+                    }
+
                 }
             }
         }
@@ -172,4 +182,4 @@
         return obj;
     }
 
- });
+});

package/Node/Documentation.js

@@ -20,6 +20,7 @@
 // #import "DocIndex.js"
 // #import "DocFramework.js"
 // #import "DocClass.js"
+// #import "DocExtension.js"
 // #import "DocProtocol.js"
 // #import "DocMethod.js"
 // #import "DocInit.js"
@@ -44,6 +45,7 @@ JSClass("Documentation", JSObject, {
         this.fileManager = fileManager;
     },
 
+    customStylesheetURL: null,
     stylesheetURL: null,
     rootURL: null,
     outputDirectoryURL: null,
@@ -61,6 +63,7 @@ JSClass("Documentation", JSObject, {
         await this.copyStyles();
         let rootComponent = await this.loadSource(this.rootURL);
         rootComponent.outputURL = this.wwwURL.appendingPathComponent('index.html');
+        rootComponent.populateRelationships();
         await this.output([rootComponent]);
         await this.outputComponentsJSON(rootComponent);
         await this.outputManifestConfig(rootComponent);
@@ -197,17 +200,35 @@ JSClass("Documentation", JSObject, {
         var stylesURL = this.wwwURL.appendingPathComponent('_style', true);
         var metadata = JSBundle.mainBundle.metadataForResourceName('doc-default', 'css');
         var contents = await JSBundle.mainBundle.getResourceData(metadata);
-        this.stylesheetURL = stylesURL.appendingPathComponent('default.css');
-        await this.fileManager.createFileAtURL(this.stylesheetURL, contents);
+        var defaultStyleURL = stylesURL.appendingPathComponent('default.css');
+        await this.fileManager.createFileAtURL(defaultStyleURL, contents);
+        if (this.customStylesheetURL !== null){
+            var customStyleURL = stylesURL.appendingPathComponent(this.customStylesheetURL.lastPathComponent);
+            await this.fileManager.copyItemAtURL(this.customStylesheetURL, customStyleURL);
+            this.stylesheetURL = customStyleURL;
+        }else{
+            this.stylesheetURL = defaultStyleURL;
+        }
     },
 
     loadSource: async function(url){
-        this.printer.setStatus("Reading %s...".sprintf(url.lastPathComponent));
-        let exists = await this.fileManager.itemExistsAtURL(url);
-        if (!exists){
+        if (url.scheme === "jskit"){
+            if (!this.hasAttemptedJSKitDownload){
+                await this.downloadJSKitDocumentation();
+            }
+            url = JSURL.initWithString(url.path + ".doc.yaml", this.jskitDocumenationLocalURL);
+        }
+        let contents = null;
+        if (url.scheme === JSFileManager.Scheme.file){
+            this.printer.setStatus("Reading %s...".sprintf(url.lastPathComponent));
+            let exists = await this.fileManager.itemExistsAtURL(url);
+            if (exists){
+                contents = await this.fileManager.contentsAtURL(url);
+            }
+        }
+        if (contents === null){
             return null;
         }
-        let contents = await this.fileManager.contentsAtURL(url);
         let yaml = contents.stringByDecodingUTF8();
         let info = jsyaml.safeLoad(yaml);
         if (!info.name){
@@ -219,8 +240,64 @@ JSClass("Documentation", JSObject, {
         return component;
     },
 
+    jskitVersion: JSLazyInitProperty(() => JSBundle.mainBundle.info.JSBundleVersion),
+
+    jskitDocumenationRemoteURL: JSLazyInitProperty(function(){
+        let url = JSURL.initWithString("https://github.com/breakside/JSKit/archive/refs/tags/");
+        url.appendPathComponent("v" + this.jskitVersion + ".zip");
+        return url;
+    }),
+
+    jskitDocumenationLocalURL: JSLazyInitProperty(function(){
+        return JSURL.initWithString("JSKit", this.rootURL).appendingPathComponent(this.jskitVersion, true);
+    }),
+
+    hasAttemptedJSKitDownload: false,
+
+    downloadJSKitDocumentation: async function(){
+        if (!this.hasAttemptedJSKitDownload){
+            this.hasAttemptedJSKitDownload = true;
+            let exists = await this.fileManager.itemExistsAtURL(this.jskitDocumenationLocalURL);
+            if (!exists){
+                this.printer.setStatus("Downloading JSKit docs...");
+                let task = JSURLSession.shared.dataTaskWithURL(this.jskitDocumenationRemoteURL);
+                let response = await task.resume();
+                if (response.statusClass === JSURLResponse.StatusClass.success){
+                    this.printer.setStatus("Unzipping JSKit docs...");
+                    let zip = JSZip.initWithData(response.data);
+                    if (zip !== null){
+                        let docsPrefix = "JSKit-" + this.jskitVersion + "/Documentation/Code/";
+                        let url;
+                        let contents;
+                        for (let filename of zip.filenames){
+                            if (filename.startsWith(docsPrefix) && !filename.endsWith("/")){
+                                contents = zip.dataForFilename(filename);
+                                if (contents !== null){
+                                    filename = filename.substr(docsPrefix.length);
+                                    url = JSURL.initWithString(filename, this.jskitDocumenationLocalURL);
+                                    await this.fileManager.createFileAtURL(url, contents);
+                                }else{
+                                    throw new Error("could not extract " + filename);
+                                }
+                            }
+                        }
+                    }else{
+                        throw new Error("Could not read zip");
+                    }
+                }else{
+                    throw new Error("Response status is %d".sprintf(response.statusCode));
+                }
+            }
+        }
+    },
+
     createComponentFromInfo: async function(info, baseURL, defaultKind){
         if (typeof(info) === 'string'){
+            if (info.startsWith("jskit:")){
+                let url = JSURL.initWithString(info);
+                let component = await this.loadSource(url);
+                return component;
+            }
             let url = JSURL.initWithString(info + '.doc.yaml', baseURL);
             url.standardize();
             let component = await this.loadSource(url);

package/Node/HTMLBuilder.js

@@ -1197,7 +1197,9 @@ JSClass("HTMLBuilder", Builder, {
                         this.httpServer.tlsKeyFileURL = JSURL.initWithString(this.arguments['tls-key'], this.workingDirectoryURL);
                     }
                 }
-                this.httpServer.run();
+                await this.httpServer.run();
+            }else{
+                await this.httpServer.reload();
             }
         }else{
             if (this.httpServer !== null){