@adaas/are 0.0.2 → 0.0.4

package/.conf/tsconfig.base.json

@@ -4,7 +4,7 @@
    "compilerOptions": {
       "rootDir": "../",
       "useDefineForClassFields": false,
-      // "isolatedModules": true,
+      "isolatedModules": true,
 
       /* ===============================
          Output (tsup controls formats)
@@ -57,42 +57,35 @@
       "experimentalDecorators": true,
 
       /* ===============================
-         Internal path aliases ONLY
+         Internal path aliases
          =============================== */
       "baseUrl": ".",
       "paths": {
-         //  default exports of common modules
-         "@adaas/are/helpers/*": ["src/helpers/*"],
-         "@adaas/are/constants/*": ["src/constants/*"],
+         // ── Helpers & constants ──────────────────────────
+         "@adaas/are/helpers/*":     ["../src/helpers/*"],
+         "@adaas/are/constants/*":   ["../src/constants/*"],
 
-         //  A-Concept specific paths aliases
-         "@adaas/are/channels/*": ["src/channels/*"],
-         // "@adaas/are/entities/*": ["src/entities/*"],
-         // "@adaas/are/context/*": ["src/context/*"],
-         // "@adaas/are/components/*": ["src/components/*"],
-         "@adaas/are/containers/*": ["src/containers/*"],
+         // ── Core library (wildcard — resolves any file inside the folder) ──
+         "@adaas/are/loader/*":       ["../src/lib/AreLoader/*"],
+         "@adaas/are/tokenizer/*":    ["../src/lib/AreTokenizer/*"],
+         "@adaas/are/compiler/*":     ["../src/lib/AreCompiler/*"],
+         "@adaas/are/transformer/*":  ["../src/lib/AreTransformer/*"],
+         "@adaas/are/interpreter/*":  ["../src/lib/AreInterpreter/*"],
+         "@adaas/are/lifecycle/*":    ["../src/lib/AreLifecycle/*"],
+         "@adaas/are/component/*":    ["../src/lib/AreComponent/*"],
+         "@adaas/are/event/*":        ["../src/lib/AreEvent/*"],
+         "@adaas/are/node/*":         ["../src/lib/AreNode/*"],
+         "@adaas/are/store/*":        ["../src/lib/AreStore/*"],
+         "@adaas/are/scene/*":        ["../src/lib/AreScene/*"],
+         "@adaas/are/instruction/*":  ["../src/lib/AreInstruction/*"],
+         "@adaas/are/syntax/*":       ["../src/lib/AreSyntax/*"],
+         "@adaas/are/attribute/*":    ["../src/lib/AreAttribute/*"],
+         "@adaas/are/watcher/*":      ["../src/lib/AreWatcher/*"],
+         "@adaas/are/signals/*":      ["../src/lib/AreSignals/*"],
+         "@adaas/are/engine/*":       ["../src/lib/AreEngine/*"],
 
-
-         //  main library exports
-         "@adaas/are/app": ["src/lib/AreApp/index.ts"],
-         "@adaas/are/compiler": ["src/lib/AreCompiler/index.ts"],
-         "@adaas/are/component": ["src/lib/AreComponent/index.ts"],
-         "@adaas/are/event": ["src/lib/AreEvent/index.ts"],
-         "@adaas/are/index": ["src/lib/AreIndex/index.ts"],
-         "@adaas/are/node": ["src/lib/AreNode/index.ts"],
-         "@adaas/are/props": ["src/lib/AreProps/index.ts"],
-         "@adaas/are/store": ["src/lib/AreStore/index.ts"],
-         "@adaas/are/root": ["src/lib/AreRoot/index.ts"],
-         "@adaas/are/router": ["src/lib/AreRouter/index.ts"],
-         "@adaas/are/scene": ["src/lib/AreScene/index.ts"],
-         "@adaas/are/scene-instruction": ["src/lib/AreSceneInstruction/index.ts"],
-         "@adaas/are/slot": ["src/lib/AreSlot/index.ts"],
-         "@adaas/are/syntax": ["src/lib/AreSyntax/index.ts"],
-         "@adaas/are/signals": ["src/signals/index.ts"],
-
-
-         //  exported engines
-         "@adaas/are/engines/html": ["src/engines/html/index.ts"],
+         // ── Exported engines ────────────────────────────
+         "@adaas/are/engines/html/*": ["../src/engines/html/*"],
       },
       /* ===============================
          Types

package/.conf/tsconfig.browser.json

@@ -2,42 +2,34 @@
    "extends": "./tsconfig.base.json",
    "compilerOptions": {
       "rootDir": "../",
-      "outDir": "dist/browser",
+      "outDir": "../dist/browser",
       "baseUrl": "../",
-
       "paths": {
-         //  default exports of common modules
-         "@adaas/are/helpers/*": ["src/helpers/*"],
-         "@adaas/are/constants/*": ["src/constants/*"],
-
-         //  A-Concept specific paths aliases
-         "@adaas/are/channels/*": ["src/channels/*"],
-         // "@adaas/are/entities/*": ["src/entities/*"],
-         // "@adaas/are/context/*": ["src/context/*"],
-         // "@adaas/are/components/*": ["src/components/*"],
-         "@adaas/are/containers/*": ["src/containers/*"],
-
-
-         //  main library exports
-         "@adaas/are/app": ["src/lib/AreApp/index.ts"],
-         "@adaas/are/compiler": ["src/lib/AreCompiler/index.ts"],
-         "@adaas/are/component": ["src/lib/AreComponent/index.ts"],
-         "@adaas/are/event": ["src/lib/AreEvent/index.ts"],
-         "@adaas/are/index": ["src/lib/AreIndex/index.ts"],
-         "@adaas/are/node": ["src/lib/AreNode/index.ts"],
-         "@adaas/are/props": ["src/lib/AreProps/index.ts"],
-         "@adaas/are/store": ["src/lib/AreStore/index.ts"],
-         "@adaas/are/root": ["src/lib/AreRoot/index.ts"],
-         "@adaas/are/router": ["src/lib/AreRouter/index.ts"],
-         "@adaas/are/scene": ["src/lib/AreScene/index.ts"],
-         "@adaas/are/scene-instruction": ["src/lib/AreSceneInstruction/index.ts"],
-         "@adaas/are/slot": ["src/lib/AreSlot/index.ts"],
-         "@adaas/are/syntax": ["src/lib/AreSyntax/index.ts"],
-         "@adaas/are/signals": ["src/signals/index.ts"],
+         // ── Helpers & constants ──────────────────────────
+         "@adaas/are/helpers/*":     ["src/helpers/*"],
+         "@adaas/are/constants/*":   ["src/constants/*"],
 
+         // ── Core library ───────────────────────────────────
+         "@adaas/are/loader/*":       ["src/lib/AreLoader/*"],
+         "@adaas/are/tokenizer/*":    ["src/lib/AreTokenizer/*"],
+         "@adaas/are/compiler/*":     ["src/lib/AreCompiler/*"],
+         "@adaas/are/transformer/*":  ["src/lib/AreTransformer/*"],
+         "@adaas/are/interpreter/*":  ["src/lib/AreInterpreter/*"],
+         "@adaas/are/lifecycle/*":    ["src/lib/AreLifecycle/*"],
+         "@adaas/are/component/*":    ["src/lib/AreComponent/*"],
+         "@adaas/are/event/*":        ["src/lib/AreEvent/*"],
+         "@adaas/are/node/*":         ["src/lib/AreNode/*"],
+         "@adaas/are/store/*":        ["src/lib/AreStore/*"],
+         "@adaas/are/scene/*":        ["src/lib/AreScene/*"],
+         "@adaas/are/instruction/*":  ["src/lib/AreInstruction/*"],
+         "@adaas/are/syntax/*":       ["src/lib/AreSyntax/*"],
+         "@adaas/are/attribute/*":    ["src/lib/AreAttribute/*"],
+         "@adaas/are/watcher/*":      ["src/lib/AreWatcher/*"],
+         "@adaas/are/signals/*":      ["src/lib/AreSignals/*"],
+         "@adaas/are/engine/*":       ["src/lib/AreEngine/*"],
 
-         //  exported engines
-         "@adaas/are/engines/html": ["src/engines/html/index.ts"],
+         // ── Exported engines ────────────────────────────
+         "@adaas/are/engines/html/*": ["src/engines/html/*"],
       },
    },
 }

package/.conf/tsconfig.node.json

@@ -2,44 +2,35 @@
    "extends": "./tsconfig.base.json",
    "compilerOptions": {
       "rootDir": "../",
-      "outDir": "dist/node",
+      "outDir": "../dist/node",
       "baseUrl": "../",
-
       "paths": {
-         //  default exports of common modules
-         "@adaas/are/helpers/*": ["src/helpers/*"],
-         "@adaas/are/constants/*": ["src/constants/*"],
-
-         //  A-Concept specific paths aliases
-         "@adaas/are/channels/*": ["src/channels/*"],
-         // "@adaas/are/entities/*": ["src/entities/*"],
-         // "@adaas/are/context/*": ["src/context/*"],
-         // "@adaas/are/components/*": ["src/components/*"],
-         "@adaas/are/containers/*": ["src/containers/*"],
-
+         // ── Helpers & constants ──────────────────────────
+         "@adaas/are/helpers/*":     ["src/helpers/*"],
+         "@adaas/are/constants/*":   ["src/constants/*"],
 
-         //  main library exports
-         "@adaas/are/app": ["src/lib/AreApp/index.ts"],
-         "@adaas/are/compiler": ["src/lib/AreCompiler/index.ts"],
-         "@adaas/are/component": ["src/lib/AreComponent/index.ts"],
-         "@adaas/are/event": ["src/lib/AreEvent/index.ts"],
-         "@adaas/are/index": ["src/lib/AreIndex/index.ts"],
-         "@adaas/are/node": ["src/lib/AreNode/index.ts"],
-         "@adaas/are/props": ["src/lib/AreProps/index.ts"],
-         "@adaas/are/store": ["src/lib/AreStore/index.ts"],
-         "@adaas/are/root": ["src/lib/AreRoot/index.ts"],
-         "@adaas/are/router": ["src/lib/AreRouter/index.ts"],
-         "@adaas/are/scene": ["src/lib/AreScene/index.ts"],
-         "@adaas/are/scene-instruction": ["src/lib/AreSceneInstruction/index.ts"],
-         "@adaas/are/slot": ["src/lib/AreSlot/index.ts"],
-         "@adaas/are/syntax": ["src/lib/AreSyntax/index.ts"],
-         "@adaas/are/signals": ["src/signals/index.ts"],
+         // ── Core library ───────────────────────────────────
+         "@adaas/are/loader/*":       ["src/lib/AreLoader/*"],
+         "@adaas/are/tokenizer/*":    ["src/lib/AreTokenizer/*"],
+         "@adaas/are/compiler/*":     ["src/lib/AreCompiler/*"],
+         "@adaas/are/transformer/*":  ["src/lib/AreTransformer/*"],
+         "@adaas/are/interpreter/*":  ["src/lib/AreInterpreter/*"],
+         "@adaas/are/lifecycle/*":    ["src/lib/AreLifecycle/*"],
+         "@adaas/are/component/*":    ["src/lib/AreComponent/*"],
+         "@adaas/are/event/*":        ["src/lib/AreEvent/*"],
+         "@adaas/are/node/*":         ["src/lib/AreNode/*"],
+         "@adaas/are/store/*":        ["src/lib/AreStore/*"],
+         "@adaas/are/scene/*":        ["src/lib/AreScene/*"],
+         "@adaas/are/instruction/*":  ["src/lib/AreInstruction/*"],
+         "@adaas/are/syntax/*":       ["src/lib/AreSyntax/*"],
+         "@adaas/are/attribute/*":    ["src/lib/AreAttribute/*"],
+         "@adaas/are/watcher/*":      ["src/lib/AreWatcher/*"],
+         "@adaas/are/signals/*":      ["src/lib/AreSignals/*"],
+         "@adaas/are/engine/*":       ["src/lib/AreEngine/*"],
 
-
-         //  exported engines
-         "@adaas/are/engines/html": ["src/engines/html/index.ts"],
+         // ── Exported engines ────────────────────────────
+         "@adaas/are/engines/html/*": ["src/engines/html/*"],
       },
-
       "types": [
          "node"
       ],

package/CHANGELOG.md

@@ -0,0 +1,39 @@
+# Changelog
+
+All notable changes to `@adaas/are` will be documented in this file.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [Unreleased]
+
+### Added
+- `@A_Frame.Component` decorator to `AreTokenizer` and `AreSignals`
+- `@A_Frame.Entity` decorator to `AreInstruction`, `AreSignal`, `AreMutation`, and `AreDeclaration`
+- Full barrel exports in `src/index.ts`
+- HTML engine re-exported from package root
+- `external` field in `tsup.config.ts` to exclude `@adaas/*` peer dependencies from bundles
+
+### Changed
+- All `../../` relative imports in `src/lib/` replaced with `@adaas/are/*` tsconfig path aliases
+- tsconfig path aliases in `.conf/tsconfig.base.json`, `.conf/tsconfig.browser.json`, and `.conf/tsconfig.node.json` updated to match actual library structure
+- Fixed `outDir` paths in browser and node tsconfig files
+- Release script now runs `npm test` before building, uses `npm version` lifecycle hooks properly, and publishes in `postversion`
+- Removed `@A_Frame.Method` decorators from `AreTokenizer` methods (class-level decorators only)
+
+---
+
+## [0.0.2] - 2024-06-01
+
+### Added
+- Initial release of the A-Concept Rendering Engine
+- Full rendering pipeline: `AreLoader` → `AreTokenizer` → `AreCompiler` → `AreTransformer` → `AreInterpreter`
+- Signal sub-system: `AreSignals`, `AreInit`, `AreRoute`
+- `AreScene` and `AreStore` for reactive state management
+- `AreInstruction`, `AreDeclaration`, `AreMutation` for deterministic DOM updates
+- `AreLifecycle` and `AreWatcher` for component lifecycle management
+- HTML engine (`engines/html`) with DOM interpreter and HTML-specific tokenizer/compiler
+- `AreSyntax` for defining custom template syntax rules
+- `AreNode` and `AreAttribute` as the base AST entities
+- `tsup` dual build (browser ESM + node CJS/ESM)

package/LICENSE

@@ -1,22 +1,13 @@
-(The MIT License)
+Copyright (c) 2026 ADAAS YAZILIM LİMİTED ŞİRKETİ and affiliates.
 
-Copyright (c) 2025 ADAAS <https://adaas.org>
+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
 
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
+    http://www.apache.org/licenses/LICENSE-2.0
 
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+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/README.md

@@ -1,2 +1,216 @@
-# adaas-are
-adaas-are
+# # @adaas/are — A-Concept Rendering Engine
+
+[![npm version](https://img.shields.io/npm/v/@adaas/are.svg)](https://www.npmjs.com/package/@adaas/are)
+[![license](https://img.shields.io/npm/l/@adaas/are.svg)](./LICENSE)
+[![build](https://img.shields.io/github/actions/workflow/status/ADAAS-org/adaas-are/ci.yml?branch=main)](https://github.com/ADAAS-org/adaas-are/actions)
+
+**ARE** is a declarative, signal-driven rendering engine built on top of the [A-Concept](https://github.com/ADAAS-org/adaas-a-concept) framework. It provides a full pipeline — tokenization, compilation, transformation, interpretation, and lifecycle management — for building dynamic, component-based UIs.
+
+---
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Core Concepts](#core-concepts)
+  - [Are (component base)](#are-component-base)
+  - [AreEngine](#areengine)
+  - [AreLoader](#areloader)
+  - [AreTokenizer](#aretokenizer)
+  - [AreCompiler](#arecompiler)
+  - [AreInterpreter](#areinterpreter)
+  - [AreScene & AreStore](#arescene--arestore)
+  - [AreSignals](#aresignals)
+  - [AreNode & AreAttribute](#arenode--areattribute)
+  - [AreLifecycle](#arelifecycle)
+  - [HTML Engine](#html-engine)
+- [API Reference](#api-reference)
+- [Building](#building)
+- [Testing](#testing)
+- [License](#license)
+
+---
+
+## Installation
+
+```bash
+npm install @adaas/are
+```
+
+**Peer dependencies** (must be installed separately):
+
+```bash
+npm install @adaas/a-concept @adaas/a-frame @adaas/a-utils
+```
+
+---
+
+## Quick Start
+
+```typescript
+import { AreHTMLEngine, AreHTML } from '@adaas/are';
+import { A_Scope } from '@adaas/a-concept';
+
+// Create a scope and boot the HTML engine
+const scope = new A_Scope();
+const engine = new AreHTMLEngine(scope);
+
+await engine.boot({ target: document.getElementById('app')! });
+```
+
+Define a component:
+
+```typescript
+import { Are, AreSignalsContext, AreInit } from '@adaas/are';
+import { A_Inject, A_Caller } from '@adaas/a-concept';
+import { A_SignalVector } from '@adaas/a-utils/a-signal';
+
+export class MyButton extends Are {
+
+    @Are.Template
+    template(@A_Inject(A_Caller) node: any) {
+        node.setHTML(`<button>Click me</button>`);
+    }
+
+    @Are.onAfterInit
+    afterInit(@A_Inject(A_Caller) node: any, @A_Inject(AreSignalsContext) ctx?: AreSignalsContext) {
+        ctx?.subscribe(node);
+    }
+
+    @Are.Signal
+    async onSignal(@A_Inject(A_Caller) node: any, @A_Inject(A_SignalVector) vector: A_SignalVector) {
+        if (vector.has(AreInit)) {
+            console.log('App initialized!');
+        }
+    }
+}
+```
+
+---
+
+## Core Concepts
+
+### Are (component base)
+
+`Are` is the base class for all ARE-managed UI components. It exposes decorators that map to the rendering lifecycle:
+
+| Decorator | Description |
+|---|---|
+| `@Are.Template` | Renders the component HTML |
+| `@Are.onAfterInit` | Called after the component is initialized in scope |
+| `@Are.onAfterMount` | Called after the component is mounted to the DOM |
+| `@Are.Signal` | Called when a signal vector arrives |
+| `@Are.Data` | Reactive data binding |
+
+### AreEngine
+
+`AreEngine` orchestrates the full rendering pipeline for a given scope. It coordinates loading, tokenization, compilation, transformation, and interpretation phases and emits `AreInit` when the initial render is complete.
+
+### AreLoader
+
+`AreLoader` is responsible for loading the source template (HTML string or remote URL) into the rendering context prior to tokenization.
+
+### AreTokenizer
+
+`AreTokenizer` scans the template source using the `AreSyntax` rules and produces an array of `AreNode` instances that form the template AST.
+
+### AreCompiler
+
+`AreCompiler` traverses the tokenized AST and compiles each node — resolving attributes, directives, interpolations, and event listeners — into a form ready for the transformer.
+
+### AreInterpreter
+
+`AreInterpreter` applies compiled `AreInstruction` objects against the host environment (e.g. DOM) to produce the final rendered output.
+
+### AreScene & AreStore
+
+`AreScene` is a reactive state fragment that tracks the current set of `AreInstruction` objects applied to the rendered output. `AreStore` holds the reactive data model that instructions reference during rendering and updates.
+
+### AreSignals
+
+The signal sub-system provides reactive communication across the component tree:
+
+- **`AreSignals`** — central signal bus that dispatches `A_SignalVector` events to subscribed nodes
+- **`AreSignalsContext`** — fragment that holds the set of subscribed root nodes
+- **`AreInit`** — signal emitted when the engine completes the initial render
+- **`AreRoute`** — signal emitted on route changes
+- **`AreSignal`** — base class for custom signals
+
+### AreNode & AreAttribute
+
+`AreNode` is the base entity for all nodes in the template AST. `AreAttribute` holds parsed attribute data (name, value, binding type) attached to a node.
+
+### AreLifecycle
+
+`AreLifecycle` manages mount / unmount / update lifecycle phases for the component tree, calling the appropriate lifecycle hooks on each `AreNode`.
+
+### HTML Engine
+
+The `engines/html` sub-package provides a concrete HTML-DOM implementation of the ARE pipeline:
+
+| Export | Description |
+|---|---|
+| `AreHTMLEngine` | Entry point — wires all HTML pipeline pieces into a scope |
+| `AreRoot` | Root host component mounted at the target DOM element |
+| `AreHTMLNode` | Base class for all HTML-aware node types |
+| `AreHTMLCompiler` | HTML-specific compilation pass |
+| `AreHTMLTokenizer` | HTML syntax tokenizer |
+| `DOMInterpreter` | Applies instructions to the real DOM |
+
+---
+
+## API Reference
+
+All public exports are available from the package root:
+
+```typescript
+import {
+    // Core
+    Are, AreContext,
+    // Pipeline
+    AreEngine, AreLoader, AreTokenizer, AreCompiler, AreTransformer, AreInterpreter,
+    // AST
+    AreNode, AreAttribute,
+    // State
+    AreScene, AreStore,
+    // Instructions
+    AreInstruction, AreDeclaration, AreMutation,
+    // Lifecycle
+    AreLifecycle, AreWatcher,
+    // Signals
+    AreSignal, AreSignals, AreSignalsContext, AreInit, AreRoute,
+    // Syntax
+    AreSyntax,
+    // HTML engine (re-exports)
+    AreHTMLEngine,
+} from '@adaas/are';
+```
+
+---
+
+## Building
+
+```bash
+npm run build
+```
+
+Produces:
+- `dist/browser/` — ESM bundle targeting modern browsers
+- `dist/node/` — CJS + ESM bundle for Node.js
+
+---
+
+## Testing
+
+```bash
+npm test
+```
+
+---
+
+## License
+This project is licensed under the Apache License 2.0.
+
+© 2026 ADAAS YAZILIM LİMİTED ŞİRKETİ. All rights reserved.
+All original code and concepts are the intellectual property of ADAAS YAZILIM LİMİTED ŞİRKETİ.
+