Add fastboot/prember

addon/components/docs-header/index.js

@@ -87,7 +87,9 @@ export default class DocsHeader extends Component {
   @action
   didVisitPage() {
     this.query = null;
-    let search = document.querySelector('[data-search-box-input]');
-    search.blur();
+    if (typeof document !== 'undefined') {
+      let search = document.querySelector('[data-search-box-input]');
+      search?.blur();
+    }
   }
 }

addon/components/docs-header/search-box/index.js

@@ -22,6 +22,8 @@ export default class DocsHeaderSearchBox extends Component {
 
   @action
   focusSearch() {
+    if (typeof document === 'undefined') return;
+
     if (!formElementHasFocus()) {
       this.element.querySelector('input').focus();
     }

addon/components/docs-modal-dialog.js

@@ -7,6 +7,10 @@ export default class DocsModalDialog extends ModalDialog {
     super.init(...arguments);
 
     const config = getOwner(this).resolveRegistration('config:environment');
-    this.set('renderInPlace', config.environment === 'test');
+    let fastboot = getOwner(this).lookup('service:fastboot');
+    this.set(
+      'renderInPlace',
+      config.environment === 'test' || fastboot?.isFastBoot,
+    );
   }
 }

addon/components/docs-viewer/x-main/index.js

@@ -21,6 +21,8 @@ export default class XMain extends Component {
 
   @action
   setupElement(element) {
+    if (typeof MutationObserver === 'undefined') return;
+
     let target = element.querySelector('[data-current-page-index-target]');
 
     this._mutationObserver = new MutationObserver(

addon/keyboard-config.js

@@ -9,6 +9,8 @@ const TAGNAMES_THAT_WHEN_FOCUSED_PREVENT_KEYBOARD_SHORTCUTS = [
   @hide
 */
 export function formElementHasFocus() {
+  if (typeof document === 'undefined') return false;
+
   return TAGNAMES_THAT_WHEN_FOCUSED_PREVENT_KEYBOARD_SHORTCUTS.includes(
     document.activeElement.tagName,
   );

addon/services/docs-search.js

@@ -1,4 +1,5 @@
 import Service from '@ember/service';
+import { getOwner } from '@ember/application';
 import lunr from 'lunr';
 import { task } from 'ember-concurrency';
 import {
@@ -12,6 +13,7 @@ export default class DocsSearch extends Service {
   async search(phrase) {
     const { searchTokenSeparator } = getAddonDocsConfig(this);
     let { index, documents } = await this.loadSearchIndex();
+    if (!index) return [];
     let words = phrase.toLowerCase().split(new RegExp(searchTokenSeparator));
     let results = index.query((query) => {
       // In the future we could boost results based on the field they come from
@@ -91,6 +93,12 @@ export default class DocsSearch extends Service {
 
   _loadSearchIndex = task({ enqueue: true }, async () => {
     if (!this._searchIndex) {
+      let fastboot = getOwner(this).lookup('service:fastboot');
+      if (fastboot?.isFastBoot) {
+        this._searchIndex = { index: null, documents: {} };
+        return this._searchIndex;
+      }
+
       let response = await fetch(this._indexURL);
       let json = await response.json();
 

addon/services/docs-store.js

@@ -1,4 +1,6 @@
+/* global FastBoot */
 import Service from '@ember/service';
+import { getOwner } from '@ember/application';
 import { tracked } from '@glimmer/tracking';
 import { getRootURL } from 'ember-cli-addon-docs/-private/config';
 
@@ -52,11 +54,76 @@ export default class DocsStoreService extends Service {
   }
 
   async _fetchProject(id) {
-    let namespace = `${getRootURL(this).replace(/\/$/, '')}/docs`;
-    let url = `${namespace}/${id}.json`;
-
-    let response = await fetch(url);
-    let payload = await response.json();
+    let payload;
+
+    let fastboot = getOwner(this).lookup('service:fastboot');
+    if (fastboot?.isFastBoot) {
+      // In FastBoot, use Node's http module to fetch from the local server
+      // that prember/fastboot is running
+      let http = FastBoot.require('http');
+      let request = fastboot.request;
+      // Derive host and protocol from the FastBoot/Node request in a standards-based way
+      let host =
+        (request &&
+          request.headers &&
+          (request.headers.host || request.headers.Host)) ||
+        request.host;
+      let protocol =
+        (request && request.protocol) ||
+        (request &&
+          request.headers &&
+          (request.headers['x-forwarded-proto'] ||
+            request.headers['X-Forwarded-Proto'])) ||
+        'http';
+      let url = `${protocol}://${host}/docs/${id}.json`;
+
+      let data = await new Promise((resolve, reject) => {
+        let req = http.get(url, (res) => {
+          res.setEncoding('utf8');
+          let body = '';
+          res.on('data', (chunk) => {
+            body += chunk;
+          });
+          res.on('end', () => {
+            let statusCode = res.statusCode || 0;
+            if (statusCode >= 200 && statusCode < 300) {
+              resolve(body);
+            } else {
+              reject(
+                new Error(`Request to ${url} failed with status ${statusCode}`),
+              );
+            }
+          });
+          res.on('error', reject);
+        });
+
+        req.on('error', reject);
+        // Basic timeout so prember/fastboot failures don't hang indefinitely
+        req.setTimeout(10000, () => {
+          req.abort();
+          reject(new Error(`Request to ${url} timed out`));
+        });
+      });
+
+      payload = JSON.parse(data);
+    } else {
+      let namespace = `${getRootURL(this).replace(/\/$/, '')}/docs`;
+      let url = `${namespace}/${id}.json`;
+      let response;
+      try {
+        response = await fetch(url);
+      } catch (e) {
+        throw new Error(
+          `Network error while fetching ${url}: ${e && e.message}`,
+        );
+      }
+      if (!response.ok) {
+        throw new Error(
+          `Request to ${url} failed with status ${response.status}`,
+        );
+      }
+      payload = await response.json();
+    }
 
     this._loadPayload(payload);
 

addon/services/project-version.js

@@ -1,4 +1,5 @@
 import Service from '@ember/service';
+import { getOwner } from '@ember/application';
 import { task } from 'ember-concurrency';
 import { tracked } from '@glimmer/tracking';
 import {
@@ -12,6 +13,18 @@ export default class ProjectVersionService extends Service {
   @addonDocsConfig config;
 
   _loadAvailableVersions = task(async () => {
+    let fastboot = getOwner(this).lookup('service:fastboot');
+    if (fastboot?.isFastBoot) {
+      this.versions = [
+        {
+          ...this.currentVersion,
+          truncatedSha: this.currentVersion.sha?.substr(0, 5) || '',
+          key: this.config.latestVersionName,
+        },
+      ];
+      return;
+    }
+
     let response = await fetch(`${this.root}versions.json`);
     let json;
     if (response.ok) {
@@ -32,6 +45,7 @@ export default class ProjectVersionService extends Service {
   });
 
   redirectTo(version) {
+    if (typeof window === 'undefined') return;
     window.location.href = `${this.root}${version.path}`;
   }
 

blueprints/ember-cli-addon-docs/index.js

@@ -19,34 +19,13 @@ module.exports = {
         'ember-cli-deploy-build',
         'ember-cli-deploy-git',
         'ember-cli-deploy-git-ci',
+        'ember-cli-fastboot',
+        'prember',
       ],
     });
   },
 
-  afterInstall(options) {
-    let configPath = require.resolve(this.project.configPath());
-    let configContents = fs.readFileSync(configPath, 'utf-8');
-
-    if (configContents.indexOf('ADDON_DOCS_ROOT_URL') === -1) {
-      configContents = configContents.replace(
-        /([ \t]+)if \(environment === 'production'\) {/,
-        [
-          '$&',
-          '$1  // Allow ember-cli-addon-docs to update the rootURL in compiled assets',
-          "$1  ENV.rootURL = '/ADDON_DOCS_ROOT_URL/';",
-        ].join('\n'),
-      );
-
-      if (configContents.indexOf('ADDON_DOCS_ROOT_URL') === -1) {
-        this.ui.writeWarnLine(
-          `Unable to update rootURL configuration. You should update ${configPath} so that your rootURL is ` +
-            `the string '/ADDON_DOCS_ROOT_URL/' in production.`,
-        );
-      }
-    }
-
-    fs.writeFileSync(configPath, configContents, 'utf-8');
-
+  afterInstall() {
     if (fs.existsSync('.npmignore')) {
       this.insertIntoFile('.npmignore', '/config/addon-docs.js');
     }

index.js

@@ -130,6 +130,13 @@ module.exports = {
       }
     }
 
+    // Set up prember for static site generation if not already configured
+    if (!includer.options.prember) {
+      includer.options.prember = {
+        urls: require('./lib/prember-urls'),
+      };
+    }
+
     includer.options.includeFileExtensionInSnippetNames =
       includer.options.includeFileExtensionInSnippetNames || false;
     if (!includer.options.snippetSearchPaths) {

lib/prember-urls.js

@@ -0,0 +1,94 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Prember URL enumeration for ember-cli-addon-docs.
+ *
+ * Automatically discovers all documentation pages by reading
+ * the generated docs JSON and search index from the build output.
+ *
+ * Usage in ember-cli-build.js:
+ *
+ *   const app = new EmberAddon(defaults, {
+ *     prember: {
+ *       urls: require('ember-cli-addon-docs/lib/prember-urls'),
+ *     },
+ *   });
+ *
+ * @param {Object} options
+ * @param {string} options.distDir - Path to the built dist directory
+ * @returns {string[]} Array of URLs to pre-render
+ */
+module.exports = function premberUrls({ distDir }) {
+  let urls = new Set(['/']);
+
+  // Discover guide/template pages and API pages from the search index.
+  // The search index contains all indexed documents with their route info.
+  let searchIndexPath = path.join(
+    distDir,
+    'ember-cli-addon-docs',
+    'search-index.json',
+  );
+
+  if (fs.existsSync(searchIndexPath)) {
+    let searchIndex = JSON.parse(fs.readFileSync(searchIndexPath, 'utf8'));
+
+    for (let doc of Object.values(searchIndex.documents || {})) {
+      if (doc.type === 'template' && doc.route) {
+        // Skip internal/non-page routes
+        if (
+          doc.route === 'application' ||
+          doc.route === 'not-found' ||
+          doc.route.startsWith('templates.') ||
+          doc.route.startsWith('pods.')
+        ) {
+          continue;
+        }
+
+        let routePath = doc.route.replace(/\./g, '/').replace(/\/index$/, '');
+        if (routePath === 'index') routePath = '';
+        urls.add('/' + routePath);
+      }
+    }
+  }
+
+  // Discover API pages from the main project's docs JSON navigationIndex.
+  // We read all JSON files in docs/ and use the project ID to build URLs.
+  // The main project maps to /docs/api/, additional projects would need
+  // custom URL mapping from the consuming app.
+  let docsDir = path.join(distDir, 'docs');
+
+  if (fs.existsSync(docsDir)) {
+    let files = fs
+      .readdirSync(docsDir)
+      .filter((f) => f.endsWith('.json'))
+      .sort();
+
+    for (let i = 0; i < files.length; i++) {
+      let docsJson = JSON.parse(
+        fs.readFileSync(path.join(docsDir, files[i]), 'utf8'),
+      );
+      let projectData = Array.isArray(docsJson.data)
+        ? docsJson.data[0]
+        : docsJson.data;
+      let navIndex = projectData?.attributes?.navigationIndex || [];
+
+      // Only generate /docs/api/ URLs for the first (alphabetically)
+      // project. Additional projects have their own route prefixes
+      // that we can't determine automatically.
+      if (files.length === 1 || i === 0) {
+        urls.add('/docs');
+
+        for (let section of navIndex) {
+          for (let item of section.items) {
+            urls.add(`/docs/api/${item.path}`);
+          }
+        }
+      }
+    }
+  }
+
+  return [...urls];
+};