arcane-os 0.5.16 → 0.5.18

package/runtime/arcane/modules/ScreenCapture.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import { arcaneLogging } from 'arcane-os/logging';
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 import GifEncoder from './GifEncoder.js';
@@ -163,10 +166,10 @@ function signalLike(value){
     return value===undefined
         ||value===null
         ||(
-            typeof value==='object'
-            &&typeof value.aborted==='boolean'
-            &&typeof value.addEventListener==='function'
-            &&typeof value.removeEventListener==='function'
+            is.object(value)
+            &&is.boolean(value.aborted)
+            &&is.function(value.addEventListener)
+            &&is.function(value.removeEventListener)
         );
 }
 
@@ -190,7 +193,7 @@ function abortError(cause){
 
 function optionsRecord(value,label){
     if(value===undefined)return {};
-    if(!value||typeof value!=='object'||Array.isArray(value)){
+    if(!value||!is.object(value)||is.array(value)){
         throw captureError(
             SCREEN_CAPTURE_ERRORS.optionsRecordRejected,
             label+' must be an object.',
@@ -211,7 +214,7 @@ function optionsRecord(value,label){
 
 function admittedOperationId(value){
     if(value===undefined||value===null)return null;
-    if(typeof value!=='string'
+    if(!is.string(value)
         ||value.trim()!==value
         ||!value){
         throw captureError(
@@ -225,7 +228,7 @@ function admittedOperationId(value){
 }
 
 function imageResultType(blob){
-    const reported=typeof blob?.type==='string'?blob.type.trim().toLowerCase():'';
+    const reported=is.string(blob?.type)?blob.type.trim().toLowerCase():'';
     if(!reported)return SCREEN_CAPTURE_IMAGE_TYPE_FALLBACK;
     const subtype=reported.startsWith('image/')
         ?reported.slice('image/'.length).split(';',1)[0]
@@ -252,7 +255,7 @@ function supportedRecorderType(Recorder){
 }
 
 function reportDetachedError(error){
-    if(typeof globalThis.reportError==='function')globalThis.reportError(error);
+    if(is.function(globalThis.reportError))globalThis.reportError(error);
     else arcaneLogging.error?.(error);
 }
 
@@ -436,7 +439,7 @@ export default class ScreenCapture extends EventTarget{
         if(this.#events.disposed)return null;
         const compatibilityDetail={
             ...detail,
-            mode:typeof detail?.mode==='string'?detail.mode:operation.mode,
+            mode:is.string(detail?.mode)?detail.mode:operation.mode,
             operationId:operation.id,
             reason,
             ...(code?{code}:{})
@@ -527,7 +530,7 @@ export default class ScreenCapture extends EventTarget{
 
     #attachTrackEnd(operation,stream){
         for(const track of stream?.getTracks?.()||[]){
-            if(typeof track?.addEventListener!=='function')continue;
+            if(!is.function(track?.addEventListener))continue;
             const owner=this;
             function stopEndedScreenCaptureTrack(){
                 if(!owner.#isCurrent(operation))return;
@@ -782,7 +785,7 @@ export default class ScreenCapture extends EventTarget{
             );
             this.#assertCurrent(operation);
             stage='image-encoding';
-            const type=typeof options.type==='string'&&options.type.trim()
+            const type=is.string(options.type)&&options.type.trim()
                 ?options.type.trim()
                 :'image/png';
             const blob=await this.#canvasBlob(
@@ -990,7 +993,7 @@ export default class ScreenCapture extends EventTarget{
 
     #startGifFrameSampling(operation,context,frameDelay){
         const requestedDelay=Number(frameDelay);
-        const explicitDelay=Number.isFinite(requestedDelay)&&requestedDelay>0
+        const explicitDelay=is.finite(requestedDelay)&&requestedDelay>0
             ?requestedDelay
             :null;
         let active=true;
@@ -1000,10 +1003,10 @@ export default class ScreenCapture extends EventTarget{
         if(explicitDelay!==null){
             requestFrame=callback=>setTimeout(()=>callback(monotonicNow()),explicitDelay);
             cancelFrame=handle=>clearTimeout(handle);
-        }else if(typeof operation.video?.requestVideoFrameCallback==='function'){
+        }else if(is.function(operation.video?.requestVideoFrameCallback)){
             requestFrame=callback=>operation.video.requestVideoFrameCallback(callback);
             cancelFrame=handle=>operation.video.cancelVideoFrameCallback?.(handle);
-        }else if(typeof globalThis.requestAnimationFrame==='function'){
+        }else if(is.function(globalThis.requestAnimationFrame)){
             requestFrame=callback=>globalThis.requestAnimationFrame(callback);
             cancelFrame=handle=>globalThis.cancelAnimationFrame?.(handle);
         }else{
@@ -1065,7 +1068,7 @@ export default class ScreenCapture extends EventTarget{
             operation.frames=[];
             operation.frameTimes=[];
             const requestedDelay=Number(options.frameDelay);
-            operation.gifDelay=Number.isFinite(requestedDelay)&&requestedDelay>0
+            operation.gifDelay=is.finite(requestedDelay)&&requestedDelay>0
                 ?requestedDelay
                 :0;
             operation.startedAt=Date.now();
@@ -1261,7 +1264,7 @@ export default class ScreenCapture extends EventTarget{
             if(options.signal?.aborted)throw abortError(options.signal.reason);
             const width=Number(video.videoWidth);
             const height=Number(video.videoHeight);
-            if(!Number.isFinite(width)||width<=0||!Number.isFinite(height)||height<=0){
+            if(!is.finite(width)||width<=0||!is.finite(height)||height<=0){
                 throw captureError(
                     SCREEN_CAPTURE_ERRORS.displayMetadataRejected,
                     'The selected display reported invalid frame dimensions.'
@@ -1370,7 +1373,7 @@ export default class ScreenCapture extends EventTarget{
                 TypeError
             );
         }
-        const mode=typeof detail?.mode==='string'
+        const mode=is.string(detail?.mode)
             ?detail.mode
             :(this.#operation?.mode??'capture');
         const operation=this.#operation??{

package/runtime/arcane/modules/SpeechPlayback.js

@@ -1,5 +1,21 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import {createArcaneEventSource} from 'arcane-os/event-manager';
+import {stripSpeechFormatting} from 'arcane-os/speech-text';
 
+const SPEECH_VOICE_OPTIONS=[
+    {value:'alloy',label:'Alloy'},
+    {value:'ash',label:'Ash'},
+    {value:'ballad',label:'Ballad'},
+    {value:'coral',label:'Coral'},
+    {value:'echo',label:'Echo'},
+    {value:'fable',label:'Fable'},
+    {value:'nova',label:'Nova'},
+    {value:'onyx',label:'Onyx'},
+    {value:'sage',label:'Sage'},
+    {value:'shimmer',label:'Shimmer'}
+];
 const SUPERSEDED={superseded:true};
 const SPEECH_PLAYBACK_STATE_EVENT='speech-playback-state';
 const SPEECH_PLAYBACK_FAILURE_REASONS={
@@ -17,21 +33,25 @@ const WAV_AUDIO_CONTENT_TYPES=new Set([
 ]);
 const queuesBySpeechClient=new WeakMap();
 
+const SPEECH_VOICE_ALIASES=new Set(
+    SPEECH_VOICE_OPTIONS.map(function voiceAlias(option){return option.value;})
+);
+
 function splitSpeechText(value=''){
     const text=String(value??'');
     return text.trim()?[text]:[];
 }
 
 function normalizeParts(parts,defaultVoice=null,defaultSpeed=1){
-    if(!Array.isArray(parts)||!parts.length){
+    if(!is.array(parts)||!parts.length){
         throw new TypeError('Narration text cannot be blank. The full visual content remains available.');
     }
     return parts.map(function normalizePart(part){
-        const candidate=typeof part==='string'?{input:part}:part;
+        const candidate=is.string(part)?{input:part}:part;
         const input=String(candidate?.input??'');
         if(!input.trim())throw new TypeError('Speech segments cannot be blank. The full visual content remains available.');
         const pauseAfterMs=Number(candidate?.pauseAfterMs??0);
-        if(!Number.isFinite(pauseAfterMs)||pauseAfterMs<0){
+        if(!is.finite(pauseAfterMs)||pauseAfterMs<0){
             throw new RangeError('Speech segment pauses must be a nonnegative number of milliseconds.');
         }
         const voiceValue=candidate?.voice??defaultVoice;
@@ -40,7 +60,7 @@ function normalizeParts(parts,defaultVoice=null,defaultSpeed=1){
         if(voiceValue!==null&&voiceValue!==undefined&&!voice.trim()){
             throw new TypeError('Speech segment voice cannot be blank.');
         }
-        if(!Number.isFinite(speed)||speed<=0)throw new RangeError('Every speech segment requires a positive speech speed.');
+        if(!is.finite(speed)||speed<=0)throw new RangeError('Every speech segment requires a positive speech speed.');
         return {
             input,
             pauseAfterMs,
@@ -67,7 +87,7 @@ function synthesizedAudioContractError(cause=null){
 
 function normalizeAudioContentType(value,fallback=null){
     const candidate=value===undefined||value===null?fallback:value;
-    if(typeof candidate!=='string'||!candidate.trim()){
+    if(!is.string(candidate)||!candidate.trim()){
         throw synthesizedAudioContractError();
     }
     const contentType=candidate.split(';',1)[0].trim().toLowerCase();
@@ -86,7 +106,7 @@ function speechAudioBytes(value){
     if(value instanceof ArrayBuffer){
         return new Uint8Array(value.slice(0));
     }
-    if(ArrayBuffer.isView(value)){
+    if(is.arrayBufferView(value)){
         return new Uint8Array(
             value.buffer.slice(
                 value.byteOffset,
@@ -186,23 +206,23 @@ async function validatedSpeechBytes(bytes,contentType='audio/wav'){
 async function playableSpeechBlob(response){
     try{
         if(response instanceof Blob)return validatedSpeechBlob(response);
-        if(response instanceof ArrayBuffer||ArrayBuffer.isView(response)){
+        if(response instanceof ArrayBuffer||is.arrayBufferView(response)){
             return validatedSpeechBytes(speechAudioBytes(response));
         }
-        if(response&&typeof response==='object'){
+        if(response&&is.object(response)){
             if(response.audio instanceof Blob){
                 return validatedSpeechBlob(
                     response.audio,
                     response.contentType
                 );
             }
-            if(response.audio instanceof ArrayBuffer||ArrayBuffer.isView(response.audio)){
+            if(response.audio instanceof ArrayBuffer||is.arrayBufferView(response.audio)){
                 return validatedSpeechBytes(
                     speechAudioBytes(response.audio),
                     response.contentType
                 );
             }
-            if(typeof response.audioBase64==='string'&&response.audioBase64){
+            if(is.string(response.audioBase64)&&response.audioBase64){
                 return validatedSpeechBytes(
                     base64Bytes(response.audioBase64),
                     response.contentType
@@ -221,7 +241,7 @@ async function playableSpeechBlob(response){
 
 function speechPlaybackFailureReason(error){
     if(error?.name==='AbortError')return 'speech-synthesis-cancelled';
-    if(typeof error?.code==='string'
+    if(is.string(error?.code)
         &&Object.hasOwn(SPEECH_PLAYBACK_FAILURE_REASONS,error.code)){
         return SPEECH_PLAYBACK_FAILURE_REASONS[error.code];
     }
@@ -278,7 +298,7 @@ class LatestSpeechQueue{
 }
 
 function queueFor(speech){
-    if((typeof speech!=='object'||speech===null)&&typeof speech!=='function'){
+    if((!is.object(speech)||speech===null)&&!is.function(speech)){
         throw new TypeError('A local speech client is required.');
     }
     let queue=queuesBySpeechClient.get(speech);
@@ -290,15 +310,15 @@ function queueFor(speech){
 }
 
 function providerSpeechCapacity(speech){
-    if(typeof speech?.fetchTTS!=='function')return null;
+    if(!is.function(speech?.fetchTTS))return null;
     try{
         const providerRuntime=speech.providerRuntime;
-        if(!providerRuntime||typeof providerRuntime.status!=='function')return null;
+        if(!providerRuntime||!is.function(providerRuntime.status))return null;
         const capacity=providerRuntime.status(
             'tts',
             {execution:true}
         )?.execution?.maxConcurrentRequests;
-        return Number.isSafeInteger(capacity)&&capacity>0?capacity:null;
+        return is.safeInteger(capacity)&&capacity>0?capacity:null;
     }catch{
         // Clients without inspectable provider capacity retain serialized admission.
         return null;
@@ -401,16 +421,17 @@ class SpeechPlayback{
         voice=null,
         responseFormat=null,
         speed=1,
+        onState=function noop(){},
         createObjectURL,
         revokeObjectURL,
         delay,
         messages={}
     }={}){
-        if(!audio||typeof audio.addEventListener!=='function'){
+        if(!audio||!is.function(audio.addEventListener)){
             throw new TypeError('SpeechPlayback requires an audio element.');
         }
         const normalizedSpeed=Number(speed);
-        if(!Number.isFinite(normalizedSpeed)||normalizedSpeed<=0){
+        if(!is.finite(normalizedSpeed)||normalizedSpeed<=0){
             throw new RangeError('SpeechPlayback speed must be a positive number.');
         }
         this.audio=audio;
@@ -422,6 +443,7 @@ class SpeechPlayback{
                 eventTypes:[SPEECH_PLAYBACK_STATE_EVENT]
             }
         );
+        this.onState=onState;
         this.createObjectURL=createObjectURL||function createAudioURL(blob){return URL.createObjectURL(blob);};
         this.revokeObjectURL=revokeObjectURL||function revokeAudioURL(url){URL.revokeObjectURL(url);};
         this.delay=delay||function playbackDelay(duration,signal){
@@ -477,7 +499,7 @@ class SpeechPlayback{
 
     message(name,details={}){
         const value=this.messages[name];
-        return String(typeof value==='function'?value(details):value||'');
+        return String(is.function(value)?value(details):value||'');
     }
 
     nextOperationId(){
@@ -515,6 +537,12 @@ class SpeechPlayback{
                 }
             );
         }
+        try{
+            this.onState(detail);
+        }catch(error){
+            if(is.function(globalThis.reportError))globalThis.reportError(error);
+            else console.error(error);
+        }
         return detail;
     }
 
@@ -522,8 +550,8 @@ class SpeechPlayback{
         return Boolean(
             this.speech
             &&(
-                typeof this.speech.fetchTTS==='function'
-                ||typeof this.speech.synthesize==='function'
+                is.function(this.speech.fetchTTS)
+                ||is.function(this.speech.synthesize)
             )
         );
     }
@@ -569,21 +597,23 @@ class SpeechPlayback{
     }
 
     async requestSpeech(part,signal){
+        const input=stripSpeechFormatting(part.input);
+        const preparation={speechInputPrepared:true};
         const payload={
-            input:part.input,
+            input,
             speed:part.speed,
             ...(this.model?{model:this.model}:{}),
             ...(part.voice?{voice:part.voice}:{}),
             ...(this.responseFormat?{responseFormat:this.responseFormat}:{})
         };
-        if(typeof this.speech?.fetchTTS==='function'){
+        if(is.function(this.speech?.fetchTTS)){
             return playableSpeechBlob(
-                await this.speech.fetchTTS(payload,signal)
+                await this.speech.fetchTTS(payload,signal,preparation)
             );
         }
-        if(typeof this.speech?.synthesize==='function'){
+        if(is.function(this.speech?.synthesize)){
             return playableSpeechBlob(
-                await this.speech.synthesize(payload,{signal})
+                await this.speech.synthesize(payload,{signal},preparation)
             );
         }
         const error=new Error(this.message('unavailable'));
@@ -756,7 +786,7 @@ class SpeechPlayback{
                 throw error;
             }
             const numericSpeed=Number(speed);
-            if(!Number.isFinite(numericSpeed)||numericSpeed<=0)throw new RangeError('Speech speed must be a positive number.');
+            if(!is.finite(numericSpeed)||numericSpeed<=0)throw new RangeError('Speech speed must be a positive number.');
             const selectedModel=model===null||model===undefined
                 ?null
                 :String(model);
@@ -780,7 +810,7 @@ class SpeechPlayback{
             this.voice=selectedVoice;
             this.responseFormat=selectedResponseFormat;
             normalized=normalizeParts(
-                typeof parts==='function'?parts():parts,
+                is.function(parts)?parts():parts,
                 selectedVoice,
                 numericSpeed
             );
@@ -980,7 +1010,7 @@ class SpeechPlayback{
 
     fail(error){
         const reason=speechPlaybackFailureReason(error);
-        const code=typeof error?.code==='string'&&error.code.trim()
+        const code=is.string(error?.code)&&error.code.trim()
             ?error.code.trim()
             :reason==='speech-playback-request-contract-mismatch'
                 ?'ARCANE_SPEECH_PLAYBACK_REQUEST_CONTRACT_MISMATCH'
@@ -1002,12 +1032,15 @@ class SpeechPlayback{
         this.audio.removeEventListener('error',this.boundError);
         this.destroyed=true;
         this.events.dispose();
+        this.onState=function destroyedSpeechPlaybackStateObserver(){};
         return true;
     }
 }
 
 export {
     SPEECH_PLAYBACK_STATE_EVENT,
+    SPEECH_VOICE_ALIASES,
+    SPEECH_VOICE_OPTIONS,
     SpeechPlayback,
     splitSpeechText
 };

package/runtime/arcane/modules/StaticDocumentCatalog.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import DocumentLexicalSearch,{
     documentContextExcerpt,
     documentSearchTokens,
@@ -16,8 +19,8 @@ const MEDIA_TYPES=new Set(['text/markdown','text/plain']);
 
 function isPlainRecord(value){
     return Boolean(value)
-        &&typeof value==='object'
-        &&!Array.isArray(value)
+        &&is.object(value)
+        &&!is.array(value)
         &&Object.getPrototypeOf(value)===Object.prototype;
 }
 
@@ -36,7 +39,7 @@ function assertKnownKeys(value,allowed,label,code='STATIC_DOCUMENT_INVALID_CATAL
 }
 
 function structuralInteger(value,label,{minimum=0,maximum=null}={}){
-    if(!Number.isSafeInteger(value)||value<minimum||(maximum!==null&&value>maximum)){
+    if(!is.safeInteger(value)||value<minimum||(maximum!==null&&value>maximum)){
         const range=maximum===null?`${minimum} or greater`:`${minimum} through ${maximum}`;
         fail(`${label} must be a safe integer ${range}.`,'STATIC_DOCUMENT_INVALID_VALUE',RangeError);
     }
@@ -45,7 +48,7 @@ function structuralInteger(value,label,{minimum=0,maximum=null}={}){
 
 function normalizedText(value,label,{optional=false}={}){
     if(optional&&(value===undefined||value===null||value==='')) return '';
-    if(typeof value!=='string') fail(`${label} must be a string.`,'STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.string(value)) fail(`${label} must be a string.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     if(!value.trim()&&!optional) fail(`${label} cannot be empty.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     if(CONTROL_CHARACTERS.test(value)) fail(`${label} cannot contain control characters.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     if(value!==value.normalize('NFC')) fail(`${label} must use Unicode NFC normalization.`,'STATIC_DOCUMENT_INVALID_CATALOG');
@@ -93,7 +96,7 @@ function relativePath(value,label='Document path'){
 
 function normalizeTags(value){
     if(value===undefined) return [];
-    if(!Array.isArray(value))fail('Document tags must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(value))fail('Document tags must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
     const seen=new Set();
     const tags=value.map((item,index)=>{
         const tag=normalizedText(item,`Document tag ${index+1}`);
@@ -107,7 +110,7 @@ function normalizeTags(value){
 
 function normalizeTextList(value,label){
     if(value===undefined) return [];
-    if(!Array.isArray(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     const seen=new Set();
     const values=value.map(function normalizeTextListEntry(item,index){
         const text=normalizedText(item,`${label} entry ${index+1}`);
@@ -149,7 +152,7 @@ function normalizeLanguage(value,label){
 
 function normalizeSearchTerms(value,label){
     if(value===undefined) return [];
-    if(!Array.isArray(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     const seen=new Set();
     const terms=value.map((item,index)=>{
         const term=normalizedText(item,`${label} entry ${index+1}`);
@@ -163,7 +166,7 @@ function normalizeSearchTerms(value,label){
 
 function normalizeHeadings(value){
     if(value===undefined) return [];
-    if(!Array.isArray(value))fail('Document headings must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(value))fail('Document headings must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
     const seen=new Set();
     const headings=value.map((item,index)=>{
         if(!isPlainRecord(item)) fail(`Document heading ${index+1} must be a plain object.`,'STATIC_DOCUMENT_INVALID_CATALOG');
@@ -184,7 +187,7 @@ function normalizeHeadings(value){
 
 function normalizePathList(value,label){
     if(value===undefined) return [];
-    if(!Array.isArray(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(value))fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_CATALOG');
     const seen=new Set();
     const paths=value.map((item,index)=>{
         const path=relativePath(item,`${label} entry ${index+1}`);
@@ -293,7 +296,7 @@ function normalizeStaticDocumentCatalog(input,options={}){
     if(!isPlainRecord(options)) fail('Catalog normalization options must be a plain object.','STATIC_DOCUMENT_INVALID_OPTIONS');
     if(!isPlainRecord(input)) fail('Static document catalog must be a plain object.','STATIC_DOCUMENT_INVALID_CATALOG');
     assertKnownKeys(input,new Set(['documents','version']),'Static document catalog');
-    if(!Array.isArray(input.documents)) fail('Static document catalog documents must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
+    if(!is.array(input.documents)) fail('Static document catalog documents must be an array.','STATIC_DOCUMENT_INVALID_CATALOG');
     const records=input.documents.map((record,index)=>normalizeRecord(record,index));
     const ids=new Set();
     const paths=new Set();
@@ -384,11 +387,11 @@ function normalizeOptions(input){
         cacheTimeoutMs:optionalTimeout(input.cacheTimeoutMs,'cacheTimeoutMs'),
         fetchTimeoutMs:optionalTimeout(input.fetchTimeoutMs,'fetchTimeoutMs'),
     });
-    const fetchImpl=input.fetchImpl??(typeof globalThis.fetch==='function'?globalThis.fetch.bind(globalThis):null);
-    if(fetchImpl!==null&&typeof fetchImpl!=='function') fail('fetchImpl must be a function when provided.','STATIC_DOCUMENT_INVALID_OPTIONS');
-    if(input.onCacheError!==undefined&&typeof input.onCacheError!=='function') fail('onCacheError must be a function when provided.','STATIC_DOCUMENT_INVALID_OPTIONS');
+    const fetchImpl=input.fetchImpl??(is.function(globalThis.fetch)?globalThis.fetch.bind(globalThis):null);
+    if(fetchImpl!==null&&!is.function(fetchImpl)) fail('fetchImpl must be a function when provided.','STATIC_DOCUMENT_INVALID_OPTIONS');
+    if(input.onCacheError!==undefined&&!is.function(input.onCacheError)) fail('onCacheError must be a function when provided.','STATIC_DOCUMENT_INVALID_OPTIONS');
     const cache=input.cache??null;
-    if(cache!==null&&(typeof cache!=='object'||typeof cache.get!=='function'||typeof cache.set!=='function')){
+    if(cache!==null&&(!is.object(cache)||!is.function(cache.get)||!is.function(cache.set))){
         fail('cache must expose get(key) and set(key, value).','STATIC_DOCUMENT_INVALID_OPTIONS');
     }
     return completeValue({
@@ -411,7 +414,7 @@ function lineNumberAt(value,offset){
 }
 
 function queryText(value){
-    if(typeof value!=='string') fail('Search query must be a string.','STATIC_DOCUMENT_INVALID_QUERY');
+    if(!is.string(value)) fail('Search query must be a string.','STATIC_DOCUMENT_INVALID_QUERY');
     const query=value.trim();
     if(CONTROL_CHARACTERS.test(query)){
         fail('Search query must be plain text.','STATIC_DOCUMENT_INVALID_QUERY');
@@ -421,7 +424,7 @@ function queryText(value){
 
 function normalizeFilter(value,label){
     if(value===undefined) return null;
-    if(!Array.isArray(value)) fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_QUERY');
+    if(!is.array(value)) fail(`${label} must be an array.`,'STATIC_DOCUMENT_INVALID_QUERY');
     const normalized=value.map((item,index)=>normalizedText(item,`${label} entry ${index+1}`).toLowerCase());
     return new Set(normalized);
 }
@@ -442,19 +445,19 @@ function staticDocumentCacheKey(version,id){
 }
 
 async function responseText(response){
-    if(typeof response==='string')return response;
-    if(response instanceof ArrayBuffer||ArrayBuffer.isView(response)){
+    if(is.string(response))return response;
+    if(response instanceof ArrayBuffer||is.arrayBufferView(response)){
         try{return new TextDecoder('utf-8',{fatal:true}).decode(response);}
         catch{fail('Document response is not valid UTF-8 text.','STATIC_DOCUMENT_INVALID_TEXT');}
     }
-    if(!response||typeof response!=='object') fail('fetchImpl returned an invalid response.','STATIC_DOCUMENT_INVALID_RESPONSE');
+    if(!response||!is.object(response)) fail('fetchImpl returned an invalid response.','STATIC_DOCUMENT_INVALID_RESPONSE');
     if('ok' in response&&!response.ok){
         fail(`Document request failed (${Number(response.status)||0}).`,'STATIC_DOCUMENT_HTTP_ERROR');
     }
-    if(typeof response.arrayBuffer==='function'){
+    if(is.function(response.arrayBuffer)){
         return responseText(await response.arrayBuffer());
     }
-    if(typeof response.text==='function')return response.text();
+    if(is.function(response.text))return response.text();
     if(response.body?.getReader){
         const reader=response.body.getReader();
         const decoder=new TextDecoder('utf-8',{fatal:true});
@@ -488,10 +491,10 @@ function abortError(message='The document request was aborted.'){
 
 function signalLike(value){
     return value===undefined||value===null||(
-        typeof value==='object'
-        &&typeof value.aborted==='boolean'
-        &&typeof value.addEventListener==='function'
-        &&typeof value.removeEventListener==='function'
+        is.object(value)
+        &&is.boolean(value.aborted)
+        &&is.function(value.addEventListener)
+        &&is.function(value.removeEventListener)
     );
 }
 
@@ -531,7 +534,7 @@ function timedOperation(operation,{milliseconds,signal}){
 function hydrationOptions(input){
     if(!isPlainRecord(input)) fail('Hydration options must be a plain object.','STATIC_DOCUMENT_INVALID_OPTIONS');
     assertKnownKeys(input,new Set(['bypassCache','signal']),'Hydration options','STATIC_DOCUMENT_INVALID_OPTIONS');
-    if(input.bypassCache!==undefined&&typeof input.bypassCache!=='boolean') fail('bypassCache must be a boolean.','STATIC_DOCUMENT_INVALID_OPTIONS');
+    if(input.bypassCache!==undefined&&!is.boolean(input.bypassCache)) fail('bypassCache must be a boolean.','STATIC_DOCUMENT_INVALID_OPTIONS');
     if(!signalLike(input.signal)) fail('signal must be an AbortSignal.','STATIC_DOCUMENT_INVALID_OPTIONS');
     return {bypassCache:Boolean(input.bypassCache),signal:input.signal??null};
 }
@@ -545,7 +548,7 @@ function normalizedError(error){
         }
     }catch{}
     return completeValue({
-        code:typeof error?.code==='string'?error.code:'STATIC_DOCUMENT_ERROR',
+        code:is.string(error?.code)?error.code:'STATIC_DOCUMENT_ERROR',
         message,
     });
 }
@@ -615,7 +618,7 @@ export default class StaticDocumentCatalog{
     }
 
     get(id){
-        if(typeof id!=='string'||!ID_PATTERN.test(id)) fail('Document id is invalid.','STATIC_DOCUMENT_INVALID_ID');
+        if(!is.string(id)||!ID_PATTERN.test(id)) fail('Document id is invalid.','STATIC_DOCUMENT_INVALID_ID');
         return this.#recordsById.get(id)??null;
     }
 
@@ -685,7 +688,7 @@ export default class StaticDocumentCatalog{
                 ||entry.schemaVersion!==CATALOG_SCHEMA_VERSION
                 ||entry.catalogVersion!==this.version
                 ||entry.documentId!==record.id
-                ||typeof entry.text!=='string'
+                ||!is.string(entry.text)
             ) fail('Cached document metadata is invalid.','STATIC_DOCUMENT_CACHE_INVALID');
             return this.#retainHydration(record,entry.text,this.#resolve(record).href);
         }catch(error){
@@ -745,7 +748,7 @@ export default class StaticDocumentCatalog{
     async buildContext(query,options={}){
         if(!isPlainRecord(options)) fail('Context options must be a plain object.','STATIC_DOCUMENT_INVALID_OPTIONS');
         if(!signalLike(options.signal)) fail('signal must be an AbortSignal.','STATIC_DOCUMENT_INVALID_OPTIONS');
-        if(options.bodySearch!==undefined&&typeof options.bodySearch!=='boolean') fail('bodySearch must be a boolean.','STATIC_DOCUMENT_INVALID_OPTIONS');
+        if(options.bodySearch!==undefined&&!is.boolean(options.bodySearch)) fail('bodySearch must be a boolean.','STATIC_DOCUMENT_INVALID_OPTIONS');
         const queryValue=queryText(query);
         const bodySearch=Boolean(options.bodySearch)&&Boolean(queryValue);
         const indexedMatches=this.#lexicalSearch.rank(queryValue);

package/runtime/arcane/modules/SystemAppearance.js

@@ -1,10 +1,13 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 export default class SystemAppearance{
     constructor(api=globalThis.Arcane?.appearance||null){ this.api=api; }
 
-    available(){ return Boolean(this.api&&typeof this.api.apply==='function'); }
+    available(){ return Boolean(this.api&&is.function(this.api.apply)); }
 
     async current(){
-        if(!this.api||typeof this.api.current!=='function') return {supported:false,platform:'browser'};
+        if(!this.api||!is.function(this.api.current)) return {supported:false,platform:'browser'};
         return this.api.current();
     }
 

package/runtime/arcane/modules/SystemToolRegistry.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 const TOOL_PATTERN=/^[a-z][a-z0-9-]{0,63}$/;
 
 function quoteArgument(value){
@@ -11,7 +14,7 @@ export default class SystemToolRegistry{
     register(definition={}){
         const id=String(definition.id||'').trim().toLowerCase();
         if(!TOOL_PATTERN.test(id)||this.tools.has(id))throw new TypeError(`Duplicate or invalid system tool: ${id}`);
-        if(typeof definition.command!=='function'&&typeof definition.command!=='string')throw new TypeError(`System tool ${id} requires a command builder.`);
+        if(!is.function(definition.command)&&!is.string(definition.command))throw new TypeError(`System tool ${id} requires a command builder.`);
         const record=Object.freeze({id,label:String(definition.label||id),description:String(definition.description||''),usage:String(definition.usage||id),command:definition.command});
         this.tools.set(id,record);return record;
     }
@@ -19,8 +22,8 @@ export default class SystemToolRegistry{
     get(id){return this.tools.get(String(id||'').toLowerCase())||null;}
     build(id,args=[]){
         const tool=this.get(id);if(!tool)throw new RangeError(`Unknown system tool: ${id}`);
-        const command=typeof tool.command==='function'?tool.command(Array.from(args)):tool.command;
-        if(typeof command!=='string'||!command.trim())throw new TypeError(`System tool ${id} produced an empty command.`);
+        const command=is.function(tool.command)?tool.command(Array.from(args)):tool.command;
+        if(!is.string(command)||!command.trim())throw new TypeError(`System tool ${id} produced an empty command.`);
         return command.trim();
     }
 }