analytica-frontend-lib 1.0.0 → 1.0.2

package/README.md

@@ -1,2 +1,35 @@
-# analytica-frontend-lib
-Repositório público dos componentes utilizados nas plataformas da Analytica Ensino
+# README
+
+Repositório público dos componentes utilizados nas plataformas da Analytica Ensino.
+
+[![npm version](https://img.shields.io/npm/v/analytica-frontend-lib)](https://www.npmjs.com/package/analytica-frontend-lib)
+
+---
+
+## Como usar?
+
+Instale a biblioteca em seu projeto com o comando:
+
+```bash
+yarn add analytica-frontend-lib
+```
+
+---
+
+## Etapas para criar um novo componente
+
+1. Crie uma nova branch a partir da `main`.
+2. Crie o componente na pasta `/src/components`.
+3. Adicione testes unitários, com cobertura mínima de 80%.
+4. Adicione o componente no Storybook, contemplando todas as variações.
+5. Atualize a versão no campo `version` do arquivo `package.json`.
+6. Abra um Pull Request (PR) da sua branch para a `main`.
+7. O GitHub Actions cuidará da publicação automática após o merge.
+
+---
+
+## Regras
+
+- Os componentes devem ser totalmente compatíveis com Next.js versão 15+.
+- Testes unitários são obrigatórios, com coverage mínimo de 80%.
+- Siga o princípio da responsabilidade única (`single responsibility`): construa componentes compostos por componentes menores.

package/dist/index.css

@@ -1,5 +1,17 @@
 /* src/styles.css */
 @layer properties;
+.flex {
+  display: flex;
+}
+.transform {
+  transform: var(--tw-rotate-x,) var(--tw-rotate-y,) var(--tw-rotate-z,) var(--tw-skew-x,) var(--tw-skew-y,);
+}
+.flex-wrap {
+  flex-wrap: wrap;
+}
+.items-center {
+  align-items: center;
+}
 .transition {
   transition-property:
     color,
@@ -46,6 +58,11 @@
     outline-style: none;
   }
 }
+@property --tw-rotate-x { syntax: "*"; inherits: false; }
+@property --tw-rotate-y { syntax: "*"; inherits: false; }
+@property --tw-rotate-z { syntax: "*"; inherits: false; }
+@property --tw-skew-x { syntax: "*"; inherits: false; }
+@property --tw-skew-y { syntax: "*"; inherits: false; }
 @property --tw-shadow { syntax: "*"; inherits: false; initial-value: 0 0 #0000; }
 @property --tw-shadow-color { syntax: "*"; inherits: false; }
 @property --tw-shadow-alpha { syntax: "<percentage>"; inherits: false; initial-value: 100%; }
@@ -66,6 +83,11 @@
     ::before,
     ::after,
     ::backdrop {
+      --tw-rotate-x: initial;
+      --tw-rotate-y: initial;
+      --tw-rotate-z: initial;
+      --tw-skew-x: initial;
+      --tw-skew-y: initial;
       --tw-shadow: 0 0 #0000;
       --tw-shadow-color: initial;
       --tw-shadow-alpha: 100%;

package/dist/index.d.mts

@@ -1,12 +1,39 @@
-import * as react from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ButtonHTMLAttributes } from 'react';
 
+/**
+ * Button component props interface
+ */
 type ButtonProps = {
+    /** Content to be displayed inside the button */
     children: ReactNode;
+    /** Visual variant of the button */
     variant?: 'primary' | 'secondary' | 'danger';
+    /** Size variant of the button */
     size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes to apply */
     className?: string;
 } & ButtonHTMLAttributes<HTMLButtonElement>;
-declare const Button: ({ children, variant, size, className, ...props }: ButtonProps) => react.JSX.Element;
+/**
+ * Button component for Analytica Ensino platforms
+ *
+ * A flexible button component with multiple variants and sizes.
+ * Fully compatible with Next.js 15 and React 19.
+ *
+ * @param children - The content to display inside the button
+ * @param variant - The visual style variant (primary, secondary, danger)
+ * @param size - The size variant (sm, md, lg)
+ * @param className - Additional CSS classes
+ * @param props - All other standard button HTML attributes
+ * @returns A styled button element
+ *
+ * @example
+ * ```tsx
+ * <Button variant="primary" size="md" onClick={() => console.log('clicked')}>
+ *   Click me
+ * </Button>
+ * ```
+ */
+declare const Button: ({ children, variant, size, className, ...props }: ButtonProps) => react_jsx_runtime.JSX.Element;
 
 export { Button };

package/dist/index.d.ts

@@ -1,12 +1,39 @@
-import * as react from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ButtonHTMLAttributes } from 'react';
 
+/**
+ * Button component props interface
+ */
 type ButtonProps = {
+    /** Content to be displayed inside the button */
     children: ReactNode;
+    /** Visual variant of the button */
     variant?: 'primary' | 'secondary' | 'danger';
+    /** Size variant of the button */
     size?: 'sm' | 'md' | 'lg';
+    /** Additional CSS classes to apply */
     className?: string;
 } & ButtonHTMLAttributes<HTMLButtonElement>;
-declare const Button: ({ children, variant, size, className, ...props }: ButtonProps) => react.JSX.Element;
+/**
+ * Button component for Analytica Ensino platforms
+ *
+ * A flexible button component with multiple variants and sizes.
+ * Fully compatible with Next.js 15 and React 19.
+ *
+ * @param children - The content to display inside the button
+ * @param variant - The visual style variant (primary, secondary, danger)
+ * @param size - The size variant (sm, md, lg)
+ * @param className - Additional CSS classes
+ * @param props - All other standard button HTML attributes
+ * @returns A styled button element
+ *
+ * @example
+ * ```tsx
+ * <Button variant="primary" size="md" onClick={() => console.log('clicked')}>
+ *   Click me
+ * </Button>
+ * ```
+ */
+declare const Button: ({ children, variant, size, className, ...props }: ButtonProps) => react_jsx_runtime.JSX.Element;
 
 export { Button };

package/dist/index.js

@@ -24,7 +24,8 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/components/Button.tsx
+// src/components/Button/Button.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
 var Button = ({
   children,
   variant = "primary",
@@ -59,13 +60,13 @@ var Button = ({
       break;
   }
   const baseClasses = "rounded font-medium focus:outline-none focus:ring transition";
-  return /* @__PURE__ */ React.createElement(
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
     "button",
     {
       className: `${baseClasses} ${variantClasses} ${sizeClasses} ${className}`,
-      ...props
-    },
-    children
+      ...props,
+      children
+    }
   );
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -1,4 +1,5 @@
-// src/components/Button.tsx
+// src/components/Button/Button.tsx
+import { jsx } from "react/jsx-runtime";
 var Button = ({
   children,
   variant = "primary",
@@ -33,13 +34,13 @@ var Button = ({
       break;
   }
   const baseClasses = "rounded font-medium focus:outline-none focus:ring transition";
-  return /* @__PURE__ */ React.createElement(
+  return /* @__PURE__ */ jsx(
     "button",
     {
       className: `${baseClasses} ${variantClasses} ${sizeClasses} ${className}`,
-      ...props
-    },
-    children
+      ...props,
+      children
+    }
   );
 };
 export {

package/package.json

@@ -1,42 +1,102 @@
 {
   "name": "analytica-frontend-lib",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Repositório público dos componentes utilizados nas plataformas da Analytica Ensino",
-  "main": "./dist/index.cjs",
+  "main": "dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
   "scripts": {
-    "build": "tsup src/index.ts --dts --format esm,cjs --out-dir dist --clean"
+    "lint": "npx eslint \"{src,app}/**/*.{js,jsx,ts,tsx}\" --fix",
+    "typecheck": "npx tsc --noEmit",
+    "prepare": "husky install",
+    "test": "jest --coverage",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:sonar": "jest --coverage --testResultsProcessor=jest-sonar-reporter",
+    "build": "tsup src/index.ts --dts --format esm,cjs --out-dir dist --clean",
+    "build:check": "npm run typecheck && npm run build",
+    "dev": "tsup src/index.ts --dts --format esm,cjs --out-dir dist --watch",
+    "prepack": "npm run build:check",
+    "check-nextjs-compat": "echo 'Checking Next.js 15 compatibility...' && npm run typecheck && npm run test",
+    "ladle": "ladle serve",
+    "ladle:build": "ladle build"
   },
   "engines": {
     "node": "22.x"
   },
   "packageManager": "yarn@4.9.0",
   "keywords": [
-    "analytica",
-    "ensino",
+    "analytica ensino",
     "frontend",
-    "components"
+    "components",
+    "nextjs",
+    "nextjs-15",
+    "react-19",
+    "typescript",
+    "tailwindcss"
   ],
   "publishConfig": {
     "access": "public"
   },
+  "peerDependencies": {
+    "next": ">=15.0.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
   "author": "Analytica Ensino LTDA",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/analytica-ensino/analytica-frontend-lib.git"
+  },
+  "homepage": "https://github.com/analytica-ensino/analytica-frontend-lib#readme",
+  "bugs": {
+    "url": "https://github.com/analytica-ensino/analytica-frontend-lib/issues"
+  },
   "dependencies": {
     "react": "^19.1.0",
     "react-dom": "^19.1.0"
   },
   "devDependencies": {
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.28.0",
+    "@ladle/react": "^5.0.3",
     "@tailwindcss/postcss": "^4.1.8",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^6.6.3",
+    "@testing-library/react": "^16.3.0",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/jest": "^29.5.14",
     "@types/react": "^19.1.6",
     "@types/react-dom": "^19.1.6",
+    "@typescript-eslint/eslint-plugin": "^8.34.0",
+    "@typescript-eslint/parser": "^8.34.0",
     "autoprefixer": "^10.4.21",
+    "eslint": "^9.28.0",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-plugin-jsdoc": "^50.7.1",
+    "eslint-plugin-prettier": "^5.4.1",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "jest-sonar-reporter": "^2.0.0",
+    "jsdom": "^26.1.0",
+    "next": "^15.3.3",
+    "polished": "^4.3.1",
     "postcss": "^8.5.4",
+    "prettier": "^3.5.3",
+    "sonarqube-scanner": "^4.3.0",
     "tailwindcss": "^4.1.8",
+    "ts-jest": "^29.3.4",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   }