@aurorajs.dev/core-front 1.0.1

package/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/index.cjs

@@ -0,0 +1,45 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BlurActiveElement: () => BlurActiveElement
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/domain/decorators/blur-active-element.decorator.ts
+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;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BlurActiveElement
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/domain/decorators/blur-active-element.decorator.ts"],"sourcesContent":["export * from './domain';\n","/**\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,SAAS,oBAAqC;AACnD,SAAO,CACL,QACA,aACA,eACG;AACH,UAAM,iBAAiB,WAAW;AAElC,eAAW,QAAQ,YAAa,MAAa;AAC3C,YAAM,SAAS,SAAS;AAExB,UAAI,UAAU,OAAO,OAAO,SAAS,YAAY;AAC/C,eAAO,KAAK;AAAA,MACd;AAEA,aAAO,eAAe,MAAM,MAAM,IAAI;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,20 @@
+/**
+ * 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;
+
+export { BlurActiveElement };

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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;
+
+export { BlurActiveElement };

package/dist/index.js

@@ -0,0 +1,18 @@
+// src/domain/decorators/blur-active-element.decorator.ts
+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;
+  };
+}
+export {
+  BlurActiveElement
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/domain/decorators/blur-active-element.decorator.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"],"mappings":";AAiBO,SAAS,oBAAqC;AACnD,SAAO,CACL,QACA,aACA,eACG;AACH,UAAM,iBAAiB,WAAW;AAElC,eAAW,QAAQ,YAAa,MAAa;AAC3C,YAAM,SAAS,SAAS;AAExB,UAAI,UAAU,OAAO,OAAO,SAAS,YAAY;AAC/C,eAAO,KAAK;AAAA,MACd;AAEA,aAAO,eAAe,MAAM,MAAM,IAAI;AAAA,IACxC;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@aurorajs.dev/core-front",
+  "version": "1.0.1",
+  "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",
+  "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",
+    "prepare": "husky && npm run build",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:cov": "jest --coverage",
+    "test:e2e": "jest --config ./test/jest-e2e.json"
+  },
+  "peerDependencies": {
+    "@aurorajs.dev/core-common": "^1.0.3"
+  },
+  "devDependencies": {
+    "@aurorajs.dev/core-common": "^1.0.3",
+    "@commitlint/cli": "^20.4.1",
+    "@commitlint/config-conventional": "^20.4.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.2.3",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "husky": "^9.1.7",
+    "jest": "^30.0.0",
+    "prettier": "^3.8.1",
+    "prettier-plugin-organize-attributes": "^1.0.0",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "prettier-plugin-tailwindcss": "^0.7.2",
+    "rimraf": "^6.1.2",
+    "ts-jest": "^29.4.6",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.55.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "collectCoverageFrom": [
+      "**/*.(t|j)s"
+    ],
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}