@kradle/challenges 0.0.1

package/dist/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../src/commands.ts"],"names":[],"mappings":"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"}

package/dist/constants.d.ts

@@ -0,0 +1,70 @@
+import { type Score } from "sandstone";
+/**
+ * All possible events that can be defined in a challenge.
+ */
+export type POSSIBLE_SCENARIO_EVENTS = "start_challenge" | "init_participants" | "end_challenge" | "on_tick";
+export declare const VISIBLE_OBJECTIVE: import("sandstone").ObjectiveInstance<string | undefined>;
+export declare const HIDDEN_OBJECTIVE: import("sandstone").ObjectiveInstance<string | undefined>;
+export declare const WATCHER = "watcher";
+export declare const WEB_VIEWER = "KradleWebViewer";
+export declare const KRADLE_PARTICIPANT_TAG = "kradle_participant";
+export declare const WINNER_TAG = "kradle_winner";
+export declare const DISPLAY_TAG = "***KRADLE***";
+export declare const MAX_DURATION: number;
+export declare const ALL: import("sandstone").SelectorClass<false, true>;
+export declare const GAME_STATES: {
+    readonly CREATED: 0;
+    readonly ON: 2;
+    readonly OFF: 1;
+};
+export declare const BUILTIN_VARIABLES: {
+    death_count: {
+        type: "individual";
+        objective_type: "deathCount";
+        default: number;
+    };
+    has_never_died: {
+        type: "individual";
+        updater: (value: Score, { death_count }: Record<string, Score<string | undefined>>) => void;
+    };
+    alive_players: {
+        type: "global";
+        updater: (value: Score, { has_never_died }: Record<string, Score<string | undefined>>) => void;
+    };
+    main_score: {
+        type: "individual";
+        default: number;
+        updater: (value: Score) => void;
+    };
+    game_timer: {
+        type: "global";
+        default: number;
+        updater: (value: Score) => void;
+    };
+    game_state: {
+        type: "global";
+        default: 0;
+    };
+    player_count: {
+        type: "global";
+        default: number;
+    };
+    player_number: {
+        type: "individual";
+        objective_type: "dummy";
+        default: number;
+        updater: (value: Score, { player_count }: Record<string, Score<string | undefined>>) => void;
+    };
+    death_event: {
+        type: "individual";
+        objective_type: "deathCount";
+        updater: (value: Score) => void;
+    };
+};
+export type BUILTIN_VARIABLE_NAMES = keyof typeof BUILTIN_VARIABLES;
+export declare const BUILTIN_SCORE_EVENTS: (variables: Record<BUILTIN_VARIABLE_NAMES, Score>) => {
+    mode: "repeatable";
+    score: Score<string | undefined>;
+    actions: (() => void)[];
+}[];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,KAAK,EAAY,MAAM,WAAW,CAAC;AAIxE;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,eAAe,GAAG,SAAS,CAAC;AAE7G,eAAO,MAAM,iBAAiB,2DAAuF,CAAC;AACtH,eAAO,MAAM,gBAAgB,2DAAoC,CAAC;AAElE,eAAO,MAAM,OAAO,YAAY,CAAC;AACjC,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAC5C,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAC3D,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAC1C,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAE1C,eAAO,MAAM,YAAY,QAAc,CAAC;AAGxC,eAAO,MAAM,GAAG,gDAAkD,CAAC;AACnE,eAAO,MAAM,WAAW;;;;CAId,CAAC;AAKX,eAAO,MAAM,iBAAiB;;;;;;;;yBAQX,KAAK;;;;yBASL,KAAK;;;;;yBAYL,KAAK;;;;;yBAOL,KAAK;;;;;;;;;;;;;;yBAiBL,KAAK;;;;;yBAYL,KAAK;;CAS8B,CAAC;AAEvD,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEpE,eAAO,MAAM,oBAAoB,GAAI,WAAW,MAAM,CAAC,sBAAsB,EAAE,KAAK,CAAC;;;;GAWjD,CAAC"}

package/dist/constants.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUILTIN_SCORE_EVENTS = exports.BUILTIN_VARIABLES = exports.GAME_STATES = exports.ALL = exports.MAX_DURATION = exports.DISPLAY_TAG = exports.WINNER_TAG = exports.KRADLE_PARTICIPANT_TAG = exports.WEB_VIEWER = exports.WATCHER = exports.HIDDEN_OBJECTIVE = exports.VISIBLE_OBJECTIVE = void 0;
+const sandstone_1 = require("sandstone");
+const types_1 = require("./types");
+const utils_1 = require("./utils");
+exports.VISIBLE_OBJECTIVE = sandstone_1.Objective.create("kradle.board", "dummy", [{ text: "Kradle Board", color: "gold" }]);
+exports.HIDDEN_OBJECTIVE = sandstone_1.Objective.create("kradle.hidden");
+exports.WATCHER = "watcher";
+exports.WEB_VIEWER = "KradleWebViewer";
+exports.KRADLE_PARTICIPANT_TAG = "kradle_participant";
+exports.WINNER_TAG = "kradle_winner";
+exports.DISPLAY_TAG = "***KRADLE***";
+exports.MAX_DURATION = 5 * 60 * 20; // 5 minutes in ticks
+/// The selector that targets all participants in the game.
+exports.ALL = (0, sandstone_1.Selector)("@a", { tag: exports.KRADLE_PARTICIPANT_TAG });
+exports.GAME_STATES = {
+    CREATED: 0,
+    ON: 2,
+    OFF: 1,
+};
+/// The variables that are builtin by default in every challenge.
+/// These variables are used to track the state of the game and the players.
+/// They can be used in the challenge definition to create end conditions, win conditions, and events.
+exports.BUILTIN_VARIABLES = {
+    death_count: {
+        type: "individual",
+        objective_type: "deathCount",
+        default: 0,
+    },
+    has_never_died: {
+        type: "individual",
+        updater: (value, { death_count }) => {
+            value.set(0);
+            sandstone_1._.if(death_count.equalTo(0), () => {
+                value.set(1);
+            });
+        },
+    },
+    alive_players: {
+        type: "global",
+        updater: (value, { has_never_died }) => {
+            value.set(0);
+            sandstone_1.execute.as(exports.ALL).run((0, utils_1.getChildFunctionName)("alive_players"), () => {
+                sandstone_1._.if(has_never_died, () => {
+                    value.add(1);
+                });
+            });
+        },
+    },
+    main_score: {
+        type: "individual",
+        default: 0,
+        updater: (value) => {
+            (0, exports.VISIBLE_OBJECTIVE)("@s").set(value);
+        },
+    },
+    game_timer: {
+        type: "global",
+        default: 0,
+        updater: (value) => {
+            value.add(1);
+        },
+    },
+    game_state: {
+        type: "global",
+        default: exports.GAME_STATES.CREATED,
+    },
+    player_count: {
+        type: "global",
+        default: 0,
+    },
+    /// This variable is used to assign a unique number to each player, starting from 1.
+    player_number: {
+        type: "individual",
+        objective_type: "dummy",
+        default: 0,
+        updater: (value, { player_count }) => {
+            sandstone_1._.if(value.equalTo(0), () => {
+                player_count.add(1);
+                value.set(player_count);
+                //tellraw("@a", [`${DISPLAY_TAG}`, { selector: "@s" }, "@s is player number ", value]);
+            });
+        },
+    },
+    /// This variable is used to announce in-game deaths
+    death_event: {
+        type: "individual",
+        objective_type: "deathCount",
+        updater: (value) => {
+            sandstone_1._.if(value.greaterThan(0), () => {
+                types_1.Actions.announce({
+                    message: [(0, sandstone_1.Selector)("@s"), " has died!"],
+                })();
+                value.set(0); // Reset the death count after announcing
+            });
+        },
+    },
+};
+const BUILTIN_SCORE_EVENTS = (variables) => [
+    {
+        mode: "repeatable",
+        score: variables.main_score,
+        actions: [
+            () => {
+                (0, exports.VISIBLE_OBJECTIVE)("@s").set(variables.main_score);
+            },
+        ],
+    },
+];
+exports.BUILTIN_SCORE_EVENTS = BUILTIN_SCORE_EVENTS;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Actions } from "./actions";
+export * from "./api_utils";
+export * from "./challenge";
+export * from "./constants";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actions = void 0;
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "Actions", { enumerable: true, get: function () { return actions_1.Actions; } });
+__exportStar(require("./api_utils"), exports);
+__exportStar(require("./challenge"), exports);
+__exportStar(require("./constants"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,8CAA4B;AAC5B,8CAA4B;AAC5B,8CAA4B"}

package/dist/testmode.d.ts

@@ -0,0 +1,3 @@
+export declare const test_mode_enabled = false;
+export declare const set_up_test_mode: () => void;
+//# sourceMappingURL=testmode.d.ts.map

package/dist/testmode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testmode.d.ts","sourceRoot":"","sources":["../src/testmode.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,QAAQ,CAAC;AAIvC,eAAO,MAAM,gBAAgB,YAS5B,CAAC"}

package/dist/testmode.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.set_up_test_mode = exports.test_mode_enabled = void 0;
+const sandstone_1 = require("sandstone");
+const constants_1 = require("./constants");
+//set to true to enable test mode
+exports.test_mode_enabled = false;
+//set the minecraft name of the tester player
+const tester_minecraft_name = "";
+const set_up_test_mode = () => {
+    // 1. Tag the tester player if they're going to be participating
+    (0, sandstone_1.tag)(tester_minecraft_name).add(constants_1.KRADLE_PARTICIPANT_TAG);
+    // 2. Set the tester player's gamemode, e.g. survival
+    (0, sandstone_1.raw)(`gamemode survival ${tester_minecraft_name}`);
+    // 3. Set the gamerule sendCommandFeedback to true
+    (0, sandstone_1.raw)("gamerule sendCommandFeedback true");
+};
+exports.set_up_test_mode = set_up_test_mode;
+//# sourceMappingURL=testmode.js.map

package/dist/testmode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testmode.js","sourceRoot":"","sources":["../src/testmode.ts"],"names":[],"mappings":";;;AAAA,yCAAqC;AACrC,2CAAqD;AAErD,iCAAiC;AACpB,QAAA,iBAAiB,GAAG,KAAK,CAAC;AACvC,6CAA6C;AAC7C,MAAM,qBAAqB,GAAG,EAAE,CAAC;AAE1B,MAAM,gBAAgB,GAAG,GAAG,EAAE;IACpC,gEAAgE;IAChE,IAAA,eAAG,EAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,kCAAsB,CAAC,CAAC;IAEvD,qDAAqD;IACrD,IAAA,eAAG,EAAC,qBAAqB,qBAAqB,EAAE,CAAC,CAAC;IAElD,kDAAkD;IAClD,IAAA,eAAG,EAAC,mCAAmC,CAAC,CAAC;AAC1C,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B"}

package/dist/types.d.ts

@@ -0,0 +1,103 @@
+import type { Score } from "sandstone";
+import type { OBJECTIVE_CRITERION } from "sandstone/arguments/generated";
+import type { AdvancementTriggers } from "sandstone/arguments/resources/AdvancementTriggers";
+import type { Action } from "./actions";
+import type { BUILTIN_VARIABLE_NAMES, POSSIBLE_SCENARIO_EVENTS } from "./constants";
+export { Actions } from "./actions";
+export type _SpecificObjectiveVariable<VARIABLE_NAMES extends string = string> = {
+    type: "individual";
+    objective_type: OBJECTIVE_CRITERION;
+    /** The default value for the variable. 0 if undefined. */
+    default?: number;
+    /** The updater function is used to dynamically compute the value of the variable. */
+    updater?: (value: Score, variables: Record<VARIABLE_NAMES, Score>) => void;
+};
+export type _DummyGlobalVariable<VARIABLE_NAMES extends string = string> = {
+    type: "global";
+    /** Whether the value should be displayed in-game. */
+    hidden?: boolean;
+    /** The default value for the variable. 0 if undefined. */
+    default?: number;
+    /** The updater function is used to dynamically compute the value of the variable. */
+    updater?: (value: Score, variables: Record<VARIABLE_NAMES, Score>) => void;
+};
+export type _DummyIndividualVariable<VARIABLE_NAMES extends string = string> = {
+    type: "individual";
+    /** The default value for the variable. 0 if undefined. */
+    default?: number;
+    /** The updater function is used to dynamically compute the value of the variable. */
+    updater?: (value: Score, variables: Record<VARIABLE_NAMES, Score>) => void;
+};
+/**
+ * A custom variable defined for the whole challenge.
+ */
+export type _InputVariableType<VARIABLE_NAMES extends string = string> = _SpecificObjectiveVariable<VARIABLE_NAMES> | _DummyGlobalVariable<VARIABLE_NAMES> | _DummyIndividualVariable<VARIABLE_NAMES>;
+export declare function isSpecificObjectiveVariable(variable: _InputVariableType<string>): variable is _SpecificObjectiveVariable<string>;
+/**
+ * The base configuration necessary to define events, end conditions, and win conditions for a challenge.
+ */
+export type _BaseConfig<ROLE_NAMES extends string, VARIABLE_NAMES extends string> = {
+    /**
+     * Name of the datapack that will be created for this challenge.
+     */
+    name: string;
+    /**
+     * The path where the datapack will be created. It is expected to be `kradle-studio/challenges`.
+     */
+    kradle_challenge_path: string;
+    /**
+     * Game duration in ticks.
+     *
+     * Can be set to `INFINITY` (the default) to run without a time limit.
+     *
+     * @default INFINITY
+     */
+    GAME_DURATION?: number;
+    roles: ROLE_NAMES[];
+    custom_variables: Record<VARIABLE_NAMES, _InputVariableType<VARIABLE_NAMES | BUILTIN_VARIABLE_NAMES>>;
+};
+export type _ScenarioEvents = Partial<Record<POSSIBLE_SCENARIO_EVENTS, {
+    actions: Action[];
+}>>;
+export type Roles<ROLES_NAMES extends string = string> = {
+    [role in ROLES_NAMES]: role;
+};
+export type FullVariable<VARIABLE_NAMES extends string = string> = {
+    type: "individual" | "global";
+    score: Score;
+    default: number | undefined;
+    updater: ((value: Score, variables: Record<VARIABLE_NAMES, Score>) => void) | undefined;
+};
+/**
+ * "Full" variables are the variables the challenges passes to the user in events/other variable updaters.
+ */
+export type FullVariables<VARIABLE_NAMES extends string = string> = Record<VARIABLE_NAMES | BUILTIN_VARIABLE_NAMES, FullVariable<VARIABLE_NAMES>>;
+export type Variables<VARIABLE_NAMES extends string = string> = Record<VARIABLE_NAMES | BUILTIN_VARIABLE_NAMES, Score>;
+type _InputEventCommonProperties = {
+    /** The target score to reach to trigger the event */
+    target?: number | undefined;
+    /** The mode of the event, either fire once or fire every time the score reaches the target */
+    mode: "fire_once" | "repeatable";
+    /** Actions to execute when the event is triggered */
+    actions: Action[];
+};
+export type _InputScoreCustomEventType = {
+    /** The target score to reach to trigger the event */
+    score: Score;
+} & _InputEventCommonProperties;
+export type _InputAdvancementCustomEventType = {
+    /** A list of criteria that must be met to trigger the event */
+    criteria: AdvancementTriggers[];
+} & _InputEventCommonProperties;
+export type _InputCustomEventType = _InputScoreCustomEventType | _InputAdvancementCustomEventType;
+export type CustomScoreEvent = {
+    /** The input event that defines the conditions for the custom event */
+    inputEvent: _InputScoreCustomEventType;
+    /** The score that counts how many times the event has been triggered */
+    counter: Score;
+    /** The type of the event */
+    type: "global" | "individual";
+    /** A name used for debugging purposes */
+    debugName: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mDAAmD,CAAC;AAC7F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEpF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,MAAM,0BAA0B,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI;IAChF,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,EAAE,mBAAmB,CAAC;IACpC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;CAC3E,CAAC;AAKF,MAAM,MAAM,oBAAoB,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI;IAC1E,IAAI,EAAE,QAAQ,CAAC;IACf,qDAAqD;IACrD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;CAC3E,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI;IAC9E,IAAI,EAAE,YAAY,CAAC;IACnB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC;CAC3E,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAClE,0BAA0B,CAAC,cAAc,CAAC,GAC1C,oBAAoB,CAAC,cAAc,CAAC,GACpC,wBAAwB,CAAC,cAAc,CAAC,CAAC;AAE5C,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAClC,QAAQ,IAAI,0BAA0B,CAAC,MAAM,CAAC,CAEhD;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,UAAU,SAAS,MAAM,EAAE,cAAc,SAAS,MAAM,IAAI;IACnF;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAE9B;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC,cAAc,GAAG,sBAAsB,CAAC,CAAC,CAAC;CACtG,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,wBAAwB,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAAC,CAAC;AAE/F,MAAM,MAAM,KAAK,CAAC,WAAW,SAAS,MAAM,GAAG,MAAM,IAAI;KACvD,IAAI,IAAI,WAAW,GAAG,IAAI;CAC3B,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI;IAClE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,KAAK,CAAC,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACxF,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CACzE,cAAc,GAAG,sBAAsB,EACvC,YAAY,CAAC,cAAc,CAAC,CAC5B,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,cAAc,SAAS,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,cAAc,GAAG,sBAAsB,EAAE,KAAK,CAAC,CAAC;AAEvH,KAAK,2BAA2B,GAAG;IAClC,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,8FAA8F;IAC9F,IAAI,EAAE,WAAW,GAAG,YAAY,CAAC;IACjC,qDAAqD;IACrD,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACxC,qDAAqD;IACrD,KAAK,EAAE,KAAK,CAAC;CACb,GAAG,2BAA2B,CAAC;AAEhC,MAAM,MAAM,gCAAgC,GAAG;IAC9C,+DAA+D;IAC/D,QAAQ,EAAE,mBAAmB,EAAE,CAAC;CAChC,GAAG,2BAA2B,CAAC;AAEhC,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,GAAG,gCAAgC,CAAC;AAElG,MAAM,MAAM,gBAAgB,GAAG;IAC9B,uEAAuE;IACvE,UAAU,EAAE,0BAA0B,CAAC;IAEvC,wEAAwE;IACxE,OAAO,EAAE,KAAK,CAAC;IAEf,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,GAAG,YAAY,CAAC;IAE9B,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/types.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Actions = void 0;
+exports.isSpecificObjectiveVariable = isSpecificObjectiveVariable;
+var actions_1 = require("./actions");
+Object.defineProperty(exports, "Actions", { enumerable: true, get: function () { return actions_1.Actions; } });
+function isSpecificObjectiveVariable(variable) {
+    return variable.type === "individual" && !!variable.objective_type;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AA+CA,kEAIC;AA7CD,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAyChB,SAAgB,2BAA2B,CAC1C,QAAoC;IAEpC,OAAO,QAAQ,CAAC,IAAI,KAAK,YAAY,IAAI,CAAC,CAAE,QAAgB,CAAC,cAAc,CAAC;AAC7E,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,17 @@
+export type LiteralStringUnion<LiteralType> = LiteralType | (string & Record<never, never>);
+/**
+ * Generates a unique child function name based on the given name & the current context.
+ *
+ * For example, if you're inside a MCFunction named "test",
+ * getChildFunctionName("myFunction") will return "test/myFunction".
+ *
+ * This is useful to get meaningful names for child functions, instead of the standard "execute_as_1/2/3...".
+ *
+ * 👉 This brings more clarity to the generated functions tree, without impacting the datapack behavior.
+ *
+ * @param name The base name for the child function.
+ *
+ * @returns A meaningful child function name that is unique within the current context.
+ */
+export declare function getChildFunctionName(name: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,kBAAkB,CAAC,WAAW,IAAI,WAAW,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5F;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/utils.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getChildFunctionName = getChildFunctionName;
+const init_1 = require("sandstone/init");
+/**
+ * Generates a unique child function name based on the given name & the current context.
+ *
+ * For example, if you're inside a MCFunction named "test",
+ * getChildFunctionName("myFunction") will return "test/myFunction".
+ *
+ * This is useful to get meaningful names for child functions, instead of the standard "execute_as_1/2/3...".
+ *
+ * 👉 This brings more clarity to the generated functions tree, without impacting the datapack behavior.
+ *
+ * @param name The base name for the child function.
+ *
+ * @returns A meaningful child function name that is unique within the current context.
+ */
+function getChildFunctionName(name) {
+    return init_1.dataPack.getUniqueChildName(name).fullName;
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":";;AAmBA,oDAEC;AArBD,yCAA0C;AAK1C;;;;;;;;;;;;;GAaG;AACH,SAAgB,oBAAoB,CAAC,IAAY;IAChD,OAAO,eAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;AACnD,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@kradle/challenges",
+  "version": "0.0.1",
+  "description": "Kradle's challenges API",
+  "keywords": [],
+  "license": "AGPL-3.0",
+  "author": "Kradle",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "lint": "biome lint --fix --unsafe",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "sandstone": "0.14.0-alpha.13"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.4",
+    "@types/node": "^18.14.0",
+    "typescript": "^5.9.3"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  }
+}