Add utils functions

deps.ts

@@ -1,3 +1,4 @@
+export { deepMerge as _deepMerge } from "https://deno.land/[email protected]/collections/deep_merge.ts";
 export * as JSONC from "https://deno.land/[email protected]/encoding/jsonc.ts";
 export { dirname } from "https://deno.land/[email protected]/path/mod.ts";
 export { join } from "https://deno.land/[email protected]/path/posix.ts";

lib/utils/addAnimation.ts

@@ -0,0 +1,38 @@
+import { StringOrRecord } from "../schemas/mod.ts";
+
+interface DescriptionLike {
+  scripts?: {
+    animate?: StringOrRecord[];
+  };
+  animations?: Record<string, string>;
+}
+
+/**
+ * Helper function to add an animation to a description object
+ *
+ * @param description A description object that has a scripts and animations property
+ * @param name Animation name
+ * @param identifier Animation identifier
+ * @param condition Molang query. Set to `true` to always run
+ */
+export function addAnimation(
+  description: DescriptionLike,
+  name: string,
+  identifier: string,
+  condition?: string | true,
+): void {
+  description.scripts ??= {};
+  description.scripts.animate ??= [];
+  description.animations ??= {};
+
+  description.animations[name] = identifier;
+
+  if (!condition) return;
+  if (typeof condition === "string") {
+    description.scripts.animate.push({
+      [name]: condition,
+    });
+  } else {
+    description.scripts.animate.push(name);
+  }
+}

lib/utils/deepMerge.ts

@@ -0,0 +1,6 @@
+import { _deepMerge } from "../../deps.ts";
+
+export function deepMerge<T>(source: T, others: T): T {
+  // @ts-ignore: deepMerge is not generic
+  return _deepMerge(source, others);
+}

mod.ts

@@ -16,8 +16,10 @@ export * from "./lib/addon/recipe/Recipe.ts";
 export * from "./lib/addon/render_controller/RenderController.ts";
 export * from "./lib/core/Identifier.ts";
 export * from "./lib/core/Project.ts";
-export * from "./lib/core/proxy.ts";
 export * from "./lib/fs/file.ts";
 export * from "./lib/fs/json.ts";
 export * from "./lib/lazuli.ts";
 export * from "./lib/schemas/mod.ts";
+export * from "./lib/utils/addAnimation.ts";
+export * from "./lib/utils/deepMerge.ts";
+export * from "./lib/utils/proxy.ts";