@pisapp/core 7.0.0-dev.20260916-153034

package/migration/v7.schema.json

@@ -0,0 +1,595 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://pisapp.dev/core/migration/v7.schema.json",
+  "title": "@pisapp/core migration/v7.json",
+  "description": "Machine-readable v6\u2192v7 migration spec consumed by the @pisapp/migrate codemod and the per-framework skills. Generated from ComponentTemplateMap.ts.",
+  "type": "object",
+  "required": [
+    "version",
+    "reactiveContext",
+    "emit",
+    "webApi",
+    "injectionPoints",
+    "publicApiRefactors",
+    "instanceAttributes"
+  ],
+  "additionalProperties": false,
+  "properties": {
+    "version": {
+      "type": "string",
+      "pattern": "^7\\."
+    },
+    "generatedFrom": {
+      "type": "string"
+    },
+    "_generated": {
+      "description": "Provenance banner (JSON equivalent of an auto-generated file header): the owning script, a short purpose, and a do-not-edit warning.",
+      "type": "object",
+      "required": [
+        "by",
+        "purpose",
+        "warning"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "by": {
+          "type": "string"
+        },
+        "purpose": {
+          "type": "string"
+        },
+        "warning": {
+          "type": "string"
+        }
+      }
+    },
+    "reactiveContext": {
+      "type": "object",
+      "required": [
+        "decision",
+        "note"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "decision": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      }
+    },
+    "emit": {
+      "type": "object",
+      "required": [
+        "routesTo",
+        "unchangedFromV6",
+        "note"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "routesTo": {
+          "type": "string"
+        },
+        "unchangedFromV6": {
+          "type": "boolean"
+        },
+        "note": {
+          "type": "string"
+        }
+      }
+    },
+    "webApi": {
+      "description": "Generated Web API v1-to-v2 migration rules. Generated v2 routes and types are the executable source of truth.",
+      "type": "object",
+      "required": [
+        "sourceOfTruth",
+        "criterionValues",
+        "requestTransforms",
+        "responseTransforms",
+        "typeRenames",
+        "manualReview"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "sourceOfTruth": {
+          "type": "object",
+          "required": ["routes", "types", "migrationGuide"],
+          "additionalProperties": false,
+          "properties": {
+            "routes": { "type": "string" },
+            "types": { "type": "string" },
+            "migrationGuide": { "type": "string" }
+          }
+        },
+        "criterionValues": {
+          "type": "object",
+          "required": ["keys", "rulesMayBeOmittedOrNull"],
+          "additionalProperties": false,
+          "properties": {
+            "keys": {
+              "const": ["h", "v", "u"]
+            },
+            "rulesMayBeOmittedOrNull": { "type": "boolean" }
+          }
+        },
+        "requestTransforms": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/webApiTransform" }
+        },
+        "responseTransforms": {
+          "type": "array",
+          "items": { "$ref": "#/definitions/webApiTransform" }
+        },
+        "typeRenames": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["from", "to"],
+            "additionalProperties": false,
+            "properties": {
+              "from": { "type": "string" },
+              "to": { "type": "string" }
+            }
+          }
+        },
+        "manualReview": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["id", "detect", "message"],
+            "additionalProperties": false,
+            "properties": {
+              "id": { "type": "string" },
+              "detect": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+              "message": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "injectionPoints": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "configKey",
+          "domain",
+          "component",
+          "surface",
+          "oldField",
+          "newField",
+          "contextFields",
+          "helper"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "configKey": {
+            "type": "string"
+          },
+          "domain": {
+            "enum": [
+              "products",
+              "catalogs",
+              "common"
+            ]
+          },
+          "component": {
+            "type": "string"
+          },
+          "surface": {
+            "type": "string"
+          },
+          "oldField": {
+            "type": "string"
+          },
+          "newField": {
+            "type": "string",
+            "pattern": "Template$"
+          },
+          "contextFields": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "minItems": 1
+          },
+          "helper": {
+            "type": "object",
+            "required": [
+              "javascript",
+              "vue",
+              "react",
+              "angular"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "javascript": {
+                "type": "object",
+                "description": "Plain-JS has ONE locked method (D-JsLock): assign a render function to the option (MountPoint wraps it in @pisapp/reactive-dom's reactiveMount).",
+                "required": [
+                  "renderFunction"
+                ],
+                "additionalProperties": false,
+                "properties": {
+                  "renderFunction": {
+                    "type": "string"
+                  }
+                }
+              },
+              "vue": {
+                "type": "string"
+              },
+              "react": {
+                "type": "string"
+              },
+              "angular": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "publicApiRefactors": {
+      "description": "Exact post-v7 public API reconciliation rules generated with the callback migration contract.",
+      "type": "object",
+      "required": [
+        "componentOptions",
+        "customElementTags",
+        "apiRoutes",
+        "typeRenames",
+        "moduleSpecifiers",
+        "manualReview",
+        "topLevelOptions"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "componentOptions": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications"
+                ]
+              },
+              "from": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              },
+              "removed": {
+                "type": "boolean",
+                "description": "True when the v6 option has no v7 owner; the codemod flags it for manual removal instead of rewriting."
+              },
+              "subKeyRoutes": {
+                "type": "object",
+                "description": "Keys inside the legacy group that move to a DIFFERENT v7 group than the rule's default `to` (e.g. products details.actionTemplate → details.actions, omitted from DetailsDataOptions). Maps legacy sub-key → canonical group path.",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "removedSubKeys": {
+                "type": "array",
+                "description": "Keys inside the legacy group that the v7 redesign removed with no owner at the rule's `to` path (e.g. classifications treeTypeTabs.displayModes → the per-tab items[] model). The group still renames; each present sub-key is flagged for manual review.",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          }
+        },
+        "topLevelOptions": {
+          "type": "array",
+          "description": "Renames applied to top-level keys of the .init({...}) options object (siblings of baseUrl/components). domain '*' applies to every domain.",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications",
+                  "*"
+                ]
+              },
+              "from": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              },
+              "removed": {
+                "type": "boolean",
+                "description": "True when the v6 top-level option has no v7 owner (e.g. the light-DOM styling options); the codemod flags it for manual removal instead of rewriting."
+              }
+            }
+          }
+        },
+        "customElementTags": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications"
+                ]
+              },
+              "from": {
+                "type": "string",
+                "pattern": "^pis-"
+              },
+              "to": {
+                "type": "string",
+                "pattern": "^pis-"
+              }
+            }
+          }
+        },
+        "apiRoutes": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs"
+                ]
+              },
+              "from": {
+                "type": "string",
+                "pattern": "^/v1/"
+              },
+              "to": {
+                "type": "string",
+                "pattern": "^/v2/"
+              }
+            }
+          }
+        },
+        "typeRenames": {
+          "type": "array",
+          "description": "Exact word-boundary identifier rewrites — types and route-data fields (e.g. the Salesforce legacy-adapter I-prefixed types, or DisplayMode → SubView). The wire shapes are unchanged.",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications",
+                  "*"
+                ]
+              },
+              "from": {
+                "type": "string",
+                "pattern": "^[A-Za-z]"
+              },
+              "to": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "routeFields": {
+          "type": "array",
+          "description": "Route-data restructurings scoped to route positions (init() route argument literals, setRoute() argument literals, and route-data member reads). Reroutes flat v6/pre-release fields into the per-view scope objects (products search/detail), renames the classifications tree selection, and moves relationshipDisplayMode out of route data into the per-relationship-type option.",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "from",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications",
+                  "*"
+                ]
+              },
+              "from": {
+                "type": "string",
+                "pattern": "^[A-Za-z]"
+              },
+              "to": {
+                "type": "string"
+              },
+              "valueMap": {
+                "type": "object",
+                "description": "Maps quoted legacy route literals to canonical values while renaming the field.",
+                "additionalProperties": {
+                  "type": "string"
+                }
+              },
+              "unmappedValueMessage": {
+                "type": "string",
+                "description": "Manual-review guidance for expressions, member accesses, and literals absent from valueMap."
+              }
+            }
+          }
+        },
+        "moduleSpecifiers": {
+          "type": "array",
+          "description": "v6 module specifier prefixes → v7 entries (e.g. pis-next-gen deep paths → @pisapp/core/<domain>). Longest prefix wins; only quoted specifiers after from/import/require are rewritten.",
+          "items": {
+            "type": "object",
+            "required": [
+              "domain",
+              "fromPrefix",
+              "to"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "domain": {
+                "enum": [
+                  "products",
+                  "catalogs",
+                  "classifications",
+                  "*"
+                ]
+              },
+              "fromPrefix": {
+                "type": "string"
+              },
+              "to": {
+                "type": "string"
+              }
+            }
+          }
+        },
+        "manualReview": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": [
+              "id",
+              "domain",
+              "detect",
+              "action",
+              "message"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "id": {
+                "type": "string"
+              },
+              "domain": {
+                "enum": [
+                  "classifications",
+                  "all"
+                ]
+              },
+              "detect": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                },
+                "minItems": 1
+              },
+              "action": {
+                "const": "manual-review"
+              },
+              "message": {
+                "type": "string"
+              },
+              "advisory": {
+                "type": "boolean",
+                "description": "True when the detect token also occurs in legitimate v7 code, so the rule is reported as an advisory that never fails a --check gate (e.g. dataInterceptor, which is the v7 option name itself)."
+              }
+            }
+          }
+        }
+      }
+    },
+    "instanceAttributes": {
+      "type": "array",
+      "description": "Reserved by Phase 1.5; filled by Phase 3b.3. One entry per removed instance-component attribute \u2192 its IOptions/IRouteData target + transform.",
+      "items": {
+        "type": "object",
+        "required": [
+          "attr",
+          "domain",
+          "target",
+          "transform"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "attr": {
+            "type": "string"
+          },
+          "domain": {
+            "enum": [
+              "products",
+              "catalogs",
+              "classifications",
+              "all"
+            ]
+          },
+          "target": {
+            "type": "string"
+          },
+          "transform": {
+            "type": "string"
+          },
+          "removed": {
+            "type": "boolean",
+            "description": "True when the v6 attribute has no v7 owner (e.g. styling attributes removed by the light-DOM contract); the codemod flags it for manual review instead of writing an option."
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "webApiTransform": {
+      "type": "object",
+      "required": ["id", "strategy", "endpoints", "from", "to"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string" },
+        "strategy": {
+          "enum": [
+            "rename-property",
+            "move-property",
+            "criteria-array-to-group",
+            "list-to-criterion",
+            "sales-unit-to-criteria",
+            "sales-erp-to-criteria",
+            "boolean-to-data-type",
+            "translation-domains",
+            "filter-value-object",
+            "load-sparse-group",
+            "remove-property"
+          ]
+        },
+        "endpoints": { "type": "array", "items": { "type": "string" }, "minItems": 1 },
+        "from": { "type": "string" },
+        "to": { "type": "string" },
+        "criterionCode": { "type": "string" },
+        "dataType": { "type": "string" }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@pisapp/core",
+  "version": "7.0.0-dev.20260916-153034",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./types.d.ts",
+  "exports": {
+    "./migration/*": "./migration/*",
+    "./package.json": "./package.json",
+    "./styles/*": "./styles/*",
+    ".": {
+      "types": "./types.d.ts",
+      "import": "./index.js"
+    },
+    "./core": {
+      "types": "./types.d.ts",
+      "import": "./core.js"
+    },
+    "./products": {
+      "types": "./types.d.ts",
+      "import": "./products.js"
+    },
+    "./catalogs": {
+      "types": "./types.d.ts",
+      "import": "./catalogs.js"
+    },
+    "./classifications": {
+      "types": "./types.d.ts",
+      "import": "./classifications.js"
+    },
+    "./pis.js": "./pis.js",
+    "./pis-csp.js": "./pis-csp.js"
+  },
+  "files": [
+    "*.js",
+    "*.d.ts",
+    "pis.js.map",
+    "pis-csp.js.map",
+    "types",
+    "generated",
+    "styles",
+    "chunks",
+    "migration",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.txt"
+  ],
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "ABB Asea Brown Boveri Ltd",
+  "peerDependencies": {
+    "vue": ">=3.5.17 <4"
+  },
+  "sideEffects": [
+    "./index.js",
+    "./core.js",
+    "./products.js",
+    "./catalogs.js",
+    "./classifications.js"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pisRelease": {
+    "version": "7.0.0-dev.20260916-153034",
+    "channel": "dev",
+    "commit": "3cfd54cc87975b643036674bfb2d000d81973ac5"
+  }
+}