@pb33f/cowboy-components 0.14.1 → 0.15.0

package/dist/components/the-doctor/the-doctor.js

@@ -4,6 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
+var TheDoctor_1;
 import '@shoelace-style/shoelace/dist/components/split-panel/split-panel.js';
 import '@shoelace-style/shoelace/dist/components/tab-group/tab-group.js';
 import '@shoelace-style/shoelace/dist/components/tab-panel/tab-panel.js';
@@ -17,7 +18,7 @@ import { customElement, property, query, state } from "lit/decorators.js";
 import { html, LitElement, nothing } from "lit";
 import { ref, createRef } from "lit/directives/ref.js";
 import { SpecEditor } from "../editor/editor.js";
-import { ActiveView, AddToast, ArchiveURLRequested, BuiltInRulesetChanged, CreditEmpty, CustomRulesetEnabled, DocumentReferenceClicked, EditorClicked, EditorUpdated, ExplorerEqualizerChanged, ExplorerEqualizerFiltered, ExplorerPovModeExit, ExplorerNodeClicked, ExportRuleset, LoadRenderedNodeIntoInspector, ModelTreeNodeClicked, NodeReferenceClicked, NukeWorkspaceEvent, OpenDrawer, OpenSettings, ProblemClicked, Reboot, RolodexRootFileSelected, RolodexTreeNodeClicked, RuleClicked, RulesetSaved, RuleViolationClicked, StartSessionFailed, CreditStreamUpdated, SocketDisconnected, DiagramRequested, TimelineViolationsLoaded, BundleRequested, BundleDownloadRequested, BundleCopyRequested, } from "../../events/doctor.js";
+import { ActiveView, AddToast, ArchiveURLRequested, BuiltInRulesetChanged, CreditEmpty, CustomRulesetEnabled, DocumentReferenceClicked, EditorClicked, EditorUpdated, ExplorerEqualizerChanged, ExplorerEqualizerFiltered, ExplorerPovModeExit, ExplorerNodeClicked, ExportRuleset, LoadRenderedNodeIntoInspector, ModelTreeNodeClicked, NodeReferenceClicked, NukeWorkspaceEvent, OpenDrawer, OpenSettings, ProblemClicked, Reboot, RolodexRootFileSelected, RolodexTreeNodeClicked, RuleClicked, RulesetSaved, RuleViolationClicked, StartSessionFailed, CreditStreamUpdated, SocketDisconnected, DiagramRequested, TimelineViolationsLoaded, BundleRequested, BundleDownloadRequested, BundleCopyRequested, PrintingPressZipExportRequested, PrintingPressTarballExportRequested, } from "../../events/doctor.js";
 import { CreateBagManager } from "@pb33f/saddlebag";
 import { LintingService } from "../../services/linting-service.js";
 import { ProblemList } from "../problem-list/problem-list.js";
@@ -49,6 +50,8 @@ import spinnerCss from "../../css/spinner.css.js";
 import { resolveNodeIdFromHash } from "../../utils/node-helpers.js";
 import { UploadArchiveComponent } from "./upload-archive.js";
 import '../premium-gate/premium-gate.js';
+import './printing-press-docs-unavailable.js';
+import './printing-press-export-controls.js';
 import tooltipCss from "../../css/tooltip.css.js";
 import { NukeWorkspaceComponent } from "./nuke-workspace.js";
 import { CreditTicker } from "../credit-ticker/credit-ticker.js";
@@ -76,13 +79,14 @@ import { GitHubController } from "../../controllers/github-controller.js";
 import { DiagramatronController } from "../../controllers/diagramatron-controller.js";
 import { TimelineController } from "../../controllers/timeline-controller.js";
 import { BundleController } from "../../controllers/bundle-controller.js";
-import { ApiKeyController } from "../../controllers/api-key-controller.js";
+import { PB33F_THEME, DarkTheme } from "../theme-switcher/theme-switcher.js";
+import { PB33F_THEME_CHANGE } from "../../events/theme.js";
 import '../bundle-toolbar/bundle-toolbar.js';
 import { WorkspaceService } from '../../services/workspace-service.js';
 import { WalletService } from '../../services/wallet-service.js';
 import { GlobalTaskService } from '../../services/global-task-service.js';
 import { GitHubService } from '../../services/github-service.js';
-import { ApiKeyService } from '../../services/api-key-service.js';
+import { PrintingPressService } from '../../services/printing-press-service.js';
 import { GenericDetailsDrawer } from '../details-drawer/generic-details-drawer.js';
 import { DrawerContentRegistry } from '../../services/drawer-content-registry.js';
 import { TabCacheController } from '../../controllers/tab-cache-controller.js';
@@ -128,13 +132,18 @@ export const GitHubStateBag = "pb33f-doctor-github-state";
 export const DefaultDocument = "pb33f-doctor-document";
 export const DocumentProblems = "pb33f-doctor-problems";
 export const DoctorEndpoint = "doctor-endpoint";
-let TheDoctor = class TheDoctor extends LitElement {
+let TheDoctor = TheDoctor_1 = class TheDoctor extends LitElement {
     constructor(doctorEndpoint = "https://doctor.pb33f.io") {
         super();
         this.toolsEditorHasContent = false;
         this.editorDirty = false;
         this.bundleLoading = false;
         this.isBundled = false;
+        this.printingPressDocsPending = false;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = false;
+        this.docsTakeoverApplied = false;
         // Use ref directives instead of @query for better control
         this.tardisControlRef = createRef();
         this.editorRef = createRef();
@@ -168,7 +177,6 @@ let TheDoctor = class TheDoctor extends LitElement {
         WalletService.doctorEndpoint = this.doctorEndpoint;
         GlobalTaskService.doctorEndpoint = this.doctorEndpoint;
         GitHubService.doctorEndpoint = this.doctorEndpoint;
-        ApiKeyService.doctorEndpoint = this.doctorEndpoint;
         // bus it up
         this.bus = CreateBus();
         this.events = createDoctorEventChannels(this.bus);
@@ -235,12 +243,7 @@ let TheDoctor = class TheDoctor extends LitElement {
             requestUpdate: () => this.requestUpdate(),
             getOriginalFileName: () => this.rolodexRootPath || 'openapi'
         });
-        this.apiKeyController = new ApiKeyController({
-            getBrokerId: () => this.brokerController?.brokerConnectionId,
-            sendToast: (toast) => this.sendToast(toast)
-        });
-        // Initialize workspace view after GitHub controller and API key controller are created
-        this.workspaceController.initializeView(this.githubController, this.apiKeyController);
+        this.workspaceController.initializeView(this.githubController);
         this.globalTaskView = new GlobalTaskView();
         //this.globalTaskView.mockMode = true; // Enable mock mode for demo
         this.globalTaskView.setController(this.globalTaskController);
@@ -388,6 +391,10 @@ let TheDoctor = class TheDoctor extends LitElement {
         this.addTrackedListener(this, BundleRequested, this.handleBundleRequested.bind(this));
         this.addTrackedListener(this, BundleDownloadRequested, this.handleBundleDownload.bind(this));
         this.addTrackedListener(this, BundleCopyRequested, this.handleBundleCopy.bind(this));
+        this.addTrackedListener(this, PrintingPressZipExportRequested, this.handlePrintingPressZipExport.bind(this));
+        this.addTrackedListener(this, PrintingPressTarballExportRequested, this.handlePrintingPressTarballExport.bind(this));
+        this.addTrackedListener(window, 'message', this.handlePrintingPressMessage.bind(this));
+        this.addTrackedListener(window, PB33F_THEME_CHANGE, this.handleThemeChangeForPrintingPress.bind(this));
         // hijack navigation buttons - store reference for cleanup
         this.popstateHandler = (e) => {
             const state = e.state;
@@ -448,7 +455,9 @@ let TheDoctor = class TheDoctor extends LitElement {
             'feedback': 'Feedback'
         };
         this.currentViewName = viewNames[tabName] || tabName;
-        this.managePanelFocus(this.sidebarPanel, tabName);
+        if (event.detail.focusPanel !== false) {
+            this.managePanelFocus(this.sidebarPanel, tabName);
+        }
     }
     openSidebar() {
         if (this.sidebarClosed && this.sidebarPanel) {
@@ -490,6 +499,7 @@ let TheDoctor = class TheDoctor extends LitElement {
             'spec': 'Specification Editor',
             'explorer': 'Explorer',
             'tardis': 'Timeline',
+            'docs': 'API Docs',
             'workspaces': 'Workspaces'
         };
         this.currentViewName = viewNames[tabName] || tabName;
@@ -529,6 +539,7 @@ let TheDoctor = class TheDoctor extends LitElement {
             case 'docs':
                 this.hideMinimapIcon();
                 this.hideDiagnosisButton();
+                this.preloadPrintingPressDocs();
                 break;
         }
     }
@@ -661,6 +672,12 @@ let TheDoctor = class TheDoctor extends LitElement {
                 // Don't fetch history here - wait until doctor is fully booted
             }
         });
+        this.syncDocsTakeoverLayout();
+    }
+    updated(changedProperties) {
+        if (changedProperties.has('selectedEditorTab')) {
+            this.syncDocsTakeoverLayout();
+        }
     }
     disconnectedCallback() {
         super.disconnectedCallback();
@@ -730,8 +747,54 @@ let TheDoctor = class TheDoctor extends LitElement {
     sendToast(toast) {
         this.toastManager.addToastManually(toast);
     }
-    updateInspectorDivider() { this.panelDividerManager.updateInspectorDivider(); }
-    updateExplorerDivider() { this.panelDividerManager.updateExplorerDivider(); }
+    updateInspectorDivider() {
+        if (this.selectedEditorTab === 'docs')
+            return;
+        this.panelDividerManager.updateInspectorDivider();
+    }
+    updateExplorerDivider() {
+        if (this.selectedEditorTab === 'docs')
+            return;
+        this.panelDividerManager.updateExplorerDivider();
+    }
+    syncDocsTakeoverLayout() {
+        const docsActive = this.selectedEditorTab === 'docs';
+        const explorerPanel = this.splitPanelExplorer;
+        const inspectorPanel = this.splitPanelInspector;
+        if (!explorerPanel || !inspectorPanel) {
+            return;
+        }
+        if (docsActive) {
+            if (!this.docsTakeoverApplied) {
+                this.explorerPositionBeforeDocs = explorerPanel.position > 0 ? explorerPanel.position : 12;
+                this.inspectorPositionBeforeDocs = inspectorPanel.position > 0 ? inspectorPanel.position : 50;
+                this.docsTakeoverApplied = true;
+            }
+            explorerPanel.style.setProperty('--min', '0');
+            explorerPanel.style.setProperty('--max', '100%');
+            explorerPanel.position = 0;
+            explorerPanel.disabled = true;
+            inspectorPanel.style.setProperty('--min', '0');
+            inspectorPanel.style.setProperty('--max', '100%');
+            inspectorPanel.position = 100;
+            inspectorPanel.disabled = true;
+            return;
+        }
+        if (!this.docsTakeoverApplied) {
+            return;
+        }
+        explorerPanel.style.removeProperty('--min');
+        explorerPanel.style.removeProperty('--max');
+        explorerPanel.disabled = false;
+        explorerPanel.position = this.explorerPositionBeforeDocs ?? 12;
+        inspectorPanel.style.removeProperty('--min');
+        inspectorPanel.style.removeProperty('--max');
+        inspectorPanel.disabled = false;
+        inspectorPanel.position = this.inspectorPositionBeforeDocs ?? 50;
+        this.docsTakeoverApplied = false;
+        this.explorerPositionBeforeDocs = undefined;
+        this.inspectorPositionBeforeDocs = undefined;
+    }
     updateRefmapBag(currentPath, result) {
         let refMap = this.referenceMapBag?.get(ReferenceMapBag);
         let cp = currentPath ?? "";
@@ -831,6 +894,468 @@ let TheDoctor = class TheDoctor extends LitElement {
     handleBundleCopy() {
         this.bundleController.copyToClipboard();
     }
+    async handlePrintingPressZipExport() {
+        await this.handlePrintingPressExport('zip');
+    }
+    async handlePrintingPressTarballExport() {
+        await this.handlePrintingPressExport('tar.gz');
+    }
+    async handlePrintingPressExport(format) {
+        try {
+            await PrintingPressService.exportDocs(format, this.brokerController?.brokerConnectionId);
+            this.sendToast({
+                id: crypto.randomUUID(),
+                type: ToastType.SUCCESS,
+                title: "docs exported",
+                body: `Printing Press docs exported as ${format}.`
+            });
+        }
+        catch (error) {
+            this.sendToast({
+                id: crypto.randomUUID(),
+                type: ToastType.ERROR,
+                title: "docs export failed",
+                body: error?.detail || error?.title || 'Unable to export generated docs.'
+            });
+        }
+    }
+    handlePrintingPressTask(taskId) {
+        this.clearPrintingPressDocsReadyWatchdog();
+        this.printingPressDocsTaskId = taskId;
+        this.printingPressDocsPending = true;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsError = undefined;
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = false;
+        this.printingPressDocsUrl = undefined;
+        this.printingPressDocsExpectedOrigin = undefined;
+        this.requestUpdate();
+        this.globalTaskController.waitForTask(taskId).then(async (task) => {
+            if (this.printingPressDocsTaskId !== taskId) {
+                return;
+            }
+            if (task.status !== 'completed') {
+                this.printingPressDocsPending = false;
+                this.printingPressDocsReady = false;
+                this.printingPressDocsUrl = undefined;
+                this.printingPressDocsExpectedOrigin = undefined;
+                this.printingPressDocsError = task.error || task.message || 'Printing Press failed to build generated docs.';
+                this.printingPressDocsAccessDenied = this.isPrintingPressAccessDeniedError(task);
+                this.printingPressDocsRetryableError = true;
+                this.requestUpdate();
+                return;
+            }
+            await this.loadPrintingPressDocsForTask(taskId);
+        });
+    }
+    preloadPrintingPressDocs(options = {}) {
+        this.tabCache.markEditorTabLoaded('docs');
+        if (this.printingPressDocsPending && !options.refresh) {
+            return;
+        }
+        if (!options.refresh && this.printingPressDocsUrl && !this.printingPressDocsError) {
+            return;
+        }
+        if (!options.refresh && this.printingPressDocsError && !this.printingPressDocsRetryableError) {
+            return;
+        }
+        this.clearPrintingPressDocsReadyWatchdog();
+        const requestId = this.createPrintingPressRequestId();
+        this.printingPressDocsTaskId = requestId;
+        this.printingPressDocsPending = true;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsError = undefined;
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = false;
+        this.printingPressDocsUrl = undefined;
+        this.printingPressDocsExpectedOrigin = undefined;
+        this.requestUpdate();
+        void this.loadCurrentPrintingPressDocs(requestId);
+    }
+    markPrintingPressDocsUnavailable(detail) {
+        this.clearPrintingPressDocsReadyWatchdog();
+        this.printingPressDocsTaskId = undefined;
+        this.printingPressDocsPending = false;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsError = detail;
+        this.printingPressDocsAccessDenied = this.isPrintingPressAccessDeniedError({ detail });
+        this.printingPressDocsRetryableError = false;
+        this.printingPressDocsUrl = undefined;
+        this.printingPressDocsExpectedOrigin = undefined;
+        this.requestUpdate();
+    }
+    resetPrintingPressDocsState() {
+        this.clearPrintingPressDocsReadyWatchdog();
+        this.printingPressDocsTaskId = undefined;
+        this.printingPressDocsPending = false;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsError = undefined;
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = false;
+        this.printingPressDocsUrl = undefined;
+        this.printingPressDocsExpectedOrigin = undefined;
+    }
+    async loadCurrentPrintingPressDocs(requestId) {
+        try {
+            const brokerId = this.brokerController?.brokerConnectionId;
+            const result = await PrintingPressService.ensureWorkspaceDocs(brokerId);
+            if (this.printingPressDocsTaskId !== requestId) {
+                return;
+            }
+            if (result.status !== 'completed') {
+                if (!result.taskId) {
+                    throw new Error('Printing Press did not return a task ID.');
+                }
+                this.handlePrintingPressTask(result.taskId);
+                return;
+            }
+            await this.loadPrintingPressDocsFromResult(requestId, result, brokerId);
+        }
+        catch (error) {
+            if (this.printingPressDocsTaskId !== requestId) {
+                return;
+            }
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = false;
+            this.printingPressDocsExpectedOrigin = undefined;
+            this.printingPressDocsError = error?.detail || error?.message || 'Unable to load generated docs.';
+            this.printingPressDocsAccessDenied = this.isPrintingPressAccessDeniedError(error);
+            this.printingPressDocsRetryableError = true;
+            this.requestUpdate();
+        }
+    }
+    async loadPrintingPressDocsForTask(taskId) {
+        try {
+            const brokerId = this.brokerController?.brokerConnectionId;
+            const result = await PrintingPressService.fetchTaskResult(taskId, brokerId);
+            if (this.printingPressDocsTaskId !== taskId) {
+                return;
+            }
+            await this.loadPrintingPressDocsFromResult(taskId, result, brokerId);
+        }
+        catch (error) {
+            if (this.printingPressDocsTaskId !== taskId) {
+                return;
+            }
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = false;
+            this.printingPressDocsExpectedOrigin = undefined;
+            this.printingPressDocsError = error?.detail || error?.message || 'Unable to load generated docs.';
+            this.printingPressDocsAccessDenied = this.isPrintingPressAccessDeniedError(error);
+            this.printingPressDocsRetryableError = true;
+            this.requestUpdate();
+        }
+    }
+    async loadPrintingPressDocsFromResult(requestId, result, brokerId) {
+        const docsUrl = result.docsUrl || result.url;
+        if (!docsUrl) {
+            throw new Error('Printing Press did not return a docs URL.');
+        }
+        const absoluteUrl = PrintingPressService.absoluteDocsUrl(docsUrl);
+        const preflight = await PrintingPressService.preflightDocs(absoluteUrl, brokerId);
+        if (this.printingPressDocsTaskId !== requestId) {
+            return;
+        }
+        if (!preflight.ok) {
+            const accessDenied = preflight.status === 401 || preflight.status === 403;
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = false;
+            this.printingPressDocsUrl = undefined;
+            this.printingPressDocsExpectedOrigin = undefined;
+            this.printingPressDocsAccessDenied = accessDenied;
+            this.printingPressDocsRetryableError = true;
+            this.printingPressDocsError = accessDenied
+                ? 'Access denied. Sign in with access to this workspace to view these docs.'
+                : `Unable to load generated docs (${preflight.status}).`;
+            this.requestUpdate();
+            return;
+        }
+        this.printingPressDocsUrl = absoluteUrl;
+        try {
+            this.printingPressDocsExpectedOrigin = new URL(absoluteUrl).origin;
+        }
+        catch {
+            this.printingPressDocsExpectedOrigin = undefined;
+        }
+        this.printingPressDocsReady = false;
+        this.printingPressDocsPending = true;
+        this.printingPressDocsError = undefined;
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = false;
+        this.armPrintingPressDocsReadyWatchdog(requestId);
+        this.tabCache.markEditorTabLoaded('docs');
+        this.requestUpdate();
+    }
+    handlePrintingPressMessage(event) {
+        if (!this.printingPressDocsExpectedOrigin) {
+            return;
+        }
+        if (event.origin !== this.printingPressDocsExpectedOrigin) {
+            return;
+        }
+        const frameWindow = this.findPrintingPressIframeWindow();
+        if (!frameWindow || event.source !== frameWindow) {
+            return;
+        }
+        const data = event.data;
+        if (!data || typeof data !== 'object') {
+            return;
+        }
+        if (data.type === 'ppress:ready') {
+            this.clearPrintingPressDocsReadyWatchdog();
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = true;
+            this.printingPressDocsError = undefined;
+            this.printingPressDocsAccessDenied = false;
+            this.printingPressDocsRetryableError = false;
+            this.sendCurrentThemeToPrintingPress(event.source);
+            this.sendPrintingPressArchiveControls(event.source);
+            this.requestUpdate();
+            return;
+        }
+        if (data.type === 'ppress:export') {
+            void this.handlePrintingPressDocumentExport(data.format, data.diagnostics === true, data.llm === true);
+            return;
+        }
+        if (data.type === 'ppress:error') {
+            this.clearPrintingPressDocsReadyWatchdog();
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = false;
+            this.printingPressDocsUrl = undefined;
+            this.printingPressDocsExpectedOrigin = undefined;
+            this.printingPressDocsError = data.message || 'Unable to load generated docs.';
+            this.printingPressDocsAccessDenied = data.status === 401 || data.status === 403;
+            this.printingPressDocsRetryableError = true;
+            this.requestUpdate();
+        }
+    }
+    async handlePrintingPressDocumentExport(format, diagnostics = false, llm = false) {
+        const archiveFormat = format === 'tar.gz' ? 'tar.gz' : 'zip';
+        if (!this.printingPressDocsUrl) {
+            this.sendToast({
+                id: crypto.randomUUID(),
+                type: ToastType.ERROR,
+                title: "docs export failed",
+                body: 'Generated docs are not loaded yet.'
+            });
+            return;
+        }
+        if (!this.authController?.authenticated) {
+            this.openPrintingPressExportGate();
+            return;
+        }
+        try {
+            await PrintingPressService.exportDocumentDocs(this.printingPressDocsUrl, {
+                format: archiveFormat,
+                diagnostics,
+                llm,
+                brokerId: this.brokerController?.brokerConnectionId
+            });
+            this.sendToast({
+                id: crypto.randomUUID(),
+                type: ToastType.SUCCESS,
+                title: "docs exported",
+                body: `Printing Press docs exported as ${archiveFormat}.`
+            });
+        }
+        catch (error) {
+            if (this.shouldOpenPrintingPressExportGate(error)) {
+                this.openPrintingPressExportGate();
+                return;
+            }
+            this.sendToast({
+                id: crypto.randomUUID(),
+                type: ToastType.ERROR,
+                title: "docs export failed",
+                body: error?.detail || error?.title || error?.message || 'Unable to export generated docs.'
+            });
+        }
+    }
+    shouldOpenPrintingPressExportGate(error) {
+        const status = Number(error?.status ?? error?.response?.status ?? 0);
+        return status === 401 || (!this.authController?.authenticated && this.isPrintingPressAccessDeniedError(error));
+    }
+    openPrintingPressExportGate() {
+        this.printingPressExportGate?.openGate('unauthenticated');
+    }
+    armPrintingPressDocsReadyWatchdog(taskId) {
+        this.clearPrintingPressDocsReadyWatchdog();
+        this.printingPressDocsReadyTimeout = setTimeout(() => {
+            this.printingPressDocsReadyTimeout = undefined;
+            if (this.printingPressDocsTaskId !== taskId) {
+                return;
+            }
+            if (this.printingPressDocsReady) {
+                return;
+            }
+            this.printingPressDocsPending = false;
+            this.printingPressDocsReady = false;
+            this.printingPressDocsUrl = undefined;
+            this.printingPressDocsExpectedOrigin = undefined;
+            this.printingPressDocsError = 'Generated docs did not finish loading.';
+            this.printingPressDocsAccessDenied = false;
+            this.printingPressDocsRetryableError = true;
+            this.requestUpdate();
+        }, TheDoctor_1.PRINTING_PRESS_DOCS_READY_TIMEOUT_MS);
+    }
+    clearPrintingPressDocsReadyWatchdog() {
+        if (this.printingPressDocsReadyTimeout !== undefined) {
+            clearTimeout(this.printingPressDocsReadyTimeout);
+            this.printingPressDocsReadyTimeout = undefined;
+        }
+    }
+    createPrintingPressRequestNonce() {
+        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+            return crypto.randomUUID();
+        }
+        return `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    }
+    createPrintingPressRequestId() {
+        return `preload:${this.createPrintingPressRequestNonce()}`;
+    }
+    handlePrintingPressDocsIframeError() {
+        this.clearPrintingPressDocsReadyWatchdog();
+        this.printingPressDocsPending = false;
+        this.printingPressDocsReady = false;
+        this.printingPressDocsUrl = undefined;
+        this.printingPressDocsExpectedOrigin = undefined;
+        this.printingPressDocsError = 'Unable to load generated docs.';
+        this.printingPressDocsAccessDenied = false;
+        this.printingPressDocsRetryableError = true;
+        this.requestUpdate();
+    }
+    handlePrintingPressDocsIframeLoad() {
+        this.sendPrintingPressArchiveControls();
+        window.setTimeout(() => this.sendPrintingPressArchiveControls(), 50);
+    }
+    handleThemeChangeForPrintingPress(event) {
+        const detail = event.detail;
+        if (!detail?.theme) {
+            return;
+        }
+        this.sendThemeToPrintingPress(detail.theme);
+    }
+    sendCurrentThemeToPrintingPress(target) {
+        const stored = (typeof localStorage !== 'undefined' && localStorage.getItem(PB33F_THEME)) || DarkTheme;
+        this.sendThemeToPrintingPress(stored, target ?? undefined);
+    }
+    sendThemeToPrintingPress(theme, target) {
+        if (!this.printingPressDocsExpectedOrigin) {
+            return;
+        }
+        const win = target || this.findPrintingPressIframeWindow();
+        if (!win) {
+            return;
+        }
+        try {
+            win.postMessage({ type: 'doctor:theme', theme }, this.printingPressDocsExpectedOrigin);
+        }
+        catch {
+            // intentional: failure to post a theme update is not user-actionable
+        }
+    }
+    sendPrintingPressArchiveControls(target) {
+        if (!this.printingPressDocsExpectedOrigin) {
+            return;
+        }
+        const win = target || this.findPrintingPressIframeWindow();
+        if (!win) {
+            return;
+        }
+        try {
+            win.postMessage({ type: 'doctor:archive-controls', enabled: true }, this.printingPressDocsExpectedOrigin);
+        }
+        catch {
+            // intentional: export controls are a hosted enhancement, docs remain usable without them
+        }
+    }
+    findPrintingPressIframeWindow() {
+        const root = this.renderRoot ?? this;
+        const iframe = root.querySelector('iframe.printing-press-docs-frame');
+        return iframe?.contentWindow ?? null;
+    }
+    renderPrintingPressDocsPanel() {
+        if (!this.tabCache.shouldRenderEditorTab('docs')) {
+            return nothing;
+        }
+        return html `
+            <div class="printing-press-docs-panel">
+                <div class="printing-press-docs-content">
+                    ${this.renderPrintingPressDocs()}
+                </div>
+            </div>
+        `;
+    }
+    renderPrintingPressDocs() {
+        if (!this.tabCache.shouldRenderEditorTab('docs')) {
+            return nothing;
+        }
+        if (this.printingPressDocsError) {
+            if (this.printingPressDocsAccessDenied) {
+                return this.renderPrintingPressAccessDenied();
+            }
+            return html `
+                <pb33f-printing-press-docs-unavailable
+                    .detail=${this.printingPressDocsError}>
+                </pb33f-printing-press-docs-unavailable>
+            `;
+        }
+        if (!this.printingPressDocsUrl) {
+            return this.printingPressDocsPending ? this.renderPrintingPressDocsPending() : nothing;
+        }
+        return html `
+            <div class="printing-press-docs-shell">
+                <iframe
+                    class="printing-press-docs-frame ${this.printingPressDocsReady ? 'ready' : 'loading'}"
+                    src="${this.printingPressDocsUrl}"
+                    width="100%"
+                    height="100%"
+                    style="border: none"
+                    @load=${this.handlePrintingPressDocsIframeLoad}
+                    @error=${this.handlePrintingPressDocsIframeError}>
+                </iframe>
+                ${this.printingPressDocsPending ? html `
+                    <div class="printing-press-docs-overlay">
+                        ${this.renderPrintingPressDocsPending()}
+                    </div>
+                ` : nothing}
+            </div>
+        `;
+    }
+    renderPrintingPressAccessDenied() {
+        const accessDeniedUrl = new URL('/access-denied', ModelService.doctorEndpoint).toString();
+        return html `
+            <iframe
+                class="printing-press-docs-access-denied-frame"
+                src="${accessDeniedUrl}"
+                width="100%"
+                height="100%"
+                style="border: none"
+                title="access denied">
+            </iframe>
+        `;
+    }
+    isPrintingPressAccessDeniedError(error) {
+        const status = Number(error?.status ?? error?.response?.status ?? 0);
+        if (status === 401 || status === 403) {
+            return true;
+        }
+        const text = `${error?.title ?? ''} ${error?.detail ?? ''} ${error?.message ?? ''} ${error?.error ?? ''}`.toLowerCase();
+        return text.includes('access denied') || text.includes('authentication required') || text.includes('requires authentication');
+    }
+    renderPrintingPressDocsPending() {
+        return html `
+            <div class="printing-press-docs-pending" aria-live="polite">
+                <div class="printing-press-docs-pending-nav" aria-hidden="true">
+                    <span></span><span></span><span></span><span></span><span></span>
+                </div>
+                <div class="printing-press-docs-pending-main">
+                    <h2>building api docs</h2>
+                    <p>Printing Press is preparing the static docs.</p>
+                </div>
+            </div>
+        `;
+    }
     handleEditorUpdatedForBundle(event) {
         if (event.detail.id === 'spec' && this.isBundled) {
             this.bundleController.reset();
@@ -862,6 +1387,7 @@ let TheDoctor = class TheDoctor extends LitElement {
         this.modelController.renderedNodeComponent.node = null;
         this.sidebarPanel?.showTab('overview');
         this.bundleController.reset();
+        this.resetPrintingPressDocsState();
         this.isBundled = false;
         this.modelTree.isBundled = false;
         this.importDisabled = false;
@@ -878,6 +1404,9 @@ let TheDoctor = class TheDoctor extends LitElement {
             this.docBag?.set(DefaultDocument, result);
             this.diagnosticController.loadStoredDiagnostics();
             this.updateWorkspaceReadOnlyState();
+            if (this.selectedEditorTab === 'docs') {
+                this.preloadPrintingPressDocs();
+            }
         }).finally(() => {
             this.isRebooting = false;
         });
@@ -1092,8 +1621,8 @@ let TheDoctor = class TheDoctor extends LitElement {
         }
         return this._controlTabs;
     }
-    _showControlTab(panel) {
-        this.sidebarPanel?.showTab(panel);
+    _showControlTab(panel, options) {
+        this.sidebarPanel?.showTab(panel, options);
     }
     _getSelectedControlTab() {
         const activeTab = this.sidebarPanel?.tabGroup?.querySelector('sl-tab[active]');
@@ -1108,7 +1637,7 @@ let TheDoctor = class TheDoctor extends LitElement {
         }
         return this._editorTabs;
     }
-    _showEditorTab(panel) {
+    _showEditorTab(panel, _options) {
         this.editorPanel?.showTab(panel);
     }
     _getSelectedEditorTab() {
@@ -1123,7 +1652,7 @@ let TheDoctor = class TheDoctor extends LitElement {
         }
         return this._navigatorTabs;
     }
-    _showNavigatorTab(panel) {
+    _showNavigatorTab(panel, _options) {
         this.navigatorPanel?.showTab(panel);
     }
     _getSelectedNavigatorTab() {
@@ -1238,7 +1767,8 @@ let TheDoctor = class TheDoctor extends LitElement {
             overlay = html `
                 <div class="overlay" @click="return false"></div>`;
         }
-        const mainPanelView = html `
+        const docsActive = this.selectedEditorTab === 'docs';
+        const mainPanelView = docsActive ? nothing : html `
             <pb33f-doctor-sidebar-panel
                 slot="end"
                 role="complementary"
@@ -1265,6 +1795,12 @@ let TheDoctor = class TheDoctor extends LitElement {
             ${this.nukeWorkspace}
             ${this.toastManager}
             ${this.globalTaskView}
+            <pb33f-premium-gate
+                id="printing-press-export-gate"
+                dialogTitle="Show us your credentials, partner"
+                featureName="Export API Docs"
+                featureExplanation="Howdy! In order to export generated API docs, we're going to need you to authenticate first. Tell us who you are, and we will give you a bunch of free credit to use.">
+            </pb33f-premium-gate>
             <sl-dialog open id="loading-overlay" class="dialog-overview"
                        style="--width: 30vw" no-header>
                 <h3 class="loading">OpenAPI Doctor is booting...</h3>
@@ -1291,7 +1827,7 @@ let TheDoctor = class TheDoctor extends LitElement {
             <div class="doctor">
                 ${this.errorBanner}
                 ${overlay}
-                <sl-split-panel id="explorer-split-panel" class="split-panel-explorer" position="12"
+                <sl-split-panel id="explorer-split-panel" class="split-panel-explorer ${docsActive ? 'docs-takeover' : ''}" position="12"
                                 @sl-reposition="${this.updateExplorerDivider}">
                     <sl-icon id="split-divider-tree" slot="divider" name="grip-vertical" class="divider-vert" aria-hidden="true"></sl-icon>
                     <div slot="start" class="model-tree" role="navigation" aria-label="Document navigation">
@@ -1321,7 +1857,7 @@ let TheDoctor = class TheDoctor extends LitElement {
                     <div slot="end">
                         <sl-split-panel id="inspector-split-panel"
                                         @sl-reposition="${this.updateInspectorDivider}"
-                                        class="split-panel ${this.unavailable ? 'unavailable' : ''}">
+                                        class="split-panel ${this.unavailable ? 'unavailable' : ''} ${docsActive ? 'docs-mode' : ''}">
                             <sl-icon id="split-divider" slot="divider" name="grip-vertical"
                                      class="divider-vert" aria-hidden="true"></sl-icon>
                             <div class="editor" slot="start" role="main" aria-label="API specification editor">
@@ -1353,7 +1889,7 @@ let TheDoctor = class TheDoctor extends LitElement {
                                             </div>
                                         </pb33f-tardis-control>
                                     ` : nothing}</div>
-                                    <div slot="docs" style="height: 100%">${this.tabCache.shouldRenderEditorTab('docs') ? html `<iframe src="${this.doctorEndpoint}/model/scalar-template?z=${Date.now()}" width="100%" height="100%" style="border: none"></iframe>` : nothing}</div>
+                                    <div slot="docs" class="docs-slot">${this.renderPrintingPressDocsPanel()}</div>
                                     <div slot="workspaces">${this.tabCache.shouldRenderEditorTab('workspaces') ? this.workspaceController.workspaceView : nothing}</div>
                                 </pb33f-doctor-editor-panel>
                             </div>
@@ -1408,6 +1944,7 @@ TheDoctor.styles = [theDoctorCss,
     tooltipCss,
     panelsCss,
     nukeCss];
+TheDoctor.PRINTING_PRESS_DOCS_READY_TIMEOUT_MS = 12000;
 __decorate([
     query('sl-radio-group#export-ruleset-radio')
 ], TheDoctor.prototype, "exportSelection", void 0);
@@ -1417,6 +1954,9 @@ __decorate([
 __decorate([
     query('sl-dialog#loading-overlay')
 ], TheDoctor.prototype, "loadingOverlay", void 0);
+__decorate([
+    query('pb33f-premium-gate#printing-press-export-gate')
+], TheDoctor.prototype, "printingPressExportGate", void 0);
 __decorate([
     query('#url-input-button')
 ], TheDoctor.prototype, "urlInputButton", void 0);
@@ -1504,13 +2044,31 @@ __decorate([
 __decorate([
     state()
 ], TheDoctor.prototype, "isBundled", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "printingPressDocsPending", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "printingPressDocsUrl", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "printingPressDocsReady", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "printingPressDocsError", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "printingPressDocsAccessDenied", void 0);
+__decorate([
+    state()
+], TheDoctor.prototype, "selectedEditorTab", void 0);
 __decorate([
     state()
 ], TheDoctor.prototype, "rolodexDividerPosition", void 0);
 __decorate([
     state()
 ], TheDoctor.prototype, "currentViewName", void 0);
-TheDoctor = __decorate([
+TheDoctor = TheDoctor_1 = __decorate([
     customElement("pb33f-doctor")
 ], TheDoctor);
 export { TheDoctor };