@colixsystems/widget-sdk 0.31.0 → 0.33.0

package/README.md

@@ -46,7 +46,15 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.31.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
+
+**New `fieldList` propertySchema type (REQ-WBLT-03 / #139).** A per-field repeater that composes a form from author-picked columns of a sibling `tableRef` (default `tableId`, override via `ui.tableProp`). Each row stores `{ id, columnId, kind, label, required, optionsSource, inlineOptions, optionsTableId, optionsValueColumn, optionsLabelColumn }`; `kind` is one of `auto` / `singleChoice` / `multiChoice` and is gated by the column's `data_type` so an array column can't render as a scalar picker. The Studio renders the built-in **Form Builder** widget's editor through `SchemaForm` instead of the hand-rolled block it shipped with — removes the last data widget from `LEGACY_EDITOR_TYPES`. Persisted field shape is unchanged so existing pages keep rendering. **`CONTRACT.version` → `1.22.0`** (additive: one new propertySchema type). No existing export or type changed signature.
 
 ### What's new in 0.31.0
 

package/dist/contract.cjs

@@ -1323,7 +1323,33 @@ const CONTRACT = deepFreeze({
   //    new optional `existingSignatureId` arg on `useFileSignature` so an
   //    already-signed file shows its state + verify()s without re-signing.
   //    Backwards-compatible — the added arg is optional.
-  version: "1.21.0",
+  //
+  // 1.22.0: additive (REQ-WBLT-03 / #139) — new `fieldList` propertySchema type.
+  //    A per-field repeater that composes a form from author-picked columns of
+  //    a sibling tableRef (default `tableId`, override via `ui.tableProp`). Each
+  //    row stores `{ id, columnId, kind, label, required, optionsSource,
+  //    inlineOptions, optionsTableId, optionsValueColumn, optionsLabelColumn }`;
+  //    `kind` is one of `auto` / `singleChoice` / `multiChoice` (gated by the
+  //    column's data_type so an array column can't be rendered as a scalar
+  //    picker). The Studio renders the Form Builder editor through SchemaForm
+  //    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.
+  //
+  // 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

@@ -1323,7 +1323,33 @@ const CONTRACT = deepFreeze({
   //    new optional `existingSignatureId` arg on `useFileSignature` so an
   //    already-signed file shows its state + verify()s without re-signing.
   //    Backwards-compatible — the added arg is optional.
-  version: "1.21.0",
+  //
+  // 1.22.0: additive (REQ-WBLT-03 / #139) — new `fieldList` propertySchema type.
+  //    A per-field repeater that composes a form from author-picked columns of
+  //    a sibling tableRef (default `tableId`, override via `ui.tableProp`). Each
+  //    row stores `{ id, columnId, kind, label, required, optionsSource,
+  //    inlineOptions, optionsTableId, optionsValueColumn, optionsLabelColumn }`;
+  //    `kind` is one of `auto` / `singleChoice` / `multiChoice` (gated by the
+  //    column's data_type so an array column can't be rendered as a scalar
+  //    picker). The Studio renders the Form Builder editor through SchemaForm
+  //    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.
+  //
+  // 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

@@ -47,10 +47,22 @@ export type WidgetPropertyType =
   | "assetList"
   // REQ-WDG-FOLDERREF: Filestore folder picker → folder UUID (or null = root).
   | "folderRef"
+  // REQ-WBLT-03 / #139: per-field repeater that composes a form from columns
+  // of a sibling tableRef (default `tableId`, override via `ui.tableProp`).
+  // Each row: { id, columnId, kind: "auto"|"singleChoice"|"multiChoice",
+  // label, required, optionsSource, inlineOptions, optionsTableId,
+  // optionsValueColumn, optionsLabelColumn }.
+  | "fieldList"
   | "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;
@@ -65,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.31.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",