@adaas/are 0.0.2

package/dist/node/lib/AreSyntax/AreSyntax.component.js

@@ -0,0 +1,241 @@
+'use strict';
+
+var aConcept = require('@adaas/a-concept');
+var aFrame = require('@adaas/a-frame');
+var AreSyntax_context = require('./AreSyntax.context');
+var node = require('@adaas/are/node');
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+exports.AreSyntax = class AreSyntax extends aConcept.A_Component {
+  get config() {
+    return aConcept.A_Context.scope(this).resolveFlat(AreSyntax_context.AreSyntaxContext);
+  }
+  isRootNode(node) {
+    return node.aseid.entity.toLowerCase() === this.config.rootTag;
+  }
+  isCustomNode(node) {
+    return !this.config.standardTags.has(node.aseid.entity.toLowerCase());
+  }
+  extractRoots(template) {
+    const rootTag = this.config.rootTag;
+    const rootTagRegex = new RegExp(`<${rootTag}([\\s>])`, "gi");
+    let match;
+    const nodes = [];
+    while ((match = rootTagRegex.exec(template)) !== null) {
+      const startIndex = match.index;
+      const endTag = `</${rootTag}>`;
+      const endIndex = template.indexOf(endTag, startIndex);
+      if (endIndex === -1) {
+        throw new aConcept.A_Error(`Missing closing tag for <${rootTag}> starting at index ${startIndex}`);
+      }
+      const attributes = this.extractAttributes(template.slice(startIndex, endIndex + endTag.length));
+      let rootId = `auto-root-${startIndex}`;
+      for (let i = 0; i < attributes.length; i++) {
+        if (attributes[i].name === "id") {
+          rootId = attributes[i].value;
+          break;
+        }
+      }
+      const markup = template.slice(startIndex, endIndex + endTag.length);
+      const content = markup.slice(rootTag.length + 2, -endTag.length).trim();
+      const node$1 = new node.AreNode({
+        id: rootId,
+        scope: "are",
+        component: "are-root",
+        markup,
+        template: content
+      });
+      nodes.push(node$1);
+    }
+    return nodes;
+  }
+  extractInterpolations(template) {
+    const interpolationRegex = new RegExp(`${this.config.interpolationDelimiters[0]}\\s*([a-zA-Z0-9_.$]+)\\s*${this.config.interpolationDelimiters[1]}`, "g");
+    const interpolations = [];
+    let match;
+    while ((match = interpolationRegex.exec(template)) !== null) {
+      interpolations.push({
+        raw: match[0],
+        name: match[1],
+        position: match.index
+      });
+    }
+    return interpolations;
+  }
+  extractDirectives(template) {
+    const trimmedTemplate = template.trim();
+    const firstTagMatch = trimmedTemplate.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const directiveRegex = new RegExp(
+      `\\s+(\\${this.config.directiveDelimiter}[a-zA-Z0-9_-]+)(?:\\s*=\\s*(?:"([^"]*)"|'([^']*)'))?`,
+      "g"
+    );
+    let match;
+    const directives = [];
+    while ((match = directiveRegex.exec(attributesPart)) !== null) {
+      const name = match[1];
+      if (this.config.customDirectives && this.config.customDirectives.length > 0 && !this.config.customDirectives.includes(name)) {
+        continue;
+      }
+      const raw = match[0];
+      const value = match[2] ?? match[3];
+      const tagTemplate = firstTagMatch[0];
+      directives.push({
+        tag,
+        name,
+        raw,
+        value,
+        template: tagTemplate
+      });
+    }
+    return directives;
+  }
+  /**
+   * Extracts component props from the FIRST opening tag.
+   *
+   * Examples:
+   *   label="Click"
+   *   :label="'Click Me'"
+   *
+   * Excludes:
+   *   @click
+   *   $if
+   */
+  extractAttributes(template) {
+    const firstTagMatch = template.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const propRegex = new RegExp(
+      `\\s+(\\${this.config.bindingDelimiter}?)([a-zA-Z][a-zA-Z0-9._-]*)\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
+      "g"
+    );
+    let match;
+    const attributes = [];
+    while ((match = propRegex.exec(attributesPart)) !== null) {
+      const isBinding = match[1] === this.config.bindingDelimiter;
+      const name = match[2];
+      if (name.startsWith(this.config.listenerDelimiter) || name.startsWith(this.config.directiveDelimiter)) {
+        continue;
+      }
+      const raw = match[0];
+      const value = match[3] ?? match[4];
+      attributes.push({
+        tag,
+        name,
+        raw,
+        value: value || "",
+        binding: isBinding
+      });
+    }
+    return attributes;
+  }
+  /**
+   * Extracts event listeners from the FIRST/TOP-LEVEL opening tag ONLY in the template.
+   * Supports:
+   *  - @event="handler"
+   *  - @event='handler'
+   * 
+   * Note: This method intentionally ignores nested elements and only processes
+   * the very first opening tag in the provided template string.
+   */
+  extractListeners(template) {
+    const trimmedTemplate = template.trim();
+    const firstTagMatch = trimmedTemplate.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const listenerRegex = new RegExp(
+      `\\s+${this.config.listenerDelimiter}([a-zA-Z0-9_:-]+)\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
+      "g"
+    );
+    let match;
+    const listeners = [];
+    while ((match = listenerRegex.exec(attributesPart)) !== null) {
+      const raw = match[0];
+      const name = match[1];
+      const handler = match[2] ?? match[3] ?? "";
+      listeners.push({
+        tag,
+        name,
+        raw,
+        handler
+      });
+    }
+    return listeners;
+  }
+  isBindingProp(prop) {
+    return prop.raw.trim().startsWith(this.config.bindingDelimiter);
+  }
+  extractPropValue(prop, parentStore) {
+    if (prop.value == null) {
+      return void 0;
+    }
+    if (prop.binding) {
+      const value = prop.value.trim();
+      if (value.startsWith("'") && value.endsWith("'") || value.startsWith('"') && value.endsWith('"')) {
+        return value.slice(1, -1);
+      }
+      return parentStore?.get(value);
+    }
+    return prop.value;
+  }
+  replaceInterpolation(template, interpolation, value) {
+    const key = typeof interpolation === "string" ? interpolation : interpolation.name;
+    return template.replace(new RegExp(`${this.config.interpolationDelimiters[0]}\\s*${key}\\s*${this.config.interpolationDelimiters[1]}`, "g"), value !== void 0 ? String(value) : "");
+  }
+};
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Determines if a given AreNode is a root node based on its entity type."
+  })
+], exports.AreSyntax.prototype, "isRootNode", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Determines if a given AreNode represents a custom component as opposed to a standard HTML tag."
+  })
+], exports.AreSyntax.prototype, "isCustomNode", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Extracts root AreNode elements from the document based on the configured root tag."
+  })
+], exports.AreSyntax.prototype, "extractRoots", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Extracts interpolations from a template string based on the configured interpolation delimiters."
+  })
+], exports.AreSyntax.prototype, "extractInterpolations", 1);
+__decorateClass([
+  aFrame.A_Frame.Method({
+    description: "Extracts custom directives from the first opening tag of a template string."
+  })
+], exports.AreSyntax.prototype, "extractDirectives", 1);
+exports.AreSyntax = __decorateClass([
+  aFrame.A_Frame.Component({
+    namespace: "A-ARE",
+    name: "AreSyntax",
+    description: "Context component that defines the syntax rules and structures for the A-Concept Rendering Engine (ARE). It provides mechanisms for parsing and interpreting templates, attributes, directives, interpolations, and event listeners, enabling dynamic and interactive UI rendering within the ARE framework."
+  })
+], exports.AreSyntax);
+//# sourceMappingURL=AreSyntax.component.js.map
+//# sourceMappingURL=AreSyntax.component.js.map

package/dist/node/lib/AreSyntax/AreSyntax.component.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/AreSyntax/AreSyntax.component.ts"],"names":["AreSyntax","A_Component","A_Context","AreSyntaxContext","A_Error","node","AreNode","A_Frame"],"mappings":"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","file":"AreSyntax.component.js","sourcesContent":["import { A_Component, A_Context, A_Error } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { AreDirective, AreInterpolation, AreAttribute, AreListener } from \"./AreSyntax.types\";\nimport { AreSyntaxContext } from \"./AreSyntax.context\";\nimport { AreNode } from \"@adaas/are/node\";\nimport type { AreStore } from \"@adaas/are/store\";\n\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreSyntax',\n    description: 'Context component that defines the syntax rules and structures for the A-Concept Rendering Engine (ARE). It provides mechanisms for parsing and interpreting templates, attributes, directives, interpolations, and event listeners, enabling dynamic and interactive UI rendering within the ARE framework.'\n})\nexport class AreSyntax extends A_Component {\n\n\n    get config(): AreSyntaxContext {\n        return A_Context.scope(this).resolveFlat<AreSyntaxContext>(AreSyntaxContext)!;\n    }\n\n\n    /**\n     * Determines if a tag is a root node\n     * \n     * @param node \n     * @returns \n     */\n    @A_Frame.Method({\n        description: 'Determines if a given AreNode is a root node based on its entity type.'\n    })\n    isRootNode(node: AreNode): boolean {\n        return node.aseid.entity.toLowerCase() === this.config.rootTag;\n    }\n\n    /**\n     * Determines if a tag is a custom component or standard HTML\n     * \n     * @param node \n     * @returns \n     */\n    @A_Frame.Method({\n        description: 'Determines if a given AreNode represents a custom component as opposed to a standard HTML tag.'\n    })\n    isCustomNode(node: AreNode): boolean {\n        return !this.config.standardTags.has(node.aseid.entity.toLowerCase());\n    }\n\n\n    /**\n     * Extracts root AreNode elements from the document based on the configured root tag.\n     * \n     * @returns An iterable of AreNode instances representing the root elements.\n     */\n    @A_Frame.Method({\n        description: 'Extracts root AreNode elements from the document based on the configured root tag.'\n    })\n    extractRoots(template: string): AreNode[] {\n        const rootTag = this.config.rootTag;\n        const rootTagRegex = new RegExp(`<${rootTag}([\\\\s>])`, 'gi');\n        let match: RegExpExecArray | null;\n        const nodes: AreNode[] = [];\n\n        while ((match = rootTagRegex.exec(template)) !== null) {\n            const startIndex = match.index;\n            const endTag = `</${rootTag}>`;\n            const endIndex = template.indexOf(endTag, startIndex);\n\n            if (endIndex === -1) {\n                throw new A_Error(`Missing closing tag for <${rootTag}> starting at index ${startIndex}`);\n            }\n\n            const attributes = this.extractAttributes(template.slice(startIndex, endIndex + endTag.length));\n            let rootId = `auto-root-${startIndex}`;\n            \n            for (let i = 0; i < attributes.length; i++) {\n                if (attributes[i].name === 'id') {\n                    rootId = attributes[i].value;\n                    break;\n                }\n            }\n\n            const markup = template.slice(startIndex, endIndex + endTag.length);\n            const content = markup.slice(rootTag.length + 2, -endTag.length).trim();\n            \n\n            const node = new AreNode({\n                id: rootId,\n                scope: 'are',\n                component: 'are-root',\n                markup: markup,\n                template: content,\n            });\n\n            nodes.push(node);\n        }\n        \n        return nodes;\n    }\n\n\n    /**\n     * Extracts interpolations from template (syntax-agnostic).\n     * \n     * Simply finds all interpolation patterns and returns their position, raw text, and name.\n     * Works with any template format - HTML, plain text, or any other syntax.\n     * \n     * Example: `Hello {{name}}, welcome to {{place}}!`\n     * Returns: [\n     *   { raw: \"{{name}}\", name: \"name\", position: 6 },\n     *   { raw: \"{{place}}\", name: \"place\", position: 26 }\n     * ]\n     * \n     * @param template - Template string in any format\n     */\n    @A_Frame.Method({\n        description: 'Extracts interpolations from a template string based on the configured interpolation delimiters.'\n    })\n    extractInterpolations(template: string): AreInterpolation[] {\n        const interpolationRegex = new RegExp(`${this.config.interpolationDelimiters[0]}\\\\s*([a-zA-Z0-9_.$]+)\\\\s*${this.config.interpolationDelimiters[1]}`, 'g');\n        const interpolations: AreInterpolation[] = [];\n\n        let match: RegExpExecArray | null;\n        while ((match = interpolationRegex.exec(template)) !== null) {\n            interpolations.push({\n                raw: match[0],\n                name: match[1],\n                position: match.index!\n            });\n        }\n        \n        return interpolations;\n    }\n\n    /**\n     * Extracts custom directives from the FIRST/TOP-LEVEL opening tag ONLY.\n     * Directives start with `$`\n     *\n     * Examples:\n     *   $if=\"condition\"\n     *   $show\n     *   $no-update=\"\"\n     * \n     * Note: This method intentionally ignores nested elements and only processes\n     * the very first opening tag in the provided template string.\n     */\n    @A_Frame.Method({\n        description: 'Extracts custom directives from the first opening tag of a template string.'\n    })\n    extractDirectives(template: string): AreDirective[] {\n        // Trim whitespace to ensure we start at the actual first tag\n        const trimmedTemplate = template.trim();\n\n        // Match ONLY the very first opening tag (anchored with ^)\n        const firstTagMatch = trimmedTemplate.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        // If no attributes, no directives possible\n        if (!attributesPart) return [];\n\n        /**\n         * Extract directives from the first tag's attributes only.\n         * Matches patterns like:\n         *  $if=\"condition\"\n         *  $show\n         *  $no-update=\"\"\n         */\n        const directiveRegex = new RegExp(\n            `\\\\s+(\\\\${this.config.directiveDelimiter}[a-zA-Z0-9_-]+)(?:\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)'))?`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const directives: AreDirective[] = [];\n\n        while ((match = directiveRegex.exec(attributesPart)) !== null) {\n            const name = match[1];\n\n            // Optional whitelist support - only apply if whitelist is explicitly provided\n            if (\n                this.config.customDirectives &&\n                this.config.customDirectives.length > 0 &&\n                !this.config.customDirectives.includes(name)\n            ) {\n                continue;\n            }\n\n            const raw = match[0];\n            const value = match[2] ?? match[3];\n            const tagTemplate = firstTagMatch[0]; // Only the first tag\n\n            directives.push({\n                tag,\n                name,\n                raw,\n                value,\n                template: tagTemplate\n            });\n        }\n        \n        return directives;\n    }\n\n\n    /**\n     * Extracts component props from the FIRST opening tag.\n     *\n     * Examples:\n     *   label=\"Click\"\n     *   :label=\"'Click Me'\"\n     *\n     * Excludes:\n     *   @click\n     *   $if\n     */\n    extractAttributes(template: string): AreAttribute[] {\n        // Match first opening tag\n        const firstTagMatch = template.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        if (!attributesPart) return [];\n\n        /**\n         * Matches:\n         *   label=\"text\"\n         *   :label=\"'Click'\"\n         *\n         * Skips:\n         *   @click\n         *   $if\n         */\n        const propRegex = new RegExp(\n            `\\\\s+(\\\\${this.config.bindingDelimiter}?)([a-zA-Z][a-zA-Z0-9._-]*)\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)')`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const attributes: AreAttribute[] = [];\n\n        while ((match = propRegex.exec(attributesPart)) !== null) {\n            const isBinding = match[1] === this.config.bindingDelimiter;\n            const name = match[2];\n\n            // Exclude listeners & directives explicitly\n            if (\n                name.startsWith(this.config.listenerDelimiter) ||\n                name.startsWith(this.config.directiveDelimiter)\n            ) {\n                continue;\n            }\n\n            const raw = match[0];\n            const value = match[3] ?? match[4];\n\n            attributes.push({\n                tag,\n                name,\n                raw,\n                value: value || '',\n                binding: isBinding\n            });\n        }\n        \n        return attributes;\n    }\n\n\n    /**\n     * Extracts event listeners from the FIRST/TOP-LEVEL opening tag ONLY in the template.\n     * Supports:\n     *  - @event=\"handler\"\n     *  - @event='handler'\n     * \n     * Note: This method intentionally ignores nested elements and only processes\n     * the very first opening tag in the provided template string.\n     */\n    extractListeners(template: string): AreListener[] {\n        // Trim whitespace to ensure we start at the actual first tag\n        const trimmedTemplate = template.trim();\n\n        // Match ONLY the very first opening tag (anchored with ^)\n        const firstTagMatch = trimmedTemplate.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        // If no attributes, no listeners possible\n        if (!attributesPart) return [];\n\n        /**\n         * Extract listeners from the first tag's attributes only.\n         * Match listener attributes:\n         *  @input=\"onChange\"\n         *  @change='handleChange'\n         */\n        const listenerRegex = new RegExp(\n            `\\\\s+${this.config.listenerDelimiter}([a-zA-Z0-9_:-]+)` +\n            `\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)')`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const listeners: AreListener[] = [];\n\n        while ((match = listenerRegex.exec(attributesPart)) !== null) {\n            const raw = match[0];\n            const name = match[1];\n            const handler = match[2] ?? match[3] ?? \"\";\n\n            listeners.push({\n                tag,\n                name,\n                raw,\n                handler\n            });\n        }\n        \n        return listeners;\n    }\n\n\n\n    isBindingProp(prop: AreAttribute): boolean {\n        return prop.raw.trim().startsWith(this.config.bindingDelimiter)\n    }\n\n\n    extractPropValue(prop: AreAttribute, parentStore: AreStore): any {\n\n        if (prop.value == null) {\n            return undefined;\n        }\n\n        // Binding prop (starts with :)\n        if (prop.binding) {\n            const value = prop.value.trim();\n\n            // Static literal binding: :label=\"'Click'\" or :\"Click\"\n            if (\n                (value.startsWith(\"'\") && value.endsWith(\"'\")) ||\n                (value.startsWith('\"') && value.endsWith('\"'))\n            ) {\n                return value.slice(1, -1);\n            }\n\n            // Dynamic binding: :label=\"someKey\"\n            // (future: expressions, paths, computed, etc.)\n            return parentStore?.get(value);\n        }\n\n        // Static prop: label=\"Click\"\n        return prop.value;\n    }\n\n\n    replaceInterpolation(template: string, interpolation: AreInterpolation | string, value: any): string {\n        const key = typeof interpolation === 'string' ? interpolation : interpolation.name;\n\n        return template.replace(new RegExp(`${this.config.interpolationDelimiters[0]}\\\\s*${key}\\\\s*${this.config.interpolationDelimiters[1]}`, 'g'), value !== undefined ? String(value) : '');\n    }\n\n\n}"]}

package/dist/node/lib/AreSyntax/AreSyntax.component.mjs

@@ -0,0 +1,232 @@
+import { __decorateClass } from '../../chunk-EQQGB2QZ.mjs';
+import { A_Component, A_Context, A_Error } from '@adaas/a-concept';
+import { A_Frame } from '@adaas/a-frame';
+import { AreSyntaxContext } from './AreSyntax.context';
+import { AreNode } from '@adaas/are/node';
+
+let AreSyntax = class extends A_Component {
+  get config() {
+    return A_Context.scope(this).resolveFlat(AreSyntaxContext);
+  }
+  isRootNode(node) {
+    return node.aseid.entity.toLowerCase() === this.config.rootTag;
+  }
+  isCustomNode(node) {
+    return !this.config.standardTags.has(node.aseid.entity.toLowerCase());
+  }
+  extractRoots(template) {
+    const rootTag = this.config.rootTag;
+    const rootTagRegex = new RegExp(`<${rootTag}([\\s>])`, "gi");
+    let match;
+    const nodes = [];
+    while ((match = rootTagRegex.exec(template)) !== null) {
+      const startIndex = match.index;
+      const endTag = `</${rootTag}>`;
+      const endIndex = template.indexOf(endTag, startIndex);
+      if (endIndex === -1) {
+        throw new A_Error(`Missing closing tag for <${rootTag}> starting at index ${startIndex}`);
+      }
+      const attributes = this.extractAttributes(template.slice(startIndex, endIndex + endTag.length));
+      let rootId = `auto-root-${startIndex}`;
+      for (let i = 0; i < attributes.length; i++) {
+        if (attributes[i].name === "id") {
+          rootId = attributes[i].value;
+          break;
+        }
+      }
+      const markup = template.slice(startIndex, endIndex + endTag.length);
+      const content = markup.slice(rootTag.length + 2, -endTag.length).trim();
+      const node = new AreNode({
+        id: rootId,
+        scope: "are",
+        component: "are-root",
+        markup,
+        template: content
+      });
+      nodes.push(node);
+    }
+    return nodes;
+  }
+  extractInterpolations(template) {
+    const interpolationRegex = new RegExp(`${this.config.interpolationDelimiters[0]}\\s*([a-zA-Z0-9_.$]+)\\s*${this.config.interpolationDelimiters[1]}`, "g");
+    const interpolations = [];
+    let match;
+    while ((match = interpolationRegex.exec(template)) !== null) {
+      interpolations.push({
+        raw: match[0],
+        name: match[1],
+        position: match.index
+      });
+    }
+    return interpolations;
+  }
+  extractDirectives(template) {
+    const trimmedTemplate = template.trim();
+    const firstTagMatch = trimmedTemplate.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const directiveRegex = new RegExp(
+      `\\s+(\\${this.config.directiveDelimiter}[a-zA-Z0-9_-]+)(?:\\s*=\\s*(?:"([^"]*)"|'([^']*)'))?`,
+      "g"
+    );
+    let match;
+    const directives = [];
+    while ((match = directiveRegex.exec(attributesPart)) !== null) {
+      const name = match[1];
+      if (this.config.customDirectives && this.config.customDirectives.length > 0 && !this.config.customDirectives.includes(name)) {
+        continue;
+      }
+      const raw = match[0];
+      const value = match[2] ?? match[3];
+      const tagTemplate = firstTagMatch[0];
+      directives.push({
+        tag,
+        name,
+        raw,
+        value,
+        template: tagTemplate
+      });
+    }
+    return directives;
+  }
+  /**
+   * Extracts component props from the FIRST opening tag.
+   *
+   * Examples:
+   *   label="Click"
+   *   :label="'Click Me'"
+   *
+   * Excludes:
+   *   @click
+   *   $if
+   */
+  extractAttributes(template) {
+    const firstTagMatch = template.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const propRegex = new RegExp(
+      `\\s+(\\${this.config.bindingDelimiter}?)([a-zA-Z][a-zA-Z0-9._-]*)\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
+      "g"
+    );
+    let match;
+    const attributes = [];
+    while ((match = propRegex.exec(attributesPart)) !== null) {
+      const isBinding = match[1] === this.config.bindingDelimiter;
+      const name = match[2];
+      if (name.startsWith(this.config.listenerDelimiter) || name.startsWith(this.config.directiveDelimiter)) {
+        continue;
+      }
+      const raw = match[0];
+      const value = match[3] ?? match[4];
+      attributes.push({
+        tag,
+        name,
+        raw,
+        value: value || "",
+        binding: isBinding
+      });
+    }
+    return attributes;
+  }
+  /**
+   * Extracts event listeners from the FIRST/TOP-LEVEL opening tag ONLY in the template.
+   * Supports:
+   *  - @event="handler"
+   *  - @event='handler'
+   * 
+   * Note: This method intentionally ignores nested elements and only processes
+   * the very first opening tag in the provided template string.
+   */
+  extractListeners(template) {
+    const trimmedTemplate = template.trim();
+    const firstTagMatch = trimmedTemplate.match(
+      /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
+    );
+    if (!firstTagMatch) return [];
+    const tag = firstTagMatch[1];
+    const attributesPart = firstTagMatch[2];
+    if (!attributesPart) return [];
+    const listenerRegex = new RegExp(
+      `\\s+${this.config.listenerDelimiter}([a-zA-Z0-9_:-]+)\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
+      "g"
+    );
+    let match;
+    const listeners = [];
+    while ((match = listenerRegex.exec(attributesPart)) !== null) {
+      const raw = match[0];
+      const name = match[1];
+      const handler = match[2] ?? match[3] ?? "";
+      listeners.push({
+        tag,
+        name,
+        raw,
+        handler
+      });
+    }
+    return listeners;
+  }
+  isBindingProp(prop) {
+    return prop.raw.trim().startsWith(this.config.bindingDelimiter);
+  }
+  extractPropValue(prop, parentStore) {
+    if (prop.value == null) {
+      return void 0;
+    }
+    if (prop.binding) {
+      const value = prop.value.trim();
+      if (value.startsWith("'") && value.endsWith("'") || value.startsWith('"') && value.endsWith('"')) {
+        return value.slice(1, -1);
+      }
+      return parentStore?.get(value);
+    }
+    return prop.value;
+  }
+  replaceInterpolation(template, interpolation, value) {
+    const key = typeof interpolation === "string" ? interpolation : interpolation.name;
+    return template.replace(new RegExp(`${this.config.interpolationDelimiters[0]}\\s*${key}\\s*${this.config.interpolationDelimiters[1]}`, "g"), value !== void 0 ? String(value) : "");
+  }
+};
+__decorateClass([
+  A_Frame.Method({
+    description: "Determines if a given AreNode is a root node based on its entity type."
+  })
+], AreSyntax.prototype, "isRootNode", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Determines if a given AreNode represents a custom component as opposed to a standard HTML tag."
+  })
+], AreSyntax.prototype, "isCustomNode", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Extracts root AreNode elements from the document based on the configured root tag."
+  })
+], AreSyntax.prototype, "extractRoots", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Extracts interpolations from a template string based on the configured interpolation delimiters."
+  })
+], AreSyntax.prototype, "extractInterpolations", 1);
+__decorateClass([
+  A_Frame.Method({
+    description: "Extracts custom directives from the first opening tag of a template string."
+  })
+], AreSyntax.prototype, "extractDirectives", 1);
+AreSyntax = __decorateClass([
+  A_Frame.Component({
+    namespace: "A-ARE",
+    name: "AreSyntax",
+    description: "Context component that defines the syntax rules and structures for the A-Concept Rendering Engine (ARE). It provides mechanisms for parsing and interpreting templates, attributes, directives, interpolations, and event listeners, enabling dynamic and interactive UI rendering within the ARE framework."
+  })
+], AreSyntax);
+
+export { AreSyntax };
+//# sourceMappingURL=AreSyntax.component.mjs.map
+//# sourceMappingURL=AreSyntax.component.mjs.map

package/dist/node/lib/AreSyntax/AreSyntax.component.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/lib/AreSyntax/AreSyntax.component.ts"],"names":[],"mappings":"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","file":"AreSyntax.component.mjs","sourcesContent":["import { A_Component, A_Context, A_Error } from \"@adaas/a-concept\";\nimport { A_Frame } from \"@adaas/a-frame\";\nimport { AreDirective, AreInterpolation, AreAttribute, AreListener } from \"./AreSyntax.types\";\nimport { AreSyntaxContext } from \"./AreSyntax.context\";\nimport { AreNode } from \"@adaas/are/node\";\nimport type { AreStore } from \"@adaas/are/store\";\n\n\n@A_Frame.Component({\n    namespace: 'A-ARE',\n    name: 'AreSyntax',\n    description: 'Context component that defines the syntax rules and structures for the A-Concept Rendering Engine (ARE). It provides mechanisms for parsing and interpreting templates, attributes, directives, interpolations, and event listeners, enabling dynamic and interactive UI rendering within the ARE framework.'\n})\nexport class AreSyntax extends A_Component {\n\n\n    get config(): AreSyntaxContext {\n        return A_Context.scope(this).resolveFlat<AreSyntaxContext>(AreSyntaxContext)!;\n    }\n\n\n    /**\n     * Determines if a tag is a root node\n     * \n     * @param node \n     * @returns \n     */\n    @A_Frame.Method({\n        description: 'Determines if a given AreNode is a root node based on its entity type.'\n    })\n    isRootNode(node: AreNode): boolean {\n        return node.aseid.entity.toLowerCase() === this.config.rootTag;\n    }\n\n    /**\n     * Determines if a tag is a custom component or standard HTML\n     * \n     * @param node \n     * @returns \n     */\n    @A_Frame.Method({\n        description: 'Determines if a given AreNode represents a custom component as opposed to a standard HTML tag.'\n    })\n    isCustomNode(node: AreNode): boolean {\n        return !this.config.standardTags.has(node.aseid.entity.toLowerCase());\n    }\n\n\n    /**\n     * Extracts root AreNode elements from the document based on the configured root tag.\n     * \n     * @returns An iterable of AreNode instances representing the root elements.\n     */\n    @A_Frame.Method({\n        description: 'Extracts root AreNode elements from the document based on the configured root tag.'\n    })\n    extractRoots(template: string): AreNode[] {\n        const rootTag = this.config.rootTag;\n        const rootTagRegex = new RegExp(`<${rootTag}([\\\\s>])`, 'gi');\n        let match: RegExpExecArray | null;\n        const nodes: AreNode[] = [];\n\n        while ((match = rootTagRegex.exec(template)) !== null) {\n            const startIndex = match.index;\n            const endTag = `</${rootTag}>`;\n            const endIndex = template.indexOf(endTag, startIndex);\n\n            if (endIndex === -1) {\n                throw new A_Error(`Missing closing tag for <${rootTag}> starting at index ${startIndex}`);\n            }\n\n            const attributes = this.extractAttributes(template.slice(startIndex, endIndex + endTag.length));\n            let rootId = `auto-root-${startIndex}`;\n            \n            for (let i = 0; i < attributes.length; i++) {\n                if (attributes[i].name === 'id') {\n                    rootId = attributes[i].value;\n                    break;\n                }\n            }\n\n            const markup = template.slice(startIndex, endIndex + endTag.length);\n            const content = markup.slice(rootTag.length + 2, -endTag.length).trim();\n            \n\n            const node = new AreNode({\n                id: rootId,\n                scope: 'are',\n                component: 'are-root',\n                markup: markup,\n                template: content,\n            });\n\n            nodes.push(node);\n        }\n        \n        return nodes;\n    }\n\n\n    /**\n     * Extracts interpolations from template (syntax-agnostic).\n     * \n     * Simply finds all interpolation patterns and returns their position, raw text, and name.\n     * Works with any template format - HTML, plain text, or any other syntax.\n     * \n     * Example: `Hello {{name}}, welcome to {{place}}!`\n     * Returns: [\n     *   { raw: \"{{name}}\", name: \"name\", position: 6 },\n     *   { raw: \"{{place}}\", name: \"place\", position: 26 }\n     * ]\n     * \n     * @param template - Template string in any format\n     */\n    @A_Frame.Method({\n        description: 'Extracts interpolations from a template string based on the configured interpolation delimiters.'\n    })\n    extractInterpolations(template: string): AreInterpolation[] {\n        const interpolationRegex = new RegExp(`${this.config.interpolationDelimiters[0]}\\\\s*([a-zA-Z0-9_.$]+)\\\\s*${this.config.interpolationDelimiters[1]}`, 'g');\n        const interpolations: AreInterpolation[] = [];\n\n        let match: RegExpExecArray | null;\n        while ((match = interpolationRegex.exec(template)) !== null) {\n            interpolations.push({\n                raw: match[0],\n                name: match[1],\n                position: match.index!\n            });\n        }\n        \n        return interpolations;\n    }\n\n    /**\n     * Extracts custom directives from the FIRST/TOP-LEVEL opening tag ONLY.\n     * Directives start with `$`\n     *\n     * Examples:\n     *   $if=\"condition\"\n     *   $show\n     *   $no-update=\"\"\n     * \n     * Note: This method intentionally ignores nested elements and only processes\n     * the very first opening tag in the provided template string.\n     */\n    @A_Frame.Method({\n        description: 'Extracts custom directives from the first opening tag of a template string.'\n    })\n    extractDirectives(template: string): AreDirective[] {\n        // Trim whitespace to ensure we start at the actual first tag\n        const trimmedTemplate = template.trim();\n\n        // Match ONLY the very first opening tag (anchored with ^)\n        const firstTagMatch = trimmedTemplate.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        // If no attributes, no directives possible\n        if (!attributesPart) return [];\n\n        /**\n         * Extract directives from the first tag's attributes only.\n         * Matches patterns like:\n         *  $if=\"condition\"\n         *  $show\n         *  $no-update=\"\"\n         */\n        const directiveRegex = new RegExp(\n            `\\\\s+(\\\\${this.config.directiveDelimiter}[a-zA-Z0-9_-]+)(?:\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)'))?`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const directives: AreDirective[] = [];\n\n        while ((match = directiveRegex.exec(attributesPart)) !== null) {\n            const name = match[1];\n\n            // Optional whitelist support - only apply if whitelist is explicitly provided\n            if (\n                this.config.customDirectives &&\n                this.config.customDirectives.length > 0 &&\n                !this.config.customDirectives.includes(name)\n            ) {\n                continue;\n            }\n\n            const raw = match[0];\n            const value = match[2] ?? match[3];\n            const tagTemplate = firstTagMatch[0]; // Only the first tag\n\n            directives.push({\n                tag,\n                name,\n                raw,\n                value,\n                template: tagTemplate\n            });\n        }\n        \n        return directives;\n    }\n\n\n    /**\n     * Extracts component props from the FIRST opening tag.\n     *\n     * Examples:\n     *   label=\"Click\"\n     *   :label=\"'Click Me'\"\n     *\n     * Excludes:\n     *   @click\n     *   $if\n     */\n    extractAttributes(template: string): AreAttribute[] {\n        // Match first opening tag\n        const firstTagMatch = template.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        if (!attributesPart) return [];\n\n        /**\n         * Matches:\n         *   label=\"text\"\n         *   :label=\"'Click'\"\n         *\n         * Skips:\n         *   @click\n         *   $if\n         */\n        const propRegex = new RegExp(\n            `\\\\s+(\\\\${this.config.bindingDelimiter}?)([a-zA-Z][a-zA-Z0-9._-]*)\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)')`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const attributes: AreAttribute[] = [];\n\n        while ((match = propRegex.exec(attributesPart)) !== null) {\n            const isBinding = match[1] === this.config.bindingDelimiter;\n            const name = match[2];\n\n            // Exclude listeners & directives explicitly\n            if (\n                name.startsWith(this.config.listenerDelimiter) ||\n                name.startsWith(this.config.directiveDelimiter)\n            ) {\n                continue;\n            }\n\n            const raw = match[0];\n            const value = match[3] ?? match[4];\n\n            attributes.push({\n                tag,\n                name,\n                raw,\n                value: value || '',\n                binding: isBinding\n            });\n        }\n        \n        return attributes;\n    }\n\n\n    /**\n     * Extracts event listeners from the FIRST/TOP-LEVEL opening tag ONLY in the template.\n     * Supports:\n     *  - @event=\"handler\"\n     *  - @event='handler'\n     * \n     * Note: This method intentionally ignores nested elements and only processes\n     * the very first opening tag in the provided template string.\n     */\n    extractListeners(template: string): AreListener[] {\n        // Trim whitespace to ensure we start at the actual first tag\n        const trimmedTemplate = template.trim();\n\n        // Match ONLY the very first opening tag (anchored with ^)\n        const firstTagMatch = trimmedTemplate.match(\n            /^<([a-zA-Z][^\\s/>]*)(\\s[^>]*?)?>/\n        );\n\n        if (!firstTagMatch) return [];\n\n        const tag = firstTagMatch[1];\n        const attributesPart = firstTagMatch[2];\n\n        // If no attributes, no listeners possible\n        if (!attributesPart) return [];\n\n        /**\n         * Extract listeners from the first tag's attributes only.\n         * Match listener attributes:\n         *  @input=\"onChange\"\n         *  @change='handleChange'\n         */\n        const listenerRegex = new RegExp(\n            `\\\\s+${this.config.listenerDelimiter}([a-zA-Z0-9_:-]+)` +\n            `\\\\s*=\\\\s*(?:\"([^\"]*)\"|'([^']*)')`,\n            'g'\n        );\n\n        let match: RegExpExecArray | null;\n        const listeners: AreListener[] = [];\n\n        while ((match = listenerRegex.exec(attributesPart)) !== null) {\n            const raw = match[0];\n            const name = match[1];\n            const handler = match[2] ?? match[3] ?? \"\";\n\n            listeners.push({\n                tag,\n                name,\n                raw,\n                handler\n            });\n        }\n        \n        return listeners;\n    }\n\n\n\n    isBindingProp(prop: AreAttribute): boolean {\n        return prop.raw.trim().startsWith(this.config.bindingDelimiter)\n    }\n\n\n    extractPropValue(prop: AreAttribute, parentStore: AreStore): any {\n\n        if (prop.value == null) {\n            return undefined;\n        }\n\n        // Binding prop (starts with :)\n        if (prop.binding) {\n            const value = prop.value.trim();\n\n            // Static literal binding: :label=\"'Click'\" or :\"Click\"\n            if (\n                (value.startsWith(\"'\") && value.endsWith(\"'\")) ||\n                (value.startsWith('\"') && value.endsWith('\"'))\n            ) {\n                return value.slice(1, -1);\n            }\n\n            // Dynamic binding: :label=\"someKey\"\n            // (future: expressions, paths, computed, etc.)\n            return parentStore?.get(value);\n        }\n\n        // Static prop: label=\"Click\"\n        return prop.value;\n    }\n\n\n    replaceInterpolation(template: string, interpolation: AreInterpolation | string, value: any): string {\n        const key = typeof interpolation === 'string' ? interpolation : interpolation.name;\n\n        return template.replace(new RegExp(`${this.config.interpolationDelimiters[0]}\\\\s*${key}\\\\s*${this.config.interpolationDelimiters[1]}`, 'g'), value !== undefined ? String(value) : '');\n    }\n\n\n}"]}

package/dist/node/lib/AreSyntax/AreSyntax.context.d.mts

@@ -0,0 +1,80 @@
+import { A_Fragment } from '@adaas/a-concept';
+import { AreSyntaxInitOptions } from './AreSyntax.types.mjs';
+
+declare class AreSyntaxContext extends A_Fragment {
+    /**
+     * Initialization options for configuring the AreSyntax context.
+     */
+    protected readonly config: Partial<AreSyntaxInitOptions>;
+    constructor(
+    /**
+     * Initialization options for configuring the AreSyntax context.
+     */
+    config?: Partial<AreSyntaxInitOptions>);
+    /**
+     * identifier of the root tag to use when compiling in browser context.
+     *
+     * @return {string} The root tag identifier.
+     */
+    get rootTag(): string;
+    /**
+     * List of standard HTML tags to recognize.
+     * [!] This is a set of tags that can be ignored when determining if a node is a custom component.
+     *
+     * @return {Set<string>} A set of standard HTML tag names.
+     */
+    get standardTags(): Set<string>;
+    /**
+     * Enable or disable debug mode for syntax parsing.
+     * When enabled, additional debug information will be logged during parsing.
+     *
+     * @return {boolean} True if debug mode is enabled, false otherwise.
+     */
+    get debugMode(): boolean;
+    /**
+     * Custom interpolation delimiters for template parsing.
+     * Default is ['{{', '}}'].
+     *
+     * @return {[string, string]} The opening and closing interpolation delimiters.
+     */
+    get interpolationDelimiters(): [string, string];
+    /**
+     * Custom binding delimiter for data binding parsing.
+     * Default is ':'.
+     * @return {string} The binding delimiter.
+     */
+    get bindingDelimiter(): string;
+    /**
+     * Custom listener delimiter for event binding parsing.
+     * Default is '@'.
+     *
+     * @return {string} The listener delimiter.
+     */
+    get listenerDelimiter(): string;
+    /**
+     * Enable or disable strict mode for syntax parsing.
+     * When enabled, the parser will throw errors for any syntax violations.
+     * Default is true.
+     *
+     * @return {boolean} True if strict mode is enabled, false otherwise.
+     */
+    get strictMode(): boolean;
+    /**
+     * Enable or disable whitespace trimming in templates.
+     * When enabled, leading and trailing whitespace in template expressions will be trimmed.
+     * Default is true.
+     *
+     * @return {boolean} True if whitespace trimming is enabled, false otherwise.
+     */
+    get trimWhitespace(): boolean;
+    /**
+     * Custom directive delimiter for directive parsing.
+     * Default is '$'.
+     *
+     * @return {string} The directive delimiter.
+     */
+    get directiveDelimiter(): string;
+    get customDirectives(): string[];
+}
+
+export { AreSyntaxContext };