@colixsystems/widget-sdk 0.25.0 → 0.26.0

package/README.md

@@ -46,7 +46,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.25.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+`v0.26.0` — pre-publish. The package surface (types, function names, export paths) is the v1 contract; runtime behaviour for some hooks is stubbed (each hook documents what's wired and what isn't). It is **not yet published to npm**.
+
+### What's new in 0.26.0
+
+**New `pageRef` propertySchema type (REQ-WDG-PAGEREF).** A page picker: the Studio Properties Panel renders a dropdown of the app's pages and stores the chosen page's bare UUID. A widget reads the prop and navigates with `useNavigation().goTo(pageId, params)` — the cross-platform replacement for the old per-widget "navigate on press" event wiring. tenant-copy remaps the stored page id to the copied page. Additive: no existing export or type changed signature.
 
 ### What's new in 0.25.0
 

package/dist/index.d.ts

@@ -36,6 +36,9 @@ export type WidgetPropertyType =
   // REQ-USERMGMT M4 / §4.8: Group picker that emits a bare
   // AppUserGroup UUID into the page JSON.
   | "groupRef"
+  // REQ-WDG-PAGEREF: page picker that emits a bare AppPage UUID; a widget
+  // reads it and navigates via useNavigation().goTo(pageId, params).
+  | "pageRef"
   | "expression"
   | "eventBinding"
   | "object"

package/dist/property-schema.js

@@ -20,6 +20,12 @@ const VALID_TYPES = new Set([
   // value is the raw uuid string so the tenant-copy walker can remap it
   // through `_remapJson` without per-prop hooks.
   "groupRef",
+  // REQ-WDG-PAGEREF: `pageRef` is a page picker that emits a bare AppPage
+  // UUID into the page JSON. Renders a page `<select>` in the Studio
+  // Properties Panel; a widget reads it and navigates via
+  // `useNavigation().goTo(pageId, params)`. Bare uuid string — tenant-copy
+  // remaps it through the layout walk's pageId map (see tenant-copy.service.js).
+  "pageRef",
   "expression", "eventBinding",
   "object", "array",
 ]);
@@ -102,6 +108,7 @@ function coerceLeaf(def, value, path, errors) {
     case "columnRef":
     case "recordBinding":
     case "groupRef":
+    case "pageRef":
     case "expression":
     case "eventBinding":
       if (typeof value !== "string") errors.push(`${path}: expected string`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "type": "module",
   "main": "./dist/index.js",