@pixi-ui-editor/schema 0.20.0 → 0.22.0

package/dist/index.js

@@ -7,7 +7,7 @@ import { collectLocalizationIssues, createDefaultLocalization, LocalizationSchem
 export { collectBindingKeys, collectBindingKeyScopes, OWNER_BINDING_KEY_SCOPE } from "./bindingKeys.js";
 export { rewriteNodeReferences, rewritePrefabInstanceReferencePatches } from "./nodeReferences.js";
 export { clearNodeAssetReferences } from "./assetReferences.js";
-export const CURRENT_SCHEMA_VERSION = 44;
+export const CURRENT_SCHEMA_VERSION = 45;
 const Id = Type.String({ format: "uuid" });
 const Name = Type.String({ minLength: 1 });
 /**
@@ -80,6 +80,8 @@ export const TextCaseSchema = Type.Union([Type.Literal("none"), Type.Literal("up
 // Omitted/`"none"` keeps historical documents byte-for-byte unchanged without a migration.
 const Text = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("text"), text: Type.String(), textKey: Type.Optional(Type.String()), style: Type.Optional(TextStyleDefinitionSchema), textStyleOverrides: Type.Optional(TextStyleOverrides), autoSize: Type.Optional(Type.Boolean()), minFontSize: Type.Optional(Type.Number({ exclusiveMinimum: 0 })), textCase: Type.Optional(TextCaseSchema) })]);
 // Optional preserves existing documents; omitted animationSpeed is interpreted as 1 by every runtime.
+// `animationMix` — длительность кроссфейда между анимациями в секундах (0..1). Отсутствие поля
+// читается как 0, то есть исторический резкий переход, поэтому миграция документам не нужна.
 // `autoplay` is the serialized initial playback decision. Older documents are migrated to true,
 // preserving the runtime behavior they had before this field became explicit.
 const SpineProfileSettings = Type.Object({
@@ -88,6 +90,7 @@ const SpineProfileSettings = Type.Object({
     autoplay: Type.Boolean(),
     loop: Type.Boolean(),
     animationSpeed: Type.Number({ exclusiveMinimum: 0 }),
+    animationMix: Type.Number({ minimum: 0, maximum: 1 }),
 });
 const SpineOverrides = Type.Partial(Type.Object({ desktop: Type.Partial(SpineProfileSettings), mobile: Type.Partial(SpineProfileSettings) }));
 /** A presentation-time mount point: game code decides when the target follows its Spine part. */
@@ -95,19 +98,8 @@ export const SpineConnectorSchema = Type.Object({
     partType: Type.Union([Type.Literal("bone"), Type.Literal("slot")]),
     partName: Type.String({ minLength: 1 }),
     targetNodeId: NodeAddress,
-    // Множитель проецируемой позиции части по осям (1 = следовать за костью ровно, 2 = вдвое дальше
-    // от origin ноды Spine, отрицательное значение — зеркально). Отсутствует — `{ x: 1, y: 1 }`.
-    // Profile-aware тем же sparse-mobile приёмом, что `spineOverrides` (ADR 0022): base редактируется
-    // в Horizontal, `positionMultiplierOverrides.mobile` — в Vertical.
-    positionMultiplier: Type.Optional(Type.Object({ x: Type.Number(), y: Type.Number() })),
-    positionMultiplierOverrides: Type.Optional(Type.Object({ mobile: Type.Optional(Type.Object({ x: Type.Optional(Type.Number()), y: Type.Optional(Type.Number()) })) })),
 });
-export function resolveSpineConnectorPositionMultiplier(connector, profile) {
-    const base = connector.positionMultiplier ?? { x: 1, y: 1 };
-    const override = profile === "desktop" ? undefined : connector.positionMultiplierOverrides?.mobile;
-    return { x: override?.x ?? base.x, y: override?.y ?? base.y };
-}
-const Spine = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("spine"), assetId: Id, opacity: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), animation: Type.Optional(Type.String({ minLength: 1 })), autoplay: Type.Optional(Type.Boolean()), loop: Type.Optional(Type.Boolean()), animationSpeed: Type.Optional(Type.Number({ exclusiveMinimum: 0 })), spineOverrides: Type.Optional(SpineOverrides), connectors: Type.Optional(Type.Array(SpineConnectorSchema)) })]);
+const Spine = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("spine"), assetId: Id, opacity: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), animation: Type.Optional(Type.String({ minLength: 1 })), autoplay: Type.Optional(Type.Boolean()), loop: Type.Optional(Type.Boolean()), animationSpeed: Type.Optional(Type.Number({ exclusiveMinimum: 0 })), animationMix: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), spineOverrides: Type.Optional(SpineOverrides), connectors: Type.Optional(Type.Array(SpineConnectorSchema)) })]);
 const BitmapTextAlign = Type.Union([Type.Literal("left"), Type.Literal("center"), Type.Literal("right")]);
 // A bitmap font's glyphs come pre-rendered from its texture, so unlike `Text` there is no system
 // fallback: `assetId` is required (like Spine's), and the "Bitmap Text" add-node entry stays disabled
@@ -1333,6 +1325,44 @@ function migrateV42ToV43(document) {
 }
 /** v44 adds an optional Spine opacity; existing Spine nodes remain fully opaque. */
 function migrateV43ToV44(_document) { }
+/**
+ * v45 удаляет `positionMultiplier`/`positionMultiplierOverrides` у Spine-коннекторов. Множитель был
+ * обходным путём вокруг того, что цель уезжала в дерево спайна и получала его масштаб; коннектор
+ * теперь просто перезаписывает позицию цели мировой позицией части (см.
+ * `docs/spine-bone-attachment-thing-editor-reference.md`), и умножать стало нечего. Заменить поля
+ * нечем — авторские значения подбирались под старую проекцию, поэтому они просто удаляются.
+ */
+function migrateV44ToV45(document) {
+    const obsolete = ["positionMultiplier", "positionMultiplierOverrides"];
+    const strip = (record) => {
+        if (!Array.isArray(record.connectors))
+            return;
+        for (const connector of record.connectors) {
+            if (typeof connector !== "object" || connector === null)
+                continue;
+            for (const key of obsolete)
+                delete connector[key];
+        }
+    };
+    const visit = (node) => {
+        strip(node);
+        if (Array.isArray(node.propertyOverrides))
+            for (const override of node.propertyOverrides) {
+                const patch = override.patch;
+                if (typeof patch === "object" && patch !== null)
+                    strip(patch);
+            }
+        if (Array.isArray(node.locallyAddedNodes))
+            for (const local of node.locallyAddedNodes)
+                if (typeof local === "object" && local !== null)
+                    visit(local);
+    };
+    const owners = [...(document.scenes ?? []), ...(document.prefabs ?? [])];
+    for (const owner of owners)
+        for (const node of owner.nodes ?? [])
+            if (typeof node === "object" && node !== null)
+                visit(node);
+}
 export function migrateProjectDocument(input) {
     if (typeof input !== "object" || input === null || !Object.hasOwn(input, "schemaVersion"))
         throw new ProjectDocumentMigrationError("A schemaVersion is required for migration.");
@@ -1398,6 +1428,8 @@ export function migrateProjectDocument(input) {
         migrateV42ToV43(migrated);
     if (version <= 43)
         migrateV43ToV44(migrated);
+    if (version <= 44)
+        migrateV44ToV45(migrated);
     // v36 → v37 (position multiplier у spine-коннекторов) не требует переписывания данных:
     // добавлены только опциональные поля коннектора, и любой документ v36 уже валиден как v37.
     // v34 → v35 (`states.normalAssetId` стал опциональным у button/staged-button) не требует