@asor-studio/asor-cli 1.0.0

package/gen-template/setup-asor-core/src/app/pages/page-home/home.component.ts.template

@@ -0,0 +1,99 @@
+import { Component } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { BaseStorageComponent, TranslatePipe, ConsoleLogsUtility } from '@asor-studio/asor-core';
+import { IAppSystemStatus } from '../../config/interfaces/app-state.interfaces';
+import { SampleWidgetMolecule } from '../../molecules/molecule-sample-widget/sample-widget.molecule';
+import { ASOR_CORE_LOGO_BASE64 } from './asor-logo';
+
+/**
+ * Page Component: PageHomeComponent
+ *
+ * ATOMIC DESIGN ROLE:
+ * A Page is the highest level of the atomic design hierarchy. It orchestrates atoms, molecules, and organisms
+ * to form a complete functional view or screen of the application.
+ *
+ * I18N / TRANSLATIONS:
+ * Translations for this page can be found (or added) in:
+ * `assets/i18n/<prefix>/page-home/<lang>.json`
+ *
+ * ROUTE CONFIGURATION:
+ * This page is directly mapped to a route in `src/app/app.routes.ts`.
+ * Configuration for its components (Atoms, Molecules, Organisms) is managed via the `data` property of the route.
+ */
+@Component({
+    selector: 'app-home-page',
+    standalone: true,
+    imports: [CommonModule, TranslatePipe, SampleWidgetMolecule],
+    templateUrl: './home.component.html',
+})
+export class PageHomeComponent extends BaseStorageComponent<IAppSystemStatus> {
+    /**
+     * Unique identifier for the component class.
+     * CRITICAL for asor-core: used by the framework to identify this component
+     * within route metadata and correctly resolve its configuration/i18n paths.
+     */
+    public static override readonly className: string = 'PageHomeComponent';
+    public asorLogo = ASOR_CORE_LOGO_BASE64;
+    public isStateSectionHighlighted: boolean = false;
+    public widgetHighlightToken: number = 0;
+    private stateHighlightTimeoutId: ReturnType<typeof setTimeout> | null = null;
+
+    constructor() {
+        super();
+    }
+
+    public toggleMenu(): void {
+        this.props.isMenuOpen = !this.props.isMenuOpen;
+        this.triggerInteractiveHighlight();
+    }
+
+    public changeUser(): void {
+        this.props.currentUser = this.props.currentUser === 'Admin' ? 'Guest' : 'Admin';
+        this.triggerInteractiveHighlight();
+    }
+
+    private triggerInteractiveHighlight(): void {
+        this.widgetHighlightToken += 1;
+        this.isStateSectionHighlighted = false;
+
+        if (this.stateHighlightTimeoutId) {
+            clearTimeout(this.stateHighlightTimeoutId);
+        }
+
+        setTimeout(() => {
+            this.isStateSectionHighlighted = true;
+
+            this.stateHighlightTimeoutId = setTimeout(() => {
+                this.isStateSectionHighlighted = false;
+                this.stateHighlightTimeoutId = null;
+            }, 820);
+        }, 0);
+    }
+
+    /**
+     * Lifecycle hook invoked when the storage-backed state changes.
+     * Useful for observing app-state mutations propagated by the shared storage layer.
+     */
+    override storageHandlerDataChanges(prev: IAppSystemStatus, curr: IAppSystemStatus): void {
+        ConsoleLogsUtility.info(this, 'Mutable App State:', prev, '->', curr);
+    }
+
+    /**
+     * Lifecycle hook called when the component view is about to enter at a generic level.
+     * Used for system-wide initialization logic common to all asor components.
+     */
+    override baseCompViewEnter(): void {
+        super.baseCompViewEnter();
+        ConsoleLogsUtility.info(this, 'Homepage loaded and registered to StateService!');
+
+        if (typeof window !== 'undefined') {
+            setTimeout(() => {
+                const asorStudioSection = document.getElementById('home-asor-studio');
+                asorStudioSection?.scrollIntoView({
+                    behavior: 'smooth',
+                    block: 'start',
+                });
+            }, 150);
+        }
+    }
+}

package/gen-template/setup-asor-core/src/assets/i18n/app/molecule-sample-widget/en.json.template

@@ -0,0 +1,7 @@
+{
+    "SAMPLE_WIDGET.TITLE": "My First Widget",
+    "SAMPLE_WIDGET.RESPONSIVE": "I am a responsive molecule",
+    "SAMPLE_WIDGET.MENU_STATUS": "Menu Status",
+    "SAMPLE_WIDGET.OPEN": "Open",
+    "SAMPLE_WIDGET.CLOSED": "Closed"
+}

package/gen-template/setup-asor-core/src/assets/i18n/app/molecule-sample-widget/it.json.template

@@ -0,0 +1,7 @@
+{
+    "SAMPLE_WIDGET.TITLE": "Il Mio Primo Widget",
+    "SAMPLE_WIDGET.RESPONSIVE": "Sono una molecola responsiva",
+    "SAMPLE_WIDGET.MENU_STATUS": "Stato Menu",
+    "SAMPLE_WIDGET.OPEN": "Aperto",
+    "SAMPLE_WIDGET.CLOSED": "Chiuso"
+}

package/gen-template/setup-asor-core/src/assets/i18n/app/page-home/en.json.template

@@ -0,0 +1,19 @@
+{
+    "HOME.GLOBAL_APP_STATE": "Global App State",
+    "HOME.VERSION": "Version",
+    "HOME.MENU": "Menu",
+    "HOME.OPEN": "Open",
+    "HOME.CLOSED": "Closed",
+    "HOME.USER": "User",
+    "HOME.UNDEFINED": "Undefined",
+    "HOME.SIMULATE_AUTH": "Simulate Auth Interaction",
+    "HOME.CLOSE_MENU": "Close Menu",
+    "HOME.OPEN_MENU": "Open Menu",
+    "HOME.DASHBOARD": "Dashboard",
+    "HOME.SETTINGS": "Settings",
+    "HOME.LOGOUT": "Logout",
+    "HOME.WELCOME_MESSAGE": "Welcome to your first ASOR page",
+    "HOME.WELCOME_ROBROSC": "Welcome to Asor-Core create by robrosc",
+    "HOME.CONGRATULATIONS": "Congratulations! Your state-managed app is running.",
+    "HOME.OBSERVING_REACTIVE_PROXY": "This layout is observing the reactive Proxy DataSet"
+}

package/gen-template/setup-asor-core/src/assets/i18n/app/page-home/it.json.template

@@ -0,0 +1,19 @@
+{
+    "HOME.GLOBAL_APP_STATE": "Stato Globale dell'App",
+    "HOME.VERSION": "Versione",
+    "HOME.MENU": "Menu",
+    "HOME.OPEN": "Aperto",
+    "HOME.CLOSED": "Chiuso",
+    "HOME.USER": "Utente",
+    "HOME.UNDEFINED": "Non definito",
+    "HOME.SIMULATE_AUTH": "Simula Interazione Auth",
+    "HOME.CLOSE_MENU": "Chiudi Menu",
+    "HOME.OPEN_MENU": "Apri Menu",
+    "HOME.DASHBOARD": "Bacheca",
+    "HOME.SETTINGS": "Impostazioni",
+    "HOME.LOGOUT": "Esci",
+    "HOME.WELCOME_MESSAGE": "Benvenuto nella tua prima pagina ASOR",
+    "HOME.WELCOME_ROBROSC": "Benvenuto in Asor-Core creato da robrosc",
+    "HOME.CONGRATULATIONS": "Congratulazioni! La tua app gestita a stati e in esecuzione.",
+    "HOME.OBSERVING_REACTIVE_PROXY": "Questo layout sta osservando il Proxy DataSet reattivo"
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+	"name": "@asor-studio/asor-cli",
+	"version": "1.0.0",
+	"description": "CLI tool to initialize Angular projects with @asor-studio/asor-core",
+	"main": "./cli-command/setup-asor-core.js",
+	"bin": {
+		"asor": "./cli.js"
+	},
+	"scripts": {
+		"test": "node --test ./test/*.test.js"
+	},
+	"files": [
+		"cli.js",
+		"cli-command/",
+		"gen-template/",
+		"README.md",
+		"LICENSE"
+	],
+	"keywords": [
+		"asor",
+		"asor-core",
+		"angular",
+		"cli",
+		"scaffold"
+	],
+	"author": "robrosc",
+	"license": "SEE LICENSE IN LICENSE",
+	"engines": {
+		"node": ">=18.0.0"
+	}
+}