bloxd.io.d.ts 1.0.1 → 1.1.0

package/api-type-def/normal/index.d.ts

@@ -10,6 +10,7 @@ import { PositionApis } from "./positions";
 import { StandingOnApis } from "./standingOns";
 import { HealthApis } from "./health";
 import { KillstreakApis } from "./killstreak";
+import { MessageApis } from "./message";
 import { MargeObject } from "../../type";
 
 type AllNormalApiIntersection = PositionApis &
@@ -23,6 +24,7 @@ type AllNormalApiIntersection = PositionApis &
   ShopApis &
   ShieldApis &
   HealthApis &
-  KillstreakApis;
+  KillstreakApis &
+  MessageApis;
 
 export type NormalApi = MargeObject<AllNormalApiIntersection>;

package/api-type-def/normal/message/broadcastMessage.d.ts

@@ -0,0 +1,18 @@
+import { CustomTextStyling } from "../../../type/message";
+
+interface BroadcastMessageInterface {
+  /**
+   * Send a message to everyone
+   *
+   * @param {string | CustomTextStyling} message - The text contained within the message. Can use `Custom Text Styling`.
+   * @param { { fontWeight?: number | string; color?: string } } [style] - An optional style argument. Can contain values for fontWeight and color of the message.
+   * style is ignored if message uses custom text styling (i.e. is not a string).
+   * @returns {void}
+   */
+  broadcastMessage(
+    message: string | CustomTextStyling,
+    style?: { fontWeight?: number | string; color?: string },
+  ): void;
+}
+
+export default BroadcastMessageInterface;

package/api-type-def/normal/message/index.d.ts

@@ -0,0 +1,6 @@
+import BroadcastMessageInterface from "./broadcastMessage";
+import SendMessageInterface from "./sendMessage";
+import SendFlyingMiddleMessage from "./sendFlyingMiddleMessage";
+export type MessageApis = BroadcastMessageInterface &
+  SendMessageInterface &
+  SendFlyingMiddleMessage;

package/api-type-def/normal/message/sendFlyingMiddleMessage.d.ts

@@ -0,0 +1,22 @@
+import { CustomTextStyling, PlayerId } from "../../../type";
+
+interface SendFlyingMiddleMessage {
+  /**
+   * Send a flying middle message to a specific player
+   *
+   * @param {PlayerId} playerId - Id of the player
+   * @param {string | CustomTextStyling} message - The text contained within the message. Can be either a string or use `Custom Text Styling`.
+   * @param {number} distanceFromAction - The distance from the action that has caused this message to be displayed,
+   * this value will be used to determine how the message flies across the screen.
+   * @param {number} [lifetimeMs] - How long the message will be visible in milliseconds. Defaults to 1000ms.
+   * @returns {void}
+   */
+  sendFlyingMiddleMessage(
+    playerId: PlayerId,
+    message: string | CustomTextStyling,
+    distanceFromAction?: number,
+    lifetimeMs?: number,
+  ): void;
+}
+
+export default SendFlyingMiddleMessage;

package/api-type-def/normal/message/sendMessage.d.ts

@@ -0,0 +1,28 @@
+import { PlayerId, CustomTextStyling } from "../../../type";
+
+interface SendMessageInterface {
+  /**
+   * Send a message to a specific player
+   *
+   * @param {PlayerId} playerId - Id of the player
+   * @param {string} message - The text contained within the message.
+   * @param { { fontWeight?: number | string; color?: string } } [style] - An optional style argument. Can contain values for fontWeight and color of the message.
+   * @returns {void}
+   */
+  sendMessage(
+    playerId: PlayerId,
+    message: string,
+    style: { fontWeight?: number | string; color?: string },
+  ): void;
+  /**
+   * Send a message to a specific player
+   *
+   * @param {PlayerId} playerId - Id of the player
+   * @param {CustomTextStyling} message - The text contained within the message.
+   *
+   * @returns {void}
+   */
+  sendMessage(playerId: PlayerId, message: CustomTextStyling): void;
+}
+
+export default SendMessageInterface;

package/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "bloxd.io.d.ts",
-  "version": "1.0.1",
-  "description": "yo",
-  "types": "bloxd-api.d.ts",
-  "exports": {
-    "./global": {
-      "types": "./bloxd-api.d.ts"
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/bulebrainbrand/bloxd.io.d.ts.git"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "ISC",
-  "type": "module",
-  "bugs": {
-    "url": "https://github.com/bulebrainbrand/bloxd.io.d.ts/issues"
-  },
-  "homepage": "https://github.com/bulebrainbrand/bloxd.io.d.ts#readme",
-  "files": [
-    "bloxd-api.d.ts",
-    "type/",
-    "api-type-def/"
-  ]
-}
+{
+  "name": "bloxd.io.d.ts",
+  "version": "1.1.0",
+  "description": "yo",
+  "types": "bloxd-api.d.ts",
+  "exports": {
+    "./global": {
+      "types": "./bloxd-api.d.ts"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bulebrainbrand/bloxd.io.d.ts.git"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/bulebrainbrand/bloxd.io.d.ts/issues"
+  },
+  "homepage": "https://github.com/bulebrainbrand/bloxd.io.d.ts#readme",
+  "files": [
+    "bloxd-api.d.ts",
+    "type/",
+    "api-type-def/"
+  ]
+}

package/type/color/StringColor.d.ts

@@ -0,0 +1,179 @@
+/**
+ * this type is color.
+ * allow all css color type.
+ * @example
+ * `#ff0000` | `rgb(255,0,0)` | `red` | `Red` | `#f00` | `rgba(255,0,0,1)` | `hsl(0,100%,50%)` | `hsla(0,100%,50%,1)` is all red
+ */
+export type StringColor =
+  // Hex colors
+  | `#${string}`
+  // RGB and RGBA
+  | `rgb(${string})`
+  | `rgba(${string})`
+  // HSL and HSLA
+  | `hsl(${string})`
+  | `hsla(${string})`
+  // HWB
+  | `hwb(${string})`
+  // LAB and LCH
+  | `lab(${string})`
+  | `lch(${string})`
+  // OKLAB and OKLCH
+  | `oklab(${string})`
+  | `oklch(${string})`
+  // color() function
+  | `color(${string})`
+  // Special values
+  | "currentColor"
+  | "transparent"
+  // CSS named colors (full list)
+  | "aliceblue"
+  | "antiquewhite"
+  | "aqua"
+  | "aquamarine"
+  | "azure"
+  | "beige"
+  | "bisque"
+  | "black"
+  | "blanchedalmond"
+  | "blue"
+  | "blueviolet"
+  | "brown"
+  | "burlywood"
+  | "cadetblue"
+  | "chartreuse"
+  | "chocolate"
+  | "coral"
+  | "cornflowerblue"
+  | "cornsilk"
+  | "crimson"
+  | "cyan"
+  | "darkblue"
+  | "darkcyan"
+  | "darkgoldenrod"
+  | "darkgray"
+  | "darkgreen"
+  | "darkgrey"
+  | "darkkhaki"
+  | "darkmagenta"
+  | "darkolivegreen"
+  | "darkorange"
+  | "darkorchid"
+  | "darkred"
+  | "darksalmon"
+  | "darkseagreen"
+  | "darkslateblue"
+  | "darkslategray"
+  | "darkslategrey"
+  | "darkturquoise"
+  | "darkviolet"
+  | "deeppink"
+  | "deepskyblue"
+  | "dimgray"
+  | "dimgrey"
+  | "dodgerblue"
+  | "firebrick"
+  | "floralwhite"
+  | "forestgreen"
+  | "fuchsia"
+  | "gainsboro"
+  | "ghostwhite"
+  | "gold"
+  | "goldenrod"
+  | "gray"
+  | "green"
+  | "greenyellow"
+  | "grey"
+  | "honeydew"
+  | "hotpink"
+  | "indianred"
+  | "indigo"
+  | "ivory"
+  | "khaki"
+  | "lavender"
+  | "lavenderblush"
+  | "lawngreen"
+  | "lemonchiffon"
+  | "lightblue"
+  | "lightcoral"
+  | "lightcyan"
+  | "lightgoldenrodyellow"
+  | "lightgray"
+  | "lightgreen"
+  | "lightgrey"
+  | "lightpink"
+  | "lightsalmon"
+  | "lightseagreen"
+  | "lightskyblue"
+  | "lightslategray"
+  | "lightslategrey"
+  | "lightsteelblue"
+  | "lightyellow"
+  | "lime"
+  | "limegreen"
+  | "linen"
+  | "magenta"
+  | "maroon"
+  | "mediumaquamarine"
+  | "mediumblue"
+  | "mediumorchid"
+  | "mediumpurple"
+  | "mediumseagreen"
+  | "mediumslateblue"
+  | "mediumspringgreen"
+  | "mediumturquoise"
+  | "mediumvioletred"
+  | "midnightblue"
+  | "mintcream"
+  | "mistyrose"
+  | "moccasin"
+  | "navajowhite"
+  | "navy"
+  | "oldlace"
+  | "olive"
+  | "olivedrab"
+  | "orange"
+  | "orangered"
+  | "orchid"
+  | "palegoldenrod"
+  | "palegreen"
+  | "paleturquoise"
+  | "palevioletred"
+  | "papayawhip"
+  | "peachpuff"
+  | "peru"
+  | "pink"
+  | "plum"
+  | "powderblue"
+  | "purple"
+  | "rebeccapurple"
+  | "red"
+  | "rosybrown"
+  | "royalblue"
+  | "saddlebrown"
+  | "salmon"
+  | "sandybrown"
+  | "seagreen"
+  | "seashell"
+  | "sienna"
+  | "silver"
+  | "skyblue"
+  | "slateblue"
+  | "slategray"
+  | "slategrey"
+  | "snow"
+  | "springgreen"
+  | "steelblue"
+  | "tan"
+  | "teal"
+  | "thistle"
+  | "tomato"
+  | "turquoise"
+  | "violet"
+  | "wheat"
+  | "white"
+  | "whitesmoke"
+  | "yellow"
+  | "yellowgreen"
+  // fallback allowance for any other valid CSS color syntaxes not listed above
+  | string;

package/type/color/index.d.ts

@@ -1,2 +1,3 @@
 export * from "./Array255Color";
 export * from "./Array255ColorWithA";
+export * from "./StringColor";

package/type/index.d.ts

@@ -16,3 +16,4 @@ export * from "./WhoDidDamage";
 export * from "./WhoKilled";
 export * from "./utilType";
 export * from "./ApplyMeleeHitOverrides";
+export * from "./message";

package/type/message/CustomTextStyling.d.ts

@@ -0,0 +1,9 @@
+import { EntityName, StyledIcon, StyledText, TranslatedText } from ".";
+
+export type CustomTextStyling = (
+  | string
+  | EntityName
+  | TranslatedText
+  | StyledIcon
+  | StyledText
+)[];

package/type/message/EntityName.d.ts

@@ -0,0 +1,9 @@
+import { StringColor } from "..";
+
+export type EntityName = {
+  entityName: string;
+  style?: {
+    color?: StringColor;
+    colour?: StringColor;
+  };
+};

package/type/message/StyledIcon.d.ts

@@ -0,0 +1,11 @@
+import { StringColor } from "..";
+
+export type StyledIcon = {
+  icon: string;
+  style?: {
+    color?: StringColor;
+    colour?: StringColor;
+    fontSize?: string;
+    opacity?: number;
+  };
+};

package/type/message/StyledText.d.ts

@@ -0,0 +1,7 @@
+import { EntityName, TextStyle, TranslatedText } from ".";
+
+export type StyledText = {
+  str: string | EntityName | TranslatedText;
+  style?: TextStyle;
+  clickableUrl?: string;
+};

package/type/message/TextStyle.d.ts

@@ -0,0 +1,9 @@
+import { StringColor } from "../color";
+
+export type TextStyle = {
+  color?: StringColor;
+  colour?: StringColor;
+  fontSize?: string;
+  fontWeight?: number | string;
+  opacity?: number;
+};

package/type/message/TranslatedText.d.ts

@@ -0,0 +1,6 @@
+import { EntityName } from ".";
+
+export type TranslatedText = {
+  translationKey: string;
+  params?: Record<string, string | number | boolean | EntityName>;
+};

package/type/message/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./CustomTextStyling";
+export * from "./EntityName";
+export * from "./TranslatedText";
+export * from "./StyledIcon";
+export * from "./TextStyle";
+export * from "./StyledText";