@adaas/are 0.0.2 → 0.0.4

package/src/lib/AreSyntax/AreSyntax.component.ts

@@ -1,378 +0,0 @@
-import { A_Component, A_Context, A_Error } from "@adaas/a-concept";
-import { A_Frame } from "@adaas/a-frame";
-import { AreDirective, AreInterpolation, AreAttribute, AreListener } from "./AreSyntax.types";
-import { AreSyntaxContext } from "./AreSyntax.context";
-import { AreNode } from "@adaas/are/node";
-import type { AreStore } from "@adaas/are/store";
-
-
-@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.'
-})
-export class AreSyntax extends A_Component {
-
-
-    get config(): AreSyntaxContext {
-        return A_Context.scope(this).resolveFlat<AreSyntaxContext>(AreSyntaxContext)!;
-    }
-
-
-    /**
-     * Determines if a tag is a root node
-     * 
-     * @param node 
-     * @returns 
-     */
-    @A_Frame.Method({
-        description: 'Determines if a given AreNode is a root node based on its entity type.'
-    })
-    isRootNode(node: AreNode): boolean {
-        return node.aseid.entity.toLowerCase() === this.config.rootTag;
-    }
-
-    /**
-     * Determines if a tag is a custom component or standard HTML
-     * 
-     * @param node 
-     * @returns 
-     */
-    @A_Frame.Method({
-        description: 'Determines if a given AreNode represents a custom component as opposed to a standard HTML tag.'
-    })
-    isCustomNode(node: AreNode): boolean {
-        return !this.config.standardTags.has(node.aseid.entity.toLowerCase());
-    }
-
-
-    /**
-     * Extracts root AreNode elements from the document based on the configured root tag.
-     * 
-     * @returns An iterable of AreNode instances representing the root elements.
-     */
-    @A_Frame.Method({
-        description: 'Extracts root AreNode elements from the document based on the configured root tag.'
-    })
-    extractRoots(template: string): AreNode[] {
-        const rootTag = this.config.rootTag;
-        const rootTagRegex = new RegExp(`<${rootTag}([\\s>])`, 'gi');
-        let match: RegExpExecArray | null;
-        const nodes: AreNode[] = [];
-
-        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: markup,
-                template: content,
-            });
-
-            nodes.push(node);
-        }
-        
-        return nodes;
-    }
-
-
-    /**
-     * Extracts interpolations from template (syntax-agnostic).
-     * 
-     * Simply finds all interpolation patterns and returns their position, raw text, and name.
-     * Works with any template format - HTML, plain text, or any other syntax.
-     * 
-     * Example: `Hello {{name}}, welcome to {{place}}!`
-     * Returns: [
-     *   { raw: "{{name}}", name: "name", position: 6 },
-     *   { raw: "{{place}}", name: "place", position: 26 }
-     * ]
-     * 
-     * @param template - Template string in any format
-     */
-    @A_Frame.Method({
-        description: 'Extracts interpolations from a template string based on the configured interpolation delimiters.'
-    })
-    extractInterpolations(template: string): AreInterpolation[] {
-        const interpolationRegex = new RegExp(`${this.config.interpolationDelimiters[0]}\\s*([a-zA-Z0-9_.$]+)\\s*${this.config.interpolationDelimiters[1]}`, 'g');
-        const interpolations: AreInterpolation[] = [];
-
-        let match: RegExpExecArray | null;
-        while ((match = interpolationRegex.exec(template)) !== null) {
-            interpolations.push({
-                raw: match[0],
-                name: match[1],
-                position: match.index!
-            });
-        }
-        
-        return interpolations;
-    }
-
-    /**
-     * Extracts custom directives from the FIRST/TOP-LEVEL opening tag ONLY.
-     * Directives start with `$`
-     *
-     * Examples:
-     *   $if="condition"
-     *   $show
-     *   $no-update=""
-     * 
-     * Note: This method intentionally ignores nested elements and only processes
-     * the very first opening tag in the provided template string.
-     */
-    @A_Frame.Method({
-        description: 'Extracts custom directives from the first opening tag of a template string.'
-    })
-    extractDirectives(template: string): AreDirective[] {
-        // Trim whitespace to ensure we start at the actual first tag
-        const trimmedTemplate = template.trim();
-
-        // Match ONLY the very first opening tag (anchored with ^)
-        const firstTagMatch = trimmedTemplate.match(
-            /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
-        );
-
-        if (!firstTagMatch) return [];
-
-        const tag = firstTagMatch[1];
-        const attributesPart = firstTagMatch[2];
-
-        // If no attributes, no directives possible
-        if (!attributesPart) return [];
-
-        /**
-         * Extract directives from the first tag's attributes only.
-         * Matches patterns like:
-         *  $if="condition"
-         *  $show
-         *  $no-update=""
-         */
-        const directiveRegex = new RegExp(
-            `\\s+(\\${this.config.directiveDelimiter}[a-zA-Z0-9_-]+)(?:\\s*=\\s*(?:"([^"]*)"|'([^']*)'))?`,
-            'g'
-        );
-
-        let match: RegExpExecArray | null;
-        const directives: AreDirective[] = [];
-
-        while ((match = directiveRegex.exec(attributesPart)) !== null) {
-            const name = match[1];
-
-            // Optional whitelist support - only apply if whitelist is explicitly provided
-            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]; // Only the first tag
-
-            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: string): AreAttribute[] {
-        // Match first opening tag
-        const firstTagMatch = template.match(
-            /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
-        );
-
-        if (!firstTagMatch) return [];
-
-        const tag = firstTagMatch[1];
-        const attributesPart = firstTagMatch[2];
-
-        if (!attributesPart) return [];
-
-        /**
-         * Matches:
-         *   label="text"
-         *   :label="'Click'"
-         *
-         * Skips:
-         *   @click
-         *   $if
-         */
-        const propRegex = new RegExp(
-            `\\s+(\\${this.config.bindingDelimiter}?)([a-zA-Z][a-zA-Z0-9._-]*)\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
-            'g'
-        );
-
-        let match: RegExpExecArray | null;
-        const attributes: AreAttribute[] = [];
-
-        while ((match = propRegex.exec(attributesPart)) !== null) {
-            const isBinding = match[1] === this.config.bindingDelimiter;
-            const name = match[2];
-
-            // Exclude listeners & directives explicitly
-            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: string): AreListener[] {
-        // Trim whitespace to ensure we start at the actual first tag
-        const trimmedTemplate = template.trim();
-
-        // Match ONLY the very first opening tag (anchored with ^)
-        const firstTagMatch = trimmedTemplate.match(
-            /^<([a-zA-Z][^\s/>]*)(\s[^>]*?)?>/
-        );
-
-        if (!firstTagMatch) return [];
-
-        const tag = firstTagMatch[1];
-        const attributesPart = firstTagMatch[2];
-
-        // If no attributes, no listeners possible
-        if (!attributesPart) return [];
-
-        /**
-         * Extract listeners from the first tag's attributes only.
-         * Match listener attributes:
-         *  @input="onChange"
-         *  @change='handleChange'
-         */
-        const listenerRegex = new RegExp(
-            `\\s+${this.config.listenerDelimiter}([a-zA-Z0-9_:-]+)` +
-            `\\s*=\\s*(?:"([^"]*)"|'([^']*)')`,
-            'g'
-        );
-
-        let match: RegExpExecArray | null;
-        const listeners: AreListener[] = [];
-
-        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: AreAttribute): boolean {
-        return prop.raw.trim().startsWith(this.config.bindingDelimiter)
-    }
-
-
-    extractPropValue(prop: AreAttribute, parentStore: AreStore): any {
-
-        if (prop.value == null) {
-            return undefined;
-        }
-
-        // Binding prop (starts with :)
-        if (prop.binding) {
-            const value = prop.value.trim();
-
-            // Static literal binding: :label="'Click'" or :"Click"
-            if (
-                (value.startsWith("'") && value.endsWith("'")) ||
-                (value.startsWith('"') && value.endsWith('"'))
-            ) {
-                return value.slice(1, -1);
-            }
-
-            // Dynamic binding: :label="someKey"
-            // (future: expressions, paths, computed, etc.)
-            return parentStore?.get(value);
-        }
-
-        // Static prop: label="Click"
-        return prop.value;
-    }
-
-
-    replaceInterpolation(template: string, interpolation: AreInterpolation | string, value: any): string {
-        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 !== undefined ? String(value) : '');
-    }
-
-
-}

package/src/lib/AreSyntax/index.ts

@@ -1,4 +0,0 @@
-export { AreSyntax } from './AreSyntax.component';
-export { AreSyntaxContext } from './AreSyntax.context';
-export { AreSyntaxError } from './AreSyntax.error';
-export * from './AreSyntax.types';

package/src/signals/AreInit.signal.ts

@@ -1,7 +0,0 @@
-import { A_Signal } from "@adaas/a-utils/a-signal";
-
-export class AreInitSignal extends A_Signal {
-    static async default(): Promise<A_Signal| undefined> {
-        return new AreInitSignal({ data: { ready: false } });
-    }
-}

package/src/signals/AreRoute.signal.ts

@@ -1,25 +0,0 @@
-import { A_Route } from "@adaas/a-utils/a-route";
-import { A_Signal } from "@adaas/a-utils/a-signal";
-
-
-
-export class AreRouteSignal extends A_Signal<{
-    route: A_Route;
-}> {
-
-    constructor(path: string | RegExp) {
-        super({
-            data: {
-                route: new A_Route(path)
-            }
-        });
-    }
-
-    get route(): A_Route {
-        return this.data.route;
-    }
-
-    static async default(): Promise<A_Signal | undefined> {
-        return new AreRouteSignal(document.location.href);
-    }
-}

package/src/signals/index.ts

@@ -1,2 +0,0 @@
-export { AreInitSignal } from './AreInit.signal';
-export { AreRouteSignal } from './AreRoute.signal'

package/tests/A-HttpChannel.test.ts

@@ -1,204 +0,0 @@
-// import { A_Context, A_Feature, A_Inject, A_Scope } from '@adaas/a-concept';
-// import { A_HTTPChannel } from '@adaas/a-server/channels/A-Http/A-Http.channel';
-// import { A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle } from '@adaas/a-server/channels/A-Http/A-Http.channel.constants';
-// import { A_HTTPChannel_RequestContext } from '@adaas/a-server/context/A-HttpChannel/A-HttpChannel.context';
-
-// jest.retryTimes(0);
-
-
-// type MockResponse = Array<{ userId: number; id: number; title: string; body: string; customField: string }>
-
-// describe('A-HttpChannel Tests', () => {
-//     it('Should be possible to create a new HttpChannel', async () => {
-//         const scope = new A_Scope({
-//             components: [A_HTTPChannel]
-//         });
-
-
-//         const channel = scope.resolve(A_HTTPChannel);
-
-//         expect(channel).toBeInstanceOf(A_HTTPChannel);
-//         expect(channel.processing).toBe(false);
-//     });
-//     it('Should be possible to create a custom Channel', async () => {
-//         class myChannel extends A_HTTPChannel {
-//             custom = true;
-
-//             constructor() {
-//                 super();
-//                 this.baseUrl = "https://jsonplaceholder.typicode.com";
-//             }
-//         }
-
-//         const scope = new A_Scope({
-//             components: [myChannel]
-//         });
-
-//         const channel = scope.resolve(myChannel);
-//         expect(channel).toBeInstanceOf(myChannel);
-//         expect(channel.custom).toBe(true);
-//         expect(channel.processing).toBe(false);
-
-//         const response = await channel.get<MockResponse>(
-//             '/posts',
-//             { userId: 1 }
-//         );
-
-//         expect(Array.isArray(response.result)).toBe(true);
-//         expect(response.result?.length).toBeGreaterThan(0);
-//         expect(response.result?.[0].userId).toBe(1);
-//     });
-
-//     it('Should throw an error if baseUrl is not set', async () => {
-//         const scope = new A_Scope({
-//             components: [A_HTTPChannel]
-//         });
-
-//         const channel = scope.resolve(A_HTTPChannel);
-
-//         await expect(channel.get('/posts')).rejects.toThrow("Base URL is not set for HTTP Channel");
-//     });
-
-//     it('Should allow to extend response handler behavior', async () => {
-//         class myChannel extends A_HTTPChannel {
-//             custom = true;
-//             constructor() {
-//                 super();
-//                 this.baseUrl = "https://jsonplaceholder.typicode.com";
-//             }
-//         }
-
-//         class myChannelWithCustomResponseHandler extends myChannel {
-
-//             @A_Feature.Extend({
-//                 name: A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle.onAfterRequest
-//             })
-//             protected async handleResponse<T>(
-//                 @A_Inject(A_HTTPChannel_RequestContext) context: A_HTTPChannel_RequestContext<MockResponse>
-//             ): Promise<void> {
-//                 context.result = context.result?.map(item => ({
-//                     ...item,
-//                     customField: 'customValue'
-//                 })) || [];
-//             }
-//         }
-
-//         const scope = new A_Scope({
-//             components: [myChannel, myChannelWithCustomResponseHandler]
-//         });
-
-//         const channel = scope.resolve(myChannelWithCustomResponseHandler);
-//         expect(channel).toBeInstanceOf(myChannelWithCustomResponseHandler);
-//         expect(channel.custom).toBe(true);
-//         expect(channel.processing).toBe(false);
-
-//         const response = await channel.get<MockResponse>('/posts', { userId: 1 });
-
-//         expect(Array.isArray(response.result)).toBe(true);
-//         expect(response.result?.length).toBeGreaterThan(0);
-//         expect(response.result?.[0].userId).toBe(1);
-//         expect((response.result?.[0] as any).customField).toBe('customValue');
-//     });
-//     it('Should allow to extend error handler behavior', async () => {
-//         class myChannel extends A_HTTPChannel {
-//             custom = true;
-//             constructor() {
-//                 super();
-//                 this.baseUrl = "https://jsonplaceholder.typicode.com";
-//             }
-//         }
-
-//         class myChannelWithCustomErrorHandler extends myChannel {
-//             @A_Feature.Extend({
-//                 name: A_SERVER_CONSTANTS__A_HttpChannel_Lifecycle.onError
-//             })
-//             protected async handleError(
-//                 @A_Inject(A_HTTPChannel_RequestContext) context: A_HTTPChannel_RequestContext<MockResponse>,
-//                 error: any
-//             ): Promise<void> {
-//                 context.result = [{
-//                     userId: -1,
-//                     id: -1,
-//                     title: 'error',
-//                     body: 'error',
-//                     customField: 'customValue'
-//                 }];
-//             }
-//         }
-
-//         const scope = new A_Scope({
-//             components: [myChannel, myChannelWithCustomErrorHandler]
-//         });
-
-//         const channel = scope.resolve(myChannelWithCustomErrorHandler);
-//         expect(channel).toBeInstanceOf(myChannelWithCustomErrorHandler);
-//         expect(channel.custom).toBe(true);
-//         expect(channel.processing).toBe(false);
-
-//         const response = await channel.get<MockResponse>('/posts_invalid', { userId: 1 }, { throwOnError: false });
-
-//         expect(Array.isArray(response.result)).toBe(true);
-//         expect(response.result?.length).toBe(1);
-//         expect(response.result?.[0].userId).toBe(-1);
-//         expect((response.result?.[0] as any).customField).toBe('customValue');
-//     });
-
-//     it('Should do a proper filtering with query params', async () => {
-//         class myChannel extends A_HTTPChannel {
-//             custom = true;
-//             constructor() {
-//                 super();
-//                 this.baseUrl = "https://jsonplaceholder.typicode.com";
-//             }
-//         }
-
-//         const scope = new A_Scope({
-//             components: [myChannel]
-//         });
-
-//         const channel = scope.resolve(myChannel);
-//         expect(channel).toBeInstanceOf(myChannel);
-//         expect(channel.custom).toBe(true);
-//         expect(channel.processing).toBe(false);
-
-//         const response = await channel.get<MockResponse>('/posts', { userId: 1 });
-
-//         expect(Array.isArray(response.result)).toBe(true);
-//         expect(response.result?.length).toBeGreaterThan(0);
-//         expect(response.result?.every(item => item.userId === 1)).toBe(true);
-//     });
-
-//     it('Should be possible to do a POST request', async () => {
-//         class myChannel extends A_HTTPChannel {
-//             custom = true;
-//             constructor() {
-//                 super();
-//                 this.baseUrl = "https://jsonplaceholder.typicode.com";
-//             }
-//         }
-
-//         const scope = new A_Scope({
-//             components: [myChannel]
-//         });
-
-//         const channel = scope.resolve(myChannel);
-//         expect(channel).toBeInstanceOf(myChannel);
-//         expect(channel.custom).toBe(true);
-//         expect(channel.processing).toBe(false);
-
-//         const response = await channel.post<MockResponse>(
-//             '/posts',
-//             {
-//                 title: 'foo',
-//                 body: 'bar',
-//                 userId: 1,
-//             }
-//         );
-
-//         expect(response.result).toBeDefined();
-//         expect((response.result as any).id).toBeDefined();
-//         expect((response.result as any).title).toBe('foo');
-//         expect((response.result as any).body).toBe('bar');
-//         expect((response.result as any).userId).toBe(1);
-//     });
-// });