@colixsystems/widget-sdk 0.26.0 → 0.28.0

package/README.md

@@ -46,7 +46,15 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`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**.
+`v0.28.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.28.0
+
+**New `asset` propertySchema type + `ui.showWhen` (REQ-WDG-ASSET).** `asset` is a file/asset picker that stores a bare File UUID and renders the Asset Manager `FileSelector` in the Studio Properties Panel (narrow it with `ui.mimeFilter`, e.g. `"image"`). `ui.showWhen: { field, eq }` conditionally hides a field unless a sibling field equals a value (e.g. show the asset picker only when `imageSource === "asset"`). tenant-copy remaps an `asset` File UUID to the copied file. Additive — no existing export or type changed.
+
+### What's new in 0.27.0
+
+**New `richText` propertySchema type (REQ-WDG-RICHTEXT).** A rich-text (HTML) string edited via a Tiptap editor in the Studio Properties Panel; the widget renders the sanitised HTML. Stored as a plain string (no tenant-copy remap). Additive — no existing export or type changed.
 
 ### What's new in 0.26.0
 

package/dist/index.d.ts

@@ -39,6 +39,10 @@ export type WidgetPropertyType =
   // REQ-WDG-PAGEREF: page picker that emits a bare AppPage UUID; a widget
   // reads it and navigates via useNavigation().goTo(pageId, params).
   | "pageRef"
+  // REQ-WDG-RICHTEXT: rich-text (HTML string) edited via a Tiptap editor.
+  | "richText"
+  // REQ-WDG-ASSET: file/asset picker → bare File UUID (Asset Manager picker).
+  | "asset"
   | "expression"
   | "eventBinding"
   | "object"

package/dist/property-schema.js

@@ -26,6 +26,15 @@ const VALID_TYPES = new Set([
   // `useNavigation().goTo(pageId, params)`. Bare uuid string — tenant-copy
   // remaps it through the layout walk's pageId map (see tenant-copy.service.js).
   "pageRef",
+  // REQ-WDG-RICHTEXT: `richText` is a rich-text (HTML) string. Renders a
+  // Tiptap editor in the Studio Properties Panel; the widget renders the
+  // sanitised HTML. Stored as a string, so no tenant-copy remap is needed.
+  "richText",
+  // REQ-WDG-ASSET: `asset` is a file/asset picker. Stores a bare File UUID;
+  // renders the Asset Manager FileSelector in the Studio Properties Panel
+  // (an `ui.mimeFilter` narrows it, e.g. "image"). tenant-copy remaps the id
+  // through the layout walk's fileId map.
+  "asset",
   "expression", "eventBinding",
   "object", "array",
 ]);
@@ -109,6 +118,8 @@ function coerceLeaf(def, value, path, errors) {
     case "recordBinding":
     case "groupRef":
     case "pageRef":
+    case "richText":
+    case "asset":
     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.26.0",
+  "version": "0.28.0",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "type": "module",
   "main": "./dist/index.js",