@wellingtonhlc/shared-ui 0.24.4 → 0.24.5

package/README.md

@@ -64,6 +64,33 @@ Nao inclua:
 | `npm run storybook` | Sobe o Storybook local. |
 | `npm run build-storybook` | Gera build estatico do Storybook. |
 
+## Validadores para consumidores
+
+O pacote publica o CLI `shared-ui-check-page-actions` para validar o contrato de actions em projetos consumidores.
+
+Contrato esperado:
+
+- `AppLayout.actions` e somente o slot de layout.
+- `Page.Actions` e o root visual da barra.
+- Props como `helpContent`, `helpLabel`, `position`, `align` e `size` pertencem ao `Page.Actions`.
+- Nao usar `ActionBar.*`, `Page.Root actions=...` dentro de `AppLayout`, Fragment, `div` ou `Page.ActionButton` solto como root de `AppLayout.actions`.
+
+Uso recomendado no consumidor:
+
+```json
+{
+  "scripts": {
+    "check:page-actions": "shared-ui-check-page-actions"
+  }
+}
+```
+
+Tambem e possivel apontar um diretorio explicitamente:
+
+```bash
+shared-ui-check-page-actions ./src
+```
+
 ## Storybook
 
 O Storybook esta na linha `10.4.6` (`storybook`, `@storybook/react-vite`, `@storybook/addon-docs` e `@storybook/addon-a11y`).

package/dist/cli/check-page-actions.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+export interface PageActionsCheckResult {
+    errors: string[];
+    scannedFiles: number;
+    sourceRoot: string;
+}
+export declare function checkPageActionsContract(rootDir?: string): PageActionsCheckResult;
+export declare function runPageActionsContractCli(args?: string[]): PageActionsCheckResult;
+//# sourceMappingURL=check-page-actions.d.ts.map

package/dist/cli/check-page-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-page-actions.d.ts","sourceRoot":"","sources":["../../src/cli/check-page-actions.ts"],"names":[],"mappings":";AAQA,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqCD,wBAAgB,wBAAwB,CAAC,OAAO,SAAgB,GAAG,sBAAsB,CAyDxF;AAED,wBAAgB,yBAAyB,CAAC,IAAI,WAAwB,0BAerE"}

package/dist/cli/check-page-actions.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const extensions = new Set(['.ts', '.tsx']);
+const ignoredDirectories = new Set(['node_modules', 'dist', 'build', 'coverage']);
+function normalizePath(root, filePath) {
+    return path.relative(root, filePath).split(path.sep).join('/');
+}
+function* walk(directory) {
+    if (!fs.existsSync(directory))
+        return;
+    for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+        if (ignoredDirectories.has(entry.name))
+            continue;
+        const fullPath = path.join(directory, entry.name);
+        if (entry.isDirectory()) {
+            yield* walk(fullPath);
+            continue;
+        }
+        if (extensions.has(path.extname(entry.name))) {
+            yield fullPath;
+        }
+    }
+}
+function collectMatches(text, pattern, message, root, filePath, errors) {
+    for (const match of text.matchAll(pattern)) {
+        const before = text.slice(0, match.index);
+        const line = before.split(/\r?\n/).length;
+        errors.push(`${normalizePath(root, filePath)}:${line}: ${message}`);
+    }
+}
+export function checkPageActionsContract(rootDir = process.cwd()) {
+    const root = path.resolve(rootDir);
+    const sourceRoot = fs.existsSync(path.join(root, 'src')) ? path.join(root, 'src') : root;
+    const errors = [];
+    let scannedFiles = 0;
+    for (const filePath of walk(sourceRoot)) {
+        scannedFiles += 1;
+        const text = fs.readFileSync(filePath, 'utf8');
+        collectMatches(text, /ActionBar\./g, 'use Page.Actions, Page.ActionButton e Page.ActionsSeparator no lugar de ActionBar.*', root, filePath, errors);
+        collectMatches(text, /<Page\.Root\b[^>]*\bactions\s*=/gs, 'nao aninhe Page.Root actions dentro de AppLayout; use AppLayout.actions com Page.Actions', root, filePath, errors);
+        collectMatches(text, /<AppLayout\b[\s\S]*?\bactions\s*=\s*{\s*<>/g, 'AppLayout.actions nao deve receber Fragment como root; use Page.Actions ou componente *Actions', root, filePath, errors);
+        collectMatches(text, /<AppLayout\b[\s\S]*?\bactions\s*=\s*{\s*<div\b/g, 'AppLayout.actions nao deve receber div como root; use Page.Actions ou componente *Actions', root, filePath, errors);
+        collectMatches(text, /<AppLayout\b[\s\S]*?\bactions\s*=\s*{\s*<Page\.ActionButton\b/g, 'AppLayout.actions nao deve receber Page.ActionButton solto; envolva em Page.Actions', root, filePath, errors);
+    }
+    return { errors, scannedFiles, sourceRoot };
+}
+export function runPageActionsContractCli(args = process.argv.slice(2)) {
+    const rootDir = args[0] ?? process.cwd();
+    const result = checkPageActionsContract(rootDir);
+    if (result.errors.length > 0) {
+        console.error('Falha na verificacao de Page Actions:');
+        for (const error of result.errors)
+            console.error('- ' + error);
+        process.exitCode = 1;
+        return result;
+    }
+    console.log(`Page Actions OK: ${result.scannedFiles} arquivo(s) verificado(s); AppLayout.actions usa Page.Actions direta ou indiretamente.`);
+    return result;
+}
+const currentFilePath = fileURLToPath(import.meta.url);
+const entryFilePath = process.argv[1] ? path.resolve(process.argv[1]) : '';
+if (entryFilePath === currentFilePath) {
+    runPageActionsContractCli();
+}

package/package.json

@@ -1,10 +1,13 @@
 {
     "name": "@wellingtonhlc/shared-ui",
-    "version": "0.24.4",
+    "version": "0.24.5",
     "private": false,
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
+    "bin": {
+        "shared-ui-check-page-actions": "dist/cli/check-page-actions.js"
+    },
     "files": [
         "dist",
         "README.md"
@@ -58,6 +61,7 @@
         "@testing-library/jest-dom": "^6.9.1",
         "@testing-library/react": "^16.3.2",
         "@testing-library/user-event": "^14.6.1",
+        "@types/node": "^26.0.0",
         "@types/react": "^19.1.2",
         "@types/react-dom": "^19.1.2",
         "autoprefixer": "^10.5.0",