@uniformdev/canvas 20.71.2-alpha.7 → 20.72.2-alpha.3

package/dist/index.d.mts

@@ -1658,6 +1658,8 @@ interface components$q {
  *  select.slots[except]=footer
  *  select.slots[depth]=2
  *  select.slots.<name>[depth]=1
+ *  select.fields[blockDepth]=2
+ *  select.fields[blockDepth]=preserveAll
  */
 /**
  * Prefix used by every `select.*` query parameter on the wire. Exported so
@@ -1677,6 +1679,22 @@ type FieldsProjection = {
      * modifier; the pruner ignores this — see lib/canvas-sdk applyProjection.
      */
     locales?: string[];
+    /**
+     * Controls how far projection descends into block-typed fields (`$block`).
+     * A block field's value is an array of structured content, each with its own
+     * fields, so projection can recurse into it like any other node.
+     *
+     * - Omitted (default): projection descends into blocks without limit,
+     *   applying `only`/`except` at every block level.
+     * - A non-negative integer `N`: keep block nesting up to `N` levels. Block
+     *   fields on a node at depth `>= N` are dropped; `only`/`except` still
+     *   apply within the levels that are kept. `0` removes every block-typed
+     *   field; `1` keeps top-level blocks but not blocks nested inside them.
+     * - `'preserveAll'`: Projection does not evaluate within blocks at all:
+     *   `only`/`except` do not apply to fields within blocks. The top level block field
+     *   is still subject to projection rules, but its descendants are not.
+     */
+    blockDepth?: number | 'preserveAll';
 };
 type FieldTypesProjection = {
     /** Include only fields whose `type` matches one of these patterns. */
@@ -14794,7 +14812,7 @@ declare function hasReferencedVariables(value: string | undefined): number;
  */
 declare function parseVariableExpression(serialized: string, onToken?: (token: string, type: 'text' | 'variable') => void | false): number;
 
-declare const version = "20.71.1";
+declare const version = "20.72.1";
 
 /** API client to enable managing workflow definitions */
 declare class WorkflowClient extends ApiClient {

package/dist/index.d.ts

@@ -1658,6 +1658,8 @@ interface components$q {
  *  select.slots[except]=footer
  *  select.slots[depth]=2
  *  select.slots.<name>[depth]=1
+ *  select.fields[blockDepth]=2
+ *  select.fields[blockDepth]=preserveAll
  */
 /**
  * Prefix used by every `select.*` query parameter on the wire. Exported so
@@ -1677,6 +1679,22 @@ type FieldsProjection = {
      * modifier; the pruner ignores this — see lib/canvas-sdk applyProjection.
      */
     locales?: string[];
+    /**
+     * Controls how far projection descends into block-typed fields (`$block`).
+     * A block field's value is an array of structured content, each with its own
+     * fields, so projection can recurse into it like any other node.
+     *
+     * - Omitted (default): projection descends into blocks without limit,
+     *   applying `only`/`except` at every block level.
+     * - A non-negative integer `N`: keep block nesting up to `N` levels. Block
+     *   fields on a node at depth `>= N` are dropped; `only`/`except` still
+     *   apply within the levels that are kept. `0` removes every block-typed
+     *   field; `1` keeps top-level blocks but not blocks nested inside them.
+     * - `'preserveAll'`: Projection does not evaluate within blocks at all:
+     *   `only`/`except` do not apply to fields within blocks. The top level block field
+     *   is still subject to projection rules, but its descendants are not.
+     */
+    blockDepth?: number | 'preserveAll';
 };
 type FieldTypesProjection = {
     /** Include only fields whose `type` matches one of these patterns. */
@@ -14794,7 +14812,7 @@ declare function hasReferencedVariables(value: string | undefined): number;
  */
 declare function parseVariableExpression(serialized: string, onToken?: (token: string, type: 'text' | 'variable') => void | false): number;
 
-declare const version = "20.71.1";
+declare const version = "20.72.1";
 
 /** API client to enable managing workflow definitions */
 declare class WorkflowClient extends ApiClient {

package/dist/index.esm.js

@@ -70,6 +70,9 @@ function projectionToQuery(spec) {
     appendCsv(out, `${p}fields[only]`, fields.only);
     appendCsv(out, `${p}fields[except]`, fields.except);
     appendCsv(out, `${p}fields[locales]`, fields.locales);
+    if (fields.blockDepth === "preserveAll" || typeof fields.blockDepth === "number") {
+      out[`${p}fields[blockDepth]`] = String(fields.blockDepth);
+    }
   }
   if (fieldTypes) {
     appendCsv(out, `${p}fieldTypes[only]`, fieldTypes.only);
@@ -2765,6 +2768,18 @@ function parseDepth(value, key) {
   }
   return Number(str);
 }
+function parseBlockDepth(value, key) {
+  const str = toStringValue2(value);
+  if (str === "preserveAll") {
+    return "preserveAll";
+  }
+  if (str === void 0 || str === "" || !/^\d+$/.test(str)) {
+    throw new Error(
+      `Invalid select projection: '${key}' must be a non-negative integer or 'preserveAll' (got ${JSON.stringify(str)})`
+    );
+  }
+  return Number(str);
+}
 function extractSelectKeys(source) {
   if (source instanceof URLSearchParams) {
     let out2;
@@ -2825,6 +2840,9 @@ function queryToProjection(source) {
         case "locales":
           fields.locales = parseCsv(value);
           break;
+        case "blockDepth":
+          fields.blockDepth = parseBlockDepth(value, rawKey);
+          break;
         default:
           throw new Error(`Invalid select projection: unsupported operator 'fields[${operator}]'`);
       }
@@ -3355,7 +3373,7 @@ function handleRichTextNodeBinding(object, options) {
 import { ApiClientError as ApiClientError2 } from "@uniformdev/context/api";
 
 // src/.version.ts
-var version = "20.71.1";
+var version = "20.72.1";
 
 // src/WorkflowClient.ts
 import { ApiClient as ApiClient17 } from "@uniformdev/context/api";

package/dist/index.js

@@ -279,6 +279,9 @@ function projectionToQuery(spec) {
     appendCsv(out, `${p}fields[only]`, fields.only);
     appendCsv(out, `${p}fields[except]`, fields.except);
     appendCsv(out, `${p}fields[locales]`, fields.locales);
+    if (fields.blockDepth === "preserveAll" || typeof fields.blockDepth === "number") {
+      out[`${p}fields[blockDepth]`] = String(fields.blockDepth);
+    }
   }
   if (fieldTypes) {
     appendCsv(out, `${p}fieldTypes[only]`, fieldTypes.only);
@@ -2974,6 +2977,18 @@ function parseDepth(value, key) {
   }
   return Number(str);
 }
+function parseBlockDepth(value, key) {
+  const str = toStringValue2(value);
+  if (str === "preserveAll") {
+    return "preserveAll";
+  }
+  if (str === void 0 || str === "" || !/^\d+$/.test(str)) {
+    throw new Error(
+      `Invalid select projection: '${key}' must be a non-negative integer or 'preserveAll' (got ${JSON.stringify(str)})`
+    );
+  }
+  return Number(str);
+}
 function extractSelectKeys(source) {
   if (source instanceof URLSearchParams) {
     let out2;
@@ -3034,6 +3049,9 @@ function queryToProjection(source) {
         case "locales":
           fields.locales = parseCsv(value);
           break;
+        case "blockDepth":
+          fields.blockDepth = parseBlockDepth(value, rawKey);
+          break;
         default:
           throw new Error(`Invalid select projection: unsupported operator 'fields[${operator}]'`);
       }
@@ -3564,7 +3582,7 @@ function handleRichTextNodeBinding(object, options) {
 var import_api19 = require("@uniformdev/context/api");
 
 // src/.version.ts
-var version = "20.71.1";
+var version = "20.72.1";
 
 // src/WorkflowClient.ts
 var import_api18 = require("@uniformdev/context/api");

package/dist/index.mjs

@@ -70,6 +70,9 @@ function projectionToQuery(spec) {
     appendCsv(out, `${p}fields[only]`, fields.only);
     appendCsv(out, `${p}fields[except]`, fields.except);
     appendCsv(out, `${p}fields[locales]`, fields.locales);
+    if (fields.blockDepth === "preserveAll" || typeof fields.blockDepth === "number") {
+      out[`${p}fields[blockDepth]`] = String(fields.blockDepth);
+    }
   }
   if (fieldTypes) {
     appendCsv(out, `${p}fieldTypes[only]`, fieldTypes.only);
@@ -2765,6 +2768,18 @@ function parseDepth(value, key) {
   }
   return Number(str);
 }
+function parseBlockDepth(value, key) {
+  const str = toStringValue2(value);
+  if (str === "preserveAll") {
+    return "preserveAll";
+  }
+  if (str === void 0 || str === "" || !/^\d+$/.test(str)) {
+    throw new Error(
+      `Invalid select projection: '${key}' must be a non-negative integer or 'preserveAll' (got ${JSON.stringify(str)})`
+    );
+  }
+  return Number(str);
+}
 function extractSelectKeys(source) {
   if (source instanceof URLSearchParams) {
     let out2;
@@ -2825,6 +2840,9 @@ function queryToProjection(source) {
         case "locales":
           fields.locales = parseCsv(value);
           break;
+        case "blockDepth":
+          fields.blockDepth = parseBlockDepth(value, rawKey);
+          break;
         default:
           throw new Error(`Invalid select projection: unsupported operator 'fields[${operator}]'`);
       }
@@ -3355,7 +3373,7 @@ function handleRichTextNodeBinding(object, options) {
 import { ApiClientError as ApiClientError2 } from "@uniformdev/context/api";
 
 // src/.version.ts
-var version = "20.71.1";
+var version = "20.72.1";
 
 // src/WorkflowClient.ts
 import { ApiClient as ApiClient17 } from "@uniformdev/context/api";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas",
-  "version": "20.71.2-alpha.7+2ec20a4ae2",
+  "version": "20.72.2-alpha.3+a1f072e7b4",
   "description": "Common functionality and types for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -36,9 +36,9 @@
     "svix": "1.96.0"
   },
   "dependencies": {
-    "@uniformdev/assets": "20.71.2-alpha.7+2ec20a4ae2",
-    "@uniformdev/context": "20.71.2-alpha.7+2ec20a4ae2",
-    "@uniformdev/richtext": "20.71.2-alpha.7+2ec20a4ae2",
+    "@uniformdev/assets": "20.72.2-alpha.3+a1f072e7b4",
+    "@uniformdev/context": "20.72.2-alpha.3+a1f072e7b4",
+    "@uniformdev/richtext": "20.72.2-alpha.3+a1f072e7b4",
     "immer": "11.1.8",
     "p-limit": "6.2.0",
     "p-retry": "6.2.1",
@@ -50,5 +50,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "2ec20a4ae2d167b6e4e6ad47463b90fb16b73c47"
+  "gitHead": "a1f072e7b42ac4b3c694ebdd2e75216efd74a9c2"
 }