@aurorajs.dev/core-front 1.0.2 → 1.0.4

package/dist/README.md

@@ -0,0 +1,82 @@
+# @aurorajs.dev/core-front
+
+Shared TypeScript library for Aurora frontend projects. Provides domain-level
+utilities and decorators for managing common UI interactions.
+
+## Installation
+
+```bash
+npm install @aurorajs.dev/core-front
+```
+
+### Peer dependencies
+
+| Package                     | Version |
+| --------------------------- | ------- |
+| `@aurorajs.dev/core-common` | ^1.0.3  |
+
+## Usage
+
+```typescript
+import { BlurActiveElement } from '@aurorajs.dev/core-front';
+```
+
+### Decorators
+
+#### `@BlurActiveElement()`
+
+Method decorator that blurs the currently focused DOM element before executing
+the decorated method. Prevents UI side effects (visible tooltips, pending
+validations, virtual keyboard) when users trigger actions while an input still
+has focus.
+
+```typescript
+class MyComponent {
+  @BlurActiveElement()
+  onSubmit(): void {
+    // the active element is blurred before this runs
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Dev mode with watch
+npm run start:dev
+
+# Build
+npm run build
+
+# Tests
+npm test
+npm run test:watch
+npm run test:cov
+
+# Formatting & linting
+npm run format
+npm run lint
+```
+
+## Build
+
+Built with **tsup** producing dual CJS/ESM output targeting ES2021:
+
+| Output            | Path              |
+| ----------------- | ----------------- |
+| ESM               | `dist/index.js`   |
+| CJS               | `dist/index.cjs`  |
+| Type declarations | `dist/index.d.ts` |
+
+## Publishing
+
+```bash
+make publish
+```
+
+## License
+
+MIT

package/dist/domain/decorators/blur-active-element.decorator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Method decorator that blurs the currently focused DOM element
+ * before executing the decorated method.
+ *
+ * Prevents UI side effects (visible tooltips, pending validations,
+ * virtual keyboard on mobile) when the user triggers an action
+ * while an input still holds focus.
+ *
+ * @example
+ * ```typescript
+ * @BlurActiveElement()
+ * onSave(): void {
+ *     // The active input has already lost focus at this point
+ *     this.doSomething();
+ * }
+ * ```
+ */
+export declare function BlurActiveElement(): MethodDecorator;

package/dist/domain/decorators/index.d.ts

@@ -0,0 +1 @@
+export * from './blur-active-element.decorator';

package/dist/domain/index.d.ts

@@ -0,0 +1,3 @@
+export * from './decorators';
+export * from './pipes';
+export * from './types';

package/dist/{index.d.mts → domain/pipes/enum-order.pipe.d.ts}

@@ -1,26 +1,6 @@
 import { KeyValue } from '@angular/common';
 import { PipeTransform } from '@angular/core';
-import { Operator } from '@aurorajs.dev/core-common';
-
-/**
- * Method decorator that blurs the currently focused DOM element
- * before executing the decorated method.
- *
- * Prevents UI side effects (visible tooltips, pending validations,
- * virtual keyboard on mobile) when the user triggers an action
- * while an input still holds focus.
- *
- * @example
- * ```typescript
- * @BlurActiveElement()
- * onSave(): void {
- *     // The active input has already lost focus at this point
- *     this.doSomething();
- * }
- * ```
- */
-declare function BlurActiveElement(): MethodDecorator;
-
+import * as i0 from "@angular/core";
 /**
  * Converts a TypeScript string enum into a sorted `KeyValue<string, string>[]`
  * array, using a custom priority order.
@@ -56,10 +36,8 @@ declare function BlurActiveElement(): MethodDecorator;
  * @for (type of MyEnum | enumOrder; track type.key) { ... }
  * ```
  */
-declare class EnumOrderPipe implements PipeTransform {
+export declare class EnumOrderPipe implements PipeTransform {
     transform(enumObj: Record<string, string>, order?: string[]): KeyValue<string, string>[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<EnumOrderPipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<EnumOrderPipe, "enumOrder", true>;
 }
-
-type ContactOperator = Operator.and | Operator.or;
-
-export { BlurActiveElement, type ContactOperator, EnumOrderPipe };

package/dist/domain/pipes/index.d.ts

@@ -0,0 +1 @@
+export * from './enum-order.pipe';

package/dist/domain/types/aurora.types.d.ts

@@ -0,0 +1,2 @@
+import { Operator } from '@aurorajs.dev/core-common';
+export type ContactOperator = Operator.and | Operator.or;

package/dist/domain/types/index.d.ts

@@ -0,0 +1 @@
+export * from './aurora.types';

package/dist/fesm2022/aurorajs.dev-core-front.mjs

@@ -0,0 +1,99 @@
+import * as i0 from '@angular/core';
+import { Pipe } from '@angular/core';
+
+/**
+ * Method decorator that blurs the currently focused DOM element
+ * before executing the decorated method.
+ *
+ * Prevents UI side effects (visible tooltips, pending validations,
+ * virtual keyboard on mobile) when the user triggers an action
+ * while an input still holds focus.
+ *
+ * @example
+ * ```typescript
+ * @BlurActiveElement()
+ * onSave(): void {
+ *     // The active input has already lost focus at this point
+ *     this.doSomething();
+ * }
+ * ```
+ */
+function BlurActiveElement() {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        descriptor.value = function (...args) {
+            const active = document.activeElement;
+            if (active && typeof active.blur === 'function') {
+                active.blur();
+            }
+            return originalMethod.apply(this, args);
+        };
+        return descriptor;
+    };
+}
+
+/**
+ * Converts a TypeScript string enum into a sorted `KeyValue<string, string>[]`
+ * array, using a custom priority order.
+ *
+ * Enum keys present in the `order` array are sorted by their position;
+ * keys **not** included are appended at the end in their original declaration order.
+ *
+ * This pipe is **pure** — Angular only re-evaluates it when the input
+ * reference changes.
+ *
+ * @example
+ * ```html
+ * <!-- basic usage with custom order -->
+ * <mat-select formControlName="type">
+ *   @for (type of MyEnum | enumOrder: myOrder; track type.key) {
+ *     <mat-option [value]="type.key">{{ type.value }}</mat-option>
+ *   }
+ * </mat-select>
+ * ```
+ *
+ * ```typescript
+ * // in the component
+ * myOrder: string[] = [
+ *   MyEnum.FIRST,
+ *   MyEnum.SECOND,
+ *   MyEnum.THIRD,
+ * ];
+ * ```
+ *
+ * @example
+ * ```html
+ * <!-- without order array — keeps original enum declaration order -->
+ * @for (type of MyEnum | enumOrder; track type.key) { ... }
+ * ```
+ */
+class EnumOrderPipe {
+    transform(enumObj, order = []) {
+        const entries = Object.keys(enumObj).map((key) => ({
+            key,
+            value: enumObj[key],
+        }));
+        return entries.sort((a, b) => {
+            const indexA = order.indexOf(a.key);
+            const indexB = order.indexOf(b.key);
+            return ((indexA === -1 ? order.length : indexA) -
+                (indexB === -1 ? order.length : indexB));
+        });
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.18", ngImport: i0, type: EnumOrderPipe, deps: [], target: i0.ɵɵFactoryTarget.Pipe });
+    static ɵpipe = i0.ɵɵngDeclarePipe({ minVersion: "14.0.0", version: "19.2.18", ngImport: i0, type: EnumOrderPipe, isStandalone: true, name: "enumOrder" });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.18", ngImport: i0, type: EnumOrderPipe, decorators: [{
+            type: Pipe,
+            args: [{
+                    name: 'enumOrder',
+                    pure: true,
+                }]
+        }] });
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { BlurActiveElement, EnumOrderPipe };
+//# sourceMappingURL=aurorajs.dev-core-front.mjs.map

package/dist/fesm2022/aurorajs.dev-core-front.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"aurorajs.dev-core-front.mjs","sources":["../../src/domain/decorators/blur-active-element.decorator.ts","../../src/domain/pipes/enum-order.pipe.ts","../../src/aurorajs.dev-core-front.ts"],"sourcesContent":["/**\n * Method decorator that blurs the currently focused DOM element\n * before executing the decorated method.\n *\n * Prevents UI side effects (visible tooltips, pending validations,\n * virtual keyboard on mobile) when the user triggers an action\n * while an input still holds focus.\n *\n * @example\n * ```typescript\n * @BlurActiveElement()\n * onSave(): void {\n *     // The active input has already lost focus at this point\n *     this.doSomething();\n * }\n * ```\n */\nexport function BlurActiveElement(): MethodDecorator {\n  return (\n    target: any,\n    propertyKey: string | symbol,\n    descriptor: PropertyDescriptor,\n  ) => {\n    const originalMethod = descriptor.value;\n\n    descriptor.value = function (...args: any[]) {\n      const active = document.activeElement as HTMLElement | null;\n\n      if (active && typeof active.blur === 'function') {\n        active.blur();\n      }\n\n      return originalMethod.apply(this, args);\n    };\n\n    return descriptor;\n  };\n}\n","import { KeyValue } from '@angular/common';\nimport { Pipe, PipeTransform } from '@angular/core';\n\n/**\n * Converts a TypeScript string enum into a sorted `KeyValue<string, string>[]`\n * array, using a custom priority order.\n *\n * Enum keys present in the `order` array are sorted by their position;\n * keys **not** included are appended at the end in their original declaration order.\n *\n * This pipe is **pure** — Angular only re-evaluates it when the input\n * reference changes.\n *\n * @example\n * ```html\n * <!-- basic usage with custom order -->\n * <mat-select formControlName=\"type\">\n *   @for (type of MyEnum | enumOrder: myOrder; track type.key) {\n *     <mat-option [value]=\"type.key\">{{ type.value }}</mat-option>\n *   }\n * </mat-select>\n * ```\n *\n * ```typescript\n * // in the component\n * myOrder: string[] = [\n *   MyEnum.FIRST,\n *   MyEnum.SECOND,\n *   MyEnum.THIRD,\n * ];\n * ```\n *\n * @example\n * ```html\n * <!-- without order array — keeps original enum declaration order -->\n * @for (type of MyEnum | enumOrder; track type.key) { ... }\n * ```\n */\n@Pipe({\n  name: 'enumOrder',\n  pure: true,\n})\nexport class EnumOrderPipe implements PipeTransform {\n  transform(\n    enumObj: Record<string, string>,\n    order: string[] = [],\n  ): KeyValue<string, string>[] {\n    const entries: KeyValue<string, string>[] = Object.keys(enumObj).map(\n      (key) => ({\n        key,\n        value: enumObj[key],\n      }),\n    );\n\n    return entries.sort((a, b) => {\n      const indexA = order.indexOf(a.key);\n      const indexB = order.indexOf(b.key);\n\n      return (\n        (indexA === -1 ? order.length : indexA) -\n        (indexB === -1 ? order.length : indexB)\n      );\n    });\n  }\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;AAgBG;SACa,iBAAiB,GAAA;AAC/B,IAAA,OAAO,CACL,MAAW,EACX,WAA4B,EAC5B,UAA8B,KAC5B;AACF,QAAA,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK;AAEvC,QAAA,UAAU,CAAC,KAAK,GAAG,UAAU,GAAG,IAAW,EAAA;AACzC,YAAA,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAmC;YAE3D,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE;gBAC/C,MAAM,CAAC,IAAI,EAAE;YACf;YAEA,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;AACzC,QAAA,CAAC;AAED,QAAA,OAAO,UAAU;AACnB,IAAA,CAAC;AACH;;AClCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCG;MAKU,aAAa,CAAA;AACxB,IAAA,SAAS,CACP,OAA+B,EAC/B,KAAA,GAAkB,EAAE,EAAA;AAEpB,QAAA,MAAM,OAAO,GAA+B,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,CAClE,CAAC,GAAG,MAAM;YACR,GAAG;AACH,YAAA,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC;AACpB,SAAA,CAAC,CACH;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAI;YAC3B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;YACnC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;AAEnC,YAAA,QACE,CAAC,MAAM,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM;AACtC,iBAAC,MAAM,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;AAE3C,QAAA,CAAC,CAAC;IACJ;wGArBW,aAAa,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,IAAA,EAAA,CAAA;sGAAb,aAAa,EAAA,YAAA,EAAA,IAAA,EAAA,IAAA,EAAA,WAAA,EAAA,CAAA;;4FAAb,aAAa,EAAA,UAAA,EAAA,CAAA;kBAJzB,IAAI;AAAC,YAAA,IAAA,EAAA,CAAA;AACJ,oBAAA,IAAI,EAAE,WAAW;AACjB,oBAAA,IAAI,EAAE,IAAI;AACX,iBAAA;;;ACzCD;;AAEG;;;;"}

package/dist/index.d.ts

@@ -1,65 +1 @@
-import { KeyValue } from '@angular/common';
-import { PipeTransform } from '@angular/core';
-import { Operator } from '@aurorajs.dev/core-common';
-
-/**
- * Method decorator that blurs the currently focused DOM element
- * before executing the decorated method.
- *
- * Prevents UI side effects (visible tooltips, pending validations,
- * virtual keyboard on mobile) when the user triggers an action
- * while an input still holds focus.
- *
- * @example
- * ```typescript
- * @BlurActiveElement()
- * onSave(): void {
- *     // The active input has already lost focus at this point
- *     this.doSomething();
- * }
- * ```
- */
-declare function BlurActiveElement(): MethodDecorator;
-
-/**
- * Converts a TypeScript string enum into a sorted `KeyValue<string, string>[]`
- * array, using a custom priority order.
- *
- * Enum keys present in the `order` array are sorted by their position;
- * keys **not** included are appended at the end in their original declaration order.
- *
- * This pipe is **pure** — Angular only re-evaluates it when the input
- * reference changes.
- *
- * @example
- * ```html
- * <!-- basic usage with custom order -->
- * <mat-select formControlName="type">
- *   @for (type of MyEnum | enumOrder: myOrder; track type.key) {
- *     <mat-option [value]="type.key">{{ type.value }}</mat-option>
- *   }
- * </mat-select>
- * ```
- *
- * ```typescript
- * // in the component
- * myOrder: string[] = [
- *   MyEnum.FIRST,
- *   MyEnum.SECOND,
- *   MyEnum.THIRD,
- * ];
- * ```
- *
- * @example
- * ```html
- * <!-- without order array — keeps original enum declaration order -->
- * @for (type of MyEnum | enumOrder; track type.key) { ... }
- * ```
- */
-declare class EnumOrderPipe implements PipeTransform {
-    transform(enumObj: Record<string, string>, order?: string[]): KeyValue<string, string>[];
-}
-
-type ContactOperator = Operator.and | Operator.or;
-
-export { BlurActiveElement, type ContactOperator, EnumOrderPipe };
+export * from './domain';

package/package.json

@@ -1,31 +1,17 @@
 {
   "name": "@aurorajs.dev/core-front",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "Aurora npm core front package",
   "author": "José Carlos Rodríguez Palacín <carlos.rodriguez.palacin@gmail.com>",
   "license": "MIT",
   "readmeFilename": "README.md",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
+  "main": "./dist/esm2022/index.mjs",
   "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.mts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
   "files": [
     "dist"
   ],
   "scripts": {
-    "start:dev": "tsup --watch",
-    "build": "rimraf dist && tsup",
+    "build": "ng-packagr -p ng-package.json",
     "prepare": "husky && npm run build",
     "format": "prettier --write \"src/**/*.ts\"",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
@@ -35,11 +21,12 @@
     "test:e2e": "jest --config ./test/jest-e2e.json"
   },
   "peerDependencies": {
-    "@angular/common": "^19.0.5",
-    "@angular/compiler": "^19.0.5",
+    "@angular/common": ">=19.0.0",
+    "@angular/compiler": ">=19.0.0",
     "@aurorajs.dev/core-common": "^1.0.3"
   },
   "devDependencies": {
+    "@angular/compiler-cli": "^19.2.18",
     "@aurorajs.dev/core-common": "^1.0.3",
     "@commitlint/cli": "^20.4.1",
     "@commitlint/config-conventional": "^20.4.1",
@@ -50,6 +37,7 @@
     "eslint-plugin-prettier": "^5.5.5",
     "husky": "^9.1.7",
     "jest": "^30.0.0",
+    "ng-packagr": "^19.2.2",
     "prettier": "^3.8.1",
     "prettier-plugin-organize-attributes": "^1.0.0",
     "prettier-plugin-organize-imports": "^4.3.0",
@@ -57,7 +45,7 @@
     "rimraf": "^6.1.2",
     "ts-jest": "^29.4.6",
     "tsup": "^8.5.0",
-    "typescript": "^5.9.3",
+    "typescript": "~5.8.0",
     "typescript-eslint": "^8.55.0"
   },
   "jest": {