@pixi-ui-editor/schema 0.17.0 → 0.20.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 = 40;
+export const CURRENT_SCHEMA_VERSION = 44;
 const Id = Type.String({ format: "uuid" });
 const Name = Type.String({ minLength: 1 });
 /**
@@ -53,9 +53,11 @@ const GridLayout = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("g
 // assetId отсутствует — нода без источника: рантайм и редактор рисуют белый прямоугольник её размера.
 // `nineSlice` отсутствует — обычный Sprite, растянутый по transform (старое поведение, без миграции).
 // При наличии — рамки в пикселях источника (как @pixi/ui fillPadding), не сериализованные проценты:
-// нода `NineSliceSprite`, углы/края не искажаются при растяжении.
+// нода `NineSliceSprite`, углы/края не искажаются при растяжении. `cornerRadius` — третий режим
+// отображения: тот же растянутый Sprite, но с GPU-маской скруглённого прямоугольника в logical pixels.
+// Inspector делает `nineSlice` и `cornerRadius` взаимоисключающими.
 const ImageTint = Type.String({ pattern: "^#[0-9A-Fa-f]{6}$" });
-const Image = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("image"), assetId: Type.Optional(Id), opacity: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), tint: Type.Optional(ImageTint), nineSlice: Type.Optional(Padding) })]);
+const Image = Type.Composite([NodeBase, Type.Object({ type: Type.Literal("image"), assetId: Type.Optional(Id), opacity: Type.Optional(Type.Number({ minimum: 0, maximum: 1 })), tint: Type.Optional(ImageTint), nineSlice: Type.Optional(Padding), cornerRadius: Type.Optional(Type.Number({ minimum: 0 })) })]);
 const TextStroke = Type.Object({ color: Type.String({ pattern: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" }), width: Type.Number({ minimum: 0 }) });
 // Числовые начертания соответствуют CSS/PIXI `font-weight` напрямую (без адаптера): у каждого
 // значения должен быть загружен свой файл шрифта с тем же `family` (см. FontAsset.weight), иначе
@@ -105,7 +107,7 @@ export function resolveSpineConnectorPositionMultiplier(connector, profile) {
     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, 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 })), 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
@@ -299,12 +301,6 @@ const Pagination = Type.Composite([NodeBase, Type.Object({
         inactiveAssetId: Type.Optional(Id),
         numberStyle: Type.Optional(TextStyleDefinitionSchema),
         numberActiveColor: Type.Optional(Type.String({ pattern: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" })),
-        // Optional "pill" background behind the current page's digit only (a plain Sprite, or a
-        // NineSliceSprite when `numberActiveNineSlice` is set) — sized to `dotSize`, the same field a
-        // `dots`-style item already uses for its own box. Absent means no background, same as before this
-        // field existed: just the `numberActiveColor` text highlight.
-        numberActiveBackgroundAssetId: Type.Optional(Id),
-        numberActiveNineSlice: Type.Optional(Padding),
         pageCount: Type.Integer({ minimum: 1 }),
         defaultPage: Type.Integer({ minimum: 0 }),
         direction: PaginationDirection,
@@ -318,6 +314,12 @@ const Pagination = Type.Composite([NodeBase, Type.Object({
         // `NodeAddress`, а не `Id`: стрелка часто лежит внутри инстанса пресета и адресуется путём.
         prevButtonNodeId: Type.Optional(NodeAddress),
         nextButtonNodeId: Type.Optional(NodeAddress),
+        // An existing authored node wired as the "current page" highlight, the same reference-not-owned
+        // contract as the prev/next arrows. The widget renders nothing itself: while `style: "numbers"` it
+        // only sets this node's `visible` flag on, so the node's own asset / nine-slice / rounded corners /
+        // size / position — authored on the node — are the entire visual. Absent means no highlight beyond
+        // `numberActiveColor`. Ignored while `style: "dots"` (the node is kept hidden).
+        activeBackgroundNodeId: Type.Optional(NodeAddress),
         // How many indicator slots are rendered at once. Must be odd, because the active page always sits
         // in the middle slot: 4 pages with page 3 active render 2-3-4. A slot whose page falls outside
         // 0..pageCount-1 keeps its `dotSize` footprint and renders nothing, so the active page never moves
@@ -484,6 +486,13 @@ function checkNodeReferences(document, owner, path, issues) {
                 else if (target.type !== "button" && target.type !== "staged-button")
                     add(issues, "INVALID_PAGINATION_ARROW", arrowPath, "A pagination arrow must reference a button or staged-button node.");
             }
+            if (node.activeBackgroundNodeId !== undefined) {
+                const backgroundPath = `${path}/paginationActiveBackground/${node.id}`;
+                if (!nodes.has(node.activeBackgroundNodeId))
+                    add(issues, "MISSING_PAGINATION_ACTIVE_BACKGROUND", backgroundPath, `Pagination active background '${node.activeBackgroundNodeId}' does not exist in this owner.`);
+                else if (node.activeBackgroundNodeId === node.id)
+                    add(issues, "INVALID_PAGINATION_ACTIVE_BACKGROUND", backgroundPath, "A pagination cannot use itself as its active background.");
+            }
             continue;
         }
         if (node.type === "page-group") {
@@ -755,14 +764,6 @@ function hierarchy(owner, path, assets, prefabs, effects, issues) {
                     else if (asset.type !== "font")
                         add(issues, "INCOMPATIBLE_ASSET_REFERENCE", fontPath, "A pagination numberStyle fontAssetId requires a font asset.");
                 }
-                if (node.numberActiveBackgroundAssetId !== undefined) {
-                    const asset = assets.get(node.numberActiveBackgroundAssetId);
-                    const bgPath = `${nodePath}/numberActiveBackgroundAssetId`;
-                    if (!asset)
-                        addWarning(issues, "MISSING_ASSET_REFERENCE", bgPath, `Asset '${node.numberActiveBackgroundAssetId}' does not exist.`);
-                    else if (asset.type !== "image")
-                        add(issues, "INCOMPATIBLE_ASSET_REFERENCE", bgPath, "A pagination numberActiveBackgroundAssetId requires an image asset.");
-                }
             }
             if (node.defaultPage > node.pageCount - 1)
                 add(issues, "VALUE_OUT_OF_RANGE", `${nodePath}/defaultPage`, "Pagination defaultPage must be inside the inclusive 0..pageCount-1 range.");
@@ -1296,6 +1297,42 @@ function migrateV32ToV33(document) {
 }
 /** v40 adds sparse bitmap-text presentation overrides; existing values remain the shared base. */
 function migrateV39ToV40(_document) { }
+/** v41 adds an optional image corner radius; older plain and nine-slice images already retain their meaning. */
+function migrateV40ToV41(_document) { }
+/** v42 adds an optional rounded mode to pagination's active number background. */
+function migrateV41ToV42(_document) { }
+/**
+ * v43 replaces pagination's inline active-background asset (`numberActiveBackgroundAssetId` plus its
+ * `numberActiveNineSlice`/`numberActiveCornerRadius` rendering fields) with a single
+ * `activeBackgroundNodeId` reference to an authored node. There is no authored node to point the
+ * reference at, so the obsolete fields are simply dropped from every pagination node and sparse patch.
+ */
+function migrateV42ToV43(document) {
+    const obsolete = ["numberActiveBackgroundAssetId", "numberActiveNineSlice", "numberActiveCornerRadius"];
+    const strip = (record) => { for (const key of obsolete)
+        delete record[key]; };
+    const visit = (node) => {
+        if (node.type === "pagination")
+            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);
+}
+/** v44 adds an optional Spine opacity; existing Spine nodes remain fully opaque. */
+function migrateV43ToV44(_document) { }
 export function migrateProjectDocument(input) {
     if (typeof input !== "object" || input === null || !Object.hasOwn(input, "schemaVersion"))
         throw new ProjectDocumentMigrationError("A schemaVersion is required for migration.");
@@ -1353,6 +1390,14 @@ export function migrateProjectDocument(input) {
         migrateV32ToV33(migrated);
     if (version <= 39)
         migrateV39ToV40(migrated);
+    if (version <= 40)
+        migrateV40ToV41(migrated);
+    if (version <= 41)
+        migrateV41ToV42(migrated);
+    if (version <= 42)
+        migrateV42ToV43(migrated);
+    if (version <= 43)
+        migrateV43ToV44(migrated);
     // v36 → v37 (position multiplier у spine-коннекторов) не требует переписывания данных:
     // добавлены только опциональные поля коннектора, и любой документ v36 уже валиден как v37.
     // v34 → v35 (`states.normalAssetId` стал опциональным у button/staged-button) не требует
@@ -1368,6 +1413,11 @@ export function migrateProjectDocument(input) {
     // v38 → v39 (per-state button tint/opacity) не требует переписывания данных: новые appearance
     // fields optional and therefore resolve to white / 1 for every existing button.
     // v39 → v40 (bitmap-text presentation overrides) likewise adds only optional sparse fields.
+    // v40 → v41 (`image.cornerRadius`) is an optional field; existing plain and nine-slice images
+    // already have their intended rendering mode.
+    // v41 → v42 (`pagination.numberActiveCornerRadius`) is optional; existing active backgrounds
+    // remain plain or nine-slice.
+    // v43 → v44 (`spine.opacity`) is optional; existing Spine nodes remain fully opaque.
     // v37 → v38 (page-group carousel arrows) не требует переписывания данных: добавлены только
     // опциональные поля `pageUpButtonNodeId`/`pageDownButtonNodeId`, любой документ v37 уже валиден как v38.
     migrated.schemaVersion = CURRENT_SCHEMA_VERSION;