@colixsystems/widget-sdk 0.28.0 → 0.30.0

package/README.md

@@ -46,7 +46,15 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`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**.
+`v0.30.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.30.0
+
+**New `folderRef` propertySchema type (REQ-WDG-FOLDERREF).** A Filestore folder picker that stores a bare folder UUID (or `null` = space root) and renders the Asset/Filestore `FolderSelector` in the Studio Properties Panel, scoped by a sibling space field named via `ui.spaceTypeField` (its value `"project"` / `"personal"` selects the PROJECT / PERSONAL space). Changing the space drops a now-out-of-scope selection. Filestore spaces are per-tenant end-user data and are not copied, so tenant-copy leaves the id as-is. Additive — no existing export or type changed.
+
+### What's new in 0.29.0
+
+**New `assetList` propertySchema type + `ui.showWhen` `neq`/`in` + `ui.step` (REQ-WDG-ASSET).** `assetList` is the multi-pick form of `asset` — an ordered array of bare File UUIDs rendered with the Asset Manager `MultiFileSelector` (selection order preserved; narrow with `ui.mimeFilter`). tenant-copy remaps each id. `ui.showWhen` now accepts `{ neq }` and `{ in: [...] }` alongside `{ eq }`; `ui.step` sets the numeric input/slider step. Additive — no existing export or type changed.
 
 ### What's new in 0.28.0
 

package/dist/index.d.ts

@@ -43,6 +43,10 @@ export type WidgetPropertyType =
   | "richText"
   // REQ-WDG-ASSET: file/asset picker → bare File UUID (Asset Manager picker).
   | "asset"
+  // REQ-WDG-ASSET: ordered multi-file picker → Array<File UUID>.
+  | "assetList"
+  // REQ-WDG-FOLDERREF: Filestore folder picker → folder UUID (or null = root).
+  | "folderRef"
   | "expression"
   | "eventBinding"
   | "object"

package/dist/property-schema.js

@@ -35,6 +35,18 @@ const VALID_TYPES = new Set([
   // (an `ui.mimeFilter` narrows it, e.g. "image"). tenant-copy remaps the id
   // through the layout walk's fileId map.
   "asset",
+  // REQ-WDG-ASSET: `assetList` is the multi-pick form of `asset` — an ordered
+  // array of bare File UUIDs (the Asset Manager multi-picker preserves
+  // selection order). Renders `MultiFileSelector` in the Studio Properties
+  // Panel; tenant-copy remaps each id through the layout walk's fileId map.
+  "assetList",
+  // REQ-WDG-FOLDERREF: `folderRef` is a Filestore folder picker. Stores a bare
+  // folder UUID (or null = space root); renders `FolderSelector` in the Studio
+  // Properties Panel, scoped by a sibling space field named via
+  // `ui.spaceTypeField`. Filestore spaces are per-tenant end-user data and are
+  // NOT copied, so tenant-copy leaves the id as-is (it resolves to the space
+  // root if absent in the target).
+  "folderRef",
   "expression", "eventBinding",
   "object", "array",
 ]);
@@ -120,6 +132,7 @@ function coerceLeaf(def, value, path, errors) {
     case "pageRef":
     case "richText":
     case "asset":
+    case "folderRef":
     case "expression":
     case "eventBinding":
       if (typeof value !== "string") errors.push(`${path}: expected string`);
@@ -144,6 +157,15 @@ function coerceLeaf(def, value, path, errors) {
         errors.push(`${path}: value not in enum`);
       }
       return value;
+    case "assetList":
+      if (!Array.isArray(value)) {
+        errors.push(`${path}: expected array`);
+      } else {
+        value.forEach((v, i) => {
+          if (typeof v !== "string") errors.push(`${path}[${i}]: expected string`);
+        });
+      }
+      return value;
     case "multiselect":
       if (!Array.isArray(value)) {
         errors.push(`${path}: expected array`);

package/package.json

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