tgui-core 3.3.1 → 4.0.2

package/README.md

@@ -4,9 +4,12 @@ A collection of utilities and components for the [tgui](https://github.com/tgsta
 
 This package was built to help the various downstream SS13 servers stay up to date with TGUI without having to keep a local version of each file.
 
-You can view the code on [GitHub](https://github.com/tgstation/tgui-core).
+## Links
+- [GitHub](https://github.com/tgstation/tgui-core)
+- [npm](https://www.npmjs.com/package/tgui-core)
+- [Storybook](https://tgstation.github.io/tgui-core/?path=/docs/components-animatednumber--docs)
 
-## Installation
+## Usage
 
 (assuming you have a tgui folder, navigate to the specific package)
 

package/dist/common/collections.d.ts

@@ -7,11 +7,4 @@ type Zip<T extends unknown[][]> = {
  * the second elements of the given arrays, and so on.
  */
 export declare function zip<T extends unknown[][]>(...arr: T): Zip<T>;
-/**
- * Helper function for string compares with native sorts
- * @param a first string to compare
- * @param b second string to compare
- * @returns -1 for a < b, 1 for a > b and 0 otherwise
- */
-export declare function stringCompare(a: string, b: string): 1 | -1 | 0;
 export {};

package/dist/common/collections.js

@@ -1 +1 @@
-function r(...n){return Array(Math.max(...n.map(r=>r.length))).fill(void 0).map((r,t)=>n.map(r=>r[t]))}function n(r,n){return r<n?-1:+(r>n)}export{n as stringCompare,r as zip};
+function a(...p){return Array(Math.max(...p.map(a=>a.length))).fill(void 0).map((a,r)=>p.map(a=>a[r]))}export{a as zip};

package/dist/common/constants.d.ts

@@ -97,8 +97,8 @@ export declare const RADIO_CHANNELS: readonly [{
 }];
 export declare function getGasLabel(gasId: string, fallbackValue?: string): string;
 export declare function getGasColor(gasId: string): string;
-export declare const getGasFromId: (gasId: string) => Gas | undefined;
-export declare const getGasFromPath: (gasPath: string) => Gas | undefined;
+export declare function getGasFromId(gasId: string): Gas | undefined;
+export declare function getGasFromPath(gasPath: string): Gas | undefined;
 export declare const COMPONENT_COLORS: {
     readonly spectrum: readonly ["red", "orange", "yellow", "olive", "green", "teal", "blue", "violet", "purple", "pink", "brown", "grey", "gold"];
     readonly states: readonly ["", "good", "average", "bad", "black", "white"];

package/dist/common/constants.js

@@ -1 +1 @@
-let e=2,a=1,o=0,r=-1,l={damageType:{brute:"#e74c3c",burn:"#e67e22",oxy:"#3498db",toxin:"#2ecc71"},department:{captain:"#c06616",cargo:"#f39c12",centcom:"#00c100",engineering:"#f1c40f",medbay:"#3498db",other:"#c38312",science:"#9b59b6",security:"#e74c3c",service:"#7cc46a"},reagent:{acidicbuffer:"#fbc314",basicbuffer:"#3853a4"}},t=["average","bad","black","blue","brown","good","green","grey","label","olive","orange","pink","purple","red","teal","transparent","violet","white","yellow"],i=[{color:"#8f4a4b",freq:1213,name:"Syndicate"},{color:"#ff4444",freq:1215,name:"Red Team"},{color:"#3434fd",freq:1217,name:"Blue Team"},{color:"#34fd34",freq:1219,name:"Green Team"},{color:"#fdfd34",freq:1221,name:"Yellow Team"},{color:"#2681a5",freq:1337,name:"CentCom"},{color:"#b88646",freq:1347,name:"Supply"},{color:"#6ca729",freq:1349,name:"Service"},{color:"#c68cfa",freq:1351,name:"Science"},{color:"#fcdf03",freq:1353,name:"Command"},{color:"#57b8f0",freq:1355,name:"Medical"},{color:"#f37746",freq:1357,name:"Engineering"},{color:"#dd3535",freq:1359,name:"Security"},{color:"#d65d95",freq:1447,name:"AI Private"},{color:"#1ecc43",freq:1459,name:"Common"}],n=[{color:"blue",id:"o2",label:"O₂",name:"Oxygen",path:"/datum/gas/oxygen"},{color:"yellow",id:"n2",label:"N₂",name:"Nitrogen",path:"/datum/gas/nitrogen"},{color:"grey",id:"co2",label:"CO₂",name:"Carbon Dioxide",path:"/datum/gas/carbon_dioxide"},{color:"pink",id:"plasma",label:"Plasma",name:"Plasma",path:"/datum/gas/plasma"},{color:"lightsteelblue",id:"water_vapor",label:"H₂O",name:"Water Vapor",path:"/datum/gas/water_vapor"},{color:"teal",id:"hypernoblium",label:"Hyper-nob",name:"Hyper-noblium",path:"/datum/gas/hypernoblium"},{color:"bisque",id:"n2o",label:"N₂O",name:"Nitrous Oxide",path:"/datum/gas/nitrous_oxide"},{color:"brown",id:"no2",label:"Nitrium",name:"Nitrium",path:"/datum/gas/nitrium"},{color:"limegreen",id:"tritium",label:"Tritium",name:"Tritium",path:"/datum/gas/tritium"},{color:"mediumpurple",id:"bz",label:"BZ",name:"BZ",path:"/datum/gas/bz"},{color:"mediumslateblue",id:"pluoxium",label:"Pluoxium",name:"Pluoxium",path:"/datum/gas/pluoxium"},{color:"olive",id:"miasma",label:"Miasma",name:"Miasma",path:"/datum/gas/miasma"},{color:"paleturquoise",id:"freon",label:"Freon",name:"Freon",path:"/datum/gas/freon"},{color:"white",id:"hydrogen",label:"H₂",name:"Hydrogen",path:"/datum/gas/hydrogen"},{color:"salmon",id:"healium",label:"Healium",name:"Healium",path:"/datum/gas/healium"},{color:"greenyellow",id:"proto_nitrate",label:"Proto-Nitrate",name:"Proto Nitrate",path:"/datum/gas/proto_nitrate"},{color:"darkgreen",id:"zauker",label:"Zauker",name:"Zauker",path:"/datum/gas/zauker"},{color:"purple",id:"halon",label:"Halon",name:"Halon",path:"/datum/gas/halon"},{color:"aliceblue",id:"helium",label:"He",name:"Helium",path:"/datum/gas/helium"},{color:"maroon",id:"antinoblium",label:"Anti-Noblium",name:"Antinoblium",path:"/datum/gas/antinoblium"},{color:"brown",id:"nitrium",label:"Nitrium",name:"Nitrium",path:"/datum/gas/nitrium"}];function m(e,a){if(!e)return a||"None";let o=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===o)return n[e].label;return a||"None"}function u(e){if(!e)return"black";let a=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===a)return n[e].color;return"black"}let c=e=>{if(!e)return;let a=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===a)return n[e]},d=e=>{if(e){for(let a=0;a<n.length;a++)if(n[a].path===e)return n[a]}},b={spectrum:["red","orange","yellow","olive","green","teal","blue","violet","purple","pink","brown","grey","gold"],states:["","good","average","bad","black","white"]};export{l as COLORS,b as COMPONENT_COLORS,t as CSS_COLORS,i as RADIO_CHANNELS,r as UI_CLOSE,o as UI_DISABLED,e as UI_INTERACTIVE,a as UI_UPDATE,u as getGasColor,c as getGasFromId,d as getGasFromPath,m as getGasLabel};
+let e=2,a=1,o=0,r=-1,l={damageType:{brute:"#e74c3c",burn:"#e67e22",oxy:"#3498db",toxin:"#2ecc71"},department:{captain:"#c06616",cargo:"#f39c12",centcom:"#00c100",engineering:"#f1c40f",medbay:"#3498db",other:"#c38312",science:"#9b59b6",security:"#e74c3c",service:"#7cc46a"},reagent:{acidicbuffer:"#fbc314",basicbuffer:"#3853a4"}},t=["average","bad","black","blue","brown","good","green","grey","label","olive","orange","pink","purple","red","teal","transparent","violet","white","yellow"],i=[{color:"#8f4a4b",freq:1213,name:"Syndicate"},{color:"#ff4444",freq:1215,name:"Red Team"},{color:"#3434fd",freq:1217,name:"Blue Team"},{color:"#34fd34",freq:1219,name:"Green Team"},{color:"#fdfd34",freq:1221,name:"Yellow Team"},{color:"#2681a5",freq:1337,name:"CentCom"},{color:"#b88646",freq:1347,name:"Supply"},{color:"#6ca729",freq:1349,name:"Service"},{color:"#c68cfa",freq:1351,name:"Science"},{color:"#fcdf03",freq:1353,name:"Command"},{color:"#57b8f0",freq:1355,name:"Medical"},{color:"#f37746",freq:1357,name:"Engineering"},{color:"#dd3535",freq:1359,name:"Security"},{color:"#d65d95",freq:1447,name:"AI Private"},{color:"#1ecc43",freq:1459,name:"Common"}],n=[{color:"blue",id:"o2",label:"O₂",name:"Oxygen",path:"/datum/gas/oxygen"},{color:"yellow",id:"n2",label:"N₂",name:"Nitrogen",path:"/datum/gas/nitrogen"},{color:"grey",id:"co2",label:"CO₂",name:"Carbon Dioxide",path:"/datum/gas/carbon_dioxide"},{color:"pink",id:"plasma",label:"Plasma",name:"Plasma",path:"/datum/gas/plasma"},{color:"lightsteelblue",id:"water_vapor",label:"H₂O",name:"Water Vapor",path:"/datum/gas/water_vapor"},{color:"teal",id:"hypernoblium",label:"Hyper-nob",name:"Hyper-noblium",path:"/datum/gas/hypernoblium"},{color:"bisque",id:"n2o",label:"N₂O",name:"Nitrous Oxide",path:"/datum/gas/nitrous_oxide"},{color:"brown",id:"no2",label:"Nitrium",name:"Nitrium",path:"/datum/gas/nitrium"},{color:"limegreen",id:"tritium",label:"Tritium",name:"Tritium",path:"/datum/gas/tritium"},{color:"mediumpurple",id:"bz",label:"BZ",name:"BZ",path:"/datum/gas/bz"},{color:"mediumslateblue",id:"pluoxium",label:"Pluoxium",name:"Pluoxium",path:"/datum/gas/pluoxium"},{color:"olive",id:"miasma",label:"Miasma",name:"Miasma",path:"/datum/gas/miasma"},{color:"paleturquoise",id:"freon",label:"Freon",name:"Freon",path:"/datum/gas/freon"},{color:"white",id:"hydrogen",label:"H₂",name:"Hydrogen",path:"/datum/gas/hydrogen"},{color:"salmon",id:"healium",label:"Healium",name:"Healium",path:"/datum/gas/healium"},{color:"greenyellow",id:"proto_nitrate",label:"Proto-Nitrate",name:"Proto Nitrate",path:"/datum/gas/proto_nitrate"},{color:"darkgreen",id:"zauker",label:"Zauker",name:"Zauker",path:"/datum/gas/zauker"},{color:"purple",id:"halon",label:"Halon",name:"Halon",path:"/datum/gas/halon"},{color:"aliceblue",id:"helium",label:"He",name:"Helium",path:"/datum/gas/helium"},{color:"maroon",id:"antinoblium",label:"Anti-Noblium",name:"Antinoblium",path:"/datum/gas/antinoblium"},{color:"brown",id:"nitrium",label:"Nitrium",name:"Nitrium",path:"/datum/gas/nitrium"}];function m(e,a){if(!e)return a||"None";let o=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===o)return n[e].label;return a||"None"}function u(e){if(!e)return"black";let a=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===a)return n[e].color;return"black"}function c(e){if(!e)return;let a=e.toLowerCase();for(let e=0;e<n.length;e++)if(n[e].id===a)return n[e]}function d(e){if(e){for(let a=0;a<n.length;a++)if(n[a].path===e)return n[a]}}let b={spectrum:["red","orange","yellow","olive","green","teal","blue","violet","purple","pink","brown","grey","gold"],states:["","good","average","bad","black","white"]};export{l as COLORS,b as COMPONENT_COLORS,t as CSS_COLORS,i as RADIO_CHANNELS,r as UI_CLOSE,o as UI_DISABLED,e as UI_INTERACTIVE,a as UI_UPDATE,u as getGasColor,c as getGasFromId,d as getGasFromPath,m as getGasLabel};

package/dist/common/events.d.ts

@@ -1,4 +1,4 @@
-type Fn = (...args: any[]) => void;
+import type { Fn } from './types';
 export declare class EventEmitter {
     private listeners;
     constructor();
@@ -30,4 +30,3 @@ export declare class KeyEvent {
     isUp(): boolean;
     toString(): string;
 }
-export {};

package/dist/common/format.d.ts

@@ -2,7 +2,6 @@ export declare function formatSiUnit(value: number, minBase1000?: number, unit?:
 export declare function formatPower(value: number, minBase1000?: number): string;
 export declare function formatEnergy(value: number, minBase1000?: number): string;
 export declare function formatMoney(value: number, precision?: number): string;
-export declare function formatDb(value: number): string;
 export declare function formatSiBaseTenUnit(value: number, minBase1000?: number, unit?: string): string;
 /**
  * Formats decisecond count into HH:MM:SS display by default

package/dist/common/format.js

@@ -1 +1 @@
-let t=["f","p","n","μ","m"," ","k","M","G","T","P","E","Z","Y","R","Q","F","N","H"],r=t.indexOf(" ");function e(n,i=-r,o=""){if(!Number.isFinite(n))return n.toString();let a=Math.floor(Math.max(3*i,Math.floor(Math.log10(Math.abs(n))))/3),f=t[Math.min(a+r,t.length-1)],l=(n/1e3**a).toFixed(2);return l.endsWith(".00")?l=l.slice(0,-3):l.endsWith(".0")&&(l=l.slice(0,-2)),`${l} ${f.trim()}${o}`.trim()}function n(t,r=0){return e(t,r,"W")}function i(t,r=0){return e(t,r,"J")}function o(t,r=0){if(!Number.isFinite(t))return String(t);let e=Number(t.toFixed(r)),n=Math.abs(e).toString().split(".");n[0]=n[0].replace(/\B(?=(\d{3})+(?!\d))/g," ");let i=n.join(".");return e<0?`-${i}`:i}function a(t){let r=20*Math.log10(t),e=Math.abs(r);return e=e===Number.POSITIVE_INFINITY?"Inf":e.toFixed(2),`${r>=0?"+":"-"}${e} dB`}let f=["","\xb7 10\xb3","\xb7 10⁶","\xb7 10⁹","\xb7 10\xb9\xb2","\xb7 10\xb9⁵","\xb7 10\xb9⁸","\xb7 10\xb2\xb9","\xb7 10\xb2⁴","\xb7 10\xb2⁷","\xb7 10\xb3⁰","\xb7 10\xb3\xb3","\xb7 10\xb3⁶","\xb7 10\xb3⁹"];function l(t,r=0,e=""){if(!Number.isFinite(t))return"NaN";let n=Math.max(3*r,Math.floor(Math.log10(t))),i=Math.floor(n/3),o=f[i],a=Math.max(0,2-n%3),u=(t/1e3**i).toFixed(a);return`${u} ${o} ${e}`.trim()}function u(t,r="default"){let e=Math.floor(t/10),n=Math.floor(e/3600),i=Math.floor(e%3600/60),o=e%60;if("short"===r){let t=n>0?`${n}h`:"",r=i>0?`${i}m`:"",e=o>0?`${o}s`:"";return`${t}${r}${e}`}let a=String(n).padStart(2,"0"),f=String(i).padStart(2,"0"),l=String(o).padStart(2,"0");return`${a}:${f}:${l}`}export{a as formatDb,i as formatEnergy,o as formatMoney,n as formatPower,l as formatSiBaseTenUnit,e as formatSiUnit,u as formatTime};
+let t=["f","p","n","μ","m"," ","k","M","G","T","P","E","Z","Y","R","Q","F","N","H"],r=t.indexOf(" ");function e(i,n=-r,o=""){if(!Number.isFinite(i))return i.toString();let a=Math.floor(Math.max(3*n,Math.floor(Math.log10(Math.abs(i))))/3),f=t[Math.min(a+r,t.length-1)],l=(i/1e3**a).toFixed(2);return l.endsWith(".00")?l=l.slice(0,-3):l.endsWith(".0")&&(l=l.slice(0,-2)),`${l} ${f.trim()}${o}`.trim()}function i(t,r=0){return e(t,r,"W")}function n(t,r=0){return e(t,r,"J")}function o(t,r=0){if(!Number.isFinite(t))return String(t);let e=Number(t.toFixed(r)),i=Math.abs(e).toString().split(".");i[0]=i[0].replace(/\B(?=(\d{3})+(?!\d))/g," ");let n=i.join(".");return e<0?`-${n}`:n}let a=["","\xb7 10\xb3","\xb7 10⁶","\xb7 10⁹","\xb7 10\xb9\xb2","\xb7 10\xb9⁵","\xb7 10\xb9⁸","\xb7 10\xb2\xb9","\xb7 10\xb2⁴","\xb7 10\xb2⁷","\xb7 10\xb3⁰","\xb7 10\xb3\xb3","\xb7 10\xb3⁶","\xb7 10\xb3⁹"];function f(t,r=0,e=""){if(!Number.isFinite(t))return"NaN";let i=Math.max(3*r,Math.floor(Math.log10(t))),n=Math.floor(i/3),o=a[n],l=Math.max(0,2-i%3),u=(t/1e3**n).toFixed(l);return`${u} ${o} ${e}`.trim()}function l(t,r="default"){let e=Math.floor(t/10),i=Math.floor(e/3600),n=Math.floor(e%3600/60),o=e%60;if("short"===r){let t=i>0?`${i}h`:"",r=n>0?`${n}m`:"",e=o>0?`${o}s`:"";return`${t}${r}${e}`}let a=String(i).padStart(2,"0"),f=String(n).padStart(2,"0"),u=String(o).padStart(2,"0");return`${a}:${f}:${u}`}export{n as formatEnergy,o as formatMoney,i as formatPower,f as formatSiBaseTenUnit,e as formatSiUnit,l as formatTime};

package/dist/common/fp.d.ts

@@ -1,4 +1,4 @@
-type Func = (...args: any[]) => any;
+import type { Fn } from './types';
 /**
  * Creates a function that returns the result of invoking the given
  * functions, where each successive invocation is supplied the return
@@ -15,5 +15,4 @@ type Func = (...args: any[]) => any;
  * const composedFunction2 = flow([add2, multiplyBy3], subtract5); // ((4 + 2) * 3) - 5 = 13
  *
  */
-export declare const flow: (...funcs: Array<Func | Func[]>) => (input: any, ...rest: any[]) => any;
-export {};
+export declare const flow: (...funcs: Array<Fn | Fn[]>) => (input: any, ...rest: any[]) => any;

package/dist/common/hotkeys.d.ts

@@ -9,7 +9,12 @@ export declare function acquireHotKey(keyCode: number): void;
  */
 export declare function releaseHotKey(keyCode: number): void;
 export declare function releaseHeldKeys(): void;
-export declare function setupHotKeys(): void;
+export type KeyPassthroughConfig = {
+    keyUpVerb: string;
+    keyDownVerb: string;
+    verbParamsFn: (verb: string, keyCode: string) => string;
+};
+export declare function setupHotKeys(config?: KeyPassthroughConfig): void;
 export declare function startKeyPassthrough(): void;
 export declare function stopKeyPassthrough(): void;
 /**

package/dist/common/hotkeys.js

@@ -1 +1 @@
-import*as e from"./events.js";import*as t from"./keycodes.js";let o={},n=[t.KEY_ESCAPE,t.KEY_ENTER,t.KEY_SPACE,t.KEY_TAB,t.KEY_CTRL,t.KEY_SHIFT,t.KEY_UP,t.KEY_DOWN,t.KEY_LEFT,t.KEY_RIGHT,t.KEY_F5],l={},r=[];function i(e){n.push(e)}function s(e){let t=n.indexOf(e);t>=0&&n.splice(t,1)}function a(){for(let e in l)l[e]&&(l[e]=!1,Byond.command(`${globalThis.ByondKeyUp} "${e}"`))}function d(){globalThis.ByondKeyUp||(globalThis.ByondKeyUp="KeyUp",globalThis.ByondKeyDown="KeyDown"),Byond.winget("default.*").then(e=>{let t={};for(let o in e){let n=o.split("."),l=n[1],r=n[2];l&&r&&(t[l]||(t[l]={}),t[l][r]=e[o])}let n=/\\"/g;function l(e){return e.substring(1,e.length-1).replace(n,'"')}for(let e in t){let n=t[e];o[l(n.name)]=l(n.command)}}),e.globalEvents.on("window-blur",()=>{a()}),f()}function f(){e.globalEvents.on("key",y)}function u(){e.globalEvents.off("key",y)}function y(e){for(let t of r)t(e);!function(e){var t;let r=String(e);if("Ctrl+F5"===r||"Ctrl+R"===r)return location.reload();if("Ctrl+F"===r||e.event.defaultPrevented||e.isModifierKey()||n.includes(e.code))return;let i=16===(t=e.code)?"Shift":17===t?"Ctrl":18===t?"Alt":33===t?"Northeast":34===t?"Southeast":35===t?"Southwest":36===t?"Northwest":37===t?"West":38===t?"North":39===t?"East":40===t?"South":45===t?"Insert":46===t?"Delete":t>=48&&t<=57||t>=65&&t<=90?String.fromCharCode(t):t>=96&&t<=105?`Numpad${t-96}`:t>=112&&t<=123?`F${t-111}`:188===t?",":189===t?"-":190===t?".":void 0;if(!i)return;let s=o[i];if(s)return Byond.command(s);if(e.isDown()&&!l[i]){l[i]=!0;let e=`${globalThis.ByondKeyDown} "${i}"`;return Byond.command(e)}if(e.isUp()&&l[i]){l[i]=!1;let e=`${globalThis.ByondKeyUp} "${i}"`;Byond.command(e)}}(e)}function K(e){r.push(e);let t=!1;return()=>{t||(t=!0,r.splice(r.indexOf(e),1))}}export{i as acquireHotKey,K as listenForKeyEvents,a as releaseHeldKeys,s as releaseHotKey,d as setupHotKeys,f as startKeyPassthrough,u as stopKeyPassthrough};
+import*as e from"./events.js";import*as t from"./keycodes.js";let n={},o=[t.KEY_ESCAPE,t.KEY_ENTER,t.KEY_SPACE,t.KEY_TAB,t.KEY_CTRL,t.KEY_SHIFT,t.KEY_UP,t.KEY_DOWN,t.KEY_LEFT,t.KEY_RIGHT,t.KEY_F5],r={},l=[];function s(e){o.push(e)}function i(e){let t=o.indexOf(e);t>=0&&o.splice(t,1)}function a(){for(let e in r)r[e]&&(r[e]=!1,Byond.command(f.verbParamsFn(f.keyUpVerb,e)))}let f={keyDownVerb:"KeyDown",keyUpVerb:"KeyUp",verbParamsFn:(e,t)=>`${e} "${t}"`};function u(t){t&&(f=t),Byond.winget("default.*").then(e=>{let t={};for(let n in e){let o=n.split("."),r=o[1],l=o[2];r&&l&&(t[r]||(t[r]={}),t[r][l]=e[n])}let o=/\\"/g;function r(e){return e.substring(1,e.length-1).replace(o,'"')}for(let e in t){let o=t[e];n[r(o.name)]=r(o.command)}}),e.globalEvents.on("window-blur",()=>{a()}),d()}function d(){e.globalEvents.on("key",y)}function c(){e.globalEvents.off("key",y)}function y(e){for(let t of l)t(e);!function(e){var t;let l=String(e);if("Ctrl+F5"===l||"Ctrl+R"===l)return location.reload();if("Ctrl+F"===l||e.event.defaultPrevented||e.isModifierKey()||o.includes(e.code))return;let s=16===(t=e.code)?"Shift":17===t?"Ctrl":18===t?"Alt":33===t?"Northeast":34===t?"Southeast":35===t?"Southwest":36===t?"Northwest":37===t?"West":38===t?"North":39===t?"East":40===t?"South":45===t?"Insert":46===t?"Delete":t>=48&&t<=57||t>=65&&t<=90?String.fromCharCode(t):t>=96&&t<=105?`Numpad${t-96}`:t>=112&&t<=123?`F${t-111}`:188===t?",":189===t?"-":190===t?".":void 0;if(!s)return;let i=n[s];if(i)return Byond.command(i);if(e.isDown()&&!r[s]){r[s]=!0;let e=f.verbParamsFn(f.keyDownVerb,s);return Byond.command(e)}if(e.isUp()&&r[s]){r[s]=!1;let e=f.verbParamsFn(f.keyUpVerb,s);Byond.command(e)}}(e)}function E(e){l.push(e);let t=!1;return()=>{t||(t=!0,l.splice(l.indexOf(e),1))}}export{s as acquireHotKey,E as listenForKeyEvents,a as releaseHeldKeys,i as releaseHotKey,u as setupHotKeys,d as startKeyPassthrough,c as stopKeyPassthrough};

package/dist/common/http.d.ts

@@ -1,4 +1,2 @@
-/**
- * An equivalent to `fetch`, except will automatically retry.
- */
+/** An equivalent to `fetch`, except will automatically retry. */
 export declare function fetchRetry(url: string, options?: RequestInit, retryTimer?: number): Promise<Response>;

package/dist/common/react.d.ts

@@ -2,22 +2,15 @@
  * Helper for conditionally adding/removing classes in React
  */
 export declare function classes(classNames: (string | BooleanLike)[]): string;
-/**
- * Normalizes children prop, so that it is always an array of VDom
- * elements.
- */
-export declare function normalizeChildren<T>(children: T | T[]): T[];
 /**
  * Shallowly checks if two objects are different.
  * Credit: https://github.com/developit/preact-compat
  */
 export declare function shallowDiffers(a: Record<string, any>, b: Record<string, any>): boolean;
 /**
- * A common case in tgui, when you pass a value conditionally, these are
+ * A common case in tgui when you pass a value conditionally. These are
  * the types that can fall through the condition.
  */
 export type BooleanLike = number | boolean | null | undefined;
-/**
- * A helper to determine whether the object is renderable by React.
- */
+/** A helper to determine whether the object is renderable by React. */
 export declare function canRender(value: unknown): boolean;

package/dist/common/react.js

@@ -1 +1 @@
-function r(r){let n="";for(let e=0;e<r.length;e++){let t=r[e];"string"==typeof t&&(n+=`${t} `)}return n}function n(r){return Array.isArray(r)?r.flat().filter(r=>r):"object"==typeof r?[r]:[]}function e(r,n){let e;for(e in r)if(!(e in n))return!0;for(e in n)if(r[e]!==n[e])return!0;return!1}function t(r){return null!=r&&"boolean"!=typeof r}export{t as canRender,r as classes,n as normalizeChildren,e as shallowDiffers};
+function n(n){let e="";for(let r=0;r<n.length;r++){let t=n[r];"string"==typeof t&&(e+=`${t} `)}return e}function e(n,e){let r;for(r in n)if(!(r in e))return!0;for(r in e)if(n[r]!==e[r])return!0;return!1}function r(n){return null!=n&&"boolean"!=typeof n}export{r as canRender,n as classes,e as shallowDiffers};

package/dist/common/type-utils.js

@@ -1 +1 @@
-function e(e){let t={};for(let n in e)if(Array.isArray(e[n])){let r=e[n];if(e[n].length>0){t[n]=r[0];continue}t[n]="emptyarray"}else if("object"==typeof e[n]&&null!==e[n])t[n]="object (inspect) || Record<string, any>";else if("number"==typeof e[n]){let r=Number(e[n]);if(1===r||0===r){t[n]=`${r}, BooleanLike?`;continue}t[n]=e[n]}return t}export{e as getShallowTypes};
+function e(e){let t={};for(let r in e)if(Array.isArray(e[r])){let n=e[r];if(e[r].length>0){t[r]=n[0];continue}t[r]="emptyarray"}else if("object"==typeof e[r]&&null!==e[r])t[r]="Record<string, sometype>";else if("number"==typeof e[r]){let n=Number(e[r]);if(1===n||0===n){t[r]=`${n}, BooleanLike?`;continue}t[r]=e[r]}return t}export{e as getShallowTypes};

package/dist/common/ui.d.ts

@@ -9,7 +9,7 @@ export declare const unit: UnitMapper;
  * Same as `unit`, but half the size for integers numbers.
  */
 export declare const halfUnit: UnitMapper;
-export type StringStyleMap = {
+export type StringStyleMap = Partial<{
     /** Align text inside the box. */
     align: string | BooleanLike;
     /** A direct mapping to `position` CSS property. */
@@ -94,9 +94,9 @@ export type StringStyleMap = {
     lineHeight: string | BooleanLike;
     /** Align text inside the box. */
     textAlign: string | BooleanLike;
-};
+}>;
 export declare const stringStyleMap: Record<keyof StringStyleMap, any>;
-export type BooleanStyleMap = {
+export type BooleanStyleMap = Partial<{
     /** Make text bold. */
     bold: boolean;
     /** Fill positioned parent. */
@@ -109,7 +109,7 @@ export type BooleanStyleMap = {
     nowrap: boolean;
     /** Preserves line-breaks and spacing in text. */
     preserveWhitespace: boolean;
-};
+}>;
 export declare const booleanStyleMap: Record<keyof BooleanStyleMap, any>;
 export declare function computeBoxProps(props: any): Record<string, any>;
 export declare function computeBoxClassName<TElement = HTMLDivElement>(props: BoxProps<TElement>): string;

package/dist/components/Autofocus.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 type Props = Partial<{
     /** Optional child elements */
     children: ReactNode;

package/dist/components/Blink.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 type Props = {
     /** Things that blink! */
     children: ReactNode;

package/dist/components/Box.d.ts

@@ -1,7 +1,7 @@
 import { type CSSProperties, type KeyboardEventHandler, type MouseEventHandler, type ReactNode, type UIEventHandler } from 'react';
 import type { BooleanLike } from '../common/react';
 import { type BooleanStyleMap, type StringStyleMap } from '../common/ui';
-type EventHandlers<TElement = HTMLDivElement> = {
+type EventHandlers<TElement = HTMLDivElement> = Partial<{
     onClick: MouseEventHandler<TElement>;
     onContextMenu: MouseEventHandler<TElement>;
     onDoubleClick: MouseEventHandler<TElement>;
@@ -13,9 +13,12 @@ type EventHandlers<TElement = HTMLDivElement> = {
     onMouseOver: MouseEventHandler<TElement>;
     onMouseUp: MouseEventHandler<TElement>;
     onScroll: UIEventHandler<TElement>;
-};
-type InternalProps = {
-    /** The component used for the root node. */
+}>;
+type InternalProps = Partial<{
+    /**
+     * The component used for the root node.
+     * @default <div>
+     */
     as: string;
     /** The content of the component. */
     children: ReactNode;
@@ -48,8 +51,9 @@ type InternalProps = {
      * 3. This should be a static string with minimal interpolation. If you need more logic, prefer the props approach.
      */
     tw: string;
-};
-export type BoxProps<TElement = HTMLDivElement> = Partial<InternalProps & BooleanStyleMap & StringStyleMap & EventHandlers<TElement>>;
+}>;
+export interface BoxProps<TElement = HTMLDivElement> extends InternalProps, BooleanStyleMap, StringStyleMap, EventHandlers<TElement> {
+}
 type DangerDoNotUse = {
     dangerouslySetInnerHTML?: {
         __html: any;

package/dist/components/ByondUi.d.ts

@@ -16,6 +16,12 @@ type Props = Partial<{
      * You can find a full reference of these parameters
      * in [BYOND controls and parameters guide](https://secure.byond.com/docs/ref/skinparams.html). */
     params: SampleByondParams & Record<string, any>;
+    /**
+     * If this ByondUi element should tell DreamMaker that it has been created or not.
+     *
+     * Defaults to on.
+     */
+    phonehome: boolean;
 }> & BoxProps;
 /**
  * ## ByondUi

package/dist/components/ByondUi.js

@@ -1 +1 @@
-import*as e from"react/jsx-runtime";import*as t from"react";import*as n from"../common/timer.js";import*as o from"../common/ui.js";let r=[];function i(i){let{params:s,...u}=i,l=(0,t.useRef)(null),d=(0,t.useRef)(function(e){let t=r.length;r.push(null);let n=e||`byondui_${t}`;return{render:e=>{r[t]=n,Byond.winset(n,e)},unmount:()=>{r[t]=null,Byond.winset(n,{parent:""})}}}(s?.id));function m(){let e=l.current;if(!e)return;let t=function(e){let t=window.devicePixelRatio??1,n=e.getBoundingClientRect();return{pos:[n.left*t,n.top*t],size:[(n.right-n.left)*t,(n.bottom-n.top)*t]}}(e);d.current.render({parent:Byond.windowId,...s,pos:`${t.pos[0]},${t.pos[1]}`,size:`${t.size[0]}x${t.size[1]}`})}let f=(0,n.debounce)(()=>{m()},100);return(0,t.useEffect)(()=>(window.addEventListener("resize",f),m(),()=>{window.removeEventListener("resize",f),d.current.unmount()}),[]),(0,e.jsx)("div",{ref:l,...(0,o.computeBoxProps)(u),children:(0,e.jsx)("div",{style:{minHeight:"22px"}})})}window.addEventListener("beforeunload",()=>{for(let e=0;e<r.length;e++){let t=r[e];"string"==typeof t&&(r[e]=null,Byond.winset(t,{parent:""}))}});export{i as ByondUi};
+import*as e from"react/jsx-runtime";import*as n from"react";import*as t from"../common/timer.js";import*as o from"../common/ui.js";let r=[];function i(i){let{params:s,phonehome:d,...u}=i,l=(0,n.useRef)(null),m=(0,n.useRef)(function(e,n=!0){let t=r.length;r.push(null);let o=e||`byondui_${t}`;return{render:e=>{n&&Byond.sendMessage("renderByondUi",{renderByondUi:o}),r[t]=o,Byond.winset(o,e)},unmount:()=>{n&&Byond.sendMessage("unmountByondUi",{renderByondUi:o}),r[t]=null,Byond.winset(o,{parent:""})}}}(s?.id,d));function f(){let e=l.current;if(!e)return;let n=function(e){let n=window.devicePixelRatio??1,t=e.getBoundingClientRect();return{pos:[t.left*n,t.top*n],size:[(t.right-t.left)*n,(t.bottom-t.top)*n]}}(e);m.current.render({parent:Byond.windowId,...s,pos:`${n.pos[0]},${n.pos[1]}`,size:`${n.size[0]}x${n.size[1]}`})}let p=(0,t.debounce)(()=>{f()},100);return(0,n.useEffect)(()=>(window.addEventListener("resize",p),f(),()=>{window.removeEventListener("resize",p),m.current.unmount()}),[]),(0,e.jsx)("div",{ref:l,...(0,o.computeBoxProps)(u),children:(0,e.jsx)("div",{style:{minHeight:"22px"}})})}window.addEventListener("beforeunload",()=>{for(let e=0;e<r.length;e++){let n=r[e];"string"==typeof n&&(r[e]=null,Byond.winset(n,{parent:""}))}});export{i as ByondUi};

package/dist/components/Popper.d.ts

@@ -6,7 +6,8 @@ type Props = {
     /** Whether the popper is open */
     isOpen: boolean;
 } & Partial<{
-    /** Base z-index of the popper div
+    /**
+     * Base z-index of the popper div
      * @default 5
      */
     baseZIndex: number;

package/package.json

@@ -73,5 +73,5 @@
     "test": "bun test"
   },
   "type": "module",
-  "version": "3.3.1"
+  "version": "4.0.2"
 }