ranuts 0.4.0-alpha.1 → 0.4.0-alpha.3

package/dist/src/utils/index.js

@@ -1 +1 @@
-import{i as s}from"../../enums-BAgbyGdH.js";import{A as a,B as t,C as n,D as o,E as r,F as m,G as i,H as p,I as f,J as j,K as c,L as l,M as u,N as h,O as x,P as b,Q as d,R as e,S as g,T as k,U as v,V as w,W as y,X as z,Y as A,Z as B,_ as C,a as D,b as E,c as F,d as H,f as I,g as L,h as M,i as N,j as O,k as P,l as R,m as S,n as T,o as U,p as V,q as W,r as _,s as q,t as G,u as J,v as K,w as Q,x as X,y as Y,z as Z}from"../../color-Dohr9BXX.js";import{$,$t as ss,A as as,At as ts,B as ns,Bt as os,C as rs,Ct as ms,D as is,Dt as ps,E as fs,Et as js,F as cs,Ft as ls,G as us,Gt as hs,H as xs,Ht as bs,I as ds,It as es,J as gs,Jt as ks,K as vs,Kt as ws,L as ys,Lt as zs,M as As,Mt as Bs,N as Cs,Nt as Ds,O as Es,Ot as Fs,P as Hs,Pt as Is,Q as Ls,Qt as Ms,R as Ns,Rt as Os,S as Ps,St as Rs,T as Ss,Tt as Ts,U as Us,Ut as Vs,V as Ws,Vt as _s,W as qs,Wt as Gs,X as Js,Xt as Ks,Y as Qs,Yt as Xs,Z as Ys,Zt as Zs,_ as $s,_t as sa,a as aa,an as ta,at as na,b as oa,bt as ra,c as ma,cn as ia,ct as pa,d as fa,dt as ja,en as ca,et as la,f as ua,ft as ha,g as xa,gt as ba,h as da,ht as ea,i as ga,in as ka,it as va,j as wa,jt as ya,k as za,kt as Aa,l as Ba,ln as Ca,lt as Da,m as Ea,mt as Fa,n as Ha,nn as Ia,nt as La,o as Ma,on as Na,ot as Oa,p as Pa,pt as Ra,q as Sa,qt as Ta,r as Ua,rn as Va,rt as Wa,s as _a,sn as qa,st as Ga,t as Ja,tn as Ka,tt as Qa,u as Xa,un as Ya,ut as Za,v as $a,vt as st,w as at,wt as tt,x as nt,xt as ot,y as rt,yt as mt,z as it,zt as pt}from"../../utils-8TVtLBjA.js";import{A as ft,B as jt,C as ct,D as lt,E as ut,F as ht,H as xt,I as bt,L as dt,M as et,N as gt,O as kt,P as vt,R as wt,S as yt,T as zt,U as At,V as Bt,W as Ct,_ as Dt,a as Et,b as Ft,c as Ht,d as It,f as Lt,g as Mt,h as Nt,i as Ot,k as Pt,l as Rt,m as St,n as Tt,o as Ut,p as Vt,r as Wt,s as _t,t as qt,u as Gt,v as Jt,w as Kt,x as Qt,y as Xt,z as Yt}from"../../i18n-Cf5TtRb4.js";import{n as Zt,t as $t}from"../../chain-CTywmh_H.js";export{gs as ADOPTED_SHEET_MARKER,Qs as ADOPTED_STYLE_MARKER,Ds as AudioRecorder,ws as BRIDGE_MARKER,Ta as BridgeManager,$t as Chain,ks as Client,G as Color,T as ColorScheme,Xs as DEFAULT_CHANNEL,sa as EventManager,_ as FMT,N as HEX_COLOR_REGEX,D as Hsl,U as Hsla,qt as I18nCore,et as MOBILE_MEDIA_QUERY,Ia as Mathjs,f as MessageCodec,u as MimeType,Ma as Monitor,Ks as Platform,Zs as PostMessageBridge,Ua as QuestQueue,q as RGBA_REGEX,F as RGB_REGEX,R as Rgb,J as Rgba,s as SyncHook,ps as TOTP,at as TimeoutError,vs as WebDB,cs as WorkerClient,da as ZIP_DEFLATE,xa as ZIP_STORED,Ms as acceptPortBridge,mt as addClassToElement,Va as addNumSym,Js as adoptSheetText,Ys as adoptStyles,It as appendUrl,l as arrayBufferToString,Fs as audioVendor,ss as bridgeManager,Us as buildOffsets,Aa as canvasVendor,e as changeHumpToLowerCase,Z as checkEncoding,Za as circ,t as clearBr,w as clearStr,Is as cloneDeep,H as componentToHex,js as compose,Lt as connection,Ls as convertImageToBase64,$s as crc32,Zt as create,Xa as createData,ra as createDocumentFragment,Sa as createHandoff,Tt as createI18n,Ws as createLocalePath,Vt as createObjectURL,ca as createPortBridge,ya as createSignal,_t as createStore,$a as createZip,ja as cubic,gt as currentDevice,$ as cutRound,tt as debounce,Ss as deferred,fs as delay,Ot as detectLanguage,St as durationHandler,Nt as encodeUrl,ot as escapeHtml,ha as expo,va as fanShapedByArc,ls as filterObj,jt as formatDate,es as formatJson,Mt as getAllQueryString,na as getAngle,Oa as getArcPointerByDeg,Dt as getCookie,Jt as getCookieByName,h as getExtensions,Xt as getFrame,la as getImage,Ga as getLinearGradient,p as getMatchingSentences,Qa as getMatrix,b as getMime,Ea as getPerformance,Ft as getPixelRatio,Qt as getQuery,v as getRandomString,fa as getReportUrl,ga as getStatus,pa as getTangentByPointer,yt as getWindow,Ts as handleConsole,st as handleError,ma as handleFetchHook,Ba as handleXhrHook,I as hexToAlpha,V as hexToHsb,S as hexToHsv,M as hexToRgb,L as hsbToHsl,C as hsbToRgb,K as hslToHsb,Y as hslToHsv,E as hslToRgb,X as hsvToHsl,g as hsvToRgb,n as hue2rgb,ct as imageRequest,qs as indexForOffset,rt as inflateRaw,vt as isBangDevice,ht as isClient,zs as isEqual,La as isImageSize,Kt as isInIframe,bt as isMobile,zt as isSafari,y as isString,za as isUrlCached,dt as isWeiXin,Ja as loadScript,Ht as localStorageGetItem,Rt as localStorageRemoveItem,Gt as localStorageSetItem,wt as matchMediaQuery,ka as mathjs,i as md5,Vs as memoize,Os as merge,pt as mergeExports,Et as navigatorLanguage,as as networkAllowsDownload,ut as networkSpeed,Ct as noop,Gs as once,Wa as opacity,Ka as openPortBridge,xs as paginateText,ta as parseChineseNumber,Na as parseEnglishNumber,qa as parseRomanNumber,ia as perToNum,Bt as performanceTime,wa as prefetchUrl,As as prefetchUrls,Cs as prefetchWhenIdle,Ra as quad,Fa as quart,lt as queryFlag,os as querystring,ea as quint,Q as randomColor,c as randomString,Ca as range,ys as readFileAsArrayBuffer,Ns as readFileAsDataURL,it as readFileAsText,ns as readFileAsUint8Array,oa as readZipEntries,nt as readZipEntry,Rs as removeClassToElement,kt as removeGhosting,_s as replaceOld,ua as report,Pt as requestUrlToBuffer,Ut as resolveLocale,ft as retain,Ps as rewriteZip,k as rgbToHex,r as rgbToHsb,o as rgbToHsl,x as rgbToHsv,P as rgbaString,a as rgbaToHex,O as rgbaToRgb,Da as roundRectByArc,Ha as scriptOnLoad,us as segmentByRanges,ds as serveWorker,bs as setAttributeByGlobal,ms as setFontSize2html,m as setMime,Pa as setReportUrl,ba as sine,hs as singleFlight,aa as status,W as str2Xml,j as strParse,Bs as subscribers,_a as throttle,xt as timeFormat,At as timestampToTime,A as toFullWidth,z as toHalfWidth,B as toString,Ya as transformNumber,d as transformText,Wt as useI18n,Yt as watchMediaQuery,ts as webglVendor,Hs as whenIdle,is as withTimeout,Es as withTimeoutFallback,rs as zipHasEntry};
+import{i as s}from"../../enums-BAgbyGdH.js";import{$ as a,A as t,B as n,C as o,D as r,E as m,F as i,G as p,H as f,I as j,J as c,K as l,L as u,M as h,N as b,O as d,P as e,Q as g,R as v,S as x,T as y,U as _,V as k,W as w,X as z,Y as A,Z as B,_ as C,a as D,at as E,b as F,c as H,d as I,et as L,f as M,g as N,h as P,i as R,it as S,j as T,k as U,l as V,m as q,n as G,nt as J,o as K,ot as O,p as Q,q as W,r as X,rt as Y,s as Z,st as $,t as ss,tt as as,u as ts,v as ns,w as os,x as rs,y as ms,z as is}from"../../color-DPV7TsVU.js";import{$ as ps,$t as fs,A as js,At as cs,B as ls,Bt as us,C as hs,Ct as bs,D as ds,Dt as es,E as gs,Et as vs,F as xs,Ft as ys,G as _s,Gt as ks,H as ws,Ht as zs,I as As,It as Bs,J as Cs,Jt as Ds,K as Es,Kt as Fs,L as Hs,Lt as Is,M as Ls,Mt as Ms,N as Ns,Nt as Ps,O as Rs,Ot as Ss,P as Ts,Pt as Us,Q as Vs,Qt as qs,R as Gs,Rt as Js,S as Ks,St as Os,T as Qs,Tt as Ws,U as Xs,Ut as Ys,V as Zs,Vt as $s,W as sa,Wt as aa,X as ta,Xt as na,Y as oa,Yt as ra,Z as ma,Zt as ia,_ as pa,_n as fa,_t as ja,a as ca,an as la,at as ua,b as ha,bn as ba,bt as da,c as ea,cn as ga,ct as va,d as xa,dn as ya,dt as _a,en as ka,et as wa,f as za,fn as Aa,ft as Ba,g as Ca,gn as Da,gt as Ea,h as Fa,hn as Ha,ht as Ia,i as La,in as Ma,it as Na,j as Pa,jt as Ra,k as Sa,kt as Ta,l as Ua,ln as Va,lt as qa,m as Ga,mn as Ja,mt as Ka,n as Oa,nn as Qa,nt as Wa,o as Xa,on as Ya,ot as Za,p as $a,pn as st,pt as at,q as tt,qt as nt,r as ot,rn as rt,rt as mt,s as it,sn as pt,st as ft,t as jt,tn as ct,tt as lt,u as ut,un as ht,ut as bt,v as dt,vn as et,vt as gt,w as vt,wt as xt,x as yt,xt as _t,y as kt,yn as wt,yt as zt,z as At,zt as Bt}from"../../utils-CYrYCt5o.js";import{A as Ct,B as Dt,C as Et,D as Ft,E as Ht,F as It,H as Lt,I as Mt,L as Nt,M as Pt,N as Rt,P as St,R as Tt,S as Ut,T as Vt,U as qt,V as Gt,_ as Jt,a as Kt,b as Ot,c as Qt,d as Wt,f as Xt,g as Yt,h as Zt,i as $t,j as sn,k as an,l as tn,m as nn,n as on,o as rn,p as mn,r as pn,s as fn,t as jn,u as cn,v as ln,w as un,x as hn,y as bn,z as dn}from"../../i18n-Bq-f7htr.js";import{n as en,t as gn}from"../../chain-CTywmh_H.js";export{ta as ADOPTED_SHEET_MARKER,ma as ADOPTED_STYLE_MARKER,Us as AudioRecorder,nt as BRIDGE_MARKER,Ds as BridgeManager,gn as Chain,ra as Client,ss as Color,G as ColorScheme,na as DEFAULT_CHANNEL,zt as EventManager,X as FMT,R as HEX_COLOR_REGEX,D as Hsl,K as Hsla,jn as I18nCore,an as MOBILE_MEDIA_QUERY,la as Mathjs,l as MessageCodec,f as MimeType,Xa as Monitor,ia as Platform,qs as PostMessageBridge,ot as QuestQueue,Z as RGBA_REGEX,H as RGB_REGEX,V as Rgb,ts as Rgba,s as SyncHook,Ra as TOTP,vt as TimeoutError,Cs as WebDB,As as WorkerClient,Fa as ZIP_DEFLATE,Ca as ZIP_STORED,fs as acceptPortBridge,Os as addClassToElement,Ya as addNumSym,Vs as adoptSheetText,ps as adoptStyles,Wt as appendUrl,W as arrayBufferToString,bs as autosizeTextarea,I as blendMultiply,M as blendOverlay,Q as blendScreen,ka as bridgeManager,q as brightnessContrast,_s as buildOffsets,c as checkEncoding,Ba as circ,pt as clamp,A as clearBr,z as clearStr,ys as cloneDeep,P as componentToHex,cs as compose,ws as computePlacement,Xt as connection,wa as convertImageToBase64,N as cosinePalette,pa as crc32,en as create,ut as createData,xt as createDocumentFragment,da as createDoubleTapDetector,oa as createHandoff,on as createI18n,Xs as createLocalePath,mn as createObjectURL,ct as createPortBridge,Qs as createRaceGuard,Ms as createSignal,rt as createSpeechRecognizer,fn as createStore,dt as createZip,at as cubic,Ct as currentDevice,lt as cutRound,Ss as debounce,gs as deferred,ds as delay,$t as detectLanguage,nn as durationHandler,Zt as encodeUrl,Ws as escapeHtml,Ka as expo,Za as fanShapedByArc,Bs as filterObj,ga as fit,Mt as formatDate,Nt as formatDuration,Is as formatJson,Tt as formatRelative,Yt as getAllQueryString,ft as getAngle,va as getArcPointerByDeg,Jt as getCookie,ln as getCookieByName,_ as getExtensions,bn as getFrame,Wa as getImage,qa as getLinearGradient,B as getMatchingSentences,mt as getMatrix,w as getMime,Ga as getPerformance,Ot as getPixelRatio,g as getRandomString,xa as getReportUrl,La as getStatus,bt as getTangentByPointer,hn as getWindow,Ta as handleConsole,_t as handleError,ea as handleFetchHook,Ua as handleXhrHook,C as hexToAlpha,ns as hexToHsb,ms as hexToHsv,F as hexToRgb,rs as hsbToHsl,x as hsbToRgb,o as hslToHsb,os as hslToHsv,y as hslToRgb,m as hsvToHsl,r as hsvToRgb,d as hue2rgb,Ut as imageRequest,Es as indexForOffset,kt as inflateRaw,Va as inverseLerp,sn as isClient,Js as isEqual,Na as isImageSize,Et as isInIframe,Pt as isMobile,un as isSafari,Ma as isSpeechRecognitionSupported,a as isString,js as isUrlCached,Rt as isWeiXin,ht as lerp,U as linearToSrgb,ya as linearstep,jt as loadScript,Qt as localStorageGetItem,tn as localStorageRemoveItem,cn as localStorageSetItem,t as luma,St as matchMediaQuery,Aa as mathjs,L as md5,aa as memoize,Bt as merge,us as mergeExports,Kt as navigatorLanguage,Pa as networkAllowsDownload,Vt as networkSpeed,Ys as noop,ks as once,ua as opacity,Qa as openPortBridge,sa as paginateText,st as parseChineseNumber,Ja as parseEnglishNumber,Ha as parseRomanNumber,dn as parseVttCueTiming,Dt as parseVttTimestamp,Da as perToNum,Gt as performanceTime,Ls as prefetchUrl,Ns as prefetchUrls,Ts as prefetchWhenIdle,Ia as quad,Ea as quart,Ht as queryFlag,$s as querystring,ja as quint,T as randomColor,as as randomString,fa as range,Gs as readFileAsArrayBuffer,At as readFileAsDataURL,ls as readFileAsText,Zs as readFileAsUint8Array,ha as readZipEntries,yt as readZipEntry,et as remap,vs as removeClassToElement,zs as replaceOld,za as report,Ft as requestUrlToBuffer,rn as resolveLocale,Ks as rewriteZip,h as rgbToHex,b as rgbToHsb,e as rgbToHsl,i as rgbToHsv,j as rgbaString,u as rgbaToHex,v as rgbaToRgb,_a as roundRectByArc,is as saturation,Oa as scriptOnLoad,tt as segmentByRanges,Hs as serveWorker,es as setFontSize2html,p as setMime,$a as setReportUrl,gt as sine,Fs as singleFlight,wt as smoothstep,n as srgbToLinear,ca as status,J as strParse,Ps as subscribers,it as throttle,Lt as timeFormat,qt as timestampToTime,Y as toFullWidth,S as toHalfWidth,E as toString,ba as transformNumber,O as transformText,$ as truncate,pn as useI18n,k as vibrance,It as watchMediaQuery,xs as whenIdle,Rs as withTimeout,Sa as withTimeoutFallback,hs as zipHasEntry};

package/dist/src/utils/number.d.ts

@@ -79,4 +79,64 @@ export declare const parseRomanNumber: (value: string) => number | null;
  * ```
  */
 export declare const parseEnglishNumber: (value: string) => number | null;
+/**
+ * @description: Clamp `value` into the inclusive range `[min, max]`.
+ * @param {number} value
+ * @param {number} min
+ * @param {number} max
+ * @return {number}
+ */
+export declare const clamp: (value: number, min: number, max: number) => number;
+/**
+ * @description: Linear interpolation from `a` to `b` by `t` (t=0 → a, t=1 → b). Not clamped.
+ * @param {number} a start value
+ * @param {number} b end value
+ * @param {number} t interpolation factor
+ * @return {number}
+ */
+export declare const lerp: (a: number, b: number, t: number) => number;
+/**
+ * @description: Inverse of `lerp` — where `value` sits between `a` and `b`, as 0..1. Returns 0 when `a === b`. Not clamped.
+ * @param {number} a start value
+ * @param {number} b end value
+ * @param {number} value probed value
+ * @return {number}
+ */
+export declare const inverseLerp: (a: number, b: number, value: number) => number;
+/**
+ * @description: Linearly remap `value` from range `[a1, a2]` onto `[b1, b2]`. Not clamped (GLSL-style map).
+ * @param {number} value
+ * @param {number} a1 input range start
+ * @param {number} a2 input range end
+ * @param {number} b1 output range start
+ * @param {number} b2 output range end
+ * @return {number}
+ */
+export declare const remap: (value: number, a1: number, a2: number, b1: number, b2: number) => number;
+/**
+ * @description: Remap `value` from `[a1, a2]` onto `[b1, b2]` and clamp to the output range — the shader `fit`.
+ * @param {number} value
+ * @param {number} a1 input range start
+ * @param {number} a2 input range end
+ * @param {number} b1 output range start
+ * @param {number} b2 output range end
+ * @return {number}
+ */
+export declare const fit: (value: number, a1: number, a2: number, b1: number, b2: number) => number;
+/**
+ * @description: Linear ramp — 0 below `edge0`, 1 above `edge1`, a straight line between (the shader `linearstep`, no smoothing).
+ * @param {number} edge0
+ * @param {number} edge1
+ * @param {number} x
+ * @return {number}
+ */
+export declare const linearstep: (edge0: number, edge1: number, x: number) => number;
+/**
+ * @description: Smooth Hermite interpolation between 0 and 1 for `edge0 < x < edge1` (GLSL `smoothstep`).
+ * @param {number} edge0
+ * @param {number} edge1
+ * @param {number} x
+ * @return {number}
+ */
+export declare const smoothstep: (edge0: number, edge1: number, x: number) => number;
 export {};

package/dist/src/utils/obj.d.ts

@@ -64,20 +64,9 @@ export declare function replaceOld(source: any, name: string, replacement: (...a
  * @return {Object}
  */
 export declare const mergeExports: (obj: Record<string, string>, exports: Record<string, string>) => Record<string, string>;
-/**
- * @description: Define a property on the global object
- * @param {string} name
- * @param {string} value
- * @return {*}
- */
-export declare const setAttributeByGlobal: (name: string, value: unknown) => void;
 /**
  * Deep-compare two values, in the manner of Lodash's isEqual.
  */
-/**
- * Whether two primitives are the same value, handling the special cases NaN and -0/+0.
- */
-export declare function sameValueZero(x: any, y: any): boolean;
 /**
  * Whether the value is object-like
  */

package/dist/src/utils/placement.d.ts

@@ -0,0 +1,40 @@
+export type Placement = 'top' | 'bottom' | 'left' | 'right';
+export interface PlacementRect {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+}
+export interface ComputePlacementOptions {
+    /** Anchor (trigger) rect, in viewport coordinates (e.g. `getBoundingClientRect()`). */
+    anchor: PlacementRect;
+    /** The floating panel's own size. */
+    floating: {
+        width: number;
+        height: number;
+    };
+    /** Preferred side. Flips to the opposite side when it lacks room and the opposite side has more. */
+    placement: Placement;
+    /** Gap kept between the anchor and the floating panel, in px. */
+    offset?: number;
+    /** Region the panel must stay inside, in viewport coordinates. Defaults to the window viewport. */
+    boundary?: PlacementRect;
+    /** Minimum gap kept between the panel and the boundary edge when shifting, in px. */
+    padding?: number;
+}
+export interface ComputedPlacement {
+    top: number;
+    left: number;
+    /** The side actually used, after flip. */
+    placement: Placement;
+}
+/**
+ * Position a floating panel relative to an anchor rect: flips to the opposite
+ * side when the preferred side doesn't have room and the opposite side has
+ * more, then shifts along the cross axis to stay within `boundary`. Mirrors
+ * Floating UI's `flip`/`shift` middleware, minus the dependency.
+ *
+ * Coordinates are viewport-relative throughout (same space as `anchor`); the
+ * caller adds `scrollX`/`scrollY` when writing `position: absolute` styles.
+ */
+export declare const computePlacement: (options: ComputePlacementOptions) => ComputedPlacement;

package/dist/src/utils/speech.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Speech recognition (dictation) over the Web Speech API.
+ *
+ * This is the counterpart to `AudioRecorder`, which captures audio *bytes*; this one asks the
+ * platform to turn speech into *text*. The browser API is still prefixed on WebKit, is absent
+ * from `lib.dom`, and reports several routine non-events (a silent pause, a programmatic stop)
+ * through the same error channel as a denied microphone — so it is worth wrapping once.
+ */
+/**
+ * `denied` means the user or the browser refused the microphone — worth surfacing.
+ * `noSpeech` and `aborted` are routine (a silent pause, a programmatic `stop()`) and are
+ * usually not worth showing anyone; they are reported rather than swallowed so the caller
+ * decides. Everything else is `failed`.
+ */
+export type SpeechErrorKind = 'denied' | 'noSpeech' | 'aborted' | 'failed';
+export interface SpeechError {
+    kind: SpeechErrorKind;
+    /** The raw `error` string from the platform event. */
+    detail: string;
+}
+export interface SpeechRecognizerOptions {
+    /**
+     * BCP 47 tag for the language being spoken, e.g. `'en-US'`, `'zh-CN'`. Pass a function to
+     * have it read at the start of each capture, which is what an app whose UI language can
+     * change mid-session wants.
+     */
+    lang?: string | (() => string);
+    /** Keep listening across pauses instead of stopping at the first one. Default `true`. */
+    continuous?: boolean;
+    /** Emit partial results as the speaker talks. Default `true`. */
+    interimResults?: boolean;
+    /**
+     * Called as text arrives, with the transcript of the **whole capture so far** — not just
+     * the newest fragment — because interim results are revised as recognition firms up.
+     */
+    onResult?: (transcript: string, isFinal: boolean) => void;
+    onError?: (error: SpeechError) => void;
+    onStart?: () => void;
+    /** Fires once per capture, however it ended: stopped, timed out, or errored. */
+    onEnd?: () => void;
+}
+export interface SpeechRecognizer {
+    /** `false` when the platform has no speech recognition; every method is then a no-op. */
+    readonly supported: boolean;
+    /** Whether a capture is currently running. */
+    readonly active: boolean;
+    /** Begin a capture. Ignored if one is already running. */
+    start(): void;
+    /** End the current capture; results already recognized are kept. `onEnd` follows. */
+    stop(): void;
+    /** End the current capture and discard pending results. */
+    abort(): void;
+    /** Start if idle, stop if running — the behaviour a single microphone button wants. */
+    toggle(): void;
+}
+/**
+ * @description: Whether this runtime can recognize speech. Checked at call time, so it is safe
+ * to import this module during server-side rendering.
+ * @return {boolean}
+ */
+export declare const isSpeechRecognitionSupported: () => boolean;
+/**
+ * @description: Create a dictation session over the Web Speech API.
+ *
+ * A recognizer is reusable: `start` builds a fresh native instance each time, so options read
+ * through a function (notably `lang`) are re-read per capture.
+ *
+ * On a platform without speech recognition this returns an inert recognizer with
+ * `supported === false` rather than throwing — check that field to hide your microphone button.
+ *
+ * @param {SpeechRecognizerOptions} options
+ * @return {SpeechRecognizer}
+ * @example
+ * ```ts
+ * const mic = createSpeechRecognizer({
+ *   lang: () => currentLocale(),
+ *   onResult: (text) => { input.value = text; },
+ *   onError: (e) => { if (e.kind === 'denied') toast('Microphone access was refused'); },
+ *   onEnd: () => button.classList.remove('recording'),
+ *   onStart: () => button.classList.add('recording'),
+ * });
+ * if (!mic.supported) button.style.display = 'none';
+ * button.addEventListener('click', () => mic.toggle());
+ * ```
+ */
+export declare const createSpeechRecognizer: (options?: SpeechRecognizerOptions) => SpeechRecognizer;

package/dist/src/utils/str.d.ts

@@ -12,16 +12,8 @@ export declare const strParse: (str?: string, sep?: string | RegExp, eq?: string
  * @return {string} the resulting plain text
  */
 export declare const clearBr: (str?: string) => string;
-/**
- * @description: Parse a string into XML using the given MIME type
- * @param {string} xmlStr
- * @param {DOMParserSupportedType} format
- * @return {Document}
- */
-export declare const str2Xml: (xmlStr: string, format?: DOMParserSupportedType) => HTMLElement | undefined;
 export declare const isString: (obj: unknown) => boolean;
 export declare function randomString(len?: number): string;
-export declare function changeHumpToLowerCase(str: string): string;
 interface ClearStrOption {
     urlencoded?: boolean;
 }
@@ -64,6 +56,41 @@ export declare const toHalfWidth: (value: string) => string;
  * @return {string}
  */
 export declare const toFullWidth: (value: string) => string;
+/** Which end of the string gets dropped when it is too long. */
+export type TruncatePosition = 'end' | 'start' | 'middle';
+export interface TruncateOptions {
+    /** Ceiling for the returned string, ellipsis included. */
+    length: number;
+    /** Default `'end'`. */
+    position?: TruncatePosition;
+    /** Default `'…'`. */
+    ellipsis?: string;
+}
+/**
+ * @description: Shorten a string to a maximum length, marking the cut with an ellipsis.
+ *
+ * `position` decides which end survives, and that choice carries real information:
+ *
+ * - `'end'` (default) keeps the beginning — right for prose and titles.
+ * - `'start'` keeps the **tail**, which is what a file path wants. `/Users/someone/work/…`
+ *   are the bytes a reader already knows; `…/src/utils/str.ts` is the part they need.
+ * - `'middle'` keeps both ends, for identifiers whose head *and* tail are meaningful, such as
+ *   a hash or an account number.
+ *
+ * The result never exceeds `length`, so a `length` shorter than the ellipsis returns a
+ * truncated ellipsis rather than overflowing.
+ *
+ * @param {string} value
+ * @param {TruncateOptions | number} options a bare number is shorthand for `{ length }`
+ * @return {string}
+ * @example
+ * ```ts
+ * truncate('the quick brown fox', 12);                                 // 'the quick b…'
+ * truncate('/Users/me/code/app/src/index.ts', { length: 20, position: 'start' }); // '…de/app/src/index.ts'
+ * truncate('0xabcdef0123456789', { length: 11, position: 'middle' });   // '0xabc…56789'
+ * ```
+ */
+export declare const truncate: (value: string, options: TruncateOptions | number) => string;
 export interface TransformText {
     encoding: string;
     content: string;

package/dist/src/utils/time.d.ts

@@ -1,3 +1,5 @@
+/** Accepted everywhere a moment in time is taken; `undefined` means "now". */
+export type DateInput = number | string | Date;
 /**
  * @description: Format a date with a token pattern. Accepts a timestamp, a date string, a
  * `Date`, or nothing (meaning now). Wrap literal text in `[]` to keep it out of the substitution.
@@ -26,7 +28,7 @@
  * formatDate(new Date(), 'YYYY[年]MM[月]DD[日] hh:mm a'); // '2026年07月25日 02:30 pm' (escaped literals)
  * ```
  */
-export declare const formatDate: (value?: number | string | Date, pattern?: string) => string;
+export declare const formatDate: (value?: DateInput, pattern?: string) => string;
 /**
  * @description: Turn a timestamp into a `Date` carrying a `format` method.
  * @deprecated Use [`formatDate`](#formatdate). This returns a `Date` with an extra method
@@ -39,12 +41,112 @@ export declare const formatDate: (value?: number | string | Date, pattern?: stri
 export declare function timestampToTime(timestamp?: number | string): Date & {
     format?: Function;
 };
+/**
+ * @description: Format an elapsed number of **seconds** as a colon-separated clock duration,
+ * the shape media players use for a playhead: `mm:ss`, widening to `hh:mm:ss` past an hour.
+ *
+ * This is a length of time, not a point in time — for the latter see
+ * [`formatDate`](#formatdate) (absolute) and [`formatRelative`](#formatrelative) (relative).
+ *
+ * @param {number} seconds elapsed seconds; negatives clamp to `0`
+ * @return {string} the duration, or `''` when the input is not a finite number — a player
+ * asks for `video.duration` before metadata loads and gets `NaN`, and an empty label reads
+ * better there than `NaN:NaN`
+ * @example
+ * ```ts
+ * formatDuration(0);    // '00:00'
+ * formatDuration(65);   // '01:05'
+ * formatDuration(3661); // '01:01:01'
+ * formatDuration(NaN);  // ''
+ * ```
+ */
+export declare const formatDuration: (seconds: number) => string;
 /**
  * @description: Format a number of seconds as a colon-separated duration
+ * @deprecated Renamed to [`formatDuration`](#formatduration) — `timeFormat` said nothing about
+ * *which* of the three time formats it was, and read backwards from its `formatDate` sibling.
+ * This alias stays for compatibility and behaves identically.
  * @param {number} time
- * @return {*}
+ * @return {string}
  */
 export declare const timeFormat: (time: number) => string;
+/**
+ * @description: Parse a WebVTT/SRT-style timestamp — `HH:MM:SS.mmm` or `MM:SS.mmm` (the hour
+ * component is optional) — into seconds. The inverse of [`formatDuration`](#formatduration),
+ * for anything that reads cue timings back out of subtitle/thumbnail-sprite manifests rather
+ * than formatting a duration for display.
+ * @param {string} raw the timestamp text, e.g. `'00:01:05.250'` or `'01:05.250'`
+ * @return {number | undefined} seconds, or `undefined` when `raw` doesn't match the pattern
+ * @example
+ * ```ts
+ * parseVttTimestamp('00:00:05.000');    // 5
+ * parseVttTimestamp('01:05.250');       // 65.25
+ * parseVttTimestamp('01:00:00.000');    // 3600
+ * parseVttTimestamp('not a timestamp'); // undefined
+ * ```
+ */
+export declare const parseVttTimestamp: (raw: string) => number | undefined;
+/**
+ * @description: Parse a WebVTT cue timing line — `<start> --> <end>`, optionally followed by
+ * cue settings (`align:start line:0`) after the end timestamp, which are ignored. Built on
+ * [`parseVttTimestamp`](#parsevtttimestamp) for each side.
+ * @param {string} line the timing line, e.g. `'00:00:00.000 --> 00:00:05.000 align:start line:0'`
+ * @return {{ start: number; end: number } | undefined} `undefined` when either side fails to parse
+ * @example
+ * ```ts
+ * parseVttCueTiming('00:00:00.000 --> 00:00:05.000'); // { start: 0, end: 5 }
+ * parseVttCueTiming('00:00:05.000 --> 00:00:10.000 align:start line:0'); // { start: 5, end: 10 }
+ * ```
+ */
+export declare const parseVttCueTiming: (line: string) => {
+    start: number;
+    end: number;
+} | undefined;
+/** `'compact'` is ours; the other three are `Intl.RelativeTimeFormat` styles. */
+export type RelativeStyle = 'long' | 'short' | 'narrow' | 'compact';
+export interface FormatRelativeOptions {
+    /** What to measure against. Defaults to the current time. */
+    now?: DateInput;
+    /** BCP 47 tag(s); defaults to the runtime's locale. Ignored by the `compact` style. */
+    locale?: string | string[];
+    /** Defaults to `'long'` (`'3 days ago'`). */
+    style?: RelativeStyle;
+    /**
+     * `'auto'` (the default here) swaps in idioms where a language has them — `yesterday`
+     * rather than `1 day ago`, `now` rather than `in 0 seconds`. `'always'` keeps the number.
+     */
+    numeric?: 'always' | 'auto';
+}
+/**
+ * @description: Format a point in time relative to another — "3 days ago", "in 2 hours".
+ *
+ * Localization is delegated to the platform's `Intl.RelativeTimeFormat`, which has been
+ * available in every major browser since 2020 and knows each language's plural and
+ * inflection rules. This function supplies only the part `Intl` deliberately leaves out:
+ * picking *which* unit to express the gap in.
+ *
+ * Like `Intl` itself it reports a **single** unit — a gap of 3 days and 6 hours is
+ * "3 days ago", never "3 days and 6 hours ago".
+ *
+ * The extra `compact` style is the dense badge form seen next to list items (`5m`, `3h`,
+ * `2d`). It is a magnitude only: it carries **no direction**, so a future timestamp reads
+ * the same as a past one. Use it for feeds of past events, and any other style when the
+ * reader has to tell past from future.
+ *
+ * @param {DateInput} value the moment to describe
+ * @param {FormatRelativeOptions} options
+ * @return {string} the description, or `''` when either end cannot be parsed
+ * @example
+ * ```ts
+ * const twoHoursAgo = Date.now() - 2 * 3600_000;
+ * formatRelative(twoHoursAgo);                          // '2 hours ago'
+ * formatRelative(twoHoursAgo, { style: 'short' });      // '2 hr. ago'
+ * formatRelative(twoHoursAgo, { style: 'compact' });    // '2h'
+ * formatRelative(twoHoursAgo, { locale: 'zh-CN' });     // '2 小时前'
+ * formatRelative(Date.now() + 60_000);                  // 'in 1 minute'
+ * ```
+ */
+export declare const formatRelative: (value: DateInput, options?: FormatRelativeOptions) => string;
 /**
  * @description: Current timestamp
  * @return {*}

package/dist/src/utils/visual/application.d.ts

@@ -1,5 +1,6 @@
 import { Container } from '@/utils/visual/vertex/container';
 import { EventSystem } from '@/utils/visual/event';
+import type { Filter } from '@/utils/visual/render/filter';
 import type { IApplicationOptions } from '@/utils/visual/types';
 export declare class Application {
     private readonly renderer;
@@ -21,6 +22,15 @@ export declare class Application {
      * app.start();
      */
     static create(options: IApplicationOptions): Promise<Application>;
+    /**
+     * Full-screen post-processing passes applied after the scene is drawn, in order. WebGL only
+     * (the Canvas backend ignores them).
+     *
+     * @example
+     * app.filters = [new ColorAdjustFilter({ saturation: 1.4, contrast: 1.1 })];
+     */
+    get filters(): Filter[];
+    set filters(filters: Filter[]);
     render(): void;
     start(): void;
     stop(): void;

package/dist/src/utils/visual/index.d.ts

@@ -1,7 +1,10 @@
 import { Application } from '@/utils/visual/application';
 import { Container } from '@/utils/visual/vertex/container';
 import { Graphics } from '@/utils/visual/graphics/graphics';
+import { ColorAdjustFilter, Filter } from '@/utils/visual/render/filter';
+import { WebGLRenderTarget } from '@/utils/visual/render/renderTarget';
 import { BYTES_PER_VERTEX, LINE_CAP, LINE_JOIN, MAX_VERTEX_COUNT, RENDERER_TYPE, SHAPE_TYPE } from '@/utils/visual/enums';
 import type { IApplicationOptions, IFillStyleOptions, ILineStyleOptions } from '@/utils/visual/types';
-export { Application, Container, Graphics, SHAPE_TYPE, LINE_CAP, LINE_JOIN, RENDERER_TYPE, MAX_VERTEX_COUNT, BYTES_PER_VERTEX, };
-export type { IApplicationOptions, IFillStyleOptions, ILineStyleOptions };
+import type { ColorAdjustOptions } from '@/utils/visual/render/filter';
+export { Application, Container, Graphics, Filter, ColorAdjustFilter, WebGLRenderTarget, SHAPE_TYPE, LINE_CAP, LINE_JOIN, RENDERER_TYPE, MAX_VERTEX_COUNT, BYTES_PER_VERTEX, };
+export type { IApplicationOptions, IFillStyleOptions, ILineStyleOptions, ColorAdjustOptions };