@controleonline/ui-common 1.2.87 → 1.2.88

package/.github/workflows/integration-source-gate.yml

@@ -0,0 +1,68 @@
+name: Integration source gate
+
+on:
+  pull_request:
+    branches: [dev, staging, master]
+    types: [opened, synchronize, reopened, edited, ready_for_review]
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  source-policy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Enforce task or frozen RC source
+        env:
+          HEAD_REF: ${{ github.head_ref }}
+          BASE_REF: ${{ github.base_ref }}
+        run: |
+          set -eu
+          if [ "$BASE_REF" = "dev" ]; then
+            echo "$HEAD_REF" | grep -Eq '^task-[1-9][0-9]*$' || {
+              echo "::error::dev only accepts task-<numeric issue>."
+              exit 1
+            }
+            exit 0
+          fi
+          echo "$HEAD_REF" | grep -Eq '^rc/[0-9]+\.[0-9]+\.[0-9]+-rc\.[1-9][0-9]*$' || {
+            echo "::error::$BASE_REF only accepts a frozen rc/X.Y.Z-rc.N source."
+            exit 1
+          }
+
+      - uses: actions/checkout@v4
+        if: github.base_ref != 'dev'
+        with:
+          ref: ${{ github.head_ref }}
+
+      - name: Validate frozen RC manifest
+        if: github.base_ref != 'dev'
+        env:
+          HEAD_REF: ${{ github.head_ref }}
+        run: |
+          set -eu
+          test -f .release/rc-manifest.json || {
+            echo "::error::Missing .release/rc-manifest.json"
+            exit 1
+          }
+          node --input-type=module <<'NODE'
+          import fs from 'node:fs';
+          const m = JSON.parse(fs.readFileSync('.release/rc-manifest.json', 'utf8'));
+          const branch = process.env.HEAD_REF;
+          const match = /^rc\/(\d+\.\d+\.\d+)-rc\.([1-9][0-9]*)$/.exec(branch);
+          if (!match) throw new Error('invalid RC branch');
+          if (m.branch !== branch || m.version !== match[1] || Number(m.rc) !== Number(match[2])) throw new Error('manifest identity mismatch');
+          if (m.frozen !== true) throw new Error('manifest is not frozen');
+          if (!Array.isArray(m.tasks) || m.tasks.length < 1 || m.tasks.length > 5) throw new Error('RC must contain 1..5 tasks');
+          const tasks = m.tasks.map(Number);
+          if (tasks.some((id) => !Number.isInteger(id) || id < 1)) throw new Error('invalid task id');
+          if (new Set(tasks).size !== tasks.length) throw new Error('duplicate RC tasks');
+          if (!/^[0-9a-f]{40}$/i.test(String(m.baseMaster || ''))) throw new Error('invalid baseMaster');
+          const repos = m.repositories || {};
+          if (!Object.keys(repos).length) throw new Error('empty repositories manifest');
+          for (const [repo, sha] of Object.entries(repos)) {
+            if (!/^ControleOnline\/[A-Za-z0-9_.-]+$/.test(repo) || !/^[0-9a-f]{40}$/i.test(String(sha))) throw new Error('invalid repository manifest entry');
+          }
+          console.log('Frozen RC manifest valid:', branch, tasks);
+          NODE

package/.github/workflows/manager-worker.yml

@@ -1,168 +1,19 @@
 name: Manager Worker
 
 on:
-  push:
-    branches: [master, dev, staging]
+  workflow_dispatch:
+
+# PAUSA CTO ControleOnline/agents-mcp#201 (2026-08-29)
+# Trigger original desativado: push em master, dev, staging.
 
 permissions:
-  contents: write
+  contents: read
   issues: write
   pull-requests: write
 
-# Orquestrador: Manager resolve/cria issue e decide quais workers invocar.
-# Padrão de branch da org = master (não usar main).
-# Em master: bump patch + tag vX.Y.Z → dispara publish-npm.yml (Trusted Publishing).
 jobs:
   manager:
-    name: Manager — resolve + plano de workers
-    runs-on: ubuntu-latest
-    outputs:
-      issue_number: ${{ steps.mgr.outputs.issue_number }}
-      created: ${{ steps.mgr.outputs.created }}
-      run_qa: ${{ steps.mgr.outputs.run_qa }}
-      run_security: ${{ steps.mgr.outputs.run_security }}
-      run_docs: ${{ steps.mgr.outputs.run_docs }}
-      run_gates: ${{ steps.mgr.outputs.run_gates }}
-      base_branch: ${{ steps.mgr.outputs.base_branch }}
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Manager subworker
-        id: mgr
-        uses: ./.github/actions/workers/manager
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          branch: ${{ github.ref_name }}
-
-  # Workers invocados pelo plano do Manager (paralelo quando ambos true)
-  qa:
-    name: QA (invocado pelo Manager)
-    needs: manager
-    if: needs.manager.outputs.run_qa == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ./.github/actions/workers/qa
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          issue_number: ${{ needs.manager.outputs.issue_number }}
-          base_branch: ${{ needs.manager.outputs.base_branch }}
-
-  security:
-    name: Security (invocado pelo Manager)
-    needs: manager
-    if: needs.manager.outputs.run_security == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ./.github/actions/workers/security
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          issue_number: ${{ needs.manager.outputs.issue_number }}
-          base_branch: ${{ needs.manager.outputs.base_branch }}
-
-  technical-documenter:
-    name: Technical Documenter (invocado pelo Manager)
-    needs: manager
-    if: needs.manager.outputs.run_docs == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ./.github/actions/workers/technical-documenter
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          issue_number: ${{ needs.manager.outputs.issue_number }}
-          base_branch: ${{ needs.manager.outputs.base_branch }}
-
-  # master: se faltar gate do quarteto → tags + workers faltantes
-  master-gates:
-    name: Master gates (quarteto)
-    needs: manager
-    if: needs.manager.outputs.run_gates == 'true'
-    runs-on: ubuntu-latest
-    outputs:
-      need_qa: ${{ steps.check.outputs.need_qa }}
-      need_security: ${{ steps.check.outputs.need_security }}
-      need_docs: ${{ steps.check.outputs.need_docs }}
-    steps:
-      - uses: actions/checkout@v4
-      - name: Inspect quarteto e tags
-        id: check
-        env:
-          GH_TOKEN: ${{ secrets.GH_TOKEN }}
-          ISSUE: ${{ needs.manager.outputs.issue_number }}
-          REPO: ${{ github.repository }}
-        run: |
-          set -euo pipefail
-          LABELS=$(gh issue view "$ISSUE" --repo "$REPO" --json labels --jq '[.labels[].name] | join(",")')
-          echo "Labels: $LABELS"
-
-          need_qa=false
-          need_security=false
-          need_docs=false
-
-          echo "$LABELS" | grep -q 'qa:accepted' || need_qa=true
-          echo "$LABELS" | grep -q 'security:accepted' || need_security=true
-          echo "$LABELS" | grep -q 'agent:technical-documenter:done' || need_docs=true
-
-          echo "need_qa=$need_qa" >> "$GITHUB_OUTPUT"
-          echo "need_security=$need_security" >> "$GITHUB_OUTPUT"
-          echo "need_docs=$need_docs" >> "$GITHUB_OUTPUT"
-
-          [ "$need_qa" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:qa" || true
-          [ "$need_security" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:security" || true
-          [ "$need_docs" = true ] && gh issue edit "$ISSUE" --repo "$REPO" --add-label "agent:technical-documenter" || true
-
-          gh issue comment "$ISSUE" --repo "$REPO" --body \
-            "Master gates (Manager): need_qa=$need_qa need_security=$need_security need_docs=$need_docs"
-
-  master-qa:
-    name: QA (master gap via Manager)
-    needs: [manager, master-gates]
-    if: needs.master-gates.outputs.need_qa == 'true'
+    name: Manager — paused
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: ./.github/actions/workers/qa
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          issue_number: ${{ needs.manager.outputs.issue_number }}
-          base_branch: master
-
-  master-security:
-    name: Security (master gap via Manager)
-    needs: [manager, master-gates]
-    if: needs.master-gates.outputs.need_security == 'true'
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: ./.github/actions/workers/security
-        with:
-          gh_token: ${{ secrets.GH_TOKEN }}
-          issue_number: ${{ needs.manager.outputs.issue_number }}
-          base_branch: master
-
-  # Em push para master: bump patch + cria tag vX.Y.Z (dispara publish-npm.yml)
-  # Ignora commits de release ([skip bump]) para evitar loop.
-  version-tag:
-    name: Bump version + tag
-    if: github.ref == 'refs/heads/master' && !contains(github.event.head_commit.message, '[skip bump]')
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-          token: ${{ secrets.GH_TOKEN }}
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '24'
-
-      - name: Bump patch + tag
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
-          npm version patch -m "chore(release): %s [skip bump]"
-          git push origin HEAD:master --follow-tags
+      - run: echo "Manager Worker paused by ControleOnline/agents-mcp#201"

package/.github/workflows/publish-npm.yml

@@ -2,44 +2,90 @@ name: Publish Package to npmjs
 
 on:
   push:
-    tags:
-      - 'v*'
 
 permissions:
+  contents: write
   id-token: write
-  contents: read
+
+concurrency:
+  group: ${{ github.repository }}-npm-release
+  cancel-in-progress: false
 
 jobs:
   publish:
+    if: ${{ github.repository_owner == 'ControleOnline' && (github.ref == 'refs/heads/dev' || github.ref == 'refs/heads/master' || startsWith(github.ref, 'refs/tags/v')) }}
     runs-on: ubuntu-latest
-    permissions:
-      id-token: write
-      contents: read
     steps:
       - uses: actions/checkout@v4
-
+        with:
+          ref: ${{ github.ref }}
+          fetch-depth: 0
+      - name: Validate package metadata and create version tag
+        id: release
+        env:
+          REF_TYPE: ${{ github.ref_type }}
+          REF_NAME: ${{ github.ref_name }}
+          EXPECTED_REPOSITORY: ${{ github.repository }}
+        run: |
+          node <<'NODE'
+          const fs = require('node:fs');
+          const cp = require('node:child_process');
+          const pkg = require('./package.json');
+          const expectedUrl = `https://github.com/${process.env.EXPECTED_REPOSITORY}`;
+          if (!/^\d+\.\d+\.\d+$/.test(String(pkg.version))) throw new Error(`Expected stable X.Y.Z, got ${pkg.version}`);
+          if (pkg.repository?.url !== expectedUrl) throw new Error(`repository.url must be ${expectedUrl}; got ${pkg.repository?.url}`);
+          const sourceSha = cp.execFileSync('git', ['rev-parse', 'HEAD'], {encoding:'utf8'}).trim();
+          let tag = '';
+          if (process.env.REF_TYPE === 'tag') {
+            tag = process.env.REF_NAME;
+            if (tag !== `v${pkg.version}`) throw new Error(`Tag ${tag} does not match package version ${pkg.version}`);
+          } else {
+            let previous = '';
+            try { previous = JSON.parse(cp.execFileSync('git', ['show', `${sourceSha}^:package.json`], {encoding:'utf8'})).version || ''; } catch {}
+            if (previous === pkg.version) { fs.appendFileSync(process.env.GITHUB_OUTPUT, 'release_tag=\n'); process.exit(0); }
+            const parts = String(pkg.version).split('.').map(Number);
+            if (previous) {
+              const old = String(previous).split('.').map(Number);
+              let cmp = 0; for (let i=0;i<3;i++) { if ((parts[i]||0)!==(old[i]||0)) { cmp=(parts[i]||0)>(old[i]||0)?1:-1; break; } }
+              if (cmp <= 0) throw new Error(`Version ${pkg.version} must be greater than first-parent version ${previous}`);
+            }
+            tag = `v${pkg.version}`;
+            const existing = cp.spawnSync('git', ['ls-remote', '--exit-code', '--refs', 'origin', `refs/tags/${tag}`], {encoding:'utf8'});
+            if (existing.status === 0) {
+              cp.execFileSync('git', ['fetch', 'origin', `refs/tags/${tag}:refs/tags/${tag}`], {stdio:'inherit'});
+              const tagged = cp.execFileSync('git', ['rev-parse', `${tag}^{commit}`], {encoding:'utf8'}).trim();
+              if (tagged !== sourceSha) throw new Error(`Immutable tag ${tag} already points at ${tagged}, not ${sourceSha}`);
+            } else {
+              cp.execFileSync('git', ['config', 'user.name', 'github-actions[bot]']);
+              cp.execFileSync('git', ['config', 'user.email', '41898282+github-actions[bot]@users.noreply.github.com']);
+              cp.execFileSync('git', ['tag', '-a', tag, sourceSha, '-m', `Release ${pkg.name}@${pkg.version}`], {stdio:'inherit'});
+              cp.execFileSync('git', ['push', 'origin', `refs/tags/${tag}`], {stdio:'inherit'});
+            }
+          }
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, `release_tag=${tag}\n`);
+          console.log(`Validated ${pkg.name}@${pkg.version} from ${sourceSha}; release tag ${tag}`);
+          NODE
       - uses: actions/setup-node@v4
+        if: steps.release.outputs.release_tag != ''
         with:
-          node-version: '24'
-
+          node-version: 24
       - name: Ensure npm 11.5.1+ (OIDC support)
+        if: steps.release.outputs.release_tag != ''
         run: |
-          npm install -g npm@latest
-          echo "node=$(node -v) npm=$(npm -v)"
-
-      - name: Prepare registry (OIDC only — no classic token)
-        run: |
-          unset NODE_AUTH_TOKEN NPM_TOKEN || true
-          rm -f .npmrc "$HOME/.npmrc" || true
-          npm config delete //registry.npmjs.org/:_authToken 2>/dev/null || true
-          npm config set registry https://registry.npmjs.org/
-          echo "NODE_AUTH_TOKEN=${NODE_AUTH_TOKEN-<unset>}"
-          echo "ACTIONS_ID_TOKEN_REQUEST_URL=${ACTIONS_ID_TOKEN_REQUEST_URL:+set}"
-          echo "ACTIONS_ID_TOKEN_REQUEST_TOKEN=${ACTIONS_ID_TOKEN_REQUEST_TOKEN:+set}"
-          npm config list 2>/dev/null | grep -E "registry|auth|token" || true
-          cat "$HOME/.npmrc" 2>/dev/null || echo "(no ~/.npmrc)"
-
-      - name: Publish to npmjs (Trusted Publishing / OIDC)
+          npm install --global npm@latest
+          npm --version
+      - name: Skip if version is already on npm
+        id: registry
+        if: steps.release.outputs.release_tag != ''
         run: |
-          unset NODE_AUTH_TOKEN NPM_TOKEN || true
-          npm publish --access public --loglevel verbose
+          PACKAGE_NAME=$(node -p "require('./package.json').name")
+          PACKAGE_VERSION=$(node -p "require('./package.json').version")
+          if npm view "$PACKAGE_NAME@$PACKAGE_VERSION" version >/dev/null 2>&1; then
+            echo 'published=true' >> "$GITHUB_OUTPUT"
+            echo "$PACKAGE_NAME@$PACKAGE_VERSION is already published; skipping duplicate publish"
+          else
+            echo 'published=false' >> "$GITHUB_OUTPUT"
+          fi
+      - name: Publish to npmjs with trusted publishing
+        if: steps.release.outputs.release_tag != '' && steps.registry.outputs.published != 'true'
+        run: npm publish --access public --loglevel verbose

package/.github/workflows/pull-request-checks.yml

@@ -12,8 +12,10 @@ jobs:
     steps:
       - uses: actions/checkout@v5
 
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20.x'
-
-      - run: npm test
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+
+      - run: npm install --ignore-scripts --no-package-lock --no-audit --no-fund
+
+      - run: npm test

package/docs/technical/Device-Detail-Alias-UI-Sync.md

@@ -0,0 +1,141 @@
+# Device Detail — sincronização do alias (nome) na UI após save
+
+Documentação técnica da correção de feedback visual ao editar o **nome (alias)** do device na tela `/device-detail` (Manager).
+
+**Issue de origem:** [app-community#382](https://github.com/ControleOnline/app-community/issues/382).
+
+## Problema de negócio
+
+Na tela de detalhe de dispositivo (`/device-detail`):
+
+1. O usuário edita o **nome do device** e grava.
+2. A alteração **é persistida** no backend (API `devices`).
+3. A UI **não** refletia o novo nome até um **refresh** (F5) da página.
+
+O feedback esperado é imediato: após save com sucesso, o valor exibido no header deve ser o novo alias **sem** reload.
+
+## Papel no produto (`APP_TYPE`)
+
+| Visão | O que este fluxo faz | O que **não** faz |
+| --- | --- | --- |
+| **MANAGER** | Rota principal: lista Dispositivos → detalhe → editar alias → save; header atualiza na hora | Não altera permissões, tipos de device nem DeviceConfig de PDV/DISPLAY |
+| **ADMIN** | Pode reutilizar a mesma página compartilhada de `ui-common` quando a visão importa `DeviceDetailPage` | Não é o alvo prioritário do smoke Manager |
+| **POS / PPC / SHOP / DELIVERY / CRM** | Não expõem esta tela de edição de alias de device | Não devem assumir ownership da tela de device-detail |
+
+Fronteiras: módulo compartilhado `ui-common`; rota consumida pelo **Manager** via `ui-manager`.
+
+## Onde vive o código
+
+| Peça | Caminho |
+| --- | --- |
+| Shell da página | `ui-common` → `src/react/pages/DeviceDetailPage.js` (orquestra hooks/seções; ≤ 500 linhas após modularização) |
+| Header (alias edit/save) | `src/react/pages/Devices/detail/DeviceDetailHeader.js` |
+| Ações (inclui `saveAlias`) | `src/react/pages/Devices/detail/useDeviceDetailActions.js` |
+| Estado local + ref de skip | `src/react/pages/Devices/detail/useDeviceDetailStateA.js` (ou estado co-localizado nos hooks de detail) |
+| Merge store pós-save | `src/react/utils/deviceAliasSync.js` → `buildDeviceAliasStoreUpdates` |
+| Smoke browser | `src/tests/browser/manager/device-detail-alias-save.spec.js` |
+| Unit | `src/tests/react/utils/deviceAliasSync.test.js` |
+
+Rota Manager: `ui-manager` importa `DeviceDetailPage` de `@controleonline/ui-common`.
+
+## Causa raiz (técnica)
+
+Havia descompasso entre:
+
+1. **Persistência** (`deviceActions.save({ id, alias })`) — ok no backend.
+2. **Estado local** (`alias` / `aliasInput` no header).
+3. **Store runtime** (`device` e `device_config`), de onde `initialAlias` é derivado:
+
+```text
+initialAlias = currentDevice?.alias
+  || currentDeviceConfig?.device?.alias
+  || currentDevice?.device
+```
+
+Um `useEffect` sincroniza o estado local a partir de `initialAlias` quando **não** está em modo edição:
+
+```text
+useEffect(() => {
+  if (editingAlias) return;
+  if (skipAliasSyncFromStoreRef.current) {
+    skipAliasSyncFromStoreRef.current = false;
+    return;
+  }
+  setAlias(initialAlias || '');
+  setAliasInput(initialAlias || '');
+}, [editingAlias, initialAlias]);
+```
+
+Se o save atualizava só o backend (ou só o state local) **sem** atualizar o store, na saída do modo edição o efeito reaplicava o `initialAlias` antigo → a UI “voltava” ao nome anterior até um reload completo recarregar o device do servidor.
+
+## Correção canônica
+
+Após `deviceActions.save` com sucesso:
+
+1. Calcular o alias definitivo (`savedDevice?.alias || trimmed`).
+2. Chamar `buildDeviceAliasStoreUpdates({ deviceId, nextAlias, runtimeDevice, runtimeDeviceConfig, savedDevice, normalizeEntityId })`.
+3. Persistir no store:
+   - `deviceActions.setItem(mergedDevice)`
+   - `deviceConfigActions.setItem(nextDeviceConfig)` quando houver config aninhada com `device.alias`
+4. Armar `skipAliasSyncFromStoreRef.current = true` **antes** de atualizar o state local (evita race com o `useEffect` no mesmo ciclo).
+5. `setAlias(nextAlias)`, `setAliasInput(nextAlias)`, `setEditingAlias(false)`.
+
+### `buildDeviceAliasStoreUpdates`
+
+Responsável por manter **device** e **device_config.device** coerentes com o alias gravado, para que `initialAlias` derivado do store não “snap back” para o valor antigo.
+
+- Mescla o device runtime (mesmo id) com o payload salvo e força `alias`.
+- Se existir `runtimeDeviceConfig`, clona e atualiza `device.alias` aninhado.
+
+## Fluxo (Mermaid)
+
+```mermaid
+sequenceDiagram
+  participant U as Usuário (Manager)
+  participant H as DeviceDetailHeader
+  participant A as useDeviceDetailActions.saveAlias
+  participant API as deviceActions.save
+  participant S as Store (device + device_config)
+  participant E as useEffect (sync initialAlias)
+
+  U->>H: Edita alias + grava
+  H->>A: onSaveAlias
+  A->>API: save({ id, alias })
+  API-->>A: savedDevice
+  A->>S: setItem(mergedDevice / nextDeviceConfig)
+  A->>A: skipAliasSyncFromStoreRef = true
+  A->>H: setAlias + setAliasInput + exit edit
+  Note over E: effect roda com editingAlias=false
+  E->>E: vê skip=true → consome flag e não sobrescreve
+  H-->>U: Header mostra novo nome (sem F5)
+```
+
+## Critérios de aceite (referência)
+
+- Em `/device-detail`, após editar o nome e gravar com sucesso, o nome no header passa a ser o novo valor **sem** refresh.
+- Sem regressão em outros campos editáveis da mesma tela nem na listagem de dispositivos.
+- Persistência no backend permanece correta.
+- Evidência: smoke `device-detail-alias-save.spec.js` (edit → PUT → texto do header com `testID` `device-alias-text` / `device-alias-input` / `device-alias-save`).
+
+## testIDs (smoke)
+
+| testID | Uso |
+| --- | --- |
+| `device-alias-text` | Texto do alias no header (modo leitura) |
+| `device-alias-input` | Input em modo edição |
+| `device-alias-edit` | Botão para entrar em edição |
+| `device-alias-save` | Botão de confirmar save |
+
+## Fora de escopo desta página
+
+- Redesign da tela device-detail.
+- Novas funcionalidades de device além do feedback pós-save do alias.
+- Contratos de API além do `save` de device já existente.
+- Configuração de PDV/DISPLAY/PRINT (ver [Smoke helpers — device-configuracao](https://github.com/ControleOnline/app-community/wiki/Smoke-Helpers-Device-Configuracao)).
+
+## Links cruzados
+
+- Issue: [app-community#382](https://github.com/ControleOnline/app-community/issues/382)
+- Wiki do app: [Home](https://github.com/ControleOnline/app-community/wiki) · ponte [ui-common](https://github.com/ControleOnline/app-community/wiki/ui-common)
+- Smoke de listagem/navegação relacionada: `ui-common/src/tests/browser/manager/devices-current.spec.js`
+- Code quality / limite ≤ 500 linhas: [agents-mcp code-quality](https://github.com/ControleOnline/agents-mcp/blob/master/skills/shared/code-quality.md)

package/package.json

@@ -1,30 +1,35 @@
 {
   "name": "@controleonline/ui-common",
-  "version": "1.2.87",
+  "version": "1.2.88",
   "author": "ControleOnline",
   "description": "ControleOnline Common Quasar UI Component",
   "license": "MIT",
   "main": "src/react/index.js",
   "scripts": {
-    "test": "npm run test:receita-federal && npm run test:imports-status && npm run test:runtime-language && npm run test:runtime-footer && npm run test:runtime-footer-marquee && npm run test:invoice-presentation && npm run test:system-error-message && npm run test:bottom-navigation-toolbar && npm run test:copy-device-configs && npm run test:print-routing",
+    "test": "npm run test:receita-federal && npm run test:imports-status && npm run test:runtime-language && npm run test:runtime-footer && npm run test:runtime-footer-marquee && npm run test:invoice-presentation && npm run test:system-error-message && npm run test:bottom-navigation-toolbar && npm run test:copy-device-configs && npm run test:print-routing && npm run test:device-detail-dependencies",
     "test:receita-federal": "node --test src/tests/react/pages/receitaFederalIntegrationContract.test.mjs",
-    "test:imports-status": "mkdir -p node_modules/@controleonline && ln -sfn ../.. node_modules/@controleonline/ui-common && node --test src/tests/react/utils/importStatus.test.js",
+    "test:imports-status": "mkdir -p node_modules/@controleonline && rm -rf node_modules/@controleonline/ui-common && ln -s ../.. node_modules/@controleonline/ui-common && node --test src/tests/react/utils/importStatus.test.js",
     "test:runtime-language": "node --test src/tests/react/utils/runtimeLanguage.test.js",
-    "test:runtime-footer": "node --test src/tests/react/utils/runtimeFooter.test.js",
+    "test:runtime-footer": "node --test src/tests/react/utils/runtimeFooter.test.js src/tests/react/utils/runtimeFooterText.test.js",
     "test:invoice-presentation": "node --test src/tests/react/utils/invoicePresentation.test.mjs",
-    "test:system-error-message": "mkdir -p node_modules/@controleonline && ln -sfn ../.. node_modules/@controleonline/ui-common && node --test src/tests/react/utils/systemErrorMessage.test.js",
+    "test:system-error-message": "mkdir -p node_modules/@controleonline && rm -rf node_modules/@controleonline/ui-common && ln -s ../.. node_modules/@controleonline/ui-common && node --test src/tests/react/utils/systemErrorMessage.test.js",
     "test:coverage": "c8 --reporter=clover --report-dir coverage npm test",
     "test:bottom-navigation-toolbar": "node --test src/tests/react/utils/bottomNavigationToolbar.test.js",
     "test:copy-device-configs": "node --test src/tests/react/utils/copyDeviceConfigs.test.mjs",
     "test:print-routing": "node --test src/tests/react/utils/printRouting.test.mjs src/tests/react/utils/printSpoolUtils.test.mjs",
-    "test:runtime-footer-marquee": "node --test src/tests/react/components/RuntimeFooterMarqueeText.test.js"
+    "test:runtime-footer-marquee": "node --test src/tests/react/components/RuntimeFooterMarqueeText.test.js src/tests/react/components/RuntimeFooterMarqueeText.build.test.js",
+    "test:device-detail-dependencies": "node --test src/tests/react/pages/deviceDetailLoaderDependencies.test.mjs"
   },
   "devDependencies": {
-    "c8": "^10.1.3"
+    "c8": "^10.1.3",
+    "react": "^19.1.0",
+    "react-test-renderer": "^19.1.0",
+    "@babel/core": "^7.26.0",
+    "babel-preset-expo": "~54.0.10"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/ControleOnline/ui-common.git"
+    "url": "https://github.com/ControleOnline/ui-common"
   },
   "bugs": "",
   "homepage": "https://www.controleonline.com/devs/plugins",