@adaas/are 0.0.2 → 0.0.4

package/src/lib/AreLoader/AreLoader.component.ts

@@ -0,0 +1,89 @@
+import { A_Caller, A_Component, A_Context, A_Dependency, A_Feature, A_FormatterHelper, A_Inject, A_Scope, A_TYPES__ComponentMeta, A_TYPES__EntityFeatures } from "@adaas/a-concept";
+import { A_Frame } from "@adaas/a-frame";
+import { A_Logger } from "@adaas/a-utils/a-logger";
+import { AreNode } from "@adaas/are/node/AreNode.entity";
+import { AreFeatures } from "@adaas/are/component/Are.constants";
+import { AreContext } from "@adaas/are/component/Are.context";
+
+
+
+@A_Frame.Component({
+    description: 'Entry point of the pipeline. Accepts a raw template string and orchestrates the initial processing by delegating to Syntax. Returns a structured AreNode tree ready for transformation. Knows nothing about the template content or grammar rules.'
+})
+export class AreLoader extends A_Component {
+
+
+    // -----------------------------------------------------------------------------------------
+    // ----------------------------Are-Node Load Section----------------------------------------
+    // -----------------------------------------------------------------------------------------
+    /**
+     * Loads the AreNode 
+     * 
+     * @param node 
+     * @param scope 
+     * @param syntax 
+     * @param feature 
+     * @param logger 
+     * @param args 
+     */
+    @A_Feature.Extend({
+        name: A_TYPES__EntityFeatures.LOAD,
+        scope: [AreNode]
+    })
+    async load(
+        @A_Inject(A_Caller) node: AreNode,
+        @A_Inject(A_Scope) scope: A_Scope,
+        @A_Inject(A_Feature) feature: A_Feature,
+
+        @A_Inject(A_Logger) logger?: A_Logger,
+        @A_Inject(AreContext) context?: AreContext,
+        ...args: any[]
+    ) {
+        logger?.debug('red', `Loading node <${node.aseid.toString()}> with content:`, scope);
+
+        /**
+         * If Node has a custom component Defined
+         */
+        if (node.component) {
+            /**
+             * Chain all methods to load data from component.
+             */
+            context?.startPerformance('Total AreFeatures.onData')
+            await feature.chain(node.component, AreFeatures.onData, scope);
+            context?.endPerformance('Total AreFeatures.onData')
+
+            context?.startPerformance('Total AreFeatures.onLoad')
+            await feature.chain(node.component, AreFeatures.onStyles, scope);
+            context?.endPerformance('Total AreFeatures.onLoad')
+
+            context?.startPerformance('Total AreFeatures.onTemplate')
+            await feature.chain(node.component, AreFeatures.onTemplate, scope);
+            context?.endPerformance('Total AreFeatures.onTemplate')
+        } 
+        // else {
+        //     logger?.warning(
+        //         'Component Not Found',
+        //         `No component registered for entity: ${node.aseid.entity}. Please ensure that the component is registered in the scope before rendering.`
+        //     );
+        // }
+
+        /**
+         * 2. Tokenize Node Content
+         */
+        context?.startPerformance('Tokenization')
+        node.tokenize();
+        context?.endPerformance('Tokenization')
+
+        /**
+         * 3. We have to extract node content and create child nodes if content exists, since it can impact the rendering and compilation process, for example if we have some directives that are affecting the structure of the node or its children, we need to have them in place before compilation to ensure that they are properly processed and their instructions are added to the render plan.
+         */
+        for (let i = 0; i < node.children.length; i++) {
+            const childNode = node.children[i];
+
+            const res =  childNode.load();
+            if(res instanceof Promise) {
+                await res;
+            }
+        }
+    }
+}

package/src/lib/AreLoader/AreLoader.error.ts

@@ -0,0 +1,10 @@
+import { A_Error } from "@adaas/a-concept";
+
+
+
+export class AreLoaderError extends A_Error {
+
+    static readonly SyntaxError = 'Are Loader Syntax Error';
+
+    static readonly EmptyTemplateError = 'Are Loader Empty Template Error';
+}

package/src/lib/AreNode/AreNode.constants.ts

@@ -1,37 +1,132 @@
 
 
+export const AreNodeFeatures = {
 
-export enum AreNodeFeatures {
+    // ==============================================================================
+    // Lifecycle features
+    // ==============================================================================
     /**
-     * Event fired when the element node is about to be rendered
+     * Feature that is called to handle before init lifecycle of the element node
      */
-    onBeforeRender = '_AreNode_onBeforeRender',
+    onBeforeInit: '_AreNode_onBeforeInit',
     /**
-     * Event fired when the element node is rendered
+     * Feature that is called to init the element node
      */
-    onRender = '_AreNode_onRender',
+    onInit: '_AreNode_onInit',
     /**
-     * Event fired when the element node is after rendered
+     * 
      */
-    onAfterRender = '_AreNode_onAfterRender',
+    onAfterInit: '_AreNode_onAfterInit',
+
+
+    /**
+     * Feature that is called to handle before mount lifecycle of the element node
+     */
+    onBeforeMount: '_AreNode_onBeforeMount',
+    /**
+     * Feature that is called to mount the element node
+     */
+    onMount: '_AreNode_onMount',
+    /**
+     * Feature that is called to handle after mount lifecycle of the element node
+     */
+    onAfterMount: '_AreNode_onAfterMount',
+
+
+    /**
+     * Feature that is called to handle before update lifecycle of the element node
+     */
+    onBeforeUpdate: '_AreNode_onBeforeUpdate',
+    /**
+     * Feature that is called to handle update lifecycle of the element node
+     */
+    onUpdate: '_AreNode_onUpdate',
+    /**
+     * Feature that is called to handle after update lifecycle of the element node
+     */
+    onAfterUpdate: '_AreNode_onAfterUpdate',
+
+
+    /**
+     * Feature that is called to handle before unmount lifecycle of the element node
+     */
+    onBeforeUnmount: '_AreNode_onBeforeUnmount',
+    /**
+     * Feature that is called to unmount the element node
+     */
+    onUnmount: '_AreNode_onUnmount',
+    /**
+     * Feature that is called to handle after unmount lifecycle of the element node
+     */
+    onAfterUnmount: '_AreNode_onAfterUnmount',
+
+
+    /**
+     * Feature that is called to handle before destroy lifecycle of the element node
+     */
+    onBeforeDestroy: '_AreNode_onBeforeDestroy',
+    /**
+     * Feature that is called to handle before destroy lifecycle of the element node
+     */
+    onDestroy: '_AreNode_onDestroy',
+    /**
+     * Feature that is called to handle after destroy lifecycle of the element node
+     */
+    onAfterDestroy: '_AreNode_onAfterDestroy',
+
+
+
+    //=============================================================================
+    // Build features
+    // ==============================================================================
+    /**
+     * Feature that is called to tokenize the element node template and extract its content, attributes, and child nodes. 
+     */
+    onTokenize: '_AreNode_onTokenize',
+    /**
+     * Feature that is called to transform the element node template, markup, styles, and data into a format that can be used for compilation. This feature is responsible for processing the raw template and extracting the necessary information to create the render plan and instructions for the node.
+     */
+    onTransform: '_AreNode_onTransform',
+    /**
+     * Event fired when the element node is interpreted
+     */
+    onInterpret: '_AreNode_onInterpret',
     /**
      * Feature that is called to compile the element node
      */
-    onCompile = '_AreNode_onCompile',
+    onCompile: '_AreNode_onCompile',
+
+
+
     /**
      * Feature that is called to handle events
      */
-    onEvent = '_AreNode_onEvent',
+    onEmit: '_AreNode_onEmit',
+
+
+} as const;
+
+
+
+export const AreNodeStatuses = {
+    /**
+     * Status indicating that the node is pending compilation. When a node is in the pending status, it means that it has been created but has not yet been compiled. During this phase, the node is typically being prepared for compilation, which may involve setting up its template, markup, styles, and any associated data or context. Once the node is ready for compilation, its status will change to "compiling".
+     */
+    Pending: 'pending',
     /**
-     * Feature that is called to update the element node
+     * Status indicating that the node is in the process of being compiled. During this status, the node is being analyzed and transformed based on its template, markup, and styles to generate the necessary instructions for rendering and updating the node in the scene.
      */
-    onUpdate = '_AreNode_onUpdate',
+    Compiling: 'compiling',
     /**
-     * Feature that is called to mount the element node
+     * Status indicating that the node has been compiled and is ready to be rendered. In this status, the node has generated all the necessary instructions and is prepared to be mounted in the scene.
      */
-    onMount = '_AreNode_onMount',
+    Compiled: 'compiled',
     /**
-     * Feature that is called to unmount the element node
+     * Status indicating that the node is currently mounted in the scene. When a node is mounted, it means that it has been rendered and is actively part of the scene's structure and content.
+     */
+    Mounted: 'mounted',
+    /**
+     * Status indicating that the node has been unmounted from the scene. When a node is unmounted, it means that it has been removed from the scene's structure and content, and is no longer actively rendered in the scene.
      */
-    onUnmount = '_AreNode_onUnmount',
-}
+    Unmounted: 'unmounted',
+} as const;