@framefields/node-mesh-warp 0.0.0-stage → 2.0.2

package/.turbo/turbo-build.log

@@ -0,0 +1,20 @@
+
+> @framefields/node-mesh-warp@2.0.2 build /Users/okanaslankan/frameshop/nodes/node-mesh-warp
+> tsdown
+
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ config file: /Users/okanaslankan/frameshop/nodes/node-mesh-warp/tsdown.config.ts 
+ℹ entry: src/index.ts, src/renderers/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/index.mjs                    1.69 kB │ gzip: 0.75 kB
+ℹ dist/renderer.mjs                 0.11 kB │ gzip: 0.09 kB
+ℹ dist/renderers-DzkHlv-9.mjs.map  15.37 kB │ gzip: 4.65 kB
+ℹ dist/renderers-DzkHlv-9.mjs       8.76 kB │ gzip: 2.90 kB
+ℹ dist/index.mjs.map                3.03 kB │ gzip: 1.11 kB
+ℹ dist/index.d.mts.map              0.55 kB │ gzip: 0.31 kB
+ℹ dist/renderer.d.mts.map           0.12 kB │ gzip: 0.11 kB
+ℹ dist/index.d.mts                  2.16 kB │ gzip: 0.68 kB
+ℹ dist/renderer.d.mts               0.29 kB │ gzip: 0.20 kB
+ℹ 9 files, total: 32.08 kB
+✔ Build complete in 2899ms

package/CHANGELOG.md

@@ -0,0 +1,23 @@
+# @framefields/node-mesh-warp
+
+## 2.0.2
+
+## 2.0.1
+
+## 2.0.0
+
+## 1.4.3
+
+## 1.4.2
+
+## 1.4.1
+
+## 1.4.0
+
+## 1.3.2
+
+## 1.3.1
+
+### Patch Changes
+
+- init

package/LICENCE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Gatewai Studio
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.mts

@@ -0,0 +1,56 @@
+import "./renderer.mjs";
+import * as _framefields_core0 from "@framefields/core";
+import { z } from "zod";
+
+//#region src/shared/config.d.ts
+declare const MeshWarpNodeConfigSchema: z.ZodObject<{
+  cols: z.ZodDefault<z.ZodNumber>;
+  rows: z.ZodDefault<z.ZodNumber>;
+  points: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+  }, z.core.$strip>>>;
+}, z.core.$strict>;
+type MeshWarpNodeConfig = z.infer<typeof MeshWarpNodeConfigSchema>;
+declare const MeshWarpOperationSchema: z.ZodObject<{
+  cols: z.ZodDefault<z.ZodNumber>;
+  rows: z.ZodDefault<z.ZodNumber>;
+  points: z.ZodOptional<z.ZodArray<z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+  }, z.core.$strip>>>;
+  op: z.ZodLiteral<"MeshWarp">;
+  metadata: z.ZodOptional<z.ZodAny>;
+}, z.core.$strict>;
+type MeshWarpOperation = z.infer<typeof MeshWarpOperationSchema>;
+declare const MeshWarpResultSchema: z.ZodObject<{
+  selectedOutputIndex: z.ZodLiteral<0>;
+  outputs: z.ZodTuple<[z.ZodObject<{
+    items: z.ZodTuple<[z.ZodType<_framefields_core0.OutputItem<"Image" | "Video" | "SVG" | "GIF">, unknown, z.core.$ZodTypeInternals<_framefields_core0.OutputItem<"Image" | "Video" | "SVG" | "GIF">, unknown>>], null>;
+  }, z.core.$strip>], null>;
+}, z.core.$strip>;
+type MeshWarpResult = z.infer<typeof MeshWarpResultSchema>;
+declare const WARP_OUTPUT_TYPE_MAP: Record<string, "Image" | "Video" | "GIF" | "SVG">;
+//#endregion
+//#region src/shared/utils.d.ts
+declare function createUniformGrid(cols: number, rows: number): {
+  x: number;
+  y: number;
+}[];
+declare function interpolateGridPoint(u: number, v: number, oldPoints: {
+  x: number;
+  y: number;
+}[], oldCols: number, oldRows: number): {
+  x: number;
+  y: number;
+};
+declare function resizeGrid(oldPoints: {
+  x: number;
+  y: number;
+}[] | undefined | null, oldCols: number, oldRows: number, newCols: number, newRows: number): {
+  x: number;
+  y: number;
+}[];
+//#endregion
+export { MeshWarpNodeConfig, MeshWarpNodeConfigSchema, MeshWarpOperation, MeshWarpOperationSchema, MeshWarpResult, MeshWarpResultSchema, WARP_OUTPUT_TYPE_MAP, createUniformGrid, interpolateGridPoint, resizeGrid };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/shared/config.ts","../src/shared/utils.ts"],"sourcesContent":[],"mappings":";;;;;cAOa,0BAAwB,CAAA,CAAA;;;;IAAxB,CAAA,aAAA;;;;KA4BD,kBAAA,GAAqB,CAAA,CAAE,aAAa;cAEnC,yBAAuB,CAAA,CAAA;;;;;;;EA9BC,EAAA,cAAA,CAAA,UAAA,CAAA;EAAA,QAAA,eAAA,SAAA,CAAA;AA4BrC,CAAA,gBAAY,CAAA;AAEC,KAKD,iBAAA,GAAoB,CAAA,CAAE,KAFhC,CAAA,OAE6C,uBAF7C,CAAA;cAIW,sBAAoB,CAAA,CAAA;;;;;;KASrB,cAAA,GAAiB,CAAA,CAAE,aAAa;cAE/B,sBAAsB;;;iBCvDnB,iBAAA;;;;iBAYA,oBAAA;EDLH,CAAA,EAAA,MAAA;;;;;;iBC+CG,UAAA;;;;;;CD/CqB,EAAA"}

package/dist/index.mjs

@@ -0,0 +1,43 @@
+import { i as resizeGrid, n as createUniformGrid, r as interpolateGridPoint } from "./renderers-DzkHlv-9.mjs";
+import { SingleOutputGenericSchema, VirtualMediaDataSchema, createOutputItemSchema } from "@framefields/core";
+import { z } from "zod";
+
+//#region src/shared/config.ts
+const MeshWarpNodeConfigSchema = z.object({
+	cols: z.number().int().min(2).max(12).default(3),
+	rows: z.number().int().min(2).max(12).default(3),
+	points: z.array(z.object({
+		x: z.number().min(0).max(100),
+		y: z.number().min(0).max(100)
+	})).max(144).optional()
+}).strict().superRefine((data, ctx) => {
+	if (data.points && data.points.length > 0) {
+		const expected = data.cols * data.rows;
+		if (data.points.length !== expected) ctx.addIssue({
+			code: z.ZodIssueCode.custom,
+			path: ["points"],
+			message: `points array must have exactly ${expected} coordinates (cols * rows), got ${data.points.length}`
+		});
+	}
+});
+const MeshWarpOperationSchema = MeshWarpNodeConfigSchema.extend({
+	op: z.literal("MeshWarp"),
+	metadata: z.any().optional()
+});
+const MeshWarpResultSchema = SingleOutputGenericSchema(z.union([
+	createOutputItemSchema(z.literal("Video"), VirtualMediaDataSchema),
+	createOutputItemSchema(z.literal("Image"), VirtualMediaDataSchema),
+	createOutputItemSchema(z.literal("SVG"), VirtualMediaDataSchema),
+	createOutputItemSchema(z.literal("GIF"), VirtualMediaDataSchema)
+]));
+const WARP_OUTPUT_TYPE_MAP = {
+	Video: "Video",
+	Lottie: "Video",
+	GIF: "GIF",
+	Image: "Image",
+	SVG: "Image"
+};
+
+//#endregion
+export { MeshWarpNodeConfigSchema, MeshWarpOperationSchema, MeshWarpResultSchema, WARP_OUTPUT_TYPE_MAP, createUniformGrid, interpolateGridPoint, resizeGrid };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/shared/config.ts"],"sourcesContent":["import {\n\tcreateOutputItemSchema,\n\tSingleOutputGenericSchema,\n\tVirtualMediaDataSchema,\n} from \"@framefields/core\";\nimport { z } from \"zod\";\n\nexport const MeshWarpNodeConfigSchema = z\n\t.object({\n\t\tcols: z.number().int().min(2).max(12).default(3),\n\t\trows: z.number().int().min(2).max(12).default(3),\n\t\tpoints: z\n\t\t\t.array(\n\t\t\t\tz.object({\n\t\t\t\t\tx: z.number().min(0).max(100),\n\t\t\t\t\ty: z.number().min(0).max(100),\n\t\t\t\t}),\n\t\t\t)\n\t\t\t.max(144)\n\t\t\t.optional(),\n\t})\n\t.strict()\n\t.superRefine((data, ctx) => {\n\t\tif (data.points && data.points.length > 0) {\n\t\t\tconst expected = data.cols * data.rows;\n\t\t\tif (data.points.length !== expected) {\n\t\t\t\tctx.addIssue({\n\t\t\t\t\tcode: z.ZodIssueCode.custom,\n\t\t\t\t\tpath: [\"points\"],\n\t\t\t\t\tmessage: `points array must have exactly ${expected} coordinates (cols * rows), got ${data.points.length}`,\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\t});\n\nexport type MeshWarpNodeConfig = z.infer<typeof MeshWarpNodeConfigSchema>;\n\nexport const MeshWarpOperationSchema = MeshWarpNodeConfigSchema.extend({\n\top: z.literal(\"MeshWarp\"),\n\tmetadata: z.any().optional(),\n});\n\nexport type MeshWarpOperation = z.infer<typeof MeshWarpOperationSchema>;\n\nexport const MeshWarpResultSchema = SingleOutputGenericSchema(\n\tz.union([\n\t\tcreateOutputItemSchema(z.literal(\"Video\"), VirtualMediaDataSchema),\n\t\tcreateOutputItemSchema(z.literal(\"Image\"), VirtualMediaDataSchema),\n\t\tcreateOutputItemSchema(z.literal(\"SVG\"), VirtualMediaDataSchema),\n\t\tcreateOutputItemSchema(z.literal(\"GIF\"), VirtualMediaDataSchema),\n\t]),\n);\n\nexport type MeshWarpResult = z.infer<typeof MeshWarpResultSchema>;\n\nexport const WARP_OUTPUT_TYPE_MAP: Record<\n\tstring,\n\t\"Image\" | \"Video\" | \"GIF\" | \"SVG\"\n> = {\n\tVideo: \"Video\",\n\tLottie: \"Video\",\n\tGIF: \"GIF\",\n\tImage: \"Image\",\n\tSVG: \"Image\",\n};\n"],"mappings":";;;;;AAOA,MAAa,2BAA2B,EACtC,OAAO;CACP,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE;CAChD,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE;CAChD,QAAQ,EACN,MACA,EAAE,OAAO;EACR,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI;EAC7B,GAAG,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,IAAI;EAC7B,CAAC,CACF,CACA,IAAI,IAAI,CACR,UAAU;CACZ,CAAC,CACD,QAAQ,CACR,aAAa,MAAM,QAAQ;AAC3B,KAAI,KAAK,UAAU,KAAK,OAAO,SAAS,GAAG;EAC1C,MAAM,WAAW,KAAK,OAAO,KAAK;AAClC,MAAI,KAAK,OAAO,WAAW,SAC1B,KAAI,SAAS;GACZ,MAAM,EAAE,aAAa;GACrB,MAAM,CAAC,SAAS;GAChB,SAAS,kCAAkC,SAAS,kCAAkC,KAAK,OAAO;GAClG,CAAC;;EAGH;AAIH,MAAa,0BAA0B,yBAAyB,OAAO;CACtE,IAAI,EAAE,QAAQ,WAAW;CACzB,UAAU,EAAE,KAAK,CAAC,UAAU;CAC5B,CAAC;AAIF,MAAa,uBAAuB,0BACnC,EAAE,MAAM;CACP,uBAAuB,EAAE,QAAQ,QAAQ,EAAE,uBAAuB;CAClE,uBAAuB,EAAE,QAAQ,QAAQ,EAAE,uBAAuB;CAClE,uBAAuB,EAAE,QAAQ,MAAM,EAAE,uBAAuB;CAChE,uBAAuB,EAAE,QAAQ,MAAM,EAAE,uBAAuB;CAChE,CAAC,CACF;AAID,MAAa,uBAGT;CACH,OAAO;CACP,QAAQ;CACR,KAAK;CACL,OAAO;CACP,KAAK;CACL"}

package/dist/renderer.d.mts

@@ -0,0 +1,7 @@
+import * as _framefields_node_sdk_renderer0 from "@framefields/node-sdk/renderer";
+
+//#region src/renderers/index.d.ts
+declare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;
+//#endregion
+export { _default as default };
+//# sourceMappingURL=renderer.d.mts.map

package/dist/renderer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.mts","names":[],"sources":["../src/renderers/index.ts"],"sourcesContent":[],"mappings":""}

package/dist/renderer.mjs

@@ -0,0 +1,3 @@
+import { t as renderers_default } from "./renderers-DzkHlv-9.mjs";
+
+export { renderers_default as default };

package/dist/renderers-DzkHlv-9.mjs

@@ -0,0 +1,292 @@
+import { defineRenderer } from "@framefields/node-sdk/renderer";
+
+//#region src/shared/utils.ts
+function createUniformGrid(cols, rows) {
+	const points = [];
+	for (let r = 0; r < rows; r++) {
+		const y = r / (rows - 1) * 100;
+		for (let c = 0; c < cols; c++) {
+			const x = c / (cols - 1) * 100;
+			points.push({
+				x,
+				y
+			});
+		}
+	}
+	return points;
+}
+function interpolateGridPoint(u, v, oldPoints, oldCols, oldRows) {
+	const px = u * (oldCols - 1);
+	const py = v * (oldRows - 1);
+	const x0 = Math.floor(px);
+	const x1 = Math.min(oldCols - 1, x0 + 1);
+	const y0 = Math.floor(py);
+	const y1 = Math.min(oldRows - 1, y0 + 1);
+	const tx = px - x0;
+	const ty = py - y0;
+	const p00 = oldPoints[y0 * oldCols + x0];
+	const p10 = oldPoints[y0 * oldCols + x1];
+	const p01 = oldPoints[y1 * oldCols + x0];
+	const p11 = oldPoints[y1 * oldCols + x1];
+	if (!p00 || !p10 || !p01 || !p11) return {
+		x: u * 100,
+		y: v * 100
+	};
+	return {
+		x: (1 - tx) * (1 - ty) * p00.x + tx * (1 - ty) * p10.x + (1 - tx) * ty * p01.x + tx * ty * p11.x,
+		y: (1 - tx) * (1 - ty) * p00.y + tx * (1 - ty) * p10.y + (1 - tx) * ty * p01.y + tx * ty * p11.y
+	};
+}
+function resizeGrid(oldPoints, oldCols, oldRows, newCols, newRows) {
+	if (!oldPoints || oldPoints.length !== oldCols * oldRows) return createUniformGrid(newCols, newRows);
+	const points = [];
+	for (let r = 0; r < newRows; r++) {
+		const v = r / (newRows - 1);
+		for (let c = 0; c < newCols; c++) {
+			const u = c / (newCols - 1);
+			points.push(interpolateGridPoint(u, v, oldPoints, oldCols, oldRows));
+		}
+	}
+	return points;
+}
+
+//#endregion
+//#region src/renderers/webgpu-renderer.ts
+const meshWarpWgsl = `
+struct MeshUniforms {
+	gridSize    : vec2<f32>,
+	layerSize   : vec2<f32>,
+	matrix_col0 : vec4<f32>,
+	matrix_col1 : vec4<f32>,
+	points      : array<vec4<f32>, 144>,
+};
+
+@group(0) @binding(0) var<uniform> u : MeshUniforms;
+@group(1) @binding(0) var tex        : texture_2d<f32>;
+@group(1) @binding(1) var samp       : sampler;
+
+struct VSOut {
+	@builtin(position) pos : vec4<f32>,
+	@location(0) uv        : vec2<f32>,
+};
+
+@vertex fn vs(@builtin(vertex_index) vi: u32) -> VSOut {
+	let cols = u32(u.gridSize.x);
+	let rows = u32(u.gridSize.y);
+	
+	let cellsCol = cols - 1u;
+	let cellsRow = rows - 1u;
+	let totalCells = cellsCol * cellsRow;
+	
+	let cellIndex = vi / 6u;
+	let vertexInCell = vi % 6u;
+	
+	if (cellIndex >= totalCells) {
+		return VSOut(vec4<f32>(0.0), vec4<f32>(0.0).xy);
+	}
+	
+	let cellC = cellIndex % cellsCol;
+	let cellR = cellIndex / cellsCol;
+	
+	var colOffset = 0u;
+	var rowOffset = 0u;
+	
+	// Mapping vertex index in cell to quad corner offset
+	// Triangle 1: TL (0,0), TR (1,0), BL (0,1)
+	// Triangle 2: TR (1,0), BR (1,1), BL (0,1)
+	if (vertexInCell == 1u) { // TR
+		colOffset = 1u;
+		rowOffset = 0u;
+	} else if (vertexInCell == 2u) { // BL
+		colOffset = 0u;
+		rowOffset = 1u;
+	} else if (vertexInCell == 3u) { // TR
+		colOffset = 1u;
+		rowOffset = 0u;
+	} else if (vertexInCell == 4u) { // BR
+		colOffset = 1u;
+		rowOffset = 1u;
+	} else if (vertexInCell == 5u) { // BL
+		colOffset = 0u;
+		rowOffset = 1u;
+	}
+	// Vertex 0 is TL (colOffset=0, rowOffset=0)
+	
+	let gridC = cellC + colOffset;
+	let gridR = cellR + rowOffset;
+	
+	let pointIndex = gridR * cols + gridC;
+	let warpedPoint = u.points[pointIndex].xy;
+	
+	let lx = (warpedPoint.x / 100.0) * u.layerSize.x;
+	let ly = (warpedPoint.y / 100.0) * u.layerSize.y;
+	
+	let tx = u.matrix_col0.x * lx + u.matrix_col0.y * ly + u.matrix_col0.z;
+	let ty = u.matrix_col1.x * lx + u.matrix_col1.y * ly + u.matrix_col1.z;
+	
+	let targetW = u.matrix_col0.w;
+	let targetH = u.matrix_col1.w;
+	
+	let x_clip = (tx / targetW) * 2.0 - 1.0;
+	let y_clip = 1.0 - (ty / targetH) * 2.0;
+	
+	let u_coord = f32(gridC) / f32(cellsCol);
+	let v_coord = f32(gridR) / f32(cellsRow);
+	
+	return VSOut(vec4<f32>(x_clip, y_clip, 0.0, 1.0), vec2<f32>(u_coord, v_coord));
+}
+
+@fragment fn fs(in : VSOut) -> @location(0) vec4<f32> {
+	let color = textureSampleLevel(tex, samp, in.uv, 0.0);
+	return color;
+}
+`;
+const deviceResourceCache = /* @__PURE__ */ new WeakMap();
+function getMeshWarpResources(device, format) {
+	let res = deviceResourceCache.get(device);
+	if (!res) {
+		const warpUniformLayout = device.createBindGroupLayout({ entries: [{
+			binding: 0,
+			visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,
+			buffer: { type: "uniform" }
+		}] });
+		const warpTextureLayout = device.createBindGroupLayout({ entries: [{
+			binding: 0,
+			visibility: GPUShaderStage.FRAGMENT,
+			texture: { sampleType: "float" }
+		}, {
+			binding: 1,
+			visibility: GPUShaderStage.FRAGMENT,
+			sampler: { type: "filtering" }
+		}] });
+		const module = device.createShaderModule({
+			label: "mesh_warp.wgsl",
+			code: meshWarpWgsl
+		});
+		res = {
+			warpPipeline: device.createRenderPipeline({
+				label: "MeshWarpPipeline",
+				layout: device.createPipelineLayout({ bindGroupLayouts: [warpUniformLayout, warpTextureLayout] }),
+				vertex: {
+					module,
+					entryPoint: "vs"
+				},
+				fragment: {
+					module,
+					entryPoint: "fs",
+					targets: [{
+						format,
+						blend: {
+							color: {
+								srcFactor: "src-alpha",
+								dstFactor: "one-minus-src-alpha",
+								operation: "add"
+							},
+							alpha: {
+								srcFactor: "one",
+								dstFactor: "one-minus-src-alpha",
+								operation: "add"
+							}
+						}
+					}]
+				},
+				primitive: { topology: "triangle-list" }
+			}),
+			warpUniformLayout,
+			warpTextureLayout
+		};
+		deviceResourceCache.set(device, res);
+	}
+	return res;
+}
+const MeshWarpWebGPURenderer = async (args) => {
+	const { ctx, props, drawChild, targetTexture, targetView, targetWidth, targetHeight, encoder } = args;
+	const { virtualMedia } = props;
+	const op = virtualMedia?.operation;
+	if (!op || op.op !== "MeshWarp") return;
+	const childMedia = virtualMedia.children?.[0];
+	if (!childMedia) return;
+	const sourceWidth = op.originalWidth ?? childMedia.metadata?.width ?? props.containerWidth ?? targetWidth;
+	const sourceHeight = op.originalHeight ?? childMedia.metadata?.height ?? props.containerHeight ?? targetHeight;
+	args.pass.end();
+	const childTex = ctx.renderer.getTemporaryTexture(sourceWidth, sourceHeight, [...props.excludeTextures || [], targetTexture]);
+	const childView = childTex.createView();
+	ctx.renderer.beginFrame(encoder, childView, {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 0
+	}, sourceWidth, sourceHeight, "clear").end();
+	ctx.renderer.pushScissor({
+		x: 0,
+		y: 0,
+		width: sourceWidth,
+		height: sourceHeight
+	});
+	ctx.renderer.pushIdentity();
+	await drawChild(childMedia, {
+		...props,
+		containerWidth: sourceWidth,
+		containerHeight: sourceHeight
+	}, childView, childTex, sourceWidth, sourceHeight);
+	ctx.renderer.popTransform();
+	ctx.renderer.popScissor();
+	const cols = Number(op.cols) || 3;
+	const rows = Number(op.rows) || 3;
+	const points = op.points || [];
+	const finalPoints = points.length === cols * rows ? points : createUniformGrid(cols, rows);
+	const maxPoints = 144;
+	const uniformData = new Float32Array(12 + maxPoints * 4);
+	uniformData[0] = cols;
+	uniformData[1] = rows;
+	uniformData[2] = props.containerWidth ?? sourceWidth;
+	uniformData[3] = props.containerHeight ?? sourceHeight;
+	const matrix = ctx.renderer.getCurrentTransform();
+	uniformData[4] = matrix.a;
+	uniformData[5] = matrix.c;
+	uniformData[6] = matrix.e;
+	uniformData[7] = targetWidth;
+	uniformData[8] = matrix.b;
+	uniformData[9] = matrix.d;
+	uniformData[10] = matrix.f;
+	uniformData[11] = targetHeight;
+	for (let i = 0; i < maxPoints; i++) {
+		const pt = finalPoints[i] || {
+			x: 0,
+			y: 0
+		};
+		uniformData[12 + i * 4] = pt.x;
+		uniformData[12 + i * 4 + 1] = pt.y;
+	}
+	const { warpPipeline: pipeline, warpUniformLayout: uLayout, warpTextureLayout: tLayout } = getMeshWarpResources(ctx.device, ctx.renderer.format);
+	const sampler = ctx.renderer.samplerCache.getSampler(ctx.device);
+	const uniformBuffer = ctx.renderer.getTemporaryBuffer(uniformData);
+	const uniformBindGroup = ctx.device.createBindGroup({
+		layout: uLayout,
+		entries: [{
+			binding: 0,
+			resource: { buffer: uniformBuffer }
+		}]
+	});
+	const textureBindGroup = ctx.renderer.bindGroupCache.getBindGroup(ctx.device, tLayout, childTex, sampler);
+	const outPass = ctx.renderer.beginFrame(encoder, targetView, {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 0
+	}, targetWidth, targetHeight, "load");
+	outPass.setPipeline(pipeline);
+	outPass.setBindGroup(0, uniformBindGroup);
+	outPass.setBindGroup(1, textureBindGroup);
+	const vertexCount = (cols - 1) * (rows - 1) * 6;
+	outPass.draw(vertexCount);
+	args.pass = outPass;
+};
+
+//#endregion
+//#region src/renderers/index.ts
+var renderers_default = defineRenderer({ WebGPURenderer: MeshWarpWebGPURenderer });
+
+//#endregion
+export { resizeGrid as i, createUniformGrid as n, interpolateGridPoint as r, renderers_default as t };
+//# sourceMappingURL=renderers-DzkHlv-9.mjs.map

package/dist/renderers-DzkHlv-9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderers-DzkHlv-9.mjs","names":[],"sources":["../src/shared/utils.ts","../src/renderers/webgpu-renderer.ts","../src/renderers/index.ts"],"sourcesContent":["export function createUniformGrid(cols: number, rows: number) {\n\tconst points: { x: number; y: number }[] = [];\n\tfor (let r = 0; r < rows; r++) {\n\t\tconst y = (r / (rows - 1)) * 100;\n\t\tfor (let c = 0; c < cols; c++) {\n\t\t\tconst x = (c / (cols - 1)) * 100;\n\t\t\tpoints.push({ x, y });\n\t\t}\n\t}\n\treturn points;\n}\n\nexport function interpolateGridPoint(\n\tu: number,\n\tv: number,\n\toldPoints: { x: number; y: number }[],\n\toldCols: number,\n\toldRows: number,\n) {\n\tconst px = u * (oldCols - 1);\n\tconst py = v * (oldRows - 1);\n\n\tconst x0 = Math.floor(px);\n\tconst x1 = Math.min(oldCols - 1, x0 + 1);\n\tconst y0 = Math.floor(py);\n\tconst y1 = Math.min(oldRows - 1, y0 + 1);\n\n\tconst tx = px - x0;\n\tconst ty = py - y0;\n\n\tconst p00 = oldPoints[y0 * oldCols + x0];\n\tconst p10 = oldPoints[y0 * oldCols + x1];\n\tconst p01 = oldPoints[y1 * oldCols + x0];\n\tconst p11 = oldPoints[y1 * oldCols + x1];\n\n\tif (!p00 || !p10 || !p01 || !p11) {\n\t\treturn { x: u * 100, y: v * 100 };\n\t}\n\n\tconst x =\n\t\t(1 - tx) * (1 - ty) * p00.x +\n\t\ttx * (1 - ty) * p10.x +\n\t\t(1 - tx) * ty * p01.x +\n\t\ttx * ty * p11.x;\n\n\tconst y =\n\t\t(1 - tx) * (1 - ty) * p00.y +\n\t\ttx * (1 - ty) * p10.y +\n\t\t(1 - tx) * ty * p01.y +\n\t\ttx * ty * p11.y;\n\n\treturn { x, y };\n}\n\nexport function resizeGrid(\n\toldPoints: { x: number; y: number }[] | undefined | null,\n\toldCols: number,\n\toldRows: number,\n\tnewCols: number,\n\tnewRows: number,\n) {\n\tif (!oldPoints || oldPoints.length !== oldCols * oldRows) {\n\t\treturn createUniformGrid(newCols, newRows);\n\t}\n\tconst points: { x: number; y: number }[] = [];\n\tfor (let r = 0; r < newRows; r++) {\n\t\tconst v = r / (newRows - 1);\n\t\tfor (let c = 0; c < newCols; c++) {\n\t\t\tconst u = c / (newCols - 1);\n\t\t\tpoints.push(interpolateGridPoint(u, v, oldPoints, oldCols, oldRows));\n\t\t}\n\t}\n\treturn points;\n}\n","import type { WebGPUNodeRenderer } from \"@framefields/node-sdk\";\nimport { createUniformGrid } from \"../shared/utils.js\";\n\nconst meshWarpWgsl = `\nstruct MeshUniforms {\n\tgridSize    : vec2<f32>,\n\tlayerSize   : vec2<f32>,\n\tmatrix_col0 : vec4<f32>,\n\tmatrix_col1 : vec4<f32>,\n\tpoints      : array<vec4<f32>, 144>,\n};\n\n@group(0) @binding(0) var<uniform> u : MeshUniforms;\n@group(1) @binding(0) var tex        : texture_2d<f32>;\n@group(1) @binding(1) var samp       : sampler;\n\nstruct VSOut {\n\t@builtin(position) pos : vec4<f32>,\n\t@location(0) uv        : vec2<f32>,\n};\n\n@vertex fn vs(@builtin(vertex_index) vi: u32) -> VSOut {\n\tlet cols = u32(u.gridSize.x);\n\tlet rows = u32(u.gridSize.y);\n\t\n\tlet cellsCol = cols - 1u;\n\tlet cellsRow = rows - 1u;\n\tlet totalCells = cellsCol * cellsRow;\n\t\n\tlet cellIndex = vi / 6u;\n\tlet vertexInCell = vi % 6u;\n\t\n\tif (cellIndex >= totalCells) {\n\t\treturn VSOut(vec4<f32>(0.0), vec4<f32>(0.0).xy);\n\t}\n\t\n\tlet cellC = cellIndex % cellsCol;\n\tlet cellR = cellIndex / cellsCol;\n\t\n\tvar colOffset = 0u;\n\tvar rowOffset = 0u;\n\t\n\t// Mapping vertex index in cell to quad corner offset\n\t// Triangle 1: TL (0,0), TR (1,0), BL (0,1)\n\t// Triangle 2: TR (1,0), BR (1,1), BL (0,1)\n\tif (vertexInCell == 1u) { // TR\n\t\tcolOffset = 1u;\n\t\trowOffset = 0u;\n\t} else if (vertexInCell == 2u) { // BL\n\t\tcolOffset = 0u;\n\t\trowOffset = 1u;\n\t} else if (vertexInCell == 3u) { // TR\n\t\tcolOffset = 1u;\n\t\trowOffset = 0u;\n\t} else if (vertexInCell == 4u) { // BR\n\t\tcolOffset = 1u;\n\t\trowOffset = 1u;\n\t} else if (vertexInCell == 5u) { // BL\n\t\tcolOffset = 0u;\n\t\trowOffset = 1u;\n\t}\n\t// Vertex 0 is TL (colOffset=0, rowOffset=0)\n\t\n\tlet gridC = cellC + colOffset;\n\tlet gridR = cellR + rowOffset;\n\t\n\tlet pointIndex = gridR * cols + gridC;\n\tlet warpedPoint = u.points[pointIndex].xy;\n\t\n\tlet lx = (warpedPoint.x / 100.0) * u.layerSize.x;\n\tlet ly = (warpedPoint.y / 100.0) * u.layerSize.y;\n\t\n\tlet tx = u.matrix_col0.x * lx + u.matrix_col0.y * ly + u.matrix_col0.z;\n\tlet ty = u.matrix_col1.x * lx + u.matrix_col1.y * ly + u.matrix_col1.z;\n\t\n\tlet targetW = u.matrix_col0.w;\n\tlet targetH = u.matrix_col1.w;\n\t\n\tlet x_clip = (tx / targetW) * 2.0 - 1.0;\n\tlet y_clip = 1.0 - (ty / targetH) * 2.0;\n\t\n\tlet u_coord = f32(gridC) / f32(cellsCol);\n\tlet v_coord = f32(gridR) / f32(cellsRow);\n\t\n\treturn VSOut(vec4<f32>(x_clip, y_clip, 0.0, 1.0), vec2<f32>(u_coord, v_coord));\n}\n\n@fragment fn fs(in : VSOut) -> @location(0) vec4<f32> {\n\tlet color = textureSampleLevel(tex, samp, in.uv, 0.0);\n\treturn color;\n}\n`;\n\ninterface DeviceMeshWarpResources {\n\twarpPipeline: GPURenderPipeline;\n\twarpUniformLayout: GPUBindGroupLayout;\n\twarpTextureLayout: GPUBindGroupLayout;\n}\n\nconst deviceResourceCache = new WeakMap<GPUDevice, DeviceMeshWarpResources>();\n\nfunction getMeshWarpResources(device: GPUDevice, format: GPUTextureFormat) {\n\tlet res = deviceResourceCache.get(device);\n\tif (!res) {\n\t\tconst warpUniformLayout = device.createBindGroupLayout({\n\t\t\tentries: [\n\t\t\t\t{\n\t\t\t\t\tbinding: 0,\n\t\t\t\t\tvisibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,\n\t\t\t\t\tbuffer: { type: \"uniform\" },\n\t\t\t\t},\n\t\t\t],\n\t\t});\n\n\t\tconst warpTextureLayout = device.createBindGroupLayout({\n\t\t\tentries: [\n\t\t\t\t{\n\t\t\t\t\tbinding: 0,\n\t\t\t\t\tvisibility: GPUShaderStage.FRAGMENT,\n\t\t\t\t\ttexture: { sampleType: \"float\" },\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\tbinding: 1,\n\t\t\t\t\tvisibility: GPUShaderStage.FRAGMENT,\n\t\t\t\t\tsampler: { type: \"filtering\" },\n\t\t\t\t},\n\t\t\t],\n\t\t});\n\n\t\tconst module = device.createShaderModule({\n\t\t\tlabel: \"mesh_warp.wgsl\",\n\t\t\tcode: meshWarpWgsl,\n\t\t});\n\n\t\tconst warpPipeline = device.createRenderPipeline({\n\t\t\tlabel: \"MeshWarpPipeline\",\n\t\t\tlayout: device.createPipelineLayout({\n\t\t\t\tbindGroupLayouts: [warpUniformLayout, warpTextureLayout],\n\t\t\t}),\n\t\t\tvertex: {\n\t\t\t\tmodule,\n\t\t\t\tentryPoint: \"vs\",\n\t\t\t},\n\t\t\tfragment: {\n\t\t\t\tmodule,\n\t\t\t\tentryPoint: \"fs\",\n\t\t\t\ttargets: [\n\t\t\t\t\t{\n\t\t\t\t\t\tformat,\n\t\t\t\t\t\tblend: {\n\t\t\t\t\t\t\tcolor: {\n\t\t\t\t\t\t\t\tsrcFactor: \"src-alpha\",\n\t\t\t\t\t\t\t\tdstFactor: \"one-minus-src-alpha\",\n\t\t\t\t\t\t\t\toperation: \"add\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\talpha: {\n\t\t\t\t\t\t\t\tsrcFactor: \"one\",\n\t\t\t\t\t\t\t\tdstFactor: \"one-minus-src-alpha\",\n\t\t\t\t\t\t\t\toperation: \"add\",\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t],\n\t\t\t},\n\t\t\tprimitive: {\n\t\t\t\ttopology: \"triangle-list\",\n\t\t\t},\n\t\t});\n\n\t\tres = { warpPipeline, warpUniformLayout, warpTextureLayout };\n\t\tdeviceResourceCache.set(device, res);\n\t}\n\treturn res;\n}\n\nexport const MeshWarpWebGPURenderer: WebGPUNodeRenderer = async (args) => {\n\tconst {\n\t\tctx,\n\t\tprops,\n\t\tdrawChild,\n\t\ttargetTexture,\n\t\ttargetView,\n\t\ttargetWidth,\n\t\ttargetHeight,\n\t\tencoder,\n\t} = args;\n\tconst { virtualMedia } = props;\n\tconst op = virtualMedia?.operation as any;\n\tif (!op || op.op !== \"MeshWarp\") return;\n\n\tconst childMedia = virtualMedia.children?.[0];\n\tif (!childMedia) return;\n\n\tconst sourceWidth =\n\t\top.originalWidth ??\n\t\tchildMedia.metadata?.width ??\n\t\tprops.containerWidth ??\n\t\ttargetWidth;\n\tconst sourceHeight =\n\t\top.originalHeight ??\n\t\tchildMedia.metadata?.height ??\n\t\tprops.containerHeight ??\n\t\ttargetHeight;\n\n\t// End incoming pass to avoid conflicts\n\targs.pass.end();\n\n\t// 1. Render child into a temporary offscreen texture at its native size\n\tconst childTex = ctx.renderer.getTemporaryTexture(sourceWidth, sourceHeight, [\n\t\t...(props.excludeTextures || []),\n\t\ttargetTexture,\n\t]);\n\tconst childView = childTex.createView();\n\n\tconst clearPass = ctx.renderer.beginFrame(\n\t\tencoder,\n\t\tchildView,\n\t\t{ r: 0, g: 0, b: 0, a: 0 },\n\t\tsourceWidth,\n\t\tsourceHeight,\n\t\t\"clear\",\n\t);\n\tclearPass.end();\n\n\tctx.renderer.pushScissor({\n\t\tx: 0,\n\t\ty: 0,\n\t\twidth: sourceWidth,\n\t\theight: sourceHeight,\n\t});\n\tctx.renderer.pushIdentity();\n\n\tawait drawChild(\n\t\tchildMedia,\n\t\t{\n\t\t\t...props,\n\t\t\tcontainerWidth: sourceWidth,\n\t\t\tcontainerHeight: sourceHeight,\n\t\t},\n\t\tchildView,\n\t\tchildTex,\n\t\tsourceWidth,\n\t\tsourceHeight,\n\t);\n\n\tctx.renderer.popTransform();\n\tctx.renderer.popScissor();\n\n\t// 2. Setup warp rendering to targetView\n\tconst cols = Number(op.cols) || 3;\n\tconst rows = Number(op.rows) || 3;\n\tconst points = op.points || [];\n\n\tconst finalPoints =\n\t\tpoints.length === cols * rows ? points : createUniformGrid(cols, rows);\n\n\t// Setup uniforms: gridSize (vec2), layerSize (vec2), matrix_col0 (vec4), matrix_col1 (vec4), then 144 points\n\tconst maxPoints = 144;\n\tconst uniformData = new Float32Array(12 + maxPoints * 4);\n\tuniformData[0] = cols;\n\tuniformData[1] = rows;\n\tuniformData[2] = props.containerWidth ?? sourceWidth;\n\tuniformData[3] = props.containerHeight ?? sourceHeight;\n\n\tconst matrix = ctx.renderer.getCurrentTransform();\n\tuniformData[4] = matrix.a;\n\tuniformData[5] = matrix.c;\n\tuniformData[6] = matrix.e;\n\tuniformData[7] = targetWidth;\n\n\tuniformData[8] = matrix.b;\n\tuniformData[9] = matrix.d;\n\tuniformData[10] = matrix.f;\n\tuniformData[11] = targetHeight;\n\n\tfor (let i = 0; i < maxPoints; i++) {\n\t\tconst pt = finalPoints[i] || { x: 0, y: 0 };\n\t\tuniformData[12 + i * 4] = pt.x;\n\t\tuniformData[12 + i * 4 + 1] = pt.y;\n\t}\n\n\tconst {\n\t\twarpPipeline: pipeline,\n\t\twarpUniformLayout: uLayout,\n\t\twarpTextureLayout: tLayout,\n\t} = getMeshWarpResources(ctx.device, ctx.renderer.format);\n\n\tconst sampler = ctx.renderer.samplerCache.getSampler(ctx.device);\n\tconst uniformBuffer = ctx.renderer.getTemporaryBuffer(uniformData);\n\n\tconst uniformBindGroup = ctx.device.createBindGroup({\n\t\tlayout: uLayout!,\n\t\tentries: [{ binding: 0, resource: { buffer: uniformBuffer } }],\n\t});\n\n\tconst textureBindGroup = ctx.renderer.bindGroupCache.getBindGroup(\n\t\tctx.device,\n\t\ttLayout!,\n\t\tchildTex,\n\t\tsampler,\n\t);\n\n\tconst outPass = ctx.renderer.beginFrame(\n\t\tencoder,\n\t\ttargetView,\n\t\t{ r: 0, g: 0, b: 0, a: 0 },\n\t\ttargetWidth,\n\t\ttargetHeight,\n\t\t\"load\",\n\t);\n\n\toutPass.setPipeline(pipeline!);\n\toutPass.setBindGroup(0, uniformBindGroup);\n\toutPass.setBindGroup(1, textureBindGroup);\n\n\tconst cellCount = (cols - 1) * (rows - 1);\n\tconst vertexCount = cellCount * 6;\n\toutPass.draw(vertexCount);\n\n\targs.pass = outPass;\n};\n","import { defineRenderer } from \"@framefields/node-sdk/renderer\";\nimport { MeshWarpWebGPURenderer } from \"./webgpu-renderer.js\";\n\nexport default defineRenderer({\n\tWebGPURenderer: MeshWarpWebGPURenderer,\n});\n"],"mappings":";;;AAAA,SAAgB,kBAAkB,MAAc,MAAc;CAC7D,MAAM,SAAqC,EAAE;AAC7C,MAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;EAC9B,MAAM,IAAK,KAAK,OAAO,KAAM;AAC7B,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,KAAK;GAC9B,MAAM,IAAK,KAAK,OAAO,KAAM;AAC7B,UAAO,KAAK;IAAE;IAAG;IAAG,CAAC;;;AAGvB,QAAO;;AAGR,SAAgB,qBACf,GACA,GACA,WACA,SACA,SACC;CACD,MAAM,KAAK,KAAK,UAAU;CAC1B,MAAM,KAAK,KAAK,UAAU;CAE1B,MAAM,KAAK,KAAK,MAAM,GAAG;CACzB,MAAM,KAAK,KAAK,IAAI,UAAU,GAAG,KAAK,EAAE;CACxC,MAAM,KAAK,KAAK,MAAM,GAAG;CACzB,MAAM,KAAK,KAAK,IAAI,UAAU,GAAG,KAAK,EAAE;CAExC,MAAM,KAAK,KAAK;CAChB,MAAM,KAAK,KAAK;CAEhB,MAAM,MAAM,UAAU,KAAK,UAAU;CACrC,MAAM,MAAM,UAAU,KAAK,UAAU;CACrC,MAAM,MAAM,UAAU,KAAK,UAAU;CACrC,MAAM,MAAM,UAAU,KAAK,UAAU;AAErC,KAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAC5B,QAAO;EAAE,GAAG,IAAI;EAAK,GAAG,IAAI;EAAK;AAelC,QAAO;EAAE,IAXP,IAAI,OAAO,IAAI,MAAM,IAAI,IAC1B,MAAM,IAAI,MAAM,IAAI,KACnB,IAAI,MAAM,KAAK,IAAI,IACpB,KAAK,KAAK,IAAI;EAQH,IALV,IAAI,OAAO,IAAI,MAAM,IAAI,IAC1B,MAAM,IAAI,MAAM,IAAI,KACnB,IAAI,MAAM,KAAK,IAAI,IACpB,KAAK,KAAK,IAAI;EAEA;;AAGhB,SAAgB,WACf,WACA,SACA,SACA,SACA,SACC;AACD,KAAI,CAAC,aAAa,UAAU,WAAW,UAAU,QAChD,QAAO,kBAAkB,SAAS,QAAQ;CAE3C,MAAM,SAAqC,EAAE;AAC7C,MAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;EACjC,MAAM,IAAI,KAAK,UAAU;AACzB,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,KAAK;GACjC,MAAM,IAAI,KAAK,UAAU;AACzB,UAAO,KAAK,qBAAqB,GAAG,GAAG,WAAW,SAAS,QAAQ,CAAC;;;AAGtE,QAAO;;;;;ACrER,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgGrB,MAAM,sCAAsB,IAAI,SAA6C;AAE7E,SAAS,qBAAqB,QAAmB,QAA0B;CAC1E,IAAI,MAAM,oBAAoB,IAAI,OAAO;AACzC,KAAI,CAAC,KAAK;EACT,MAAM,oBAAoB,OAAO,sBAAsB,EACtD,SAAS,CACR;GACC,SAAS;GACT,YAAY,eAAe,SAAS,eAAe;GACnD,QAAQ,EAAE,MAAM,WAAW;GAC3B,CACD,EACD,CAAC;EAEF,MAAM,oBAAoB,OAAO,sBAAsB,EACtD,SAAS,CACR;GACC,SAAS;GACT,YAAY,eAAe;GAC3B,SAAS,EAAE,YAAY,SAAS;GAChC,EACD;GACC,SAAS;GACT,YAAY,eAAe;GAC3B,SAAS,EAAE,MAAM,aAAa;GAC9B,CACD,EACD,CAAC;EAEF,MAAM,SAAS,OAAO,mBAAmB;GACxC,OAAO;GACP,MAAM;GACN,CAAC;AAqCF,QAAM;GAAE,cAnCa,OAAO,qBAAqB;IAChD,OAAO;IACP,QAAQ,OAAO,qBAAqB,EACnC,kBAAkB,CAAC,mBAAmB,kBAAkB,EACxD,CAAC;IACF,QAAQ;KACP;KACA,YAAY;KACZ;IACD,UAAU;KACT;KACA,YAAY;KACZ,SAAS,CACR;MACC;MACA,OAAO;OACN,OAAO;QACN,WAAW;QACX,WAAW;QACX,WAAW;QACX;OACD,OAAO;QACN,WAAW;QACX,WAAW;QACX,WAAW;QACX;OACD;MACD,CACD;KACD;IACD,WAAW,EACV,UAAU,iBACV;IACD,CAAC;GAEoB;GAAmB;GAAmB;AAC5D,sBAAoB,IAAI,QAAQ,IAAI;;AAErC,QAAO;;AAGR,MAAa,yBAA6C,OAAO,SAAS;CACzE,MAAM,EACL,KACA,OACA,WACA,eACA,YACA,aACA,cACA,YACG;CACJ,MAAM,EAAE,iBAAiB;CACzB,MAAM,KAAK,cAAc;AACzB,KAAI,CAAC,MAAM,GAAG,OAAO,WAAY;CAEjC,MAAM,aAAa,aAAa,WAAW;AAC3C,KAAI,CAAC,WAAY;CAEjB,MAAM,cACL,GAAG,iBACH,WAAW,UAAU,SACrB,MAAM,kBACN;CACD,MAAM,eACL,GAAG,kBACH,WAAW,UAAU,UACrB,MAAM,mBACN;AAGD,MAAK,KAAK,KAAK;CAGf,MAAM,WAAW,IAAI,SAAS,oBAAoB,aAAa,cAAc,CAC5E,GAAI,MAAM,mBAAmB,EAAE,EAC/B,cACA,CAAC;CACF,MAAM,YAAY,SAAS,YAAY;AAUvC,CARkB,IAAI,SAAS,WAC9B,SACA,WACA;EAAE,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG,EAC1B,aACA,cACA,QACA,CACS,KAAK;AAEf,KAAI,SAAS,YAAY;EACxB,GAAG;EACH,GAAG;EACH,OAAO;EACP,QAAQ;EACR,CAAC;AACF,KAAI,SAAS,cAAc;AAE3B,OAAM,UACL,YACA;EACC,GAAG;EACH,gBAAgB;EAChB,iBAAiB;EACjB,EACD,WACA,UACA,aACA,aACA;AAED,KAAI,SAAS,cAAc;AAC3B,KAAI,SAAS,YAAY;CAGzB,MAAM,OAAO,OAAO,GAAG,KAAK,IAAI;CAChC,MAAM,OAAO,OAAO,GAAG,KAAK,IAAI;CAChC,MAAM,SAAS,GAAG,UAAU,EAAE;CAE9B,MAAM,cACL,OAAO,WAAW,OAAO,OAAO,SAAS,kBAAkB,MAAM,KAAK;CAGvE,MAAM,YAAY;CAClB,MAAM,cAAc,IAAI,aAAa,KAAK,YAAY,EAAE;AACxD,aAAY,KAAK;AACjB,aAAY,KAAK;AACjB,aAAY,KAAK,MAAM,kBAAkB;AACzC,aAAY,KAAK,MAAM,mBAAmB;CAE1C,MAAM,SAAS,IAAI,SAAS,qBAAqB;AACjD,aAAY,KAAK,OAAO;AACxB,aAAY,KAAK,OAAO;AACxB,aAAY,KAAK,OAAO;AACxB,aAAY,KAAK;AAEjB,aAAY,KAAK,OAAO;AACxB,aAAY,KAAK,OAAO;AACxB,aAAY,MAAM,OAAO;AACzB,aAAY,MAAM;AAElB,MAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;EACnC,MAAM,KAAK,YAAY,MAAM;GAAE,GAAG;GAAG,GAAG;GAAG;AAC3C,cAAY,KAAK,IAAI,KAAK,GAAG;AAC7B,cAAY,KAAK,IAAI,IAAI,KAAK,GAAG;;CAGlC,MAAM,EACL,cAAc,UACd,mBAAmB,SACnB,mBAAmB,YAChB,qBAAqB,IAAI,QAAQ,IAAI,SAAS,OAAO;CAEzD,MAAM,UAAU,IAAI,SAAS,aAAa,WAAW,IAAI,OAAO;CAChE,MAAM,gBAAgB,IAAI,SAAS,mBAAmB,YAAY;CAElE,MAAM,mBAAmB,IAAI,OAAO,gBAAgB;EACnD,QAAQ;EACR,SAAS,CAAC;GAAE,SAAS;GAAG,UAAU,EAAE,QAAQ,eAAe;GAAE,CAAC;EAC9D,CAAC;CAEF,MAAM,mBAAmB,IAAI,SAAS,eAAe,aACpD,IAAI,QACJ,SACA,UACA,QACA;CAED,MAAM,UAAU,IAAI,SAAS,WAC5B,SACA,YACA;EAAE,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG,GAAG;EAAG,EAC1B,aACA,cACA,OACA;AAED,SAAQ,YAAY,SAAU;AAC9B,SAAQ,aAAa,GAAG,iBAAiB;AACzC,SAAQ,aAAa,GAAG,iBAAiB;CAGzC,MAAM,eADa,OAAO,MAAM,OAAO,KACP;AAChC,SAAQ,KAAK,YAAY;AAEzB,MAAK,OAAO;;;;;AC5Tb,wBAAe,eAAe,EAC7B,gBAAgB,wBAChB,CAAC"}

package/package.json

@@ -1,6 +1,46 @@
 {
   "name": "@framefields/node-mesh-warp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2.0.2",
+  "license": "Apache-2.0",
+  "private": false,
+  "framefields": {
+    "type": "MeshWarp",
+    "kind": "effect"
+  },
+  "type": "module",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "development": "./src/index.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./renderer": {
+      "types": "./dist/renderer.d.mts",
+      "development": "./src/renderers/index.ts",
+      "import": "./dist/renderer.mjs",
+      "default": "./dist/renderer.mjs"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.3.6",
+    "@framefields/core": "2.0.2",
+    "@framefields/node-sdk": "2.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.1.0",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.8.3",
+    "@framefields/tsconfig": "2.0.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "clean": "rm -rf dist"
+  }
 }

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from "./shared/index.js";
+export * from "./renderers/index.js";

package/src/renderers/index.ts

@@ -0,0 +1,6 @@
+import { defineRenderer } from "@framefields/node-sdk/renderer";
+import { MeshWarpWebGPURenderer } from "./webgpu-renderer.js";
+
+export default defineRenderer({
+	WebGPURenderer: MeshWarpWebGPURenderer,
+});

package/src/renderers/webgpu-renderer.ts

@@ -0,0 +1,321 @@
+import type { WebGPUNodeRenderer } from "@framefields/node-sdk";
+import { createUniformGrid } from "../shared/utils.js";
+
+const meshWarpWgsl = `
+struct MeshUniforms {
+	gridSize    : vec2<f32>,
+	layerSize   : vec2<f32>,
+	matrix_col0 : vec4<f32>,
+	matrix_col1 : vec4<f32>,
+	points      : array<vec4<f32>, 144>,
+};
+
+@group(0) @binding(0) var<uniform> u : MeshUniforms;
+@group(1) @binding(0) var tex        : texture_2d<f32>;
+@group(1) @binding(1) var samp       : sampler;
+
+struct VSOut {
+	@builtin(position) pos : vec4<f32>,
+	@location(0) uv        : vec2<f32>,
+};
+
+@vertex fn vs(@builtin(vertex_index) vi: u32) -> VSOut {
+	let cols = u32(u.gridSize.x);
+	let rows = u32(u.gridSize.y);
+	
+	let cellsCol = cols - 1u;
+	let cellsRow = rows - 1u;
+	let totalCells = cellsCol * cellsRow;
+	
+	let cellIndex = vi / 6u;
+	let vertexInCell = vi % 6u;
+	
+	if (cellIndex >= totalCells) {
+		return VSOut(vec4<f32>(0.0), vec4<f32>(0.0).xy);
+	}
+	
+	let cellC = cellIndex % cellsCol;
+	let cellR = cellIndex / cellsCol;
+	
+	var colOffset = 0u;
+	var rowOffset = 0u;
+	
+	// Mapping vertex index in cell to quad corner offset
+	// Triangle 1: TL (0,0), TR (1,0), BL (0,1)
+	// Triangle 2: TR (1,0), BR (1,1), BL (0,1)
+	if (vertexInCell == 1u) { // TR
+		colOffset = 1u;
+		rowOffset = 0u;
+	} else if (vertexInCell == 2u) { // BL
+		colOffset = 0u;
+		rowOffset = 1u;
+	} else if (vertexInCell == 3u) { // TR
+		colOffset = 1u;
+		rowOffset = 0u;
+	} else if (vertexInCell == 4u) { // BR
+		colOffset = 1u;
+		rowOffset = 1u;
+	} else if (vertexInCell == 5u) { // BL
+		colOffset = 0u;
+		rowOffset = 1u;
+	}
+	// Vertex 0 is TL (colOffset=0, rowOffset=0)
+	
+	let gridC = cellC + colOffset;
+	let gridR = cellR + rowOffset;
+	
+	let pointIndex = gridR * cols + gridC;
+	let warpedPoint = u.points[pointIndex].xy;
+	
+	let lx = (warpedPoint.x / 100.0) * u.layerSize.x;
+	let ly = (warpedPoint.y / 100.0) * u.layerSize.y;
+	
+	let tx = u.matrix_col0.x * lx + u.matrix_col0.y * ly + u.matrix_col0.z;
+	let ty = u.matrix_col1.x * lx + u.matrix_col1.y * ly + u.matrix_col1.z;
+	
+	let targetW = u.matrix_col0.w;
+	let targetH = u.matrix_col1.w;
+	
+	let x_clip = (tx / targetW) * 2.0 - 1.0;
+	let y_clip = 1.0 - (ty / targetH) * 2.0;
+	
+	let u_coord = f32(gridC) / f32(cellsCol);
+	let v_coord = f32(gridR) / f32(cellsRow);
+	
+	return VSOut(vec4<f32>(x_clip, y_clip, 0.0, 1.0), vec2<f32>(u_coord, v_coord));
+}
+
+@fragment fn fs(in : VSOut) -> @location(0) vec4<f32> {
+	let color = textureSampleLevel(tex, samp, in.uv, 0.0);
+	return color;
+}
+`;
+
+interface DeviceMeshWarpResources {
+	warpPipeline: GPURenderPipeline;
+	warpUniformLayout: GPUBindGroupLayout;
+	warpTextureLayout: GPUBindGroupLayout;
+}
+
+const deviceResourceCache = new WeakMap<GPUDevice, DeviceMeshWarpResources>();
+
+function getMeshWarpResources(device: GPUDevice, format: GPUTextureFormat) {
+	let res = deviceResourceCache.get(device);
+	if (!res) {
+		const warpUniformLayout = device.createBindGroupLayout({
+			entries: [
+				{
+					binding: 0,
+					visibility: GPUShaderStage.VERTEX | GPUShaderStage.FRAGMENT,
+					buffer: { type: "uniform" },
+				},
+			],
+		});
+
+		const warpTextureLayout = device.createBindGroupLayout({
+			entries: [
+				{
+					binding: 0,
+					visibility: GPUShaderStage.FRAGMENT,
+					texture: { sampleType: "float" },
+				},
+				{
+					binding: 1,
+					visibility: GPUShaderStage.FRAGMENT,
+					sampler: { type: "filtering" },
+				},
+			],
+		});
+
+		const module = device.createShaderModule({
+			label: "mesh_warp.wgsl",
+			code: meshWarpWgsl,
+		});
+
+		const warpPipeline = device.createRenderPipeline({
+			label: "MeshWarpPipeline",
+			layout: device.createPipelineLayout({
+				bindGroupLayouts: [warpUniformLayout, warpTextureLayout],
+			}),
+			vertex: {
+				module,
+				entryPoint: "vs",
+			},
+			fragment: {
+				module,
+				entryPoint: "fs",
+				targets: [
+					{
+						format,
+						blend: {
+							color: {
+								srcFactor: "src-alpha",
+								dstFactor: "one-minus-src-alpha",
+								operation: "add",
+							},
+							alpha: {
+								srcFactor: "one",
+								dstFactor: "one-minus-src-alpha",
+								operation: "add",
+							},
+						},
+					},
+				],
+			},
+			primitive: {
+				topology: "triangle-list",
+			},
+		});
+
+		res = { warpPipeline, warpUniformLayout, warpTextureLayout };
+		deviceResourceCache.set(device, res);
+	}
+	return res;
+}
+
+export const MeshWarpWebGPURenderer: WebGPUNodeRenderer = async (args) => {
+	const {
+		ctx,
+		props,
+		drawChild,
+		targetTexture,
+		targetView,
+		targetWidth,
+		targetHeight,
+		encoder,
+	} = args;
+	const { virtualMedia } = props;
+	const op = virtualMedia?.operation as any;
+	if (!op || op.op !== "MeshWarp") return;
+
+	const childMedia = virtualMedia.children?.[0];
+	if (!childMedia) return;
+
+	const sourceWidth =
+		op.originalWidth ??
+		childMedia.metadata?.width ??
+		props.containerWidth ??
+		targetWidth;
+	const sourceHeight =
+		op.originalHeight ??
+		childMedia.metadata?.height ??
+		props.containerHeight ??
+		targetHeight;
+
+	// End incoming pass to avoid conflicts
+	args.pass.end();
+
+	// 1. Render child into a temporary offscreen texture at its native size
+	const childTex = ctx.renderer.getTemporaryTexture(sourceWidth, sourceHeight, [
+		...(props.excludeTextures || []),
+		targetTexture,
+	]);
+	const childView = childTex.createView();
+
+	const clearPass = ctx.renderer.beginFrame(
+		encoder,
+		childView,
+		{ r: 0, g: 0, b: 0, a: 0 },
+		sourceWidth,
+		sourceHeight,
+		"clear",
+	);
+	clearPass.end();
+
+	ctx.renderer.pushScissor({
+		x: 0,
+		y: 0,
+		width: sourceWidth,
+		height: sourceHeight,
+	});
+	ctx.renderer.pushIdentity();
+
+	await drawChild(
+		childMedia,
+		{
+			...props,
+			containerWidth: sourceWidth,
+			containerHeight: sourceHeight,
+		},
+		childView,
+		childTex,
+		sourceWidth,
+		sourceHeight,
+	);
+
+	ctx.renderer.popTransform();
+	ctx.renderer.popScissor();
+
+	// 2. Setup warp rendering to targetView
+	const cols = Number(op.cols) || 3;
+	const rows = Number(op.rows) || 3;
+	const points = op.points || [];
+
+	const finalPoints =
+		points.length === cols * rows ? points : createUniformGrid(cols, rows);
+
+	// Setup uniforms: gridSize (vec2), layerSize (vec2), matrix_col0 (vec4), matrix_col1 (vec4), then 144 points
+	const maxPoints = 144;
+	const uniformData = new Float32Array(12 + maxPoints * 4);
+	uniformData[0] = cols;
+	uniformData[1] = rows;
+	uniformData[2] = props.containerWidth ?? sourceWidth;
+	uniformData[3] = props.containerHeight ?? sourceHeight;
+
+	const matrix = ctx.renderer.getCurrentTransform();
+	uniformData[4] = matrix.a;
+	uniformData[5] = matrix.c;
+	uniformData[6] = matrix.e;
+	uniformData[7] = targetWidth;
+
+	uniformData[8] = matrix.b;
+	uniformData[9] = matrix.d;
+	uniformData[10] = matrix.f;
+	uniformData[11] = targetHeight;
+
+	for (let i = 0; i < maxPoints; i++) {
+		const pt = finalPoints[i] || { x: 0, y: 0 };
+		uniformData[12 + i * 4] = pt.x;
+		uniformData[12 + i * 4 + 1] = pt.y;
+	}
+
+	const {
+		warpPipeline: pipeline,
+		warpUniformLayout: uLayout,
+		warpTextureLayout: tLayout,
+	} = getMeshWarpResources(ctx.device, ctx.renderer.format);
+
+	const sampler = ctx.renderer.samplerCache.getSampler(ctx.device);
+	const uniformBuffer = ctx.renderer.getTemporaryBuffer(uniformData);
+
+	const uniformBindGroup = ctx.device.createBindGroup({
+		layout: uLayout!,
+		entries: [{ binding: 0, resource: { buffer: uniformBuffer } }],
+	});
+
+	const textureBindGroup = ctx.renderer.bindGroupCache.getBindGroup(
+		ctx.device,
+		tLayout!,
+		childTex,
+		sampler,
+	);
+
+	const outPass = ctx.renderer.beginFrame(
+		encoder,
+		targetView,
+		{ r: 0, g: 0, b: 0, a: 0 },
+		targetWidth,
+		targetHeight,
+		"load",
+	);
+
+	outPass.setPipeline(pipeline!);
+	outPass.setBindGroup(0, uniformBindGroup);
+	outPass.setBindGroup(1, textureBindGroup);
+
+	const cellCount = (cols - 1) * (rows - 1);
+	const vertexCount = cellCount * 6;
+	outPass.draw(vertexCount);
+
+	args.pass = outPass;
+};

package/src/shared/config.ts

@@ -0,0 +1,65 @@
+import {
+	createOutputItemSchema,
+	SingleOutputGenericSchema,
+	VirtualMediaDataSchema,
+} from "@framefields/core";
+import { z } from "zod";
+
+export const MeshWarpNodeConfigSchema = z
+	.object({
+		cols: z.number().int().min(2).max(12).default(3),
+		rows: z.number().int().min(2).max(12).default(3),
+		points: z
+			.array(
+				z.object({
+					x: z.number().min(0).max(100),
+					y: z.number().min(0).max(100),
+				}),
+			)
+			.max(144)
+			.optional(),
+	})
+	.strict()
+	.superRefine((data, ctx) => {
+		if (data.points && data.points.length > 0) {
+			const expected = data.cols * data.rows;
+			if (data.points.length !== expected) {
+				ctx.addIssue({
+					code: z.ZodIssueCode.custom,
+					path: ["points"],
+					message: `points array must have exactly ${expected} coordinates (cols * rows), got ${data.points.length}`,
+				});
+			}
+		}
+	});
+
+export type MeshWarpNodeConfig = z.infer<typeof MeshWarpNodeConfigSchema>;
+
+export const MeshWarpOperationSchema = MeshWarpNodeConfigSchema.extend({
+	op: z.literal("MeshWarp"),
+	metadata: z.any().optional(),
+});
+
+export type MeshWarpOperation = z.infer<typeof MeshWarpOperationSchema>;
+
+export const MeshWarpResultSchema = SingleOutputGenericSchema(
+	z.union([
+		createOutputItemSchema(z.literal("Video"), VirtualMediaDataSchema),
+		createOutputItemSchema(z.literal("Image"), VirtualMediaDataSchema),
+		createOutputItemSchema(z.literal("SVG"), VirtualMediaDataSchema),
+		createOutputItemSchema(z.literal("GIF"), VirtualMediaDataSchema),
+	]),
+);
+
+export type MeshWarpResult = z.infer<typeof MeshWarpResultSchema>;
+
+export const WARP_OUTPUT_TYPE_MAP: Record<
+	string,
+	"Image" | "Video" | "GIF" | "SVG"
+> = {
+	Video: "Video",
+	Lottie: "Video",
+	GIF: "GIF",
+	Image: "Image",
+	SVG: "Image",
+};

package/src/shared/index.ts

@@ -0,0 +1,2 @@
+export * from "./config.js";
+export * from "./utils.js";

package/src/shared/utils.ts

@@ -0,0 +1,74 @@
+export function createUniformGrid(cols: number, rows: number) {
+	const points: { x: number; y: number }[] = [];
+	for (let r = 0; r < rows; r++) {
+		const y = (r / (rows - 1)) * 100;
+		for (let c = 0; c < cols; c++) {
+			const x = (c / (cols - 1)) * 100;
+			points.push({ x, y });
+		}
+	}
+	return points;
+}
+
+export function interpolateGridPoint(
+	u: number,
+	v: number,
+	oldPoints: { x: number; y: number }[],
+	oldCols: number,
+	oldRows: number,
+) {
+	const px = u * (oldCols - 1);
+	const py = v * (oldRows - 1);
+
+	const x0 = Math.floor(px);
+	const x1 = Math.min(oldCols - 1, x0 + 1);
+	const y0 = Math.floor(py);
+	const y1 = Math.min(oldRows - 1, y0 + 1);
+
+	const tx = px - x0;
+	const ty = py - y0;
+
+	const p00 = oldPoints[y0 * oldCols + x0];
+	const p10 = oldPoints[y0 * oldCols + x1];
+	const p01 = oldPoints[y1 * oldCols + x0];
+	const p11 = oldPoints[y1 * oldCols + x1];
+
+	if (!p00 || !p10 || !p01 || !p11) {
+		return { x: u * 100, y: v * 100 };
+	}
+
+	const x =
+		(1 - tx) * (1 - ty) * p00.x +
+		tx * (1 - ty) * p10.x +
+		(1 - tx) * ty * p01.x +
+		tx * ty * p11.x;
+
+	const y =
+		(1 - tx) * (1 - ty) * p00.y +
+		tx * (1 - ty) * p10.y +
+		(1 - tx) * ty * p01.y +
+		tx * ty * p11.y;
+
+	return { x, y };
+}
+
+export function resizeGrid(
+	oldPoints: { x: number; y: number }[] | undefined | null,
+	oldCols: number,
+	oldRows: number,
+	newCols: number,
+	newRows: number,
+) {
+	if (!oldPoints || oldPoints.length !== oldCols * oldRows) {
+		return createUniformGrid(newCols, newRows);
+	}
+	const points: { x: number; y: number }[] = [];
+	for (let r = 0; r < newRows; r++) {
+		const v = r / (newRows - 1);
+		for (let c = 0; c < newCols; c++) {
+			const u = c / (newCols - 1);
+			points.push(interpolateGridPoint(u, v, oldPoints, oldCols, oldRows));
+		}
+	}
+	return points;
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+	"extends": "@framefields/tsconfig/node-library.json",
+	"compilerOptions": {
+		"baseUrl": ".",
+		"paths": {
+			"@/*": ["./src/*"]
+		},
+		"lib": ["DOM"],
+		"experimentalDecorators": true,
+		"emitDecoratorMetadata": true
+	},
+	"include": ["src"]
+}

package/tsdown.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from "tsdown";
+
+export default defineConfig({
+	entry: {
+		index: "src/index.ts",
+		renderer: "src/renderers/index.ts",
+	},
+	format: ["esm"],
+	dts: true,
+	clean: true,
+	sourcemap: true,
+	treeshake: true,
+});

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.