@colixsystems/widget-sdk 0.205.0 → 0.205.1

package/README.md

@@ -83,7 +83,11 @@ See the design reference for the full architecture: [`docs/architecture/widget-m
 
 ## Status
 
-`v0.205.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.205.1` — 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.205.1
+
+**An encrypted column never labels a relation.** A RELATION read's `label` now comes from the first non-encrypted STRING/TEXT column on the target table when no display column is set, and an encrypted display column gives no label (`null`): a label is read whatever the reader may read of the target row, so it never carries encrypted text. To show an encrypted value of a related row, read that row through the table it lives in. A documentation correction; `CONTRACT.version` is unchanged.
 
 ### What's new in 0.205.0 (contract 1.164.0)
 
@@ -2110,7 +2114,7 @@ useEffect(() => {
 
 ### What's new in 0.42.0
 
-**RELATION columns hydrate with a display label (sc-1181).** Record reads now return `{ id, label }` for ONE_TO_ONE / ONE_TO_MANY and `[{ id, label }, ...]` for MANY_TO_MANY (empty array when no links) — `label` is the value of the column pointed at by the new optional `display_column_id` on `DatastoreSchemaColumn`, or, when unset, the first STRING/TEXT column on the target table. Widgets should render `record.<rel>.label` (or `record.<rel>.map(r => r.label).join(", ")` for M:M) directly; `.id` is still there for the foreign-key case. The cell-formatting helpers in the built-in `DataList` and `DataValue` widgets already walk arrays and prefer `label` over `name` / `id` — author widgets that need the same can copy that pattern. `CONTRACT.version` is unchanged.
+**RELATION columns hydrate with a display label (sc-1181).** Record reads now return `{ id, label }` for ONE_TO_ONE / ONE_TO_MANY and `[{ id, label }, ...]` for MANY_TO_MANY (empty array when no links) — `label` is the value of the column pointed at by the new optional `display_column_id` on `DatastoreSchemaColumn`, or, when unset, the first STRING/TEXT column on the target table (since 0.205.1: the first non-encrypted one; an encrypted display column gives no label). Widgets should render `record.<rel>.label` (or `record.<rel>.map(r => r.label).join(", ")` for M:M) directly; `.id` is still there for the foreign-key case. The cell-formatting helpers in the built-in `DataList` and `DataValue` widgets already walk arrays and prefer `label` over `name` / `id` — author widgets that need the same can copy that pattern. `CONTRACT.version` is unchanged.
 
 ### What's new in 0.41.0
 

package/dist/index.d.ts

@@ -1416,8 +1416,9 @@ export interface DatastoreSchemaColumn {
   /**
    * For RELATION columns only — id of a column on `target_table_id` whose
    * value supplies the `label` hydrated next to the related record id in
-   * record responses. `null` falls back to the first STRING/TEXT column on
-   * the target table.
+   * record responses. `null` falls back to the first non-encrypted
+   * STRING/TEXT column on the target table; an encrypted display column
+   * gives no label (`null`).
    */
   display_column_id?: string | null;
   /** True when this column is the table's display/identification column. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colixsystems/widget-sdk",
-  "version": "0.205.0",
+  "version": "0.205.1",
   "description": "Common widget interface for AppStudio. Implements WidgetManifest, WidgetContext, property schema, and helper hooks.",
   "homepage": "https://github.com/Colix-AB/AppStudio",
   "type": "module",