@pisapp/vue-helpers 7.0.0-dev.20260916-153034

package/LICENSE

@@ -0,0 +1,28 @@
+PRODUCT INFORMATION SERVICES (PIS) PROPRIETARY SOFTWARE LICENSE
+
+Copyright (c) 2026 ABB Asea Brown Boveri Ltd. All rights reserved.
+
+The Product Information Services (PIS) software package and its documentation
+(the "Software") are proprietary to ABB Asea Brown Boveri Ltd and its
+licensors.
+
+Subject to a valid written agreement between ABB and you or the organization
+you represent that authorizes use of PIS (the "Applicable Agreement"), ABB
+grants you a non-exclusive, non-transferable, non-sublicensable, limited
+license to install and use the Software solely to develop, test, and run
+applications that access PIS services as authorized by the Applicable
+Agreement.
+
+Except to the extent that mandatory law does not allow a restriction, you may
+not copy, modify, distribute, publish, sublicense, rent, lease, sell, or
+otherwise make the Software available to a third party. You may not remove or
+alter proprietary notices or reverse engineer the Software except as expressly
+permitted by mandatory law.
+
+If no Applicable Agreement authorizes your use of PIS, no license to use the
+Software is granted. Your right to use the Software ends when the Applicable
+Agreement ends or your authorization under it is withdrawn.
+
+The Applicable Agreement controls if it conflicts with this notice. The
+Software is provided subject to the warranties, limitations of liability, and
+other terms in the Applicable Agreement.

package/README.md

@@ -0,0 +1,48 @@
+# @pisapp/vue-helpers
+
+Vue 3.5+ helper for **PIS v7**. `compileComponent(C)` mounts a Vue component
+into a PIS template surface. Because PIS itself is built on Vue reactivity, the
+context (`ctx`) flows in natively — mutations to `ctx` fields re-render your
+component with no bridge layer.
+
+## Install
+
+```bash
+pnpm add @pisapp/core @pisapp/vue-helpers vue
+# npm install @pisapp/core @pisapp/vue-helpers vue
+```
+
+### Peer dependencies
+
+| Package        | Range    | Notes                                   |
+| -------------- | -------- | --------------------------------------- |
+| `@pisapp/core` | `^7.0.0` | The component runtime + types.          |
+| `vue`          | `^3.5.0` | The reactivity runtime PIS is built on. |
+
+## Usage
+
+```ts
+import { registerAll } from '@pisapp/core';
+import { compileComponent } from '@pisapp/vue-helpers';
+import BuyButton from './BuyButton.vue';
+
+registerAll(); // explicit registration (C11 follow-up) — once at startup
+
+const cellCallbacks = compileComponent(BuyButton);
+
+const options = {
+  components: {
+    itemsTable: {
+      columns: [{ dataField: 'ProductId', cellTemplate: cellCallbacks }],
+    },
+  },
+};
+```
+
+`compileComponent` accepts a Vue component (`Component`) and returns the
+`{ mount }` template value (`TemplateCallbacks`) that PIS expects on a template
+slot; `mount` returns the teardown cleanup. The component receives `ctx` as a
+prop.
+
+See the [Vue migration guide](../../PisNextGenDocs/src/migration/web-components/vue.md) for
+the full DSL translation rules and the codemod-first migration flow.

package/THIRD-PARTY-NOTICES.txt

@@ -0,0 +1,43 @@
+THIRD-PARTY NOTICES
+
+Product Information Services (PIS) packages may include or depend on the
+third-party software listed below. The applicable third-party license terms
+apply to that software.
+
+Bootstrap 5.3.2
+Copyright (c) 2011-2023 The Bootstrap Authors
+
+vue-virtual-scroller 2.0.1
+Copyright (c) 2020 guillaume.b.chau@gmail.com
+
+Vue 3.5.40
+Copyright (c) 2018-present, Yuxi (Evan) You
+
+vue3-runtime-template 1.0.2
+Copyright (c) 2018 Alex Jover
+
+The components listed above are licensed under the MIT License:
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+ABBvoice font assets are proprietary ABB assets. They are not redistributed in
+these npm packages. PIS CSS references the ABB-hosted font service at:
+https://external.productinformation.abb.com/PisApp/current/fonts/

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { MountCallback, TemplateCallbacks, VueSlotComponent } from '@pisapp/core';
+import { Component } from 'vue';
+/**
+ * What a Vue consumer may place on a `*Template` config field — the same union
+ * as core's `MountPoint<C>`, on a Vue-specific name:
+ *
+ * - `MountCallback<C>` — a bare render function, the plain-JS form. MountPoint
+ *   wraps it in reactiveMount (a bare function is NEVER a Vue functional
+ *   component — the shapes are indistinguishable at runtime).
+ * - `TemplateCallbacks<C>` — the `{ mount }` value returned by
+ *   `compileComponent` (cross-framework compatible) or `reactiveMount`.
+ * - `VueSlotComponent` — an object Vue component passed DIRECTLY. The runtime
+ *   projects it via `<component :is>` and hands it the reactive `ctx` as a
+ *   prop, preserving the Vue lifecycle natively. This is the canonical Vue
+ *   example: `options.components.search.table.columns[i].cellTemplate = MyCell`
+ *   (no `compileComponent` needed). Functional components (bare functions)
+ *   must be wrapped with `compileComponent`.
+ */
+export type VueTemplateRenderable<C = unknown> = TemplateCallbacks<C> | MountCallback<C> | VueSlotComponent;
+/**
+ * Compile a Vue component into a template mount value. The context type `C`
+ * defaults to `unknown` (Vue's `h()` erases component prop types, so the
+ * context can't be inferred from the component here); type safety lives on the
+ * component itself, whose `ctx` prop is typed against the surface context.
+ * Pass `C` explicitly for wiring-site checking:
+ * `compileComponent<ProductsSearchTableCellProps>(MyCell)`.
+ *
+ * Light-DOM note: PIS v7 components render with `shadowRoot: false`, so the
+ * mount container is plain light DOM and host-document CSS reaches consumer
+ * SFC `<style>` blocks naturally — no stylesheet mirroring is done here.
+ */
+export declare function compileComponent<C = unknown>(component: Component): TemplateCallbacks<C>;

package/dist/index.js

@@ -0,0 +1,19 @@
+import { createApp as e, h as t } from "vue";
+//#region src/index.ts
+var n = /* @__PURE__ */ new WeakMap();
+function r(r) {
+	return { mount: (i, a) => {
+		n.get(i)?.();
+		let o = e({
+			name: "PisVueHelperHost",
+			render: () => t(r, { ctx: a })
+		});
+		o.mount(i);
+		let s = !1, c = () => {
+			s || (s = !0, n.delete(i), o.unmount());
+		};
+		return n.set(i, c), c;
+	} };
+}
+//#endregion
+export { r as compileComponent };

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@pisapp/vue-helpers",
+  "version": "7.0.0-dev.20260916-153034",
+  "license": "SEE LICENSE IN LICENSE",
+  "author": "ABB Asea Brown Boveri Ltd",
+  "description": "Vue 3 helper for PIS v7 — mount custom cells via compileComponent($1). Bridges the reactive ctx to Vue props natively (decision D-N2).",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.txt"
+  ],
+  "peerDependencies": {
+    "vue": ">=3.5.17 <4",
+    "@pisapp/core": "^7.0.0"
+  },
+  "devDependencies": {
+    "typescript": "~6.0.3",
+    "@pisapp/core": "7.0.0-dev.20260916-153034",
+    "vue": ">=3.5.17 <4",
+    "vitest": "^4.1.10",
+    "jsdom": "^25.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pisRelease": {
+    "version": "7.0.0-dev.20260916-153034",
+    "channel": "dev",
+    "commit": "3cfd54cc87975b643036674bfb2d000d81973ac5"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-library.mjs --package @pisapp/vue-helpers",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  }
+}