redscript-mc 2.6.0 → 3.0.0

package/dist/cli.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * RedScript CLI
+ *
+ * Usage:
+ *   redscript compile <file> [-o <out>] [--output-nbt <file>] [--namespace <ns>]
+ *   redscript check <file>
+ *   redscript repl
+ *   redscript version
+ */
+export {};

package/dist/codegen/cmdblock/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Command Block Target
+ *
+ * Generates a JSON structure representing command blocks that can be
+ * placed in Minecraft to run the compiled datapack.
+ */
+export interface CommandBlock {
+    type: 'repeat' | 'impulse' | 'chain';
+    command: string;
+    pos: [number, number, number];
+    auto?: boolean;
+    conditional?: boolean;
+}
+export interface CommandBlockStructure {
+    format: 'redscript-cmdblock-v1';
+    namespace: string;
+    blocks: CommandBlock[];
+}
+/**
+ * Generate a command block structure JSON for a given namespace.
+ *
+ * Creates:
+ * - 1 × Repeat block: function <namespace>:__tick
+ * - 1 × Impulse block (auto): function <namespace>:__load
+ */
+export declare function generateCommandBlocks(namespace: string, hasTick: boolean, hasLoad: boolean): CommandBlockStructure;

package/dist/codegen/cmdblock/index.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Command Block Target
+ *
+ * Generates a JSON structure representing command blocks that can be
+ * placed in Minecraft to run the compiled datapack.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCommandBlocks = generateCommandBlocks;
+/**
+ * Generate a command block structure JSON for a given namespace.
+ *
+ * Creates:
+ * - 1 × Repeat block: function <namespace>:__tick
+ * - 1 × Impulse block (auto): function <namespace>:__load
+ */
+function generateCommandBlocks(namespace, hasTick, hasLoad) {
+    const blocks = [];
+    let x = 0;
+    // Load block - impulse with auto (runs once when placed)
+    if (hasLoad) {
+        blocks.push({
+            type: 'impulse',
+            command: `function ${namespace}:__load`,
+            pos: [x, 0, 0],
+            auto: true,
+        });
+        x++;
+    }
+    // Tick block - repeat (runs every tick)
+    if (hasTick) {
+        blocks.push({
+            type: 'repeat',
+            command: `function ${namespace}:__tick`,
+            pos: [x, 0, 0],
+        });
+        x++;
+    }
+    return {
+        format: 'redscript-cmdblock-v1',
+        namespace,
+        blocks,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/codegen/mcfunction/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Code generator: IR → mcfunction datapack
+ *
+ * Output structure:
+ *   <namespace>/
+ *     functions/
+ *       <fn_name>.mcfunction
+ *       <fn_name>/<block_label>.mcfunction   (for control-flow continuations)
+ *     load.mcfunction     (objective setup)
+ *
+ * Variable mapping:
+ *   scoreboard objective: "rs"
+ *   fake player:          "$<varname>"
+ *   temporaries:          "$_0", "$_1", ...
+ *   return value:         "$ret"
+ *   parameters:           "$p0", "$p1", ...
+ */
+import type { IRModule } from '../../ir/types';
+import { type OptimizationStats } from '../../optimizer/commands';
+export interface DatapackFile {
+    path: string;
+    content: string;
+}
+export interface DatapackGenerationResult {
+    files: DatapackFile[];
+    advancements: DatapackFile[];
+    stats: OptimizationStats;
+    sourceMap?: Record<string, string>;
+}
+export interface DatapackGenerationOptions {
+    optimizeCommands?: boolean;
+    mangle?: boolean;
+    /** Scoreboard objective used for all scoreboard variables.
+     *  Defaults to 'rs'. Override per-datapack to avoid collisions
+     *  when multiple RedScript datapacks are loaded simultaneously. */
+    scoreboardObjective?: string;
+}
+export declare function countMcfunctionCommands(files: DatapackFile[]): number;
+export declare function generateDatapackWithStats(module: IRModule, options?: DatapackGenerationOptions): DatapackGenerationResult;
+export declare function generateDatapack(module: IRModule): DatapackFile[];