Merge pull request #508 from exadel-inc/release-2.5.0

[Tech] Merged release-2.5.0 branch to master

Author: smiakchilo

all/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>com.exadel.etoolbox</groupId>
         <artifactId>etoolbox-authoring-kit</artifactId>
-        <version>2.4.1</version>
+        <version>2.5.0</version>
     </parent>
 
     <artifactId>etoolbox-authoring-kit-all</artifactId>

core/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>com.exadel.etoolbox</groupId>
         <artifactId>etoolbox-authoring-kit</artifactId>
-        <version>2.4.1</version>
+        <version>2.5.0</version>
     </parent>
 
     <artifactId>etoolbox-authoring-kit-core</artifactId>

core/src/main/java/com/exadel/aem/toolkit/api/annotations/policies/MaxChildren.java

@@ -0,0 +1,44 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.exadel.aem.toolkit.api.annotations.policies;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+import com.exadel.aem.toolkit.api.annotations.meta.ValueRestriction;
+import com.exadel.aem.toolkit.api.annotations.meta.ValueRestrictions;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface MaxChildren {
+    /**
+     * Specifies the maximum number of children allowed for container component
+     * @return Long value, 0 or greater
+     */
+    @ValueRestriction(ValueRestrictions.NON_NEGATIVE)
+    long value();
+
+    /**
+     * Used to specify target node for max children limit. The limitation applies to the current annotated component
+     * if set to {@link PolicyTarget#CURRENT}. Otherwise, the limitation is applied to a container nested within the current
+     * component. E.g. if the current component is an inheritor of parsys, setting {@code targetContainer} to {@link
+     * PolicyTarget#CURRENT} means that the limitation affects which components can be added to the current
+     * one. But if the current component contains a parsys inside you need to skip {@code targetContainer} or set it to
+     * {@link PolicyTarget#CHILD} so that the limitation applies to the parsys.
+     * @return {@link PolicyTarget} value
+     */
+    PolicyTarget targetContainer() default PolicyTarget.CHILD;
+}

core/src/main/java/com/exadel/aem/toolkit/api/annotations/policies/PolicyTarget.java

@@ -14,7 +14,7 @@
 package com.exadel.aem.toolkit.api.annotations.policies;
 
 /**
- * Defines possible values of {@link AllowedChildren#targetContainer()} property
+ * Defines possible values of {@link AllowedChildren#targetContainer()} and {@link MaxChildren#targetContainer()} properties
  */
 public enum PolicyTarget {
     CHILD,

docs/content/getting-started/installation.md

@@ -11,7 +11,7 @@ seoTitle: Installation - Exadel Authoring Kit
 <dependency>
    <groupId>com.exadel.etoolbox</groupId>
    <artifactId>etoolbox-authoring-kit-core</artifactId>
-   <version>2.4.1</version> <!-- Prefer the latest stable version whenever possible -->
+   <version>2.5.0</version> <!-- Prefer the latest stable version whenever possible -->
    <scope>provided</scope> <!-- Do not use compile or runtime scope!-->
 </dependency>
 ```
@@ -21,7 +21,7 @@ seoTitle: Installation - Exadel Authoring Kit
 <plugin>
     <groupId>com.exadel.etoolbox</groupId>
     <artifactId>etoolbox-authoring-kit-plugin</artifactId>
-    <version>2.4.1</version>
+    <version>2.5.0</version>
     <executions>
         <execution>
             <goals>
@@ -79,7 +79,7 @@ You need to do two steps.
 <dependency>
     <groupId>com.exadel.etoolbox</groupId>
     <artifactId>etoolbox-authoring-kit-all</artifactId>
-    <version>2.4.1</version>
+    <version>2.5.0</version>
     <type>content-package</type>
 </dependency>
 ```

docs/website/package-lock.json

@@ -20,7 +20,7 @@
     <parent>
         <groupId>com.exadel.etoolbox</groupId>
         <artifactId>etoolbox-authoring-kit</artifactId>
-        <version>2.4.1</version>
+        <version>2.5.0</version>
     </parent>
 
     <artifactId>etoolbox-authoring-kit-it.tests</artifactId>

it.tests/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>com.exadel.etoolbox</groupId>
         <artifactId>etoolbox-authoring-kit</artifactId>
-        <version>2.4.1</version>
+        <version>2.5.0</version>
     </parent>
 
     <artifactId>etoolbox-authoring-kit-plugin</artifactId>

plugin/pom.xml

@@ -28,6 +28,7 @@
 import com.exadel.aem.toolkit.plugin.handlers.common.CqDialogHandler;
 import com.exadel.aem.toolkit.plugin.handlers.common.CqEditConfigHandler;
 import com.exadel.aem.toolkit.plugin.handlers.common.CqHtmlTagHandler;
+import com.exadel.aem.toolkit.plugin.handlers.common.MaxChildrenHandler;
 import com.exadel.aem.toolkit.plugin.handlers.common.PropertyMappingHandler;
 import com.exadel.aem.toolkit.plugin.handlers.dependson.DependsOnHandler;
 import com.exadel.aem.toolkit.plugin.handlers.editconfig.DropTargetsHandler;
@@ -54,12 +55,17 @@ public class Handlers {
     private static final BiConsumer<Source, Target> CASUAL_ANNOTATIONS_HANDLER = new CasualAnnotationsHandler();
     private static final BiConsumer<Source, Target> PROPERTY_MAPPING_HANDLER = new PropertyMappingHandler();
     private static final BiConsumer<Source, Target> ALLOWED_CHILDREN_HANDLER = new AllowedChildrenHandler();
+    private static final BiConsumer<Source, Target> MAX_CHILDREN_HANDLER = new MaxChildrenHandler();
 
     // UI-specific handlers
-    private static final BiConsumer<Source, Target> CHILD_EDIT_CONFIG_HANDLER = new CqChildEditConfigHandler().andThen(ALLOWED_CHILDREN_HANDLER);
+    private static final BiConsumer<Source, Target> CHILD_EDIT_CONFIG_HANDLER = new CqChildEditConfigHandler()
+        .andThen(ALLOWED_CHILDREN_HANDLER)
+        .andThen(MAX_CHILDREN_HANDLER);
     private static final BiConsumer<Source, Target> COMPONENT_HANDLER = new ComponentHandler();
     private static final BiConsumer<Source, Target> DIALOG_HANDLER = new CqDialogHandler();
-    private static final BiConsumer<Source, Target> EDIT_CONFIG_HANDLER = new CqEditConfigHandler().andThen(ALLOWED_CHILDREN_HANDLER);
+    private static final BiConsumer<Source, Target> EDIT_CONFIG_HANDLER = new CqEditConfigHandler()
+        .andThen(ALLOWED_CHILDREN_HANDLER)
+        .andThen(MAX_CHILDREN_HANDLER);
     private static final BiConsumer<Source, Target> HTML_TAG_HANDLER = new CqHtmlTagHandler();
     private static final Map<String, BiConsumer<Source, Target>> UI_HANDLERS = ImmutableMap.<String, BiConsumer<Source, Target>>builder()
         .put(Scopes.COMPONENT, COMPONENT_HANDLER)

plugin/src/main/java/com/exadel/aem/toolkit/plugin/handlers/Handlers.java

@@ -0,0 +1,76 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License").
+ * You may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package com.exadel.aem.toolkit.plugin.handlers.common;
+
+import com.exadel.aem.toolkit.api.annotations.meta.Scopes;
+import com.exadel.aem.toolkit.api.annotations.policies.MaxChildren;
+import com.exadel.aem.toolkit.api.annotations.policies.PolicyTarget;
+import com.exadel.aem.toolkit.api.handlers.Handler;
+import com.exadel.aem.toolkit.api.handlers.Source;
+import com.exadel.aem.toolkit.api.handlers.Target;
+import com.exadel.aem.toolkit.plugin.utils.DialogConstants;
+
+/**
+ * Implements {@code BiConsumer} to populate a {@link Target} instance with properties originating from a {@link Source}
+ * object. The source refers to the {@code resolvemaxchildren} listener of the {@code
+ * cq:editConfig} node of an AEM component
+ */
+public class MaxChildrenHandler implements Handler {
+    /**
+     * Name of the listener to resolve max children limit for `policies` js module
+     */
+    public static final String MAX_CHILDREN_RESOLVER_NAME = "resolvemaxchildren";
+
+    /**
+     * Format of default max children limit resolver
+     */
+    private static final String MAX_CHILDREN_RESOLVER_FORMAT = "() => %d";
+
+
+    /**
+     * Processes data that can be extracted from the given {@code Source} and stores it into the provided {@code
+     * Target}
+     * @param source {@code Source} object used for data retrieval
+     * @param target Resulting {@code Target} object
+     */
+    @Override
+    public void accept(Source source, Target target) {
+        source.tryAdaptTo(MaxChildren.class).ifPresent(adaptation -> populate(adaptation, target));
+    }
+
+    /**
+     * Processes data from {@code MaxChildren} annotation and stores it into 'cq:listeners' node of the provided
+     * {@code Target}
+     * @param rule  {@code MaxChildren} object used for data retrieval
+     * @param target Resulting {@code Target} object
+     */
+    private static void populate(MaxChildren rule, Target target) {
+        if (isEditConfig(target) == (PolicyTarget.CURRENT == rule.targetContainer())) {
+            target
+                .attribute(DialogConstants.PN_PRIMARY_TYPE, DialogConstants.NT_EDIT_CONFIG)
+                .getOrCreateTarget(DialogConstants.NN_LISTENERS)
+                .attribute(DialogConstants.PN_PRIMARY_TYPE, DialogConstants.NT_LISTENERS)
+                .attribute(MAX_CHILDREN_RESOLVER_NAME, String.format(MAX_CHILDREN_RESOLVER_FORMAT, rule.value()));
+        }
+    }
+
+    /**
+     * Gets whether the given {@link Target} is a representation of a {@code cq:editConfig} node of an AEM component
+     * @param target {@code Target} instance
+     * @return True if the target is a {@code cq:editConfig} node; otherwise, false
+     */
+    private static boolean isEditConfig(Target target) {
+        return Scopes.CQ_EDIT_CONFIG.equals(target.getScope());
+    }
+}