@energy8platform/golem 0.5.0 → 0.6.0

package/README.md

@@ -17,6 +17,10 @@
 поверх параметрической мимики и сохраняются при смене анимации.
 [Результаты объединения и проверок](docs/verification-2026-09-28.md).
 
+В 0.6 по официальным примерам Spine и Rive обновлены скиллы нарезки и анимации, исправлены
+импорт skins, linked meshes, кривые, преобразования и активные clipping-маски.
+[Источники, результаты и ограничения проверки](docs/verification-2026-10-05.md).
+
 ```
 src/rig-format.ts       схема документа (zod) + семантическая валидация; v1: deform-треки, asset.frame (атлас)
 src/rig-anim.ts         чистая математика: easing, семплирование, Pose, аффинные матрицы костей, контуры слотов

package/dist/editor.js

@@ -48869,7 +48869,9 @@ var PathAttachment = external_exports.object({
   /** curve lengths for constant-speed positioning */
   lengths: external_exports.array(external_exports.number()).default([]),
   closed: external_exports.boolean().default(false),
-  constantSpeed: external_exports.boolean().default(true)
+  constantSpeed: external_exports.boolean().default(true),
+  /** Spine-style active clipping span in the posed draw order; end slot is inclusive. */
+  clipping: external_exports.object({ end: Id.optional() }).optional()
 });
 var Attachment = external_exports.discriminatedUnion("type", [RegionAttachment, MeshAttachment, PathAttachment]);
 var IkConstraint = external_exports.object({
@@ -48938,7 +48940,9 @@ var Key = external_exports.object({
   t: external_exports.number().nonnegative(),
   v: KeyValue,
   /** easing INTO the next key */
-  ease: Ease.default("ease_in_out")
+  ease: Ease.default("ease_in_out"),
+  /** Optional independent easing for numeric-array components (for example Spine RGBA curves). */
+  componentEase: external_exports.array(Ease).min(1).optional()
 });
 var Interpolation = { interpolation: external_exports.enum(["segment", "pchip"]).optional() };
 var Track = external_exports.discriminatedUnion("target", [
@@ -49125,6 +49129,10 @@ function validate(doc2) {
       else if (a5.slot !== s6.id) errs.push(`slot "${s6.id}": attachment "${s6.attachment}" belongs to slot "${a5.slot}"`);
     }
   }
+  for (const a5 of doc2.attachments) if (a5.type === "path" && a5.clipping) {
+    if (!a5.closed) errs.push(`attachment "${a5.id}": clipping path must be closed`);
+    if (a5.clipping.end && !slots.has(a5.clipping.end)) errs.push(`attachment "${a5.id}": unknown clipping end slot "${a5.clipping.end}"`);
+  }
   const vertexCount2 = (a5) => {
     if (a5.type === "region") return 4;
     if (a5.type === "mesh") return a5.uvs.length / 2;
@@ -49208,6 +49216,7 @@ function validate(doc2) {
       const att = t5.target === "deform" ? attachments.get(t5.id) : void 0;
       let prev = -1;
       for (const k4 of t5.keys) {
+        if (k4.componentEase && (!Array.isArray(k4.v) || !k4.v.every((v6) => typeof v6 === "number") || k4.componentEase.length !== k4.v.length)) errs.push(`animation "${a5.id}" ${tid}: componentEase must match the numeric-array value length`);
         if (k4.t <= prev && prev >= 0) errs.push(`animation "${a5.id}" ${tid}: keys not strictly increasing`);
         if (k4.t > a5.duration) errs.push(`animation "${a5.id}" ${tid}: key at ${k4.t}s exceeds duration`);
         if (t5.target === "control") {
@@ -49372,8 +49381,8 @@ function sample(track, t5, loop2 = false) {
   }
   if (Array.isArray(a5.v) && Array.isArray(b4.v) && typeof a5.v[0] === "number") {
     if (track.interpolation === "pchip") return a5.v.map((_4, j5) => smoothValue(track, i6, t5, j5, loop2));
-    const u6 = ease(a5.ease)((t5 - a5.t) / (b4.t - a5.t)), av = a5.v, bv = b4.v;
-    return av.map((v6, k4) => v6 + ((bv[k4] ?? v6) - v6) * u6);
+    const phase = (t5 - a5.t) / (b4.t - a5.t), av = a5.v, bv = b4.v;
+    return av.map((v6, k4) => v6 + ((bv[k4] ?? v6) - v6) * ease(a5.componentEase?.[k4] ?? a5.ease)(phase));
   }
   return a5.v;
 }
@@ -49461,6 +49470,13 @@ function boneWorldOf(bone, s6, parent) {
   if (!parent) return local;
   if (bone.inherit === "normal") return mul(parent, local);
   const [tx, ty] = apply(parent, s6.x, s6.y);
+  if (bone.inherit === "noScale" || bone.inherit === "noScaleOrReflection") {
+    const r5 = s6.rotation * DEG2, x4 = parent.a * Math.cos(r5) + parent.c * Math.sin(r5), y5 = parent.b * Math.cos(r5) + parent.d * Math.sin(r5);
+    const length2 = Math.hypot(x4, y5), a5 = length2 > 1e-5 ? x4 / length2 : x4, b4 = length2 > 1e-5 ? y5 / length2 : y5;
+    const sign = bone.inherit === "noScale" && parent.a * parent.d - parent.b * parent.c < 0 ? -1 : 1;
+    const basis2 = { a: a5, b: b4, c: -b4 * sign, d: a5 * sign, tx: 0, ty: 0 };
+    return { ...mul(basis2, affineOf(0, 0, 0, s6.scaleX, s6.scaleY, s6.shearX, s6.shearY)), tx, ty };
+  }
   return { ...mul(inheritedParentLinear(bone, parent), { ...local, tx: 0, ty: 0 }), tx, ty };
 }
 var orderCache = /* @__PURE__ */ new WeakMap();
@@ -49493,11 +49509,11 @@ var localOf = (doc2, pose2, b4) => {
     shearY: num(pose2, pk("bone", id, "shearY"), r5.shearY)
   };
 };
-function updateSubtree(skel, root2) {
+function updateSubtree(skel, root2, includeRoot = true) {
   const doc2 = skel.doc;
   const kids = /* @__PURE__ */ new Map();
   for (const b4 of doc2.bones) if (b4.parent) (kids.get(b4.parent) ?? kids.set(b4.parent, []).get(b4.parent)).push(b4);
-  const stack = [root2];
+  const stack = includeRoot ? [root2] : (kids.get(root2) ?? []).map((b4) => b4.id);
   while (stack.length) {
     const id = stack.pop(), b4 = boneOf(doc2, id), st = skel.bones.get(id);
     st.world = boneWorldOf(b4, st, b4.parent ? skel.bones.get(b4.parent).world : void 0);
@@ -49531,6 +49547,23 @@ function evaluate(doc2, pose2, modifiers) {
   }
   return skel;
 }
+function slotClips(skel) {
+  const keyed = skel.pose.get(pk("drawOrder", "order", "order"));
+  const order = Array.isArray(keyed) ? keyed : [...skel.doc.slots].sort((a5, b4) => a5.z - b4.z).map((s6) => s6.id);
+  const masks = /* @__PURE__ */ new Map();
+  let active;
+  for (const id of order) {
+    const att = skel.attachment.get(id);
+    if (!active && att?.type === "path" && att.clipping) {
+      active = att;
+      continue;
+    }
+    if (active) masks.set(id, active.id);
+    if (active?.clipping?.end === id) active = void 0;
+  }
+  for (const s6 of skel.doc.slots) if (s6.clip) masks.set(s6.id, s6.clip);
+  return masks;
+}
 var cnum = (skel, kind, id, prop, rest) => num(skel.pose, pk(kind, id, prop), typeof rest === "boolean" ? rest ? 1 : 0 : rest);
 var IDENTITY = { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
 var wrapRad = (r5) => r5 > Math.PI ? r5 - 2 * Math.PI : r5 < -Math.PI ? r5 + 2 * Math.PI : r5;
@@ -49740,7 +49773,8 @@ function applyTransformConstraint(skel, c5) {
   if (!mixRotate && !mixX && !mixY && !mixScaleX && !mixScaleY && !mixShearY) return;
   c5 = { ...c5, ...Object.fromEntries(["x", "y", "rotation", "scaleX", "scaleY", "shearY"].map((p6) => [p6, cnum(skel, "transform", c5.id, p6, c5[p6])])) };
   const target = skel.bones.get(c5.target), tw = target.world;
-  const offsetRotation = c5.rotation * DEG2, offsetShearY = c5.shearY * DEG2;
+  const handedness = tw.a * tw.d - tw.b * tw.c < 0 ? -1 : 1;
+  const offsetRotation = c5.rotation * DEG2 * (c5.local ? 1 : handedness), offsetShearY = c5.shearY * DEG2 * (c5.local ? 1 : handedness);
   for (const id of c5.bones) {
     const b4 = boneOf(skel.doc, id), st = skel.bones.get(id);
     if (c5.local) {
@@ -49902,6 +49936,7 @@ function applyPathConstraint(skel, c5) {
   const position = cnum(skel, "path", c5.id, "position", c5.position), spacing = cnum(skel, "path", c5.id, "spacing", c5.spacing);
   const tangents = c5.rotateMode === "tangent", scale = c5.rotateMode === "chainScale";
   const bones = c5.bones.map((id) => ({ b: boneOf(skel.doc, id), st: skel.bones.get(id) }));
+  const inputWorlds = bones.map(({ st }) => ({ ...st.world }));
   const spacesCount = tangents ? bones.length : bones.length + 1;
   const spaces = new Array(spacesCount).fill(0), worldLengths = [];
   let sum = 0;
@@ -49936,9 +49971,10 @@ function applyPathConstraint(skel, c5) {
     if (tw.a * tw.d - tw.b * tw.c < 0) offsetRotation = -offsetRotation;
   }
   let boneX = samples[0].x, boneY = samples[0].y;
+  const solvedWorlds = /* @__PURE__ */ new Map();
   for (let i6 = 0; i6 < bones.length; i6++) {
     const { b: b4, st } = bones[i6];
-    let w5 = { ...st.world };
+    let w5 = { ...inputWorlds[i6] };
     w5.tx += (boneX - w5.tx) * mixX;
     w5.ty += (boneY - w5.ty) * mixY;
     const next = samples[i6 + 1] ?? { x: 0, y: 0, angle: 0 };
@@ -49968,7 +50004,11 @@ function applyPathConstraint(skel, c5) {
       const cos = Math.cos(r5), sin = Math.sin(r5);
       w5 = { a: cos * a5 - sin * bb, b: sin * a5 + cos * bb, c: cos * cc - sin * d6, d: sin * cc + cos * d6, tx: w5.tx, ty: w5.ty };
     }
-    setEffectiveWorld(skel, b4, st, w5);
+    solvedWorlds.set(b4.id, w5);
+  }
+  for (const b4 of boneOrder(skel.doc)) {
+    const world = solvedWorlds.get(b4.id);
+    if (world) setEffectiveWorld(skel, b4, skel.bones.get(b4.id), world);
   }
 }
 function measuredPathLength(points, closed, lengths, constantSpeed) {
@@ -49997,9 +50037,14 @@ function inheritedParentLinear(bone, parent) {
     case "onlyTranslation":
       return { a: 1, b: 0, c: 0, d: 1, tx: 0, ty: 0 };
     case "noRotationOrReflection": {
-      const lenX = Math.hypot(parent.a, parent.b) || 1;
+      const lenX = Math.hypot(parent.a, parent.b);
       const det = parent.a * parent.d - parent.b * parent.c;
-      return { a: lenX, b: 0, c: 0, d: Math.abs(det) / lenX, tx: 0, ty: 0 };
+      if (lenX * lenX <= 1e-4) {
+        const lenY = Math.hypot(parent.c, parent.d), ux3 = lenY ? parent.c / lenY : 0, uy3 = lenY ? parent.d / lenY : 0;
+        return { a: lenY * ux3 * ux3, b: lenY * ux3 * uy3, c: lenY * ux3 * uy3, d: lenY * uy3 * uy3, tx: 0, ty: 0 };
+      }
+      const ux2 = parent.a / lenX, uy2 = parent.b / lenX, sy = Math.abs(det) / lenX;
+      return { a: lenX * ux2 * ux2 + sy * uy2 * uy2, b: (lenX - sy) * ux2 * uy2, c: (lenX - sy) * ux2 * uy2, d: lenX * uy2 * uy2 + sy * ux2 * ux2, tx: 0, ty: 0 };
     }
     case "noScale":
     case "noScaleOrReflection": {
@@ -50025,7 +50070,16 @@ function setEffectiveWorld(skel, bone, st, world) {
   st.scaleY = Math.hypot(lin.c, lin.d);
   st.shearX = 0;
   st.shearY = shortest(Math.atan2(lin.d, lin.c) / DEG2 - st.rotation - 90);
-  updateSubtree(skel, bone.id);
+  if (parent && (bone.inherit === "noScale" || bone.inherit === "noScaleOrReflection")) {
+    const direction = mul(invert({ ...parent, tx: 0, ty: 0 }), { ...world, tx: 0, ty: 0 });
+    st.rotation = Math.atan2(direction.b, direction.a) / DEG2;
+    st.scaleX = Math.hypot(world.a, world.b);
+    st.scaleY = Math.hypot(world.c, world.d);
+    const sign = bone.inherit === "noScale" && parent.a * parent.d - parent.b * parent.c < 0 ? -1 : 1;
+    st.shearY = shortest((Math.atan2(world.d, world.c) - Math.atan2(world.b, world.a)) / DEG2 * sign - 90);
+  }
+  st.world = world;
+  updateSubtree(skel, bone.id, false);
 }
 function attachmentWorldVertices(skel, slotId, att) {
   const deform = skel.pose.get(pk("deform", att.id, "vertices"));
@@ -58172,7 +58226,7 @@ var RigPlayer = class {
     this.clipPoints.clear();
     const skel = this.skel = evaluate(this.doc, pose2, this.beforePose);
     pose2 = skel.pose;
-    const clips = new Set(this.doc.slots.flatMap((s6) => s6.clip ? [s6.clip] : []));
+    const masks = slotClips(skel), clips = new Set(masks.values());
     for (const [id, g4] of this.clipGraphics) if (!clips.has(id)) {
       g4.destroy();
       this.clipGraphics.delete(id);
@@ -58199,7 +58253,8 @@ var RigPlayer = class {
     if (Array.isArray(orderV)) orderV.forEach((id, i6) => order.set(id, i6));
     for (const it of this.items) {
       const s6 = it.slot, shown2 = skel.attachment.get(s6.id);
-      it.node.mask = s6.clip ? this.clipGraphics.get(s6.clip) ?? null : null;
+      const mask = masks.get(s6.id);
+      it.node.mask = mask ? this.clipGraphics.get(mask) ?? null : null;
       if (shown2 !== it.att || this.hidden.has(s6.id)) {
         it.node.visible = false;
         continue;