@uniformdev/canvas 20.71.2-alpha.14 → 20.71.2-alpha.19

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. */

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. */

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}]'`);
       }

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}]'`);
       }

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}]'`);
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas",
-  "version": "20.71.2-alpha.14+e527b409ae",
+  "version": "20.71.2-alpha.19+29ab6d7f60",
   "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.14+e527b409ae",
-    "@uniformdev/context": "20.71.2-alpha.14+e527b409ae",
-    "@uniformdev/richtext": "20.71.2-alpha.14+e527b409ae",
+    "@uniformdev/assets": "20.71.2-alpha.19+29ab6d7f60",
+    "@uniformdev/context": "20.71.2-alpha.19+29ab6d7f60",
+    "@uniformdev/richtext": "20.71.2-alpha.19+29ab6d7f60",
     "immer": "11.1.8",
     "p-limit": "6.2.0",
     "p-retry": "6.2.1",
@@ -50,5 +50,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "e527b409ae4d2b190d4f9195e6787f5c8b89fc85"
+  "gitHead": "29ab6d7f60af8eee4244b495f391611999326075"
 }