@colixsystems/widget-sdk 0.32.0 → 0.33.0

package/README.md

@@ -46,7 +46,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.32.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.33.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.33.0
+
+**New `filterList` propertySchema type + `ui.resetOnFieldChange` / `ui.defaultFactory` hints (REQ-WBLT-03, Tab Layout migration / #140).** `filterList` is a multi-condition record-filter builder — per-row column + operator + value with a "Relative date (N days ago)" toggle for DATE + ordering operators. The persisted value is `Array<{ column, operator, value, valueMode }>` matching the records-filter contract (`?filter[col]=op:value`). Columns resolve from a sibling tableRef (defaults to `tableId`; override with `ui.tableProp`). Pair with `ui.resetOnFieldChange: "tableId"` so the chain wipes when the source table changes. `ui.resetOnFieldChange: "<sibling>"` resets a property to its default when the named sibling changes — used to clear stale `columnRef`/`filterList` values nested inside an `array<object>` when the form-root tableId switches. `ui.defaultFactory: "tabId"` seeds a unique stable id when a new array item is added (Tab Layout's `tabs[*].id`). The Tab Layout built-in widget moved fully onto the manifest-driven Properties Panel; its hand-rolled per-tab editor is gone. `CONTRACT.version` → `1.23.0`. Additive — no existing export or type changed.
 
 ### What's new in 0.32.0
 

package/dist/contract.cjs

@@ -1335,7 +1335,21 @@ const CONTRACT = deepFreeze({
   //    instead of the hand-rolled block it shipped with — removes the last data
   //    widget from `LEGACY_EDITOR_TYPES`. No existing type changed shape, so
   //    this is additive — minor bump on the pre-1.0 channel.
-  version: "1.22.0",
+  //
+  // 1.23.0: additive (REQ-WBLT-03, Tab Layout migration / #140) — new
+  //    `filterList` propertySchema type. A multi-condition record-filter
+  //    builder whose persisted value is `Array<{ column, operator, value,
+  //    valueMode }>` matching the records-filter contract
+  //    (`?filter[col]=op:value`). Columns resolve from a sibling tableRef
+  //    (default `tableId`; override via `ui.tableProp`). Plus two free-form
+  //    `ui.*` hints used by the Tab Layout manifest and available to any
+  //    widget: `ui.resetOnFieldChange: "<sibling>"` (reset this property to
+  //    its default when the named sibling changes — wipes stale
+  //    columnRef/filterList values inside an array<object> when the
+  //    form-root tableId switches) and `ui.defaultFactory: "tabId"`
+  //    (per-instance dynamic default). No existing field, hook, primitive,
+  //    or token changed shape — minor bump on the pre-1.0 channel.
+  version: "1.23.0",
   hooks: HOOKS,
   primitives: PRIMITIVES,
   manifestSchema: MANIFEST_SCHEMA,

package/dist/contract.js

@@ -1335,7 +1335,21 @@ const CONTRACT = deepFreeze({
   //    instead of the hand-rolled block it shipped with — removes the last data
   //    widget from `LEGACY_EDITOR_TYPES`. No existing type changed shape, so
   //    this is additive — minor bump on the pre-1.0 channel.
-  version: "1.22.0",
+  //
+  // 1.23.0: additive (REQ-WBLT-03, Tab Layout migration / #140) — new
+  //    `filterList` propertySchema type. A multi-condition record-filter
+  //    builder whose persisted value is `Array<{ column, operator, value,
+  //    valueMode }>` matching the records-filter contract
+  //    (`?filter[col]=op:value`). Columns resolve from a sibling tableRef
+  //    (default `tableId`; override via `ui.tableProp`). Plus two free-form
+  //    `ui.*` hints used by the Tab Layout manifest and available to any
+  //    widget: `ui.resetOnFieldChange: "<sibling>"` (reset this property to
+  //    its default when the named sibling changes — wipes stale
+  //    columnRef/filterList values inside an array<object> when the
+  //    form-root tableId switches) and `ui.defaultFactory: "tabId"`
+  //    (per-instance dynamic default). No existing field, hook, primitive,
+  //    or token changed shape — minor bump on the pre-1.0 channel.
+  version: "1.23.0",
   hooks: HOOKS,
   primitives: PRIMITIVES,
   manifestSchema: MANIFEST_SCHEMA,

package/dist/index.d.ts

@@ -56,7 +56,13 @@ export type WidgetPropertyType =
   | "expression"
   | "eventBinding"
   | "object"
-  | "array";
+  | "array"
+  // REQ-WBLT-03 (Tab Layout migration): multi-condition record filter
+  // builder. Persisted value is `Array<{ column, operator, value, valueMode }>`
+  // matching the ?filter[col]=op:value contract; columns resolve from a
+  // sibling tableRef (defaults to the form-root `tableId`, override via
+  // `ui.tableProp`).
+  | "filterList";
 
 export interface WidgetPropertyDef {
   type: WidgetPropertyType;
@@ -71,6 +77,15 @@ export interface WidgetPropertyDef {
     widget?: "textarea" | "slider" | "code";
     group?: string;
     order?: number;
+    // REQ-WBLT-03: when the named sibling field changes, reset this
+    // property to its schema default. Used to wipe stale columnRef /
+    // filterList bindings nested inside array<object> when the form-root
+    // tableId switches.
+    resetOnFieldChange?: string;
+    // REQ-WBLT-03: per-instance dynamic default (can't be expressed as
+    // a static `default`). Today: `"tabId"` → seed a unique stable id
+    // for newly added Tab Layout tabs.
+    defaultFactory?: "tabId";
   };
   validation?: { min?: number; max?: number; pattern?: string };
 }

package/package.json

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