arcane-os 0.42.2 → 0.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.42.2",
+  "version": "0.44.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -86,7 +86,7 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/app-selection.test.mjs test/contracts.test.mjs test/conversation-closing-report.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
     "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",

package/runtime/arcane/components/data-view.html

@@ -31,12 +31,16 @@
     let content=null;
     let fileManager=null;
     let operationGeneration=0;
+    let openController = null;
+    let closingTask = null;
     let destroyed=false;
 
     host.beforeOpen=is.function(host.beforeOpen)
         ?host.beforeOpen
         :async function beforeOpen(){};
     host.open=openData;
+    host.close = closeData;
+    host.printPreview=printPreview;
     host.destroy=destroy;
 
     openButton.innerText=host.dataset.button||'View Data';
@@ -52,80 +56,159 @@
         {signal:lifecycleController.signal}
     );
 
-    async function openData(){
-        if(destroyed){
+    dataModal.addEventListener(
+        'modal-closed',
+        function closeDataFromModal(event) {
+            if (event.target === dataModal && !closingTask) {
+                closeData();
+            }
+        },
+        {signal: lifecycleController.signal}
+    );
+
+    async function openData() {
+        if (destroyed) {
             return false;
         }
-        const generation=++operationGeneration;
-        await host.beforeOpen();
-        if(destroyed||generation!==operationGeneration){
+        const requestedGeneration=operationGeneration;
+        if (closingTask && !await closingTask) {
             return false;
         }
-
-        const reload=Boolean(content);
-
-        const modal=await waitForComponent(
-            dataModal,
-            {
-                methods:['populate','open'],
-                property:'ready',
-                event:'modal-ready',
-                signal:lifecycleController.signal
-            }
-        );
-        if(destroyed||generation!==operationGeneration){
+        if (destroyed||requestedGeneration!==operationGeneration) {
             return false;
         }
+        const generation = ++operationGeneration;
+        openController?.abort('data-view-open-replaced');
+        const controller = new AbortController();
+        openController = controller;
+
+        try {
+            await host.beforeOpen();
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-        if(!content){
-            content=document.createElement('section');
-            fileManager=document.createElement('html-import');
+            const reload = Boolean(content);
+            const modal = await waitForComponent(
+                dataModal,
+                {
+                    methods: ['populate', 'open'],
+                    property: 'ready',
+                    event: 'modal-ready',
+                    signal: controller.signal
+                }
+            );
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-            const heading=document.createElement('h1');
+            if (!content) {
+                content = document.createElement('section');
+                fileManager = document.createElement('html-import');
+
+                const heading = document.createElement('h1');
+
+                heading.innerText = host.dataset.title || 'Data';
+                fileManager.className = 'file-manager';
+                forwardPreviewOptions();
+                fileManager.dataset.dirs = host.dataset.dirs || '';
+                fileManager.dataset.layout = host.dataset.layout || 'files';
+                fileManager.setAttribute(
+                    'href',
+                    new URL('./file-manager.html', componentHref).href
+                );
+
+                content.append(heading, fileManager);
+                await modal.populate(content, false);
+                if (destroyed || generation !== operationGeneration) {
+                    return false;
+                }
+            }
 
-            heading.innerText=host.dataset.title||'Data';
-            fileManager.className='file-manager';
-            forwardPreviewOptions();
-            fileManager.dataset.dirs=host.dataset.dirs||'';
-            fileManager.dataset.layout=host.dataset.layout||'files';
-            fileManager.setAttribute(
-                'href',
-                new URL('./file-manager.html',componentHref).href
+            if (reload) {
+                forwardPreviewOptions();
+            }
+
+            const manager = await waitForComponent(
+                fileManager,
+                {
+                    methods: ['loadAll'],
+                    property: 'ready',
+                    event: 'file-manager-ready',
+                    signal: controller.signal
+                }
             );
+            if (destroyed || generation !== operationGeneration) {
+                return false;
+            }
 
-            content.append(heading,fileManager);
-            await modal.populate(content,false);
-            if(destroyed||generation!==operationGeneration){
+            if (reload) {
+                await manager.loadAll();
+                if (destroyed || generation !== operationGeneration) {
+                    return false;
+                }
+            }
+
+            return await modal.open();
+        } catch (error) {
+            if (controller.signal.aborted) {
                 return false;
             }
+            throw error;
+        } finally {
+            if (openController === controller) {
+                openController = null;
+            }
         }
+    }
 
-        if(reload){
-            forwardPreviewOptions();
+    async function closeData() {
+        if (destroyed) {
+            return false;
+        }
+        operationGeneration += 1;
+        openController?.abort('data-view-closed');
+        openController = null;
+        if (closingTask) {
+            return closingTask;
         }
 
-        const manager=await waitForComponent(
-            fileManager,
-            {
-                methods:['loadAll'],
-                property:'ready',
-                event:'file-manager-ready',
-                signal:lifecycleController.signal
-            }
-        );
-        if(destroyed||generation!==operationGeneration){
-            return false;
+        const childClosing = is.function(fileManager?.close)
+            ? fileManager.close()
+            : Promise.resolve(true);
+        closingTask = Promise.resolve(childClosing)
+            .then(closeDataAfterChildren)
+            .catch(
+                function reportDataCloseFailure(error) {
+                    arcaneLogging.error('Unable to close data view:', error);
+                    return false;
+                }
+            );
+        try {
+            return await closingTask;
+        } finally {
+            closingTask = null;
         }
+    }
 
-        if(reload){
-            await manager.loadAll();
-            if(destroyed||generation!==operationGeneration){
+    async function closeDataAfterChildren(childrenClosed) {
+        if (childrenClosed === false || destroyed) {
+            return false;
+        }
+        if (is.function(dataModal.close)) {
+            const closed = await dataModal.close();
+            if (closed === false) {
                 return false;
             }
         }
+        return !destroyed && dataModal.opened !== true;
+    }
 
-        modal.open();
-        return true;
+    async function printPreview(){
+        if(destroyed||dataModal.opened!==true||!is.function(fileManager?.printPreview)){
+            return false;
+        }
+        return fileManager.printPreview();
     }
 
     function forwardPreviewOptions(){
@@ -146,6 +229,8 @@
         }
         destroyed=true;
         operationGeneration+=1;
+        openController?.abort('data-view-destroyed');
+        openController = null;
         lifecycleController.abort('data-view-destroyed');
         fileManager?.destroy?.();
         dataModal.destroy?.();

package/runtime/arcane/components/file-manager.html

@@ -469,8 +469,15 @@
         directory=>directory.trim()
     ).filter(Boolean);
     const fileEntityPromise=import('../entities/File.js');
+    const printModulePromise=import('../modules/PrintView.js');
+    void printModulePromise.catch(function reportPrintModuleFailure(error){
+        arcaneLogging.error('Unable to load rendered printing:',error);
+    });
 
     let activePreview=null;
+    let presentationController = new AbortController();
+    let uploadPresentationController = null;
+    let closingTask = null;
     let markdownModulePromise=null;
     let uploadDirectory='';
     let initialized=false;
@@ -497,6 +504,8 @@
     host.setDirectoryFilter=setDirectoryFilter;
     host.select=select;
     host.clearSelection=clearSelection;
+    host.close = closeFileManager;
+    host.printPreview=printPreview;
     host.destroy=destroy;
 
     Object.defineProperty(
@@ -1457,22 +1466,20 @@
         }
     }
 
-    async function openDirectory(directory=''){
-        if(destroyed||!isVisibleDirectory(directory)){
+    async function openDirectory(directory = '', signal = presentationController.signal) {
+        if (closingTask && !await closingTask) {
+            return false;
+        }
+        if(destroyed||signal.aborted||!isVisibleDirectory(directory)){
             return false;
         }
         const generation=++directoryOpenGeneration;
-        const modal=await waitForComponent(
+        const modal = await waitForModal(
             directoryModal,
-            {
-                methods:['populate','open'],
-                property:'ready',
-                event:'modal-ready',
-                signal:lifecycleController.signal
-            },
-            {signal:lifecycleController.signal}
+            ['populate', 'open'],
+            signal
         );
-        if(destroyed||generation!==directoryOpenGeneration||!isVisibleDirectory(directory)){
+        if(!modal||destroyed||generation!==directoryOpenGeneration||!isVisibleDirectory(directory)){
             return false;
         }
         const keys=await dbopfs.getAllKeys(directory);
@@ -1534,7 +1541,11 @@
     }
 
     async function openFile(directory='',fileName=''){
-        if(destroyed){
+        const signal = presentationController.signal;
+        if (closingTask && !await closingTask) {
+            return false;
+        }
+        if(destroyed||signal.aborted){
             return false;
         }
         releasePreview(activePreview,'file-preview-replaced');
@@ -1543,7 +1554,12 @@
             controller:new AbortController(),
             generation,
             urls:new Set(),
-            media:new Set()
+            media:new Set(),
+            title:`${directory}/${fileName}`,
+            rendered:null,
+            printPreparation:null,
+            printRetains:0,
+            released:false
         };
         activePreview=preview;
         let modal;
@@ -1577,8 +1593,20 @@
         const deleteButton=document.createElement('button');
         const deleteIcon=document.createElement('img');
         const status=document.createElement('p');
+        const printButton=document.createElement('button');
 
         heading.innerText=`${directory}/${fileName}`;
+        printButton.type='button';
+        printButton.textContent='Print';
+        printButton.disabled=true;
+        preview.printButton=printButton;
+        preview.printStatus=status;
+        preview.container=content;
+        printButton.addEventListener('click',function printOpenPreview(){
+            void printPreview().catch(function reportPrintRejection(error){
+                reportPreviewPrintFailure(error,preview);
+            });
+        },{signal:preview.controller.signal});
         actions.className='file-view-actions';
         deleteButton.type='button';
         deleteButton.className='file-view-delete';
@@ -1598,7 +1626,7 @@
         };
         status.innerText='Opening file...';
         status.setAttribute('role','status');
-        actions.append(deleteButton);
+        actions.append(printButton,deleteButton);
         content.append(
             styles,
             heading,
@@ -1631,6 +1659,10 @@
             }
             status.remove();
             content.append(rendered);
+            preview.rendered=rendered;
+            void preparePreviewPrint(preview).catch(function reportPrintPreparation(error){
+                reportPreviewPrintFailure(error,preview);
+            });
             return true;
         }catch(error){
             if(isCurrentPreview(preview)){
@@ -1643,6 +1675,69 @@
         }
     }
 
+    function preparePreviewPrint(preview){
+        if(!preview.printPreparation){
+            preview.printPreparation=printModulePromise.then(function registerPreviewPrint({createPrintView}){
+                if(!isCurrentPreview(preview)||!preview.rendered){
+                    return null;
+                }
+                const view=createPrintView({
+                    host,
+                    content:()=>preview.rendered,
+                    title:()=>preview.title,
+                    active:()=>isCurrentPreview(preview)&&fileModal.opened===true,
+                    priority:1,
+                    signal:preview.controller.signal,
+                    retain:()=>retainPreviewPrintResources(preview),
+                    onError:error=>reportPreviewPrintFailure(error,preview)
+                });
+                preview.printButton.disabled=false;
+                return view;
+            });
+        }
+        return preview.printPreparation;
+    }
+
+    async function printPreview(){
+        const preview=activePreview;
+        if(!preview?.rendered||!isCurrentPreview(preview)||fileModal.opened!==true){
+            return false;
+        }
+        const view=await preparePreviewPrint(preview);
+        return view&&isCurrentPreview(preview)?view.print():false;
+    }
+
+    function reportPreviewPrintFailure(error,preview){
+        arcaneLogging.error('Unable to print file preview:',error);
+        if(isCurrentPreview(preview)){
+            preview.printStatus.textContent='Unable to open print preview. Please try again.';
+            preview.printStatus.setAttribute('role','alert');
+            preview.container.append(preview.printStatus);
+        }
+    }
+
+    function retainPreviewPrintResources(preview){
+        preview.printRetains+=1;
+        let retained=true;
+        return function releasePrintedPreviewResources(){
+            if(!retained){
+                return;
+            }
+            retained=false;
+            preview.printRetains-=1;
+            if(preview.released&&preview.printRetains===0){
+                releasePreviewURLs(preview);
+            }
+        };
+    }
+
+    function releasePreviewURLs(preview){
+        for(const url of preview.urls){
+            URL.revokeObjectURL(url);
+        }
+        preview.urls.clear();
+    }
+
     function configureFileModal(modal){
         const appearance=getComputedStyle(host);
         for(const property of ['--modal-width','--modal-max-height','--modal-padding']){
@@ -1660,9 +1755,10 @@
     }
 
     function releasePreview(preview,reason){
-        if(!preview){
+        if(!preview||preview.released){
             return;
         }
+        preview.released=true;
         preview.controller.abort(reason);
         for(const element of preview.media){
             if(element.localName==='audio'){
@@ -1676,11 +1772,10 @@
                 element.load();
             }
         }
-        for(const url of preview.urls){
-            URL.revokeObjectURL(url);
+        if(preview.printRetains===0){
+            releasePreviewURLs(preview);
         }
         preview.media.clear();
-        preview.urls.clear();
         if(activePreview===preview){
             activePreview=null;
         }
@@ -2091,8 +2186,12 @@
 
         openButton.addEventListener(
             'click',
-            async()=>{
+            async function openSelectedFile() {
+                const signal = presentationController.signal;
                 await select(entry.path,{entry:entry});
+                if (destroyed || signal.aborted) {
+                    return;
+                }
                 const detail={path:entry.path,entry:entry,trigger:'click'};
                 const operationId=nextOperationId('open');
                 const openAllowed=emit('file-manager-open',detail,true,operationId);
@@ -2130,21 +2229,21 @@
     }
 
     async function confirmDelete(directory='',fileName='',closeFile=false){
-        if(destroyed||!directory||!fileName){
+        const signal = presentationController.signal;
+        if (closingTask && !await closingTask) {
+            return false;
+        }
+        if(destroyed||signal.aborted||!directory||!fileName){
             return false;
         }
         const generation=++deleteGeneration;
 
-        const modal=await waitForComponent(
+        const modal = await waitForModal(
             deleteModal,
-            {
-                methods:['populate','open','close'],
-                property:'ready',
-                event:'modal-ready',
-                signal:lifecycleController.signal
-            }
+            ['populate', 'open', 'close'],
+            signal
         );
-        if(destroyed||generation!==deleteGeneration){
+        if(!modal||destroyed||generation!==deleteGeneration){
             return false;
         }
         const content=document.createElement('section');
@@ -2168,12 +2267,19 @@
         deleteButton.addEventListener(
             'click',
             async function deleteSelectedFile(){
+                if (destroyed || signal.aborted || generation !== deleteGeneration) {
+                    return;
+                }
                 cancelButton.disabled=true;
                 deleteButton.disabled=true;
 
                 try{
                     await dbopfs.delete(directory,fileName);
-                    if(destroyed||generation!==deleteGeneration){
+                    if(destroyed){
+                        return;
+                    }
+                    if (generation !== deleteGeneration) {
+                        await loadAll();
                         return;
                     }
                     await modal.close(undefined,true);
@@ -2201,7 +2307,9 @@
                         message.innerText=`Unable to delete ${fileName}.`;
                         cancelButton.disabled=false;
                         deleteButton.disabled=false;
-                        arcaneLogging.error('Unable to delete file:',error);
+                    }
+                    if (!destroyed) {
+                        arcaneLogging.error('Unable to delete file:', error);
                     }
                 }
             },
@@ -2230,6 +2338,7 @@
         }
 
         uploadDirectory=directory;
+        uploadPresentationController = presentationController;
         fileUpload.click();
     }
 
@@ -2239,6 +2348,8 @@
         }
         const files=Array.from(fileUpload.files||[]);
         const directory=uploadDirectory;
+        const presentation = uploadPresentationController || presentationController;
+        uploadPresentationController = null;
         fileUpload.value='';
 
         if(!files.length||!directory){
@@ -2269,8 +2380,8 @@
             return false;
         }
 
-        if(layout==='grid'){
-            await openDirectory(directory);
+        if(layout==='grid' && !presentation.signal.aborted){
+            await openDirectory(directory, presentation.signal);
         }
 
         const failed=results.find(
@@ -2309,6 +2420,76 @@
         }
     }
 
+    async function waitForModal(modal, methods, signal) {
+        try {
+            return await waitForComponent(
+                modal,
+                {
+                    methods,
+                    property: 'ready',
+                    event: 'modal-ready',
+                    signal
+                }
+            );
+        } catch (error) {
+            if (signal.aborted) {
+                return null;
+            }
+            throw error;
+        }
+    }
+
+    async function closeFileManager() {
+        if (destroyed) {
+            return false;
+        }
+        presentationController.abort('file-manager-closed');
+        presentationController = new AbortController();
+        treeOpenGeneration += 1;
+        directoryOpenGeneration += 1;
+        deleteGeneration += 1;
+        selectionGeneration += 1;
+        // Cancel unfinished opens now; a settled preview remains usable until
+        // its modal actually closes, including when a child refuses to close.
+        if (!activePreview?.rendered) {
+            fileOpenGeneration += 1;
+            releasePreview(activePreview, 'file-manager-closed');
+        }
+        if (closingTask) {
+            return closingTask;
+        }
+
+        closingTask = Promise.resolve().then(closeOwnedDialogs);
+        try {
+            return await closingTask;
+        } finally {
+            closingTask = null;
+        }
+    }
+
+    async function closeOwnedDialogs() {
+        try {
+            for (const modal of [deleteModal, fileModal, directoryModal]) {
+                if (destroyed) {
+                    return false;
+                }
+                if (is.function(modal.close)) {
+                    const closed = await modal.close();
+                    if (closed === false) {
+                        return false;
+                    }
+                }
+                if (modal.opened === true) {
+                    return false;
+                }
+            }
+            return !destroyed;
+        } catch (error) {
+            arcaneLogging.error('Unable to close file manager:', error);
+            return false;
+        }
+    }
+
     function destroy(){
         if(destroyed){
             return false;
@@ -2317,6 +2498,7 @@
         initialized=false;
         host.ready=false;
         lifecycleController.abort('file-manager-destroyed');
+        presentationController.abort('file-manager-destroyed');
         treeLoadSequence+=1;
         gridLoadSequence+=1;
         providerGeneration+=1;