@uniformdev/canvas 20.12.1-alpha.23 → 20.12.1-alpha.26

package/dist/index.d.mts

@@ -553,7 +553,7 @@ interface components$n {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -778,7 +778,7 @@ interface components$m {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -10105,10 +10105,7 @@ interface paths$6 {
             path?: never;
             cookie?: never;
         };
-        /**
-         * @deprecated
-         * @description Gets all preview URLs
-         */
+        /** @description Gets all preview URLs */
         get: {
             parameters: {
                 query: {
@@ -10153,10 +10150,7 @@ interface paths$6 {
                 500: components$6["responses"]["InternalServerError"];
             };
         };
-        /**
-         * @deprecated
-         * @description Upserts a preview URL
-         */
+        /** @description Upserts a preview URL */
         put: {
             parameters: {
                 query?: never;
@@ -10218,10 +10212,7 @@ interface paths$6 {
             };
         };
         post?: never;
-        /**
-         * @deprecated
-         * @description Deletes a preview URL
-         */
+        /** @description Deletes a preview URL */
         delete: {
             parameters: {
                 query?: never;
@@ -12106,13 +12097,19 @@ interface EvaluateNodeTreeVisibilityOptions extends Pick<EvaluateNodeVisibilityO
      * When false, indeterminate criteria will fail the summary result, and the node will be hidden
      */
     showIndeterminate?: boolean;
+    /**
+     * When evaluating visibility of a root node, this controls what happens when the node is found to be invisible.
+     * When 'throw' (default), an error is thrown.
+     * When 'ignore', the node is left intact. False is still returned.
+     */
+    rootNodeInvisibleHandling?: 'throw' | 'ignore';
 }
 /**
  * Function to call to evaluate visibility rules when traversing the node tree with walkNodeTree.
  *
  * If the function returns false, that means the current node is removed and you should stop any other code handling.
  */
-declare function evaluateWalkTreeNodeVisibility({ rules, showIndeterminate, context, }: EvaluateNodeTreeVisibilityOptions): boolean | undefined;
+declare function evaluateWalkTreeNodeVisibility({ rules, showIndeterminate, rootNodeInvisibleHandling, context, }: EvaluateNodeTreeVisibilityOptions): boolean | undefined;
 
 interface EvaluateWalkTreePropertyCriteriaOptions extends Pick<EvaluatePropertyCriteriaOptions, 'rules' | 'keepIndeterminate'> {
     node: ComponentInstance;
@@ -12402,8 +12399,6 @@ declare const createCanvasChannel: ({ listenTo, broadcastTo, }: {
 
 /**
  * API client to work with Uniform Project Preview entities
- *
- * @deprecated beta functionality subject to change
  */
 declare class PreviewClient extends ApiClient {
     constructor(options: ClientOptions);

package/dist/index.d.ts

@@ -553,7 +553,7 @@ interface components$n {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -778,7 +778,7 @@ interface components$m {
             categoryId?: string | null;
             /** @description Description of the component definition */
             description?: string;
-            /** @description Description of the component definition */
+            /** @description Preview image URL for the component definition (shown in the UI) */
             previewImageUrl?: string;
             /**
              * @description if this component uses team permissions or custom permissions
@@ -10105,10 +10105,7 @@ interface paths$6 {
             path?: never;
             cookie?: never;
         };
-        /**
-         * @deprecated
-         * @description Gets all preview URLs
-         */
+        /** @description Gets all preview URLs */
         get: {
             parameters: {
                 query: {
@@ -10153,10 +10150,7 @@ interface paths$6 {
                 500: components$6["responses"]["InternalServerError"];
             };
         };
-        /**
-         * @deprecated
-         * @description Upserts a preview URL
-         */
+        /** @description Upserts a preview URL */
         put: {
             parameters: {
                 query?: never;
@@ -10218,10 +10212,7 @@ interface paths$6 {
             };
         };
         post?: never;
-        /**
-         * @deprecated
-         * @description Deletes a preview URL
-         */
+        /** @description Deletes a preview URL */
         delete: {
             parameters: {
                 query?: never;
@@ -12106,13 +12097,19 @@ interface EvaluateNodeTreeVisibilityOptions extends Pick<EvaluateNodeVisibilityO
      * When false, indeterminate criteria will fail the summary result, and the node will be hidden
      */
     showIndeterminate?: boolean;
+    /**
+     * When evaluating visibility of a root node, this controls what happens when the node is found to be invisible.
+     * When 'throw' (default), an error is thrown.
+     * When 'ignore', the node is left intact. False is still returned.
+     */
+    rootNodeInvisibleHandling?: 'throw' | 'ignore';
 }
 /**
  * Function to call to evaluate visibility rules when traversing the node tree with walkNodeTree.
  *
  * If the function returns false, that means the current node is removed and you should stop any other code handling.
  */
-declare function evaluateWalkTreeNodeVisibility({ rules, showIndeterminate, context, }: EvaluateNodeTreeVisibilityOptions): boolean | undefined;
+declare function evaluateWalkTreeNodeVisibility({ rules, showIndeterminate, rootNodeInvisibleHandling, context, }: EvaluateNodeTreeVisibilityOptions): boolean | undefined;
 
 interface EvaluateWalkTreePropertyCriteriaOptions extends Pick<EvaluatePropertyCriteriaOptions, 'rules' | 'keepIndeterminate'> {
     node: ComponentInstance;
@@ -12402,8 +12399,6 @@ declare const createCanvasChannel: ({ listenTo, broadcastTo, }: {
 
 /**
  * API client to work with Uniform Project Preview entities
- *
- * @deprecated beta functionality subject to change
  */
 declare class PreviewClient extends ApiClient {
     constructor(options: ClientOptions);

package/dist/index.esm.js

@@ -2092,15 +2092,19 @@ function evaluateNodeVisibility({
 function evaluateWalkTreeNodeVisibility({
   rules,
   showIndeterminate,
+  rootNodeInvisibleHandling = "throw",
   context
 }) {
-  const { type, node, actions } = context;
+  const { type, node, actions, ancestorsAndSelf } = context;
   if (type !== "component") {
     return;
   }
   const result = evaluateNodeVisibility({ node, rules, simplifyCriteria: true });
   if (result === null && !showIndeterminate || result === false) {
-    actions.remove();
+    if (ancestorsAndSelf.length === 1 && rootNodeInvisibleHandling === "ignore") {
+    } else {
+      actions.remove();
+    }
     return false;
   }
   return true;
@@ -2336,25 +2340,24 @@ function extractLocales({ component }) {
 function localize(options) {
   const nodes = options.nodes;
   const locale = options.locale;
-  const isUsingModernOptions = typeof locale === "string";
-  const vizControlLocaleRule = isUsingModernOptions ? createLocaleVisibilityRule(locale) : {};
+  if (!locale) {
+    return;
+  }
+  const vizControlLocaleRule = createLocaleVisibilityRule(locale);
   walkNodeTree(nodes, (context) => {
     const { type, node, actions } = context;
     if (type !== "component") {
-      if (isUsingModernOptions) {
-        localizeProperties(node, locale, vizControlLocaleRule);
-      }
+      localizeProperties(node, locale, vizControlLocaleRule);
       return;
     }
-    if (isUsingModernOptions) {
-      const result = evaluateWalkTreeNodeVisibility({
-        context,
-        rules: vizControlLocaleRule,
-        showIndeterminate: true
-      });
-      if (!result) {
-        return;
-      }
+    const result = evaluateWalkTreeNodeVisibility({
+      context,
+      rules: vizControlLocaleRule,
+      showIndeterminate: true,
+      rootNodeInvisibleHandling: "ignore"
+    });
+    if (!result) {
+      return;
     }
     if (node.type === CANVAS_LOCALIZATION_TYPE) {
       const locales = extractLocales({ component: node });
@@ -2365,9 +2368,7 @@ function localize(options) {
       if (replaceComponent == null ? void 0 : replaceComponent.length) {
         replaceComponent.forEach((component) => {
           removeLocaleProperty(component);
-          if (isUsingModernOptions) {
-            localizeProperties(component, locale, vizControlLocaleRule);
-          }
+          localizeProperties(component, locale, vizControlLocaleRule);
         });
         const [first, ...rest] = replaceComponent;
         actions.replace(first);
@@ -2377,7 +2378,7 @@ function localize(options) {
       } else {
         actions.remove();
       }
-    } else if (isUsingModernOptions) {
+    } else {
       localizeProperties(node, locale, vizControlLocaleRule);
     }
   });

package/dist/index.js

@@ -2255,15 +2255,19 @@ function evaluateNodeVisibility({
 function evaluateWalkTreeNodeVisibility({
   rules,
   showIndeterminate,
+  rootNodeInvisibleHandling = "throw",
   context
 }) {
-  const { type, node, actions } = context;
+  const { type, node, actions, ancestorsAndSelf } = context;
   if (type !== "component") {
     return;
   }
   const result = evaluateNodeVisibility({ node, rules, simplifyCriteria: true });
   if (result === null && !showIndeterminate || result === false) {
-    actions.remove();
+    if (ancestorsAndSelf.length === 1 && rootNodeInvisibleHandling === "ignore") {
+    } else {
+      actions.remove();
+    }
     return false;
   }
   return true;
@@ -2499,25 +2503,24 @@ function extractLocales({ component }) {
 function localize(options) {
   const nodes = options.nodes;
   const locale = options.locale;
-  const isUsingModernOptions = typeof locale === "string";
-  const vizControlLocaleRule = isUsingModernOptions ? createLocaleVisibilityRule(locale) : {};
+  if (!locale) {
+    return;
+  }
+  const vizControlLocaleRule = createLocaleVisibilityRule(locale);
   walkNodeTree(nodes, (context) => {
     const { type, node, actions } = context;
     if (type !== "component") {
-      if (isUsingModernOptions) {
-        localizeProperties(node, locale, vizControlLocaleRule);
-      }
+      localizeProperties(node, locale, vizControlLocaleRule);
       return;
     }
-    if (isUsingModernOptions) {
-      const result = evaluateWalkTreeNodeVisibility({
-        context,
-        rules: vizControlLocaleRule,
-        showIndeterminate: true
-      });
-      if (!result) {
-        return;
-      }
+    const result = evaluateWalkTreeNodeVisibility({
+      context,
+      rules: vizControlLocaleRule,
+      showIndeterminate: true,
+      rootNodeInvisibleHandling: "ignore"
+    });
+    if (!result) {
+      return;
     }
     if (node.type === CANVAS_LOCALIZATION_TYPE) {
       const locales = extractLocales({ component: node });
@@ -2528,9 +2531,7 @@ function localize(options) {
       if (replaceComponent == null ? void 0 : replaceComponent.length) {
         replaceComponent.forEach((component) => {
           removeLocaleProperty(component);
-          if (isUsingModernOptions) {
-            localizeProperties(component, locale, vizControlLocaleRule);
-          }
+          localizeProperties(component, locale, vizControlLocaleRule);
         });
         const [first, ...rest] = replaceComponent;
         actions.replace(first);
@@ -2540,7 +2541,7 @@ function localize(options) {
       } else {
         actions.remove();
       }
-    } else if (isUsingModernOptions) {
+    } else {
       localizeProperties(node, locale, vizControlLocaleRule);
     }
   });

package/dist/index.mjs

@@ -2092,15 +2092,19 @@ function evaluateNodeVisibility({
 function evaluateWalkTreeNodeVisibility({
   rules,
   showIndeterminate,
+  rootNodeInvisibleHandling = "throw",
   context
 }) {
-  const { type, node, actions } = context;
+  const { type, node, actions, ancestorsAndSelf } = context;
   if (type !== "component") {
     return;
   }
   const result = evaluateNodeVisibility({ node, rules, simplifyCriteria: true });
   if (result === null && !showIndeterminate || result === false) {
-    actions.remove();
+    if (ancestorsAndSelf.length === 1 && rootNodeInvisibleHandling === "ignore") {
+    } else {
+      actions.remove();
+    }
     return false;
   }
   return true;
@@ -2336,25 +2340,24 @@ function extractLocales({ component }) {
 function localize(options) {
   const nodes = options.nodes;
   const locale = options.locale;
-  const isUsingModernOptions = typeof locale === "string";
-  const vizControlLocaleRule = isUsingModernOptions ? createLocaleVisibilityRule(locale) : {};
+  if (!locale) {
+    return;
+  }
+  const vizControlLocaleRule = createLocaleVisibilityRule(locale);
   walkNodeTree(nodes, (context) => {
     const { type, node, actions } = context;
     if (type !== "component") {
-      if (isUsingModernOptions) {
-        localizeProperties(node, locale, vizControlLocaleRule);
-      }
+      localizeProperties(node, locale, vizControlLocaleRule);
       return;
     }
-    if (isUsingModernOptions) {
-      const result = evaluateWalkTreeNodeVisibility({
-        context,
-        rules: vizControlLocaleRule,
-        showIndeterminate: true
-      });
-      if (!result) {
-        return;
-      }
+    const result = evaluateWalkTreeNodeVisibility({
+      context,
+      rules: vizControlLocaleRule,
+      showIndeterminate: true,
+      rootNodeInvisibleHandling: "ignore"
+    });
+    if (!result) {
+      return;
     }
     if (node.type === CANVAS_LOCALIZATION_TYPE) {
       const locales = extractLocales({ component: node });
@@ -2365,9 +2368,7 @@ function localize(options) {
       if (replaceComponent == null ? void 0 : replaceComponent.length) {
         replaceComponent.forEach((component) => {
           removeLocaleProperty(component);
-          if (isUsingModernOptions) {
-            localizeProperties(component, locale, vizControlLocaleRule);
-          }
+          localizeProperties(component, locale, vizControlLocaleRule);
         });
         const [first, ...rest] = replaceComponent;
         actions.replace(first);
@@ -2377,7 +2378,7 @@ function localize(options) {
       } else {
         actions.remove();
       }
-    } else if (isUsingModernOptions) {
+    } else {
       localizeProperties(node, locale, vizControlLocaleRule);
     }
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas",
-  "version": "20.12.1-alpha.23+36df23cbe9",
+  "version": "20.12.1-alpha.26+727af74745",
   "description": "Common functionality and types for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -38,9 +38,9 @@
     "p-throttle": "5.0.0"
   },
   "dependencies": {
-    "@uniformdev/assets": "20.12.1-alpha.23+36df23cbe9",
-    "@uniformdev/context": "20.12.1-alpha.23+36df23cbe9",
-    "@uniformdev/richtext": "20.12.1-alpha.23+36df23cbe9",
+    "@uniformdev/assets": "20.12.1-alpha.26+727af74745",
+    "@uniformdev/context": "20.12.1-alpha.26+727af74745",
+    "@uniformdev/richtext": "20.12.1-alpha.26+727af74745",
     "immer": "10.1.1"
   },
   "files": [
@@ -49,5 +49,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "36df23cbe9ca246137efcf2f4a57e04d029406cc"
+  "gitHead": "727af74745bafe690997e093f65e0c3d0aef5a45"
 }