arcane-os 0.5.16 → 0.5.18

package/runtime/arcane/components/source-code-viewer.html

@@ -177,6 +177,9 @@
 </section>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const host=this;
     host.ready=false;
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
@@ -244,7 +247,7 @@
 
     function normalizedText(value,label,{optional=false}={}){
         if(optional&&(value===undefined||value===null||value===''))return '';
-        if(typeof value!=='string'||!value.trim()||/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/.test(value)){
+        if(!is.string(value)||!value.trim()||/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/.test(value)){
             throw new TypeError(`${label} must be text.`);
         }
         return value.trim();
@@ -266,11 +269,11 @@
     }
 
     function normalizeOptions(input={},previous=defaultOptions){
-        if(!input||typeof input!=='object'||Array.isArray(input)){
+        if(!input||!is.object(input)||is.array(input)){
             throw new TypeError('Source viewer options must be an object.');
         }
         const labelInput=input.labels===undefined?{}:input.labels;
-        if(!labelInput||typeof labelInput!=='object'||Array.isArray(labelInput)){
+        if(!labelInput||!is.object(labelInput)||is.array(labelInput)){
             throw new TypeError('Source viewer labels must be an object.');
         }
         const labels={...previous.labels};
@@ -283,7 +286,7 @@
     }
 
     function normalizeRenderOptions(input={}){
-        if(!input||typeof input!=='object'||Array.isArray(input)){
+        if(!input||!is.object(input)||is.array(input)){
             throw new TypeError('Source render options must be an object.');
         }
         return {
@@ -306,10 +309,10 @@
         const sequence=++loadSequence;
         transition('loading');
         try{
-            const pending=typeof source==='function'?source():source;
+            const pending=is.function(source)?source():source;
             const result=await pending;
             if(destroyed||sequence!==loadSequence)return false;
-            if(result&&typeof result==='object'&&!Array.isArray(result)){
+            if(result&&is.object(result)&&!is.array(result)){
                 return renderSource(result.text??result.value??'',{
                     ...renderOptions,
                     ...result
@@ -334,7 +337,7 @@
     }
 
     function renderSource(text='',renderOptions={}){
-        if(typeof text!=='string')throw new TypeError('Source content must be a string.');
+        if(!is.string(text))throw new TypeError('Source content must be a string.');
         const metadata=normalizeRenderOptions(renderOptions);
         const lines=text.replace(/\r\n?/g,'\n').split('\n');
 
@@ -398,7 +401,7 @@
 
     function focusLine(value){
         const line=Number(value);
-        if(!Number.isInteger(line)||line<1||line>current.lineCount)return false;
+        if(!is.integer(line)||line<1||line>current.lineCount)return false;
         const target=sourceLines.querySelector(`[data-line="${line}"]`);
         if(!target)return false;
         target.focus({preventScroll:true});
@@ -433,7 +436,7 @@
             state:`source-code-viewer-${state}`,
             reason,
             ...(state==='error'?{
-                code:typeof error?.code==='string'
+                code:is.string(error?.code)
                     ?error.code
                     :'ARCANE_SOURCE_CODE_VIEWER_RENDER_REJECTED'
             }:{})

package/runtime/arcane/components/source-explanation.html

@@ -42,6 +42,9 @@
 </section>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
   const host=this; const root=host.shadowRoot;
   const title=root.querySelector('[data-title]'); const assessment=root.querySelector('[data-assessment]'); const badges=root.querySelector('[data-badges]');
   const elements=root.querySelector('[data-elements]'); const application=root.querySelector('[data-application]'); const limitations=root.querySelector('[data-limitations]'); const nextSteps=root.querySelector('[data-next-steps]');
@@ -73,7 +76,7 @@
   }
   function list(target,values=[],emptyLabel){
     target.replaceChildren();
-    for(const value of Array.isArray(values)?values:[]){const item=document.createElement('li'); item.textContent=String(value); target.append(item);}
+    for(const value of is.array(values)?values:[]){const item=document.createElement('li'); item.textContent=String(value); target.append(item);}
     if(!target.children.length){const item=document.createElement('li'); item.textContent=emptyLabel; target.append(item);}
   }
   function sameOrigin(value=''){
@@ -81,8 +84,8 @@
   }
 
   function showFinding(value={},config={}){
-    finding=value&&typeof value==='object'?value:null; if(!finding) throw new TypeError('A finding is required.');
-    sources=Array.isArray(finding.sources)?finding.sources:[];
+    finding=value&&is.object(value)?value:null; if(!finding) throw new TypeError('A finding is required.');
+    sources=is.array(finding.sources)?finding.sources:[];
     title.textContent=String(finding.label||'Investigative lead'); assessment.textContent=String(finding.assessment||finding.conclusion||'Human review is required before reliance.');
     badges.replaceChildren();
     for(const value of [finding.allegedActorLabel?`Alleged actor: ${finding.allegedActorLabel}`:'Actor not assigned',finding.kind||'Investigative lead',finding.confidence?`${finding.confidence} confidence`:'Confidence not assigned']){const badge=document.createElement('span'); badge.className='badge'; badge.textContent=value; badges.append(badge);}
@@ -99,7 +102,7 @@
     originalPicker.replaceChildren(...sources.flatMap((source,index)=>{if(!source?.pdfUrl)return[];const item=document.createElement('option');item.value=String(index);item.textContent=`${source.recordId||'Source'}${source.page?` — PDF page ${source.page}`:''}`;return[item];})); originalPicker.disabled=!originalPicker.options.length;
     original.hidden=true; original.removeAttribute('src'); originalLabel.textContent='Select a cited excerpt to inspect the original source page.';
     options(actor,config.actorOptions||[]); options(disposition,config.dispositionOptions||[]); options(confidence,config.confidenceOptions||[]);
-    const review=finding.review&&typeof finding.review==='object'?finding.review:{};
+    const review=finding.review&&is.object(finding.review)?finding.review:{};
     actor.value=String(review.classification||finding.allegedActor||'unassigned'); disposition.value=String(review.status||'unassessed'); confidence.value=String(review.attributes?.confidence||finding.confidence||'unassigned'); notes.value=String(review.notes||''); saveState.textContent='';
     if(!actor.value&&actor.options.length) actor.selectedIndex=0; if(!disposition.value&&disposition.options.length) disposition.selectedIndex=0; if(!confidence.value&&confidence.options.length) confidence.selectedIndex=0;
     const requestedSourceId=String(config.initialSourceId||'');
@@ -111,7 +114,7 @@
   }
 
   function selectSource(value=0){
-    const index=Number.isInteger(value)?value:sources.findIndex(source=>String(source?.id||'')===String(value||''));
+    const index=is.integer(value)?value:sources.findIndex(source=>String(source?.id||'')===String(value||''));
     if(index<0||!sources[index]?.pdfUrl) return false;
     showSource(index); return true;
   }

package/runtime/arcane/components/speech.html

@@ -132,6 +132,9 @@
 <button id="muteButton" type="button" class="mute" aria-pressed="true" aria-label="Voice unavailable" disabled>Voice unavailable</button>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const {arcaneLogging}=await import('arcane-os/logging');
 
     const completeValue = (value) => value;
@@ -251,10 +254,10 @@
         let causeCode = '';
         let message = '';
         try {
-            causeCode = typeof error?.code === 'string'
+            causeCode = is.string(error?.code)
                 ? error.code
                 : '';
-            message = typeof error?.message === 'string'
+            message = is.string(error?.message)
                 ? error.message
                 : '';
         } catch {}
@@ -293,7 +296,7 @@
         return String(reason || 'stt-transcription-cancelled');
     }
 
-    const initialMutedWasHydrated = typeof host.initialMuted === 'boolean';
+    const initialMutedWasHydrated = is.boolean(host.initialMuted);
     host.initialMuted = initialMutedWasHydrated ? host.initialMuted : true;
     host.muted = true;
     host.configure = configure;
@@ -400,9 +403,9 @@
     }
 
     function selectedRole(role) {
-        return typeof role?.providerId === 'string'
+        return is.string(role?.providerId)
             && role.providerId.length > 0
-            && typeof role?.modelId === 'string'
+            && is.string(role?.modelId)
             && role.modelId.length > 0;
     }
 
@@ -411,7 +414,7 @@
             return host;
         }
         if (Object.prototype.hasOwnProperty.call(options, 'initialMuted')) {
-            const configuredMuted = typeof options.initialMuted === 'boolean'
+            const configuredMuted = is.boolean(options.initialMuted)
                 ? options.initialMuted
                 : true;
             host.initialMuted = configuredMuted;
@@ -445,7 +448,7 @@
         if (destroyed) {
             return host;
         }
-        if (typeof muted !== 'boolean') {
+        if (!is.boolean(muted)) {
             throw new TypeError('muted must be boolean');
         }
 
@@ -545,8 +548,8 @@
     function renderControls() {
         const transcriptionReady = sttRole.state === 'ready';
         const microphoneReady = host.availability.microphone
-            && typeof globalThis.MediaRecorder === 'function'
-            && typeof navigator.mediaDevices?.getUserMedia === 'function';
+            && is.function(globalThis.MediaRecorder)
+            && is.function(navigator.mediaDevices?.getUserMedia);
         const activationVisible = sttActivationController.visible;
         recordButton.hidden = activationVisible;
         recordButton.disabled = !transcriptionReady
@@ -611,9 +614,9 @@
     }
 
     function renderTTSControl() {
-        const providerSelected = typeof ttsRole.providerId === 'string'
+        const providerSelected = is.string(ttsRole.providerId)
             && ttsRole.providerId.length > 0
-            && typeof ttsRole.modelId === 'string'
+            && is.string(ttsRole.modelId)
             && ttsRole.modelId.length > 0;
         let disabled = destroyed;
         let label = host.muted ? 'Unmute' : 'Mute';
@@ -730,10 +733,10 @@
     function visibleErrorMessage(error, fallback) {
         try {
             if (error?.userSafe === true) {
-                const message = typeof error.userMessage === 'string'
+                const message = is.string(error.userMessage)
                     ? error.userMessage
                     : error.message;
-                if (typeof message === 'string' && message.trim()) {
+                if (is.string(message) && message.trim()) {
                     return message;
                 }
             }
@@ -912,9 +915,9 @@
         ) {
             return false;
         }
-        const providerSelected = typeof ttsRole.providerId === 'string'
+        const providerSelected = is.string(ttsRole.providerId)
             && ttsRole.providerId.length > 0
-            && typeof ttsRole.modelId === 'string'
+            && is.string(ttsRole.modelId)
             && ttsRole.modelId.length > 0;
         const canRequestLoad = ttsRole.state === 'ready'
             || (
@@ -995,7 +998,7 @@
             : action;
         let lifecycle;
         try {
-            if (typeof globalThis.ai?.setSpeechMuted === 'function') {
+            if (is.function(globalThis.ai?.setSpeechMuted)) {
                 lifecycle = globalThis.ai.setSpeechMuted(action === 'unload');
             } else {
                 lifecycle = requestAIRuntimeIntent(
@@ -1162,7 +1165,7 @@
 
     function resumeTTSPlayback() {
         const aiRuntime = globalThis.ai;
-        if (!aiRuntime || typeof aiRuntime.resumeAudio !== 'function') {
+        if (!aiRuntime || !is.function(aiRuntime.resumeAudio)) {
             return;
         }
 
@@ -1196,8 +1199,8 @@
             || sttRole.state !== 'ready'
             || sttRole.busy
             || !host.availability.microphone
-            || typeof globalThis.MediaRecorder !== 'function'
-            || typeof navigator.mediaDevices?.getUserMedia !== 'function'
+            || !is.function(globalThis.MediaRecorder)
+            || !is.function(navigator.mediaDevices?.getUserMedia)
             || recordingRequested
             || captureSession
             || transcriptionActive
@@ -1473,7 +1476,7 @@
                 );
                 return false;
             }
-            if (typeof aiRuntime?.fetchSTT !== 'function') {
+            if (!is.function(aiRuntime?.fetchSTT)) {
                 const error = new Error('The selected transcription service is unavailable.');
                 error.code = 'ARCANE_SPEECH_STT_RUNTIME_METHOD_UNAVAILABLE';
                 throw error;
@@ -1490,7 +1493,7 @@
             ) {
                 return false;
             }
-            if (typeof transcription !== 'string') {
+            if (!is.string(transcription)) {
                 throw new TypeError('The selected transcription service returned invalid text.');
             }
 

package/runtime/arcane/components/summary-strip.html

@@ -38,6 +38,9 @@
 </section>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const host=this;
     const root=host.shadowRoot;
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
@@ -89,7 +92,7 @@
     }
 
     function updateItem(id,update={}){
-        const index=typeof id==='number'?id:items.findIndex(item=>item.id===`${id}`);
+        const index=is.number(id)?id:items.findIndex(item=>item.id===`${id}`);
         if(index<0||index>=items.length){
             return null;
         }

package/runtime/arcane/components/task-progress.html

@@ -45,6 +45,9 @@
 </section>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const host=this;
     const root=host.shadowRoot;
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
@@ -135,7 +138,7 @@
 
     function updateTask(id,update={}){
         if(destroyed)return null;
-        const index=typeof id==='number'?id:tasks.findIndex(task=>task.id===`${id}`);
+        const index=is.number(id)?id:tasks.findIndex(task=>task.id===`${id}`);
         if(index<0||index>=tasks.length){
             return null;
         }
@@ -203,7 +206,7 @@
         if(running){
             return activeRun;
         }
-        const runnable=Array.from(jobs||[]).filter(job=>job&&typeof job.task==='function');
+        const runnable=Array.from(jobs||[]).filter(job=>job&&is.function(job.task));
         if(!runnable.length){
             setTasks([]);
             return [];
@@ -244,7 +247,7 @@
                     'task-progress-error',
                     {error,id:tasks[index]?.id,index,task:{...tasks[index]}},
                     {
-                        code:typeof error?.code==='string'
+                        code:is.string(error?.code)
                             ?error.code
                             :'ARCANE_TASK_EXECUTION_REJECTED',
                         index,

package/runtime/arcane/components/terminal-workspace.html

@@ -26,6 +26,9 @@
     <form class="prompt" id="prompt"><label class="prompt-label" id="promptLabel" for="input">arcane ❯</label><textarea class="input" id="input" rows="1" autocomplete="off" autocapitalize="off" spellcheck="false" placeholder="Enter a command"></textarea></form>
 </section>
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const {parseAnsi,stripAnsi}=await import('../modules/AnsiText.js');
     const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
     const host=this,root=host.shadowRoot;
@@ -62,7 +65,7 @@
     function renderText(row,text,term){const clean=stripAnsi(text);if(!term){for(const token of parseAnsi(text)){const span=document.createElement('span');span.textContent=token.text;const classes=[];if(token.style.bold)classes.push('ansi-bold');if(token.style.dim)classes.push('ansi-dim');if(token.style.italic)classes.push('ansi-italic');if(token.style.underline)classes.push('ansi-underline');if(token.style.foreground&&!token.style.foreground.startsWith('index-'))classes.push(`ansi-${token.style.foreground}`);span.className=classes.join(' ');row.append(span);}return;}let cursor=0,index=clean.toLowerCase().indexOf(term);while(index>=0){row.append(document.createTextNode(clean.slice(cursor,index)));const mark=document.createElement('mark');mark.textContent=clean.slice(index,index+term.length);row.append(mark);cursor=index+term.length;index=clean.toLowerCase().indexOf(term,cursor);}row.append(document.createTextNode(clean.slice(cursor)));}
     function toggleSearch(force){search.hidden=force===undefined?!search.hidden:!force;if(!search.hidden)search.focus();else{search.value='';render();input.focus();}}
     function resizeInput(){input.style.height='auto';input.style.height=`${Math.min(input.scrollHeight,160)}px`;}
-    function emit(type,detail={}){if(destroyed)return false;const operationId=`${events.instanceId}:${type}:${(++eventOperationSequence).toString(36)}`;const publication=events.dispatch(type,detail,{operationId,publicDetail:{hasSession:Boolean(detail.sessionId),lineLength:typeof detail.line==='string'?detail.line.length:0,historyCount:Array.isArray(detail.history)?detail.history.length:0,reason:type}});return projectArcaneDOMEvent(host,publication.occurrence,{bubbles:true,composed:true});}
+    function emit(type,detail={}){if(destroyed)return false;const operationId=`${events.instanceId}:${type}:${(++eventOperationSequence).toString(36)}`;const publication=events.dispatch(type,detail,{operationId,publicDetail:{hasSession:Boolean(detail.sessionId),lineLength:is.string(detail.line)?detail.line.length:0,historyCount:is.array(detail.history)?detail.history.length:0,reason:type}});return projectArcaneDOMEvent(host,publication.occurrence,{bubbles:true,composed:true});}
     function destroy(){if(destroyed)return false;destroyed=true;host.ready=false;for(const id of ['find','clear','interrupt','settings','copy'])root.querySelector(`#${id}`).onclick=null;events.dispose();return true;}
     emit('terminal-workspace-ready');
 </script>

package/runtime/arcane/components/voice-transcription.html

@@ -60,6 +60,9 @@
 </section>
 
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
     const {arcaneLogging}=await import('arcane-os/logging');
 
     const completeValue=(value)=>value;
@@ -302,7 +305,7 @@
             return false;
         }
         if(
-            typeof MediaRecorder==='undefined'
+            is.undefined(globalThis.MediaRecorder)
             ||!navigator.mediaDevices?.getUserMedia
         ){
             setState('error',options.messages.unsupported);
@@ -468,7 +471,7 @@
                 ||destroyed){
                 return false;
             }
-            const segment=typeof result==='string'?result:'';
+            const segment=is.string(result)?result:'';
             if(segment.length===0){
                 setState('idle',options.messages.noSpeech);
                 return false;
@@ -483,7 +486,7 @@
 
             if(options.persist){
                 const save=options.onSave||(
-                    typeof host.save==='function'?host.save.bind(host):null
+                    is.function(host.save)?host.save.bind(host):null
                 );
                 if(!save){
                     setState('error',options.messages.saveError);
@@ -594,10 +597,10 @@
         if(options.transcribe){
             return options.transcribe(file,context);
         }
-        if(typeof globalThis.ai?.fetchSTT!=='function'){
+        if(!is.function(globalThis.ai?.fetchSTT)){
             await import('../modules/AI.js');
         }
-        if(typeof globalThis.ai?.fetchSTT!=='function'){
+        if(!is.function(globalThis.ai?.fetchSTT)){
             const error=new Error('Speech transcription is not configured.');
             error.code='ARCANE_VOICE_TRANSCRIPTION_STT_RUNTIME_METHOD_UNAVAILABLE';
             throw error;
@@ -646,7 +649,7 @@
         const generation=sessionGeneration;
         const completionTranscript=transcript;
         const complete=options.onComplete||(
-            typeof host.complete==='function'?host.complete.bind(host):null
+            is.function(host.complete)?host.complete.bind(host):null
         );
         setState('completing',options.messages.completing,{
             beginOperation:'completion'
@@ -963,10 +966,10 @@
     function visibleErrorMessage(error,fallback){
         try{
             if(error?.userSafe===true){
-                const message=typeof error.userMessage==='string'
+                const message=is.string(error.userMessage)
                     ?error.userMessage
                     :error.message;
-                if(typeof message==='string'&&message.trim()){
+                if(is.string(message)&&message.trim()){
                     return message;
                 }
             }

package/runtime/arcane/components/web-navigator.html

@@ -59,6 +59,9 @@ button{min-width:2.5rem}
     <p id="status" class="status" role="status" aria-live="polite">Enter an address. Some sites block embedded viewing; use Open externally when needed.</p>
 </section>
 <script type="module">
+    const {default:Is}=await import('strong-type');
+    const is=new Is(false);
+
 const host=this;
 const root=host.shadowRoot;
 const {createArcaneEventSource,projectArcaneDOMEvent}=await import('arcane-os/event-manager');
@@ -128,7 +131,7 @@ async function evaluate(url,intent){
     }
     try{
         const decision=await navigationGuard(url,{intent});
-        if(!decision||typeof decision!=='object'||typeof decision.blocked!=='boolean'){
+        if(!decision||!is.object(decision)||!is.boolean(decision.blocked)){
             throw new TypeError('Navigation policy returned an invalid decision.');
         }
         return decision;
@@ -230,7 +233,7 @@ function move(amount){
 function configure(options){
     if(destroyed)return false;
     if(options?.homeUrl)homeUrl=normalize(options.homeUrl);
-    navigationGuard=typeof options?.navigationGuard==='function'?options.navigationGuard:null;
+    navigationGuard=is.function(options?.navigationGuard)?options.navigationGuard:null;
     if(options?.initialUrl)ownNavigation(navigate(options.initialUrl));
     else updateButtons();
     return host;

package/runtime/arcane/entities/ApiModelRecord.js

@@ -1,5 +1,8 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 function deepFreeze(value){
-    if(!value||typeof value!=='object'||Object.isFrozen(value)) return value;
+    if(!value||!is.object(value)||Object.isFrozen(value)) return value;
     for(const child of Object.values(value)) deepFreeze(child);
     return Object.freeze(value);
 }
@@ -9,7 +12,7 @@ export default class ApiModelRecord{
         const url=new URL(String(endpoint||''));
         if(!['http:','https:'].includes(url.protocol)) throw new TypeError('API model endpoints must use HTTP or HTTPS.');
         const instant=new Date(fetchedAt);
-        if(Number.isNaN(instant.valueOf())) throw new TypeError('API model fetch time is invalid.');
+        if(is.NaN(instant.valueOf())) throw new TypeError('API model fetch time is invalid.');
         this.endpoint=url.href;
         this.fetchedAt=instant.toISOString();
         this.metadata=deepFreeze({...metadata});

package/runtime/arcane/entities/Calculation.js

@@ -1,11 +1,14 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 export default class Calculation{
     constructor({expression,result,createdAt=new Date()}={}){
         this.expression=String(expression??'');
         if(!this.expression.trim()) throw new TypeError('Calculation expressions must contain text.');
         this.result=Number(result);
-        if(!Number.isFinite(this.result)) throw new RangeError('Calculation result must be finite.');
+        if(!is.finite(this.result)) throw new RangeError('Calculation result must be finite.');
         const instant=new Date(createdAt);
-        if(Number.isNaN(instant.valueOf())) throw new TypeError('Calculation time is invalid.');
+        if(is.NaN(instant.valueOf())) throw new TypeError('Calculation time is invalid.');
         this.createdAt=instant.toISOString();
     }
     toJSON(){return {...this};}