arcane-os 0.46.0 → 0.48.0

package/runtime/arcane/css/print.css

@@ -0,0 +1,235 @@
+/* Shared paper presentation for direct pages and rendered PrintView snapshots.
+ * Theme/document styles import this file. PrintView loads the same complete
+ * text before registration so native beforeprint performs no asynchronous I/O.
+ */
+:root,
+:host{
+    --arcane-print-paper:rgb(255, 255, 255);
+    --arcane-print-text:rgb(23, 34, 56);
+    --arcane-print-secondary:rgb(229, 233, 243);
+    --arcane-print-border:rgb(203, 211, 226);
+    --arcane-print-focus:rgb(118, 87, 213);
+    --arcane-print-muted:rgb(95, 107, 130);
+    --arcane-print-success:rgb(39, 122, 75);
+    --arcane-print-warning:rgb(154, 101, 0);
+    --arcane-print-danger:rgb(165, 56, 56);
+    --arcane-print-review:rgb(133, 85, 165);
+    --arcane-print-shadow:rgba(23, 34, 56, .16);
+    --arcane-print-platinum:rgb(102, 112, 133);
+    --arcane-print-icon-filter:none;
+    --arcane-print-file-icon-filter:hue-rotate(8deg) saturate(.62) brightness(.86);
+}
+
+/* Snapshot rules are scoped to PrintView-owned nodes, including its shadow
+ * host. The source document's typography and artwork remain on the clones.
+ */
+:host([data-arcane-print-stage]){
+    color-scheme:light!important;
+    color:var(--arcane-print-text)!important;
+    background:var(--arcane-print-paper)!important;
+    font:12pt/1.5 serif;
+}
+
+:host([data-arcane-print-stage])>h1{
+    margin:0 0 .75em;
+    font-size:1.5em;
+    line-height:1.2;
+}
+
+[data-arcane-print-node]:not(svg,svg *,img,video,audio),
+[data-arcane-print-node]:not(svg,svg *,img,video,audio)::before,
+[data-arcane-print-node]:not(svg,svg *,img,video,audio)::after{
+    color:var(--arcane-print-text)!important;
+    background-color:transparent!important;
+    border-color:var(--arcane-print-border)!important;
+    color-scheme:light!important;
+    -webkit-text-fill-color:currentColor!important;
+    -webkit-text-stroke:0!important;
+    text-decoration-color:currentColor!important;
+    text-shadow:none!important;
+    box-shadow:none!important;
+}
+
+a[data-arcane-print-node]:not(svg *){text-decoration:underline!important;}
+table[data-arcane-print-node]:not(svg *){border-collapse:collapse!important;}
+th[data-arcane-print-node]:not(svg *),
+td[data-arcane-print-node]:not(svg *){
+    border:1px solid var(--arcane-print-border)!important;
+    padding:.35em .5em!important;
+}
+
+[data-arcane-print-expand]{
+    height:auto!important;
+    min-height:0!important;
+    max-height:none!important;
+    width:auto!important;
+    min-width:0!important;
+    max-width:100%!important;
+    overflow:visible!important;
+    contain:none!important;
+    content-visibility:visible!important;
+    grid-template-rows:none!important;
+    break-inside:auto!important;
+}
+
+img[data-arcane-print-node]{max-width:100%!important;height:auto!important;}
+[data-arcane-print-static]{position:static!important;}
+[data-arcane-print-root]{visibility:visible!important;}
+[data-arcane-print-block]{display:block!important;}
+pre[data-arcane-print-node]{white-space:pre-wrap!important;overflow-wrap:anywhere!important;}
+table[data-arcane-print-node]{table-layout:auto!important;}
+thead[data-arcane-print-node]{display:table-header-group!important;}
+tfoot[data-arcane-print-node]{display:table-footer-group!important;}
+td[data-arcane-print-node],
+th[data-arcane-print-node]{overflow-wrap:anywhere!important;white-space:normal!important;}
+
+/* Chat supplies the rendered transcript, not controls or session status.
+ * Keep public tool messages; inspection details and thinking are transient.
+ */
+.chat_output[data-arcane-print-node]{
+    display:block!important;
+    margin:0!important;
+    padding:0!important;
+    border:0!important;
+    border-radius:0!important;
+}
+
+.chat_output[data-arcane-print-node]>li{
+    display:block!important;
+    float:none!important;
+    clear:both!important;
+    max-inline-size:100%!important;
+    text-align:start!important;
+    margin:0 0 1em!important;
+    padding:0!important;
+    border:0!important;
+    border-radius:0!important;
+}
+
+.chat_output[data-arcane-print-node]>li [data-arcane-print-node]:not(.message_timestamp){
+    text-align:start!important;
+}
+
+.chat_output[data-arcane-print-node]>li>.thinking,
+.chat_output[data-arcane-print-node]>li>.message_tool_details,
+.chat_output[data-arcane-print-node]>li>.message_tool_calls>.message_tool_call>.message_tool_details,
+.chat_output[data-arcane-print-node]>li:has(>.thinking):has(>.markdown:empty):not(:has(.message_tool_message)){
+    display:none!important;
+}
+
+[data-arcane-print-stage]{display:none!important;}
+
+@media print{
+    @page{margin:1in;}
+
+    :root,
+    body,
+    [data-arcane-palette]{
+        color-scheme:light!important;
+        --background:var(--arcane-print-paper)!important;
+        --modal-background:var(--arcane-print-paper)!important;
+        --text-color:var(--arcane-print-text)!important;
+        --primary-color:var(--arcane-print-text)!important;
+        --secondary-color:var(--arcane-print-secondary)!important;
+        --accent-color:var(--focus-color)!important;
+        --button-text-color:var(--arcane-print-paper)!important;
+        --border-color:var(--arcane-print-border)!important;
+        --focus-color:var(--arcane-print-focus)!important;
+        --muted-text-color:var(--arcane-print-muted)!important;
+        --success-color:var(--arcane-print-success)!important;
+        --warning-color:var(--arcane-print-warning)!important;
+        --danger-color:var(--arcane-print-danger)!important;
+        --review-color:var(--arcane-print-review)!important;
+        --shadow-color:var(--arcane-print-shadow)!important;
+        --platinum:var(--arcane-print-platinum)!important;
+        --icon-filter:var(--arcane-print-icon-filter)!important;
+        --file-icon-filter:var(--arcane-print-file-icon-filter)!important;
+    }
+
+    html,
+    body{
+        margin:0;
+        background-color:var(--modal-background);
+        color:var(--text-color);
+    }
+
+    /* The shared screen shell has a sidebar grid and a viewport-height main
+     * scroller. Paper uses the same main content in ordinary document flow.
+     */
+    html:has(>body>main),
+    body:has(>main),
+    body>main,
+    body>main .data-workspace{
+        display:block!important;
+        position:static!important;
+        width:auto!important;
+        height:auto!important;
+        min-height:0!important;
+        max-height:none!important;
+        overflow:visible!important;
+        contain:none!important;
+        grid-template-columns:none!important;
+        grid-template-rows:none!important;
+        margin:0!important;
+        padding:0!important;
+        border:0!important;
+        border-radius:0!important;
+        box-shadow:none!important;
+    }
+
+    body:has(>main)>.header,
+    body:has(>main)>.nav{
+        display:none!important;
+    }
+
+    /* Expand only when an owned rendered snapshot is actually present. */
+    html:root:has(>body>[data-arcane-print-stage]),
+    html:root>body:has(>[data-arcane-print-stage]){
+        display:block!important;
+        height:auto!important;
+        min-height:0!important;
+        max-height:none!important;
+        overflow:visible!important;
+        contain:none!important;
+        margin:0!important;
+        padding:0!important;
+        border:0!important;
+        background:var(--arcane-print-paper)!important;
+        color:var(--arcane-print-text)!important;
+        color-scheme:light!important;
+    }
+
+    html:root>body:has(>[data-arcane-print-stage])>*:not([data-arcane-print-stage]),
+    html:root>body:has(>[data-arcane-print-stage])::before,
+    html:root>body:has(>[data-arcane-print-stage])::after{
+        display:none!important;
+    }
+
+    html:root>body>[data-arcane-print-stage]{
+        display:block!important;
+        position:static!important;
+        width:auto!important;
+        height:auto!important;
+        overflow:visible!important;
+        margin:0!important;
+        padding:0!important;
+        border:0!important;
+    }
+
+    body.static-doc-site :is(.static-site-header,.static-site-footer,.static-section-nav,.static-previous-next,.static-related,.static-document__source,.skip-link){
+        display:none!important;
+    }
+
+    body.static-doc-site :is(.static-site-main,.static-site-main--document){
+        max-inline-size:none!important;
+        padding:0!important;
+    }
+
+    body.static-doc-site .static-document-layout{display:block!important;}
+    body.static-doc-site .static-document{inline-size:100%!important;}
+    body.static-doc-site .static-document__content table{display:table!important;overflow:visible!important;}
+    body.static-doc-site .static-document__content table :where(code,kbd){
+        overflow-wrap:anywhere!important;
+        word-break:break-word!important;
+    }
+}

package/runtime/arcane/css/theme.css

@@ -1,3 +1,5 @@
+@import url('./print.css');
+
 /* Shared default and named palettes. layout.css imports this owner, and
  * standalone applications may load it directly before their own styles.
  * data-user-skin selects the root palette; data-arcane-palette scopes a swatch.
@@ -328,43 +330,3 @@ body{
     transition-duration:.01ms !important;
 }
 
-/* Paper uses the existing base light palette regardless of the screen skin.
- * Print-only importance also overrides custom-theme inline tokens; no saved
- * preference, screen layout, media paint, or scrolling state changes here.
- */
-@media print {
-    @page {
-        margin: 15mm;
-    }
-
-    :root,
-    body,
-    [data-arcane-palette] {
-        color-scheme: light !important;
-        --background: rgb(255, 255, 255) !important;
-        --modal-background: rgb(255, 255, 255) !important;
-        --text-color: rgb(23, 34, 56) !important;
-        --primary-color: rgb(23, 34, 56) !important;
-        --secondary-color: rgb(229, 233, 243) !important;
-        --accent-color: var(--focus-color) !important;
-        --button-text-color: rgb(255, 255, 255) !important;
-        --border-color: rgb(203, 211, 226) !important;
-        --focus-color: rgb(118, 87, 213) !important;
-        --muted-text-color: rgb(95, 107, 130) !important;
-        --success-color: rgb(39, 122, 75) !important;
-        --warning-color: rgb(154, 101, 0) !important;
-        --danger-color: rgb(165, 56, 56) !important;
-        --review-color: rgb(133, 85, 165) !important;
-        --shadow-color: rgba(23, 34, 56, .16) !important;
-        --platinum: rgb(102, 112, 133) !important;
-        --icon-filter: none !important;
-        --file-icon-filter: hue-rotate(8deg) saturate(.62) brightness(.86) !important;
-    }
-
-    html,
-    body {
-        margin: 0;
-        background-color: var(--modal-background);
-        color: var(--text-color);
-    }
-}

package/runtime/arcane/modules/AI.js

@@ -2081,8 +2081,10 @@ class AI {
     #assertDeviceSpeechConfiguration(configuration){
         for(const routeName of ['default','localOnly']){
             const selection=configuration?.stt?.[routeName];
-            if(selection&&selection.localOnly!==true){
-                const error=new TypeError('Speech recognition supports on-device providers only.');
+            const liveCapture=selection
+                &&this.#providerRuntime.supportsTranscriptionCapture(selection.providerId);
+            if(selection&&selection.localOnly!==true&&!liveCapture){
+                const error=new TypeError('Speech recognition requires an on-device or explicitly selected live-capture provider.');
                 error.code='AI_STT_DEVICE_ONLY';
                 throw error;
             }
@@ -3430,8 +3432,9 @@ class AI {
         if(provider!==null&&provider?.role!==role){
             throw new TypeError('The speech provider must implement the selected role.');
         }
-        if(role==='stt'&&provider&&provider.localOnly!==true){
-            const error=new TypeError('Speech recognition supports on-device providers only.');
+        if(role==='stt'&&provider&&provider.localOnly!==true
+            &&!is.function(provider.createCapture)){
+            const error=new TypeError('Speech recognition requires an on-device or explicitly selected live-capture provider.');
             error.code='AI_STT_DEVICE_ONLY';
             throw error;
         }
@@ -6875,6 +6878,14 @@ class AI {
         }
     }
 
+    supportsTranscriptionCapture(){
+        return this.#providerRuntime.supportsTranscriptionCapture();
+    }
+
+    createTranscriptionCapture(options={}){
+        return this.#providerRuntime.createTranscriptionCapture(options);
+    }
+
     async fetchSTT(audioFile,signal=null){
         const callId=this.#traceSpeech('fetchSTT.call',{audioFile,aborted:signal?.aborted});
         try{

package/runtime/arcane/modules/AIProviderRuntime.js

@@ -1366,6 +1366,9 @@ function validateProvider(provider) {
     for (const method of PROVIDER_METHODS) {
         record[method] = provider[method].bind(provider);
     }
+    if (provider.role === 'stt' && is.function(provider.createCapture)) {
+        record.createCapture = provider.createCapture.bind(provider);
+    }
     const admitted = completeValue(record);
     PROVIDER_RECORDS.set(provider, admitted);
     return admitted;
@@ -4103,6 +4106,121 @@ export class AIProviderRuntime {
         return this.#roleRequestAlias('llm', 'stream', payload, options);
     }
 
+    supportsTranscriptionCapture(providerId = null) {
+        const slot = this.#slots.stt;
+        const provider = providerId === null
+            ? this.#providerFor(slot)
+            : this.#providers.get(providerKey('stt', providerId));
+        return is.function(provider?.createCapture);
+    }
+
+    createTranscriptionCapture(options = {}) {
+        this.#assertOpen();
+        this.#assertNotConfiguring();
+        const slot = this.#slots.stt;
+        const provider = this.#providerFor(slot);
+        if (!is.function(provider?.createCapture)) return null;
+
+        const runtime = this;
+        const generation = slot.generation;
+        const capture = provider.createCapture(options);
+        const controller = new AbortController();
+        let requestRecord = null;
+        let detachSignal = null;
+        let started = false;
+        let closed = false;
+        const done = Promise.resolve(capture.done).finally(
+            function releaseTranscriptionCapture() {
+                closed = true;
+                detachSignal?.();
+                if (!requestRecord) return;
+                slot.activeRequests.delete(requestRecord.requestSequence);
+                runtime.#drainRoleRequestQueue(slot);
+                if (slot.generation !== generation || slot.unloadPromise) return;
+                if (slot.activeRequests.size || slot.requestQueue.length) {
+                    runtime.#publishRoleRequestState(slot);
+                    return;
+                }
+                const status = validateProviderStatus(provider.status());
+                slot.ready = status.state === 'ready' && status.loaded && !status.busy;
+                publishAIRuntimeRoleState(
+                    'stt',
+                    roleRecord(
+                        'stt',
+                        slot.selection,
+                        {state: slot.ready ? 'ready' : 'unloaded', loaded: status.loaded}
+                    )
+                );
+            }
+        );
+        done.catch(
+            function observeTranscriptionCaptureCleanupFailure(error) {
+                arcaneLogging.error('Transcription capture cleanup failed.', error);
+            }
+        );
+        // Capture has its own synchronous start boundary so native microphone
+        // permission retains the originating user gesture. It is never queued.
+        return {
+            done,
+            start({signal} = {}) {
+                if (started || closed) return Promise.resolve(false);
+                try {
+                    runtime.#assertOpen();
+                    runtime.#assertNotConfiguring();
+                    const status = validateProviderStatus(provider.status());
+                    if (slot.generation !== generation || !slot.ready
+                        || slot.unloadPromise || slot.disposePromise
+                        || slot.activeRequests.size || slot.requestQueue.length
+                        || status.state !== 'ready' || !status.loaded || status.busy) {
+                        throw operationError(
+                            'The selected transcription capture provider is not ready.',
+                            'ARCANE_AI_ROLE_NOT_READY'
+                        );
+                    }
+                    assertAbortSignal(signal);
+                    started = true;
+                    detachSignal = runtime.#forwardAbort(signal, controller);
+                    const requestSequence = runtime.#nextRequestSequence(slot);
+                    requestRecord = {
+                        controller,
+                        requestSequence,
+                        operationId: runtime.#nextOperationId(slot, 'capture'),
+                        promise: done,
+                        cancel: function cancelOwnedTranscriptionCapture(reason) {
+                            controller.abort(reason);
+                            capture.cancel();
+                            return done;
+                        }
+                    };
+                    slot.activeRequests.set(requestSequence, requestRecord);
+                    runtime.#publishRoleRequestState(slot);
+                    const starting = capture.start({signal: controller.signal});
+                    return Promise.resolve(starting).catch(
+                        function releaseFailedTranscriptionCaptureStart(error) {
+                            capture.cancel();
+                            throw error;
+                        }
+                    );
+                } catch (error) {
+                    capture.cancel();
+                    throw error;
+                }
+            },
+            stop() {
+                capture.stop();
+                return done;
+            },
+            cancel() {
+                controller.abort();
+                capture.cancel();
+            },
+            destroy() {
+                controller.abort();
+                capture.destroy();
+            }
+        };
+    }
+
     transcribe(payload, options = {}) {
         arcaneLogging.debug('[Arcane speech runtime] transcribe', payload, options);
         return this.#roleRequestAlias('stt', 'transcribe', payload, options);

package/runtime/arcane/modules/PrintView.js

@@ -1,5 +1,13 @@
 import Is from 'strong-type';
-import {arcaneLightThemeTokens} from '../entities/Theme.js';
+
+// Components import this module independently of their rendering. Await only
+// the required print stylesheet here so every registered view is ready for the
+// synchronous native beforeprint event, with no stylesheet fetch during print.
+const printResponse=await fetch(new URL('../css/print.css',import.meta.url));
+if(!printResponse.ok){
+    throw new Error(`Unable to load shared print styles: HTTP ${printResponse.status}.`);
+}
+const printStyles=await printResponse.text();
 
 const is=new Is(false);
 const registries=new WeakMap();
@@ -401,38 +409,13 @@ function capture(registry,session){
     const heading=document.createElement('h1');
     heading.textContent=session.title;
     const rendered=copyRendered(session.content,state,true);
-    // Screen layout and fonts describe the rendered content; screen-theme paint
-    // does not describe a readable paper surface. Keep this palette in the
-    // snapshot, including its pseudo-elements, without recoloring SVG artwork.
-    styles.textContent=`
-        :host{color-scheme:light!important;color:${arcaneLightThemeTokens.text}!important;background:${arcaneLightThemeTokens.surface}!important;font:12pt/1.5 serif}
-        :host>h1{margin:0 0 .75em;font-size:1.5em;line-height:1.2}
-        [data-arcane-print-node]:not(svg,svg *,img,video,audio),
-        [data-arcane-print-node]:not(svg,svg *,img,video,audio)::before,
-        [data-arcane-print-node]:not(svg,svg *,img,video,audio)::after{
-            color:${arcaneLightThemeTokens.text}!important;background-color:transparent!important;
-            border-color:${arcaneLightThemeTokens.border}!important;color-scheme:light!important;
-            -webkit-text-fill-color:currentColor!important;-webkit-text-stroke:0!important;
-            text-decoration-color:currentColor!important;text-shadow:none!important;box-shadow:none!important
-        }
-        a[data-arcane-print-node]:not(svg *){text-decoration:underline!important}
-        table[data-arcane-print-node]:not(svg *){border-collapse:collapse!important}
-        th[data-arcane-print-node]:not(svg *),td[data-arcane-print-node]:not(svg *){border:1px solid ${arcaneLightThemeTokens.border}!important;padding:.35em .5em!important}
-        ${state.rules.join('\n')}
-    `;
+    // Only captured pseudo-element declarations are generated here. Authored
+    // print palette, page margins, and expansion rules share the CSS owner.
+    styles.textContent=printStyles+'\n'+state.rules.join('\n');
     root.append(styles,heading,rendered);
     const sheet=document.createElement('style');
     session.sheet=sheet;
-    sheet.textContent=`
-        [data-arcane-print-stage]{display:none!important}
-        @media print{
-            @page{margin:15mm}
-            html:root,html:root>body{display:block!important;height:auto!important;min-height:0!important;max-height:none!important;overflow:visible!important;contain:none!important;margin:0!important;padding:0!important;border:0!important;background:${arcaneLightThemeTokens.surface}!important;color:${arcaneLightThemeTokens.text}!important;color-scheme:light!important}
-            html:root>body>*:not([data-arcane-print-stage]){display:none!important}
-            html:root>body::before,html:root>body::after{display:none!important}
-            html:root>body>[data-arcane-print-stage]{display:block!important;position:static!important;width:auto!important;height:auto!important;overflow:visible!important;margin:0!important;padding:0!important;border:0!important}
-        }
-    `;
+    sheet.textContent=printStyles;
     document.head.append(sheet);
     document.body.append(stage);
     session.originalTitle=document.title;
@@ -523,36 +506,17 @@ function copyRendered(source,state,root=false){
         clone.selected=source.selected;
     }
     if(!['img','svg','video','audio','input','canvas'].includes(name)){
-        for(const [property,value] of [
-            ['height','auto'],['min-height','0'],['max-height','none'],
-            ['width','auto'],['min-width','0'],['max-width','100%'],['overflow','visible'],
-            ['contain','none'],['content-visibility','visible'],['grid-template-rows','none'],
-            ['break-inside','auto']
-        ]){
-            clone.style.setProperty(property,value);
-        }
-    }else if(name==='img'||name==='canvas'){
-        clone.style.setProperty('max-width','100%');
-        clone.style.setProperty('height','auto');
+        clone.setAttribute('data-arcane-print-expand','');
     }
     if(['absolute','fixed','sticky'].includes(appearance.position)){
-        clone.style.setProperty('position','static');
+        clone.setAttribute('data-arcane-print-static','');
     }
     if(root||name==='iframe'){
         clone.hidden=false;
-        clone.style.setProperty('display',appearance.display==='none'?'block':appearance.display);
-        clone.style.setProperty('visibility','visible');
-    }
-    if(name==='pre'){
-        clone.style.setProperty('white-space','pre-wrap');
-        clone.style.setProperty('overflow-wrap','anywhere');
-    }
-    if(name==='table'){
-        clone.style.setProperty('table-layout','auto');
-    }
-    if(name==='td'||name==='th'){
-        clone.style.setProperty('overflow-wrap','anywhere');
-        clone.style.setProperty('white-space','normal');
+        clone.setAttribute('data-arcane-print-root','');
+        if(appearance.display==='none'){
+            clone.setAttribute('data-arcane-print-block','');
+        }
     }
     if(name==='iframe'){
         const embedded=frameDocument(source);