@controleonline/ui-default 1.0.263

package/.github/agents/developer.agent.md

@@ -0,0 +1,30 @@
+---
+name: Developer
+description: Executor autônomo de issues do repositório ControleOnline/ui-default, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/developer/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-default`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-default`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/devops.agent.md

@@ -0,0 +1,30 @@
+---
+name: DevOps
+description: Operador de fluxo e automações do repositório ControleOnline/ui-default, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/devops/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-default`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-default`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/qa.agent.md

@@ -0,0 +1,30 @@
+---
+name: Quality Assurance
+description: Revisor técnico de entregas do repositório ControleOnline/ui-default, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/qa/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-default`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-default`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.github/agents/security.agent.md

@@ -0,0 +1,30 @@
+---
+name: Security
+description: Revisor de segurança do repositório ControleOnline/ui-default, com fonte canônica centralizada no cto-mcp.
+target: github-copilot
+---
+
+## Fonte canônica
+
+Este wrapper é intencionalmente fino. Antes de agir, leia e siga, nesta ordem:
+
+1. `https://github.com/ControleOnline/cto-mcp/blob/master/agents/agent/security/agent.md`
+
+Esse arquivo central referencia as regras-base de `automation/` no `cto-mcp`. Se este wrapper local divergir do conteúdo canônico do `cto-mcp`, prefira o `cto-mcp`, salvo quando o estado real deste repositório exigir adaptação operacional explícita.
+
+## Contexto local
+
+Você está operando no repositório `ControleOnline/ui-default`.
+
+Você conhece o ecossistema completo da ControleOnline. Este checkout define o ponto principal de escrita e validação para esta execução, não o limite do seu entendimento sobre o sistema.
+
+- Checkout local: `app-community/modules/controleonline/ui-default`
+- Tipo: submódulo de app-community
+- Família: frontend
+- Branch base operacional: `master`
+- Alvo preferencial de PR: `dev`
+- `AGENTS.md` local: presente
+
+Leia o `AGENTS.md` mais próximo antes de editar código. Se esta alteração tocar apenas o repositório atual, trabalhe aqui; se também exigir atualização do superprojeto que consome este repositório, registre ou entregue a composição necessária sem perder a separação de ownership.
+
+_Arquivo gerado por `cto-mcp/scripts/sync-copilot-agents.mjs`._

package/.scrutinizer.yml

@@ -0,0 +1,20 @@
+checks:
+  javascript: true
+
+build:
+  nodes:
+    analysis:
+      environment:
+        node: v16
+      project_setup:
+        override: true
+      tests:
+        override:
+          - js-scrutinizer-run
+
+filter:
+  excluded_paths:
+    - "build/*"
+    - "coverage/*"
+    - "dist/*"
+    - "node_modules/*"

package/AGENTS.md

@@ -0,0 +1,47 @@
+# ui-default
+
+## Escopo
+
+- Biblioteca base de componentes reutilizaveis do front.
+- `DefaultTable` e o shell canonico de listagens React deste sistema.
+
+## Contrato do DefaultTable
+
+- A tela deve passar preferencialmente apenas `storeName` e contexto minimo, como `requestParams`, `onRowPress`, `renderCard`, `onAdd`, `onEdit` ou componentes extras realmente especificos.
+- O componente pode receber componentes de composicao para variacoes visuais, como `renderCard`, add personalizado, toolbar customizada, acoes auxiliares e modais de apoio; isso nao muda o contrato de que a listagem continua sendo responsabilidade do `DefaultTable`.
+- Quando `data` nao e informada e existe `storeName`, o `DefaultTable` trabalha em modo automatico e carrega os itens pelas actions do store.
+- O componente e responsavel por busca, ordenacao, filtros, paginação, infinite scroll, loading, erro, resumo, visibilidade de colunas, modo desktop e modo card no mobile.
+- O store nao e fallback: ele e a regra. Se `columns` define um comportamento, o `DefaultTable` deve obedecer sem recriar uma segunda regra na tela.
+- `columns` e a fonte de verdade para label, visibilidade, ordem, `editable`, `sortable`, `inputType`, `list`, `format`, `formatList`, `formatFilter`, `saveFormat`, `searchParam`, `externalFilter`, `summary` e `defaultSort`. `show:false` e um alias aceito para ocultar coluna, junto com `visible:false` e `table:false`.
+- Se uma coluna vier como `editable: false`, ela continua nao editavel mesmo que seja ordenavel. Se vier como `sortable: true`, a ordenacao precisa continuar funcionando.
+- `inputType: 'date-range'` exige filtro de intervalo. `externalFilter: true` habilita o filtro externo quando a listagem suporta esse contrato.
+- Nada de search local, sort local, paginacao manual, contador local, total calculado por `reduce` ou cards paralelos quando o `DefaultTable` ja puder resolver isso pelo store.
+- `requestParams` serve para contexto fixo do fluxo, nao para duplicar estado de filtro que ja vive no store.
+- `pageSize` so deve ser usado quando o contrato externo exigir e com justificativa clara no modulo.
+- `summary` e `totalItems` vem do backend/store e pertencem ao rodape interno do `DefaultTable`.
+- `add: true` abre o `DefaultForm` quando a tela nao prover `onAdd`.
+- O modo controlado continua existindo apenas para excecoes reais de integracao; o padrao do sistema e o modo store-driven.
+- Loadings e erros devem seguir o fluxo central do sistema, sem banners ou estados paralelos na tela.
+- O `get` do store default pode preservar o `item` atual durante refresh quando receber `__storeMeta.preserveItem = true`; use esse modo quando a tela precisa atualizar o registro sem desmontar o detalhe em exibição.
+- Explicacoes permanentes de tela devem sair do corpo principal e ir para o `DefaultTooltip`, acionado por `?`, quando houver contexto necessario para o usuario.
+
+## Componentes de feedback
+
+- `StateStore` e o shell compartilhado para loading e saving de tela/seção.
+- O `mode` do `StateStore` e um preset generico do shell e pode variar conforme a tela; exemplos validos incluem `compact`, `display` e outros modos reais do fluxo.
+- `DefaultErrors` e o shell compartilhado para erro local/inline de tela ou tab; ele lê o `error` dos stores informados, aparece como popup, auto-fecha em 5 segundos e limpa o erro do store ao ser fechado.
+- `showError` continua sendo feedback transitório global; nao deve substituir `DefaultErrors` quando o erro for inline ou local.
+- Telas e componentes visuais nao devem usar `ActivityIndicator` direto quando o estado puder ser representado por `StateStore`.
+- O contrato de explicacao permanente continua sendo `DefaultTooltip`, sempre acionado por `?` e fora do corpo principal da tela.
+
+## Arquivos e imagens
+
+- `DefaultFile` e o componente compartilhado para arquivos/imagens vindos do backend.
+- Quando a fonte for um arquivo de download do backend, o componente deve resolver a URL com `app-domain=<dominio configurado>` e enviar o mesmo valor em `headers` quando a plataforma permitir.
+- Telas que exibem logo, fundo, avatar, banner ou qualquer arquivo de empresa devem preferir `DefaultFile` em vez de `Image` direto quando o contrato vier do backend.
+
+## Regra de uso
+
+- Telas antigas devem ser simplificadas para passar o store e apenas as excecoes declarativas que o store nao cobre.
+- Se a listagem precisa de outra regra de exibicao, a primeira opcao e mover essa regra para `columns` ou para o store correspondente.
+- Se duas telas repetem a mesma logica de listagem, a resposta e um componente default ou um ajuste no `DefaultTable`, nunca uma copia local do comportamento.

package/FUNDING.yml

@@ -0,0 +1 @@
+github: [controleonline]

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@controleonline/ui-default",
+  "version": "1.0.263",
+  "author": "ControleOnline",
+  "description": "ControleOnline Default Quasar UI Component",
+  "license": "MIT",
+  "main": "src/react/index.js",
+  "scripts": {},
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ControleOnline/conline-quasar-ui"
+  },
+  "bugs": "",
+  "homepage": "https://www.controleonline.com/devs/plugins",
+  "browserslist": [
+    "last 1 version, not dead, ie >= 11"
+  ],
+  "dependencies": {
+    "@controleonline/ui-legacy": "*"
+  }
+}

package/src/react/components/errors/DefaultErrors.js

@@ -0,0 +1,360 @@
+import React, {useCallback, useEffect, useMemo, useRef, useState} from 'react';
+import {Modal, Pressable, Text, TouchableOpacity, View} from 'react-native';
+import {useStore, useStores} from '@store';
+import resolveSystemErrorMessage from '@controleonline/ui-common/src/react/utils/systemErrorMessage';
+
+const AUTO_CLOSE_MS = 5000;
+
+const resolveText = value => String(value ?? '').trim();
+
+const normalizeStoreNames = (store, stores) => {
+  const resolvedStoreNames = [
+    ...(Array.isArray(store) ? store : store ? [store] : []),
+    ...(Array.isArray(stores) ? stores : []),
+  ];
+
+  return resolvedStoreNames.filter(name => typeof name === 'string' && name.trim()).map(name => name.trim());
+};
+
+const pickThemeColor = (colors, keys, fallback) => {
+  for (const key of keys) {
+    const value = colors?.[key];
+
+    if (typeof value === 'string' && value.trim()) {
+      return value.trim();
+    }
+  }
+
+  return fallback;
+};
+
+const DefaultErrors = ({
+  store = null,
+  stores = [],
+  error = null,
+  title = '',
+  message = '',
+  compact = false,
+  align = 'center',
+  onRetry = null,
+  retryLabel = 'Tentar novamente',
+  containerStyle = null,
+  contentStyle = null,
+  titleStyle = null,
+  messageStyle = null,
+  retryButtonStyle = null,
+  retryTextStyle = null,
+}) => {
+  const themeStore = useStore('theme');
+  const themeColors = themeStore?.getters?.colors || {};
+  const allStores = typeof useStores === 'function' ? useStores(state => state) : null;
+  const storeNames = useMemo(() => normalizeStoreNames(store, stores), [store, stores]);
+  const watchedStoreEntries = useMemo(() => {
+    if (!allStores || storeNames.length === 0) {
+      return [];
+    }
+
+    return storeNames
+      .map(storeName => {
+        const currentStore = allStores?.[storeName] || null;
+        const storeError = resolveSystemErrorMessage(currentStore?.getters?.error);
+
+        if (!storeError) {
+          return null;
+        }
+
+        return {
+          error: storeError,
+          name: storeName,
+          store: currentStore,
+        };
+      })
+      .filter(Boolean);
+  }, [allStores, storeNames]);
+
+  const explicitTitle = resolveText(title);
+  const explicitMessage = resolveText(message) || resolveSystemErrorMessage(error);
+  const hasStoreError = watchedStoreEntries.length > 0;
+  const activeStoreEntry = watchedStoreEntries[0] || null;
+  const visibleMessage = hasStoreError ? activeStoreEntry?.error || '' : explicitMessage;
+  const hasExplicitContent = storeNames.length === 0
+    ? Boolean(explicitTitle || explicitMessage || typeof onRetry === 'function')
+    : Boolean(explicitMessage || typeof onRetry === 'function');
+  const storeDriverSignature = hasStoreError
+    ? `store:${watchedStoreEntries.map(entry => `${entry.name}:${entry.error}`).join('|')}`
+    : '';
+  const explicitDriverSignature = hasExplicitContent
+    ? `explicit:${[explicitTitle, explicitMessage, typeof onRetry === 'function' ? 'retry' : '']
+        .map(value => resolveText(value))
+        .filter(Boolean)
+        .join('|')}`
+    : '';
+  const activeDriverSignature = storeDriverSignature || explicitDriverSignature;
+  const [dismissedSignatures, setDismissedSignatures] = useState(() => new Set());
+  const timerRef = useRef(null);
+  const textAlign = align === 'left' ? 'left' : 'center';
+  const accentColor = pickThemeColor(
+    themeColors,
+    ['inputErrorBorder', 'textDanger', 'modalBorder', 'primary'],
+    '#DC2626',
+  );
+  const backgroundColor = pickThemeColor(
+    themeColors,
+    ['inputErrorBackground', 'modalBackground', 'surface', 'background'],
+    '#FFFFFF',
+  );
+  const overlayColor = pickThemeColor(
+    themeColors,
+    ['modalOverlay', 'overlayBackground'],
+    'rgba(15, 23, 42, 0.55)',
+  );
+  const titleColor = pickThemeColor(
+    themeColors,
+    ['inputErrorText', 'textDanger', 'modalHeaderText', 'text'],
+    '#B91C1C',
+  );
+  const messageColor = pickThemeColor(
+    themeColors,
+    ['modalText', 'textSecondary', 'text'],
+    '#334155',
+  );
+  const closeColor = pickThemeColor(
+    themeColors,
+    ['modalCloseIcon', 'textDanger', 'primary'],
+    accentColor,
+  );
+  const retryAccentColor = pickThemeColor(themeColors, ['primary'], accentColor);
+
+  const clearStoreErrors = useCallback(() => {
+    watchedStoreEntries.forEach(entry => {
+      const setError = entry?.store?.actions?.setError;
+
+      if (typeof setError === 'function') {
+        setError('');
+      }
+    });
+  }, [watchedStoreEntries]);
+
+  const dismissPopup = useCallback(() => {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+
+    setDismissedSignatures(previous => {
+      const next = new Set(previous);
+
+      if (storeDriverSignature) {
+        next.add(storeDriverSignature);
+      }
+
+      if (explicitDriverSignature) {
+        next.add(explicitDriverSignature);
+      }
+
+      return next;
+    });
+
+    clearStoreErrors();
+  }, [clearStoreErrors, explicitDriverSignature, storeDriverSignature]);
+
+  const isVisible = Boolean(activeDriverSignature) && !dismissedSignatures.has(activeDriverSignature);
+  const hasContent = Boolean(explicitTitle || visibleMessage || typeof onRetry === 'function');
+
+  useEffect(() => {
+    if (!activeDriverSignature) {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+
+      setDismissedSignatures(previous => (previous.size > 0 ? new Set() : previous));
+      return undefined;
+    }
+
+    if (!isVisible) {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+
+      return undefined;
+    }
+
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+    }
+
+    timerRef.current = setTimeout(() => {
+      dismissPopup();
+    }, AUTO_CLOSE_MS);
+
+    return () => {
+      if (timerRef.current) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, [activeDriverSignature, dismissPopup, isVisible]);
+
+  if (!isVisible || !hasContent) {
+    return null;
+  }
+
+  return (
+    <Modal
+      animationType="fade"
+      onRequestClose={dismissPopup}
+      transparent
+      visible={isVisible}
+    >
+      <Pressable
+        accessibilityRole="button"
+        onPress={dismissPopup}
+        style={[
+          {
+            alignItems: 'center',
+            backgroundColor: overlayColor,
+            flex: 1,
+            justifyContent: 'center',
+            padding: 18,
+          },
+        ]}
+      >
+        <View
+          onStartShouldSetResponder={() => true}
+          style={[
+            {
+              backgroundColor,
+              borderColor: accentColor,
+              borderRadius: 16,
+              borderWidth: 1,
+              maxWidth: compact ? 360 : 440,
+              padding: compact ? 14 : 16,
+              shadowColor: accentColor,
+              shadowOffset: {height: 10, width: 0},
+              shadowOpacity: 0.12,
+              shadowRadius: 18,
+              width: '100%',
+              elevation: 12,
+            },
+            containerStyle,
+          ]}
+        >
+          <View
+            style={[
+              {
+                alignItems: 'flex-start',
+                flexDirection: 'row',
+                gap: 10,
+                justifyContent: 'space-between',
+              },
+              contentStyle,
+            ]}
+          >
+            <View style={{flex: 1, gap: explicitTitle ? 10 : 8}}>
+              {explicitTitle ? (
+                <Text
+                  style={[
+                    {
+                      color: titleColor,
+                      fontSize: compact ? 14 : 15,
+                      fontWeight: '800',
+                      textAlign,
+                    },
+                    titleStyle,
+                  ]}
+                >
+                  {explicitTitle}
+                </Text>
+              ) : null}
+
+              {visibleMessage ? (
+                <Text
+                  style={[
+                    {
+                      color: messageColor,
+                      fontSize: compact ? 12 : 13,
+                      lineHeight: compact ? 18 : 19,
+                      textAlign,
+                    },
+                    messageStyle,
+                  ]}
+                >
+                  {visibleMessage}
+                </Text>
+              ) : null}
+
+              {typeof onRetry === 'function' ? (
+                <TouchableOpacity
+                  accessibilityRole="button"
+                  activeOpacity={0.85}
+                  onPress={onRetry}
+                  style={[
+                    {
+                      alignItems: 'center',
+                      alignSelf: textAlign === 'left' ? 'flex-start' : 'center',
+                      borderRadius: 999,
+                      borderWidth: 1,
+                      borderColor: retryAccentColor,
+                      backgroundColor: `${retryAccentColor}14`,
+                      marginTop: 4,
+                      paddingHorizontal: 12,
+                      paddingVertical: 8,
+                    },
+                    retryButtonStyle,
+                  ]}
+                >
+                  <Text
+                    style={[
+                      {
+                        color: retryAccentColor,
+                        fontSize: 12,
+                        fontWeight: '800',
+                      },
+                      retryTextStyle,
+                    ]}
+                  >
+                    {retryLabel}
+                  </Text>
+                </TouchableOpacity>
+              ) : null}
+            </View>
+
+            <TouchableOpacity
+              accessibilityLabel="Fechar erro"
+              accessibilityRole="button"
+              activeOpacity={0.8}
+              onPress={dismissPopup}
+              testID="default-errors-close"
+              style={[
+                {
+                  alignItems: 'center',
+                  borderColor: accentColor,
+                  borderRadius: 999,
+                  borderWidth: 1,
+                  height: 28,
+                  justifyContent: 'center',
+                  width: 28,
+                },
+              ]}
+            >
+              <Text
+                style={{
+                  color: closeColor,
+                  fontSize: 16,
+                  fontWeight: '800',
+                  lineHeight: 16,
+                }}
+              >
+                ×
+              </Text>
+            </TouchableOpacity>
+          </View>
+        </View>
+      </Pressable>
+    </Modal>
+  );
+};
+
+export default DefaultErrors;

package/src/react/components/files/DefaultFile.js

@@ -0,0 +1,46 @@
+import React, {memo, useMemo} from 'react';
+import {Image} from 'react-native';
+import {useStore} from '@store';
+import {resolveDefaultFileSource} from '@controleonline/ui-common/src/react/utils/fileUrl';
+
+const resolveCompanyFromStore = peopleGetters => {
+  if (peopleGetters?.defaultCompany?.id) {
+    return peopleGetters.defaultCompany;
+  }
+
+  if (peopleGetters?.currentCompany?.id) {
+    return peopleGetters.currentCompany;
+  }
+
+  return null;
+};
+
+const DefaultFile = ({
+  file,
+  source,
+  company,
+  appDomain = '',
+  headers = {},
+  ...imageProps
+}) => {
+  const peopleStore = useStore('people');
+  const peopleGetters = peopleStore?.getters || {};
+  const resolvedCompany = company || resolveCompanyFromStore(peopleGetters);
+  const resolvedSource = useMemo(
+    () =>
+      resolveDefaultFileSource(source ?? file, {
+        company: resolvedCompany,
+        appDomain,
+        headers,
+      }),
+    [appDomain, company, file, headers, resolvedCompany, source],
+  );
+
+  if (!resolvedSource) {
+    return null;
+  }
+
+  return <Image {...imageProps} source={resolvedSource} />;
+};
+
+export default memo(DefaultFile);