sandstone 1.0.0-beta.4 → 1.0.0

package/dist/_internal/types/utils.d.ts

@@ -307,4 +307,83 @@ type McdocNegatableIDMapBase<Dispatcher, UnknownValue> = MemberModifiers<Dispatc
 export type McdocNegatableIDMap<Dispatcher, UnknownValue> = Partial<McdocNegatableIDMapBase<Dispatcher, UnknownValue>> & {
     [K in keyof MemberModifiers<Dispatcher>]-?: Record<K, McdocNegatableIDMapBase<Dispatcher, UnknownValue>[K]>;
 }[keyof MemberModifiers<Dispatcher>];
+export type Enumerate<N extends number, Acc extends number[] = [
+]> = (number extends N ? number : Acc["length"] extends N ? Acc[number] : Enumerate<N, [
+    ...Acc,
+    Acc["length"]
+]>);
+export type BuildTuple<N extends number, T extends never[] = [
+]> = (number extends N ? never[] : T['length'] extends N ? T : BuildTuple<N, [
+    ...T,
+    never
+]>);
+export type Increment<N extends number> = (number extends N ? number : [
+    ...BuildTuple<N>,
+    never
+]['length'] & number);
+/**
+ * `0..`
+ *
+ * Can be made exclusive of zero via `Exclude<PositiveNumber<N>, 0>`
+ */
+export type PositiveNumber<T extends number> = (number extends T ? never : `${T}` extends `-${string}` ? never : T);
+/**
+ * `..<0`; Cannot be zero nor above zero.
+ *
+ * Can be made inclusive via `NegativeNumber<N> | 0`
+ */
+export type NegativeNumber<T extends number> = (number extends T ? never : `${T}` extends `-${string}` ? T : never);
+/**
+ * No decimal allowed.
+ */
+export type WholeNumber<T extends number> = (number extends T ? never : `${T}` extends `${string}.${string}` ? never : T);
+/**
+ * `0..` & no decimal allowed.
+ *
+ * Can be made exclusive of zero via `Exclude<PositiveWholeNumber<N>, 0>`
+ */
+export type PositiveWholeNumber<N extends number> = (PositiveNumber<N> extends never ? never : WholeNumber<N> extends never ? never : N);
+/**
+ * `..-1` & no decimal allowed.
+ *
+ * Can include zero via `NegativeWholeNumber<N> | 0`
+ */
+export type NegativeWholeNumber<T extends number> = (number extends T ? never : `${T}` extends `${string}.${string}` ? never : `${T}` extends `-${string}` ? T : never);
+/**
+ * `0<..<1`; Cannot be zero nor one, below zero, nor above one.
+ *
+ * Can be made inclusive by adding unioned `0`/`1` literals. (eg. `PositiveFraction<N> | 0 | 1`)
+ */
+export type PositiveFraction<T extends number> = (number extends T ? never : `${T}` extends `0.${string}` ? T : never);
+/**
+ * `-1<..<0`; Cannot be negative one nor zero, below negative one, nor above zero.
+ *
+ * Can be made inclusive by adding unioned `-1`/`0` literals. (eg. `NegativeFraction<N> | -1 | 0`)
+ */
+export type NegativeFraction<T extends number> = (number extends T ? never : `${T}` extends `-0.${string}` ? T : never);
+/**
+ * Converts a positive numeric literal to its negative counterpart.
+ * Example: ToNegative<5> -> -5
+ */
+export type ToNegative<T extends number> = (T extends 0 ? 0 : `-${T}` extends `${infer N extends number}` ? N : never);
+/**
+ * Checks if a number literal is negative by checking its string representation.
+ */
+export type IsNegative<N extends number> = `${N}` extends `-${string}` ? true : false;
+/**
+ * Gets the absolute value of a number.
+ */
+export type Abs<N extends number> = `${N}` extends `-${infer U extends number}` ? U : N;
+/**
+ * Creates a union of numbers from 0 to N-1.
+ */
+export type RangeTo<N extends number> = Enumerate<N>;
+/**
+ * Generates a union of numbers between two positive integers (inclusive).
+ */
+export type PositiveRange<Start extends number, End extends number> = Exclude<Enumerate<Increment<End>>, Enumerate<Start>>;
+/**
+ * The core logic for NBTInt<{ min: -5, max: 2 }>
+ */
+export type SmartRange<Min extends number, Max extends number> = (IsNegative<Min> extends true ? IsNegative<Max> extends true ? ToNegative<PositiveRange<Abs<Max>, Abs<Min>>> : ToNegative<PositiveRange<1, Abs<Min>>> | 0 | PositiveRange<1, Max> : PositiveRange<Min, Max>);
 export {};

package/dist/_internal/types/variables/Score.d.ts

@@ -167,6 +167,10 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      * @param amountOrTargetScore The value, or target's score to modulo the current score with.
      */
     modulo(amountOrTargetScore: number | Score): Score;
+    mod: {
+        (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
+        (amountOrTargetScore: number | Score): Score;
+    };
     '%=': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
         (amountOrTargetScore: number | Score): Score;
@@ -240,6 +244,10 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      * @param amountOrTargetScore The amount, or the target to multiply the scores from
      */
     multipliedBy(amountOrTargetScore: number | Score): Score;
+    times: {
+        (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
+        (amountOrTargetScore: number | Score): Score;
+    };
     '*': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
         (amountOrTargetScore: number | Score): Score;
@@ -276,6 +284,10 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      * @param amountOrTargetScore The amount, or target's score to modulo the current score by.
      */
     moduloBy(amountOrTargetScore: number | Score): Score;
+    modBy: {
+        (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
+        (amountOrTargetScore: number | Score): Score;
+    };
     '%': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): Score;
         (amountOrTargetScore: number | Score): Score;
@@ -307,13 +319,13 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      *
      * @param objective The related objective. If not specified, default to the same objective as the current target.
      */
-    greaterOrEqualThan(targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
+    greaterThanOrEqualTo(targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
     /**
      * Check if the current score is greater or equal than the given amount or score.
      *
      * @param amountOrTargetScore The amount or score compare the current score against.
      */
-    greaterOrEqualThan(amountOrTargetScore: number | Score): ConditionClass;
+    greaterThanOrEqualTo(amountOrTargetScore: number | Score): ConditionClass;
     '>=': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
         (amountOrTargetScore: number | Score): ConditionClass;
@@ -343,13 +355,13 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      *
      * @param objective The related objective. If not specified, default to the same objective as the current target.
      */
-    lessOrEqualThan(targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
+    lessThanOrEqualTo(targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
     /**
      * Check if the current score is lower or equal than the given amount or score.
      *
      * @param amountOrTargetScore The amount or score target to compare the current score against.
      */
-    lessOrEqualThan(amountOrTargetScore: number | Score): ConditionClass;
+    lessThanOrEqualTo(amountOrTargetScore: number | Score): ConditionClass;
     '<=': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
         (amountOrTargetScore: number | Score): ConditionClass;
@@ -368,6 +380,10 @@ export declare class Score extends MacroArgument implements ConditionClass, Comp
      * @param amountOrTargetScore The amount or score to compare the current score against.
      */
     equalTo(amountOrTargetScore: number | Score): ConditionClass;
+    equals: {
+        (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
+        (amountOrTargetScore: number | Score): ConditionClass;
+    };
     '==': {
         (targets: MultipleEntitiesArgument<false>, objective?: ObjectiveArgument): ConditionClass;
         (amountOrTargetScore: number | Score): ConditionClass;

package/dist/_internal/types/variables/Sleep.d.ts

@@ -7,7 +7,4 @@ export declare class SleepClass extends AwaitNode {
     mcfunction: import("../core/index.js").MCFunctionClass<undefined, undefined>;
     protected inSleepFunction: boolean;
     constructor(core: SandstoneCore, delay: TimeArgument);
-    promise(): {
-        then: any;
-    };
 }

package/dist/_internal/types/variables/nbt/NBTs.d.ts

@@ -300,5 +300,32 @@ interface NBTInterface {
     (nbts: TemplateStringsArray, ...args: unknown[]): NBTObject;
 }
 export declare const NBT: NBTInterface;
-export declare const nbtStringifier: (nbt: NBTObject | MacroArgument) => string;
+/**
+ * The resolved result of converting a Sandstone NBT value (which may contain
+ * live `MacroArgument` references) into the final Minecraft SNBT string.
+ *
+ * Carries macro information up to `CommandNode.getValue()` so commands with
+ * `$(...)` substitutions can be flagged as macro commands (prefixed with `$`)
+ * even when the macro originated from inside a nested value rather than as
+ * a top-level arg object.
+ */
+export declare class ResolvedNBT {
+    readonly value: string;
+    readonly containsMacro: boolean;
+    constructor(value: string, containsMacro: boolean);
+    toString(): string;
+}
+/**
+ * Resolves a Sandstone NBT value into its Minecraft SNBT string form.
+ *
+ * Unlike the previous `nbtStringifier`, the result is a `ResolvedNBT` object
+ * that preserves whether the value contained `$(...)` macro substitutions.
+ * `CommandNode.getValue()` uses `containsMacro` to decide whether to emit the
+ * command as a macro command (prefixed with `$`).
+ *
+ * Callers that need a plain string (template literals, string concatenation)
+ * can rely on `ResolvedNBT`'s `toString()`, which is called automatically by
+ * JS coercion. To be explicit, call `.toString()` on the result.
+ */
+export declare const nbtResolver: (nbt: NBTObject | MacroArgument) => ResolvedNBT;
 export {};

package/dist/browser/package.json

@@ -0,0 +1,3 @@
+{
+  "private": true
+}