@thibezer/ui-components-kit 2.9.0 → 2.10.1

package/dist/components/ui-tabela-propriedades/propriedades-dom-utils.d.ts

@@ -16,6 +16,11 @@ export declare function atualizarCampoVisual(shadow: ShadowRoot, propId: string,
  * (`data-externa`) em vez de o select exibir a primeira opção como se fosse o valor real.
  */
 export declare function sincronizarSelect(select: HTMLSelectElement, valor: any, corresponde?: (opcao: string, valor: any) => boolean, rotuloExterno?: (valor: any) => string): void;
+/**
+ * Exibe o estado misto ("Varia") no select: opção oculta e desabilitada, que o usuário não
+ * consegue escolher; qualquer outra opção vira o valor de todos os objetos.
+ */
+export declare function marcarSelectMisto(select: HTMLSelectElement, texto: string): void;
 export declare function focarProximoEditor(shadow: ShadowRoot, atual: HTMLElement): void;
 export declare function expandirTodasCategorias(shadow: ShadowRoot, categorias: CategoriaPropriedades[]): void;
 export declare function colapsarTodasCategorias(shadow: ShadowRoot, categorias: CategoriaPropriedades[]): void;

package/dist/components/ui-tabela-propriedades/propriedades-gerenciador-valores.d.ts

@@ -1,4 +1,6 @@
 import { CategoriaPropriedades } from './tipos';
+import { valoresIguais } from './propriedades-valor-misto';
+export { valoresIguais };
 export interface ContextoGerenciadorValores {
     hostElement: HTMLElement;
     getCategorias: () => CategoriaPropriedades[];
@@ -7,8 +9,6 @@ export interface ContextoGerenciadorValores {
     onRenderCategorias: () => void;
     isModoManual: () => boolean;
 }
-/** Igualdade de valores de propriedade: estrita, com null/undefined equivalentes e NaN igual a NaN. */
-export declare function valoresIguais(a: any, b: any): boolean;
 export declare class GerenciadorValoresPropriedades {
     private ctx;
     private valoresOriginais;
@@ -28,7 +28,7 @@ export declare class GerenciadorValoresPropriedades {
     registrarAlteracao(categoriaId: string, propId: string, novoValor: any): void;
     aplicar(): void;
     desfazer(): void;
-    /** Marca/desmarca a linha e recalcula os botões do rodapé (voltar ao original limpa o estado). */
+    /** Marca/desmarca a linha (modificada e mista) e recalcula os botões do rodapé (voltar ao original limpa o estado). */
     private aposAlterar;
     private categoriaDe;
     private emitirAlteracao;

package/dist/components/ui-tabela-propriedades/propriedades-valor-misto.d.ts

@@ -0,0 +1,25 @@
+import { ContextoEditorPropriedade, ItemPropriedade } from './tipos';
+/**
+ * Valor de uma propriedade que difere entre os objetos selecionados. `Symbol.for` mantém a
+ * identidade mesmo com duas cópias do pacote carregadas.
+ */
+export declare const VALOR_MISTO: unique symbol;
+/** Texto exibido no lugar do valor misto quando a aplicação não define `texto-misto`. */
+export declare const TEXTO_MISTO_PADRAO = "Varia";
+export declare function isValorMisto(valor: unknown): valor is typeof VALOR_MISTO;
+/** Texto do estado misto definido pela aplicação, com fallback para "Varia". */
+export declare function textoMistoDe(ctx: Pick<ContextoEditorPropriedade, 'obterTextoMisto'>): string;
+/** Igualdade de valores de propriedade: estrita, com null/undefined equivalentes e NaN igual a NaN. */
+export declare function valoresIguais(a: any, b: any): boolean;
+/** Valor inicial de um item: `misto: true` tem precedência sobre `valor`. */
+export declare function valorInicialDaPropriedade(prop: ItemPropriedade): any;
+/**
+ * Valor comum a todos os itens, ou `VALOR_MISTO` se algum diferir. Lista vazia → `undefined`.
+ */
+export declare function valorComum(valores: readonly unknown[]): any;
+/**
+ * Combina as propriedades dos objetos selecionados: cada chave recebe o valor comum ou
+ * `VALOR_MISTO`. Chave ausente em algum objeto conta como valor diferente.
+ * Uso: `painel.valores = combinarValores(formas.map(f => f.propriedades))`.
+ */
+export declare function combinarValores(registros: readonly unknown[]): Record<string, any>;

package/dist/components/ui-tabela-propriedades/tipos.d.ts

@@ -10,7 +10,10 @@ export interface ItemPropriedade {
     id: string;
     rotulo: string;
     tipo: TipoPropriedade;
+    /** Valor atual; `VALOR_MISTO` quando difere entre os objetos selecionados (exibe "Varia"). */
     valor: any;
+    /** Atalho para `valor: VALOR_MISTO`: a propriedade difere entre os objetos selecionados. */
+    misto?: boolean;
     unidade?: string;
     casasDecimais?: number;
     opcoes?: OpcaoPropriedade[];
@@ -45,4 +48,6 @@ export interface ContextoEditorPropriedade {
     registrarAlteracao: (categoriaId: string, propId: string, novoValor: any) => void;
     focarProximoEditor: (elementoAtual: HTMLElement) => void;
     despacharEventoAcao: (prop: ItemPropriedade, categoriaId: string) => void;
+    /** Texto exibido para valores mistos (atributo `texto-misto`); padrão "Varia". */
+    obterTextoMisto?: () => string;
 }

package/dist/components/ui-tabela-propriedades/ui-tabela-propriedades.d.ts

@@ -11,6 +11,7 @@ export * from './propriedades-painel-controles';
 export * from './propriedades-dom-utils';
 export * from './propriedades-flutuante';
 export * from './propriedades-densidade';
+export * from './propriedades-valor-misto';
 export declare class UITabelaPropriedades extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private shadow;
@@ -39,6 +40,12 @@ export declare class UITabelaPropriedades extends SafeHTMLElement {
     attributeChangedCallback(name: string, oldVal: string | null, newVal: string | null): void;
     get categorias(): CategoriaPropriedades[];
     set categorias(novasCategorias: CategoriaPropriedades[]);
+    /**
+     * Texto exibido nas propriedades cujo valor difere entre os objetos selecionados
+     * (`VALOR_MISTO`). Reflete o atributo `texto-misto`; padrão "Varia".
+     */
+    get textoMisto(): string;
+    set textoMisto(texto: string);
     get tipos(): SeletorTipoItem[];
     set tipos(novosTipos: SeletorTipoItem[]);
     get tipoSelecionado(): string;

package/dist/components/ui-texto/ui-texto.d.ts

@@ -3,6 +3,22 @@ export type VarianteTexto = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'corpo' |
 export type CorTexto = 'primaria' | 'secundaria' | 'destaque' | 'erro' | 'sucesso' | 'alerta';
 export type PesoTexto = 'normal' | 'medio' | 'seminegrito' | 'negrito';
 export type AlinhamentoTexto = 'esquerda' | 'centro' | 'direita' | 'justificado';
+/**
+ * Tipografia semântica do kit. Texto longo: `linhas` limita o bloco a N linhas com reticências
+ * e o conteúdo quebra palavras muito compridas em vez de estourar o contêiner.
+ *
+ * @element ui-texto
+ *
+ * @attr {string} variante - `h1`–`h6`, `corpo` (padrão), `corpo-sm`, `caption`, `codigo`.
+ * @attr {string} tag - Tag semântica do elemento interno (somente tags de texto permitidas).
+ * @attr {string} cor - `primaria`, `secundaria`, `destaque`, `erro`, `sucesso`, `alerta`.
+ * @attr {string} peso - `normal`, `medio`, `seminegrito`, `negrito`.
+ * @attr {string} alinhamento - `esquerda`, `centro`, `direita`, `justificado`.
+ * @attr {boolean} truncar - Uma linha com reticências.
+ * @attr {number} linhas - Limita a N linhas (1–50) com reticências; `truncar` tem prioridade.
+ *
+ * @csspart base - O elemento de texto interno.
+ */
 export declare class UITexto extends SafeHTMLElement {
     static get observedAttributes(): string[];
     private container;

package/dist/core/alvo-digitavel.d.ts

@@ -1 +1,6 @@
+/**
+ * O alvo real do evento (atravessando shadow roots) é um botão, link ou outro controle acionável?
+ * Serve para atalhos globais de Enter: com o foco num botão, o Enter pertence ao botão.
+ */
+export declare function focoEmControleAcionavel(evento: Event): boolean;
 export declare function focoEmCampoDeTexto(evento?: Event): boolean;

package/dist/core/opcoes.d.ts

@@ -7,3 +7,10 @@
 export declare function escolherOpcao<T extends string>(valor: string | null | undefined, permitidas: readonly T[], padrao: T): T;
 /** Como `escolherOpcao`, mas devolve `null` quando o valor não é reconhecido (opção opcional). */
 export declare function escolherOpcaoOpcional<T extends string>(valor: string | null | undefined, permitidas: readonly T[]): T | null;
+/**
+ * Converte um atributo numérico (hostil por definição) num inteiro dentro de [minimo, maximo].
+ * Texto vazio, não numérico, `NaN` ou `Infinity` devolvem `padrao`; valores fora da faixa são limitados.
+ */
+export declare function escolherInteiro(valor: string | number | null | undefined, minimo: number, maximo: number, padrao: number): number;
+/** Inteiro >= `minimo` ou `null` quando ausente/inválido (para limites opcionais como `maxlength`). */
+export declare function inteiroOuNulo(valor: string | null | undefined, minimo?: number): number | null;

package/dist/cores.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-controle-cores-uY__TgwW.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UIControleCores=r.UIControleCores;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarOpacidade=r.normalizarOpacidade;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});;/* empty css                 */const r=require("./ui-seletor-cor-Ft06TEUH.cjs"),e=require("./ui-controle-cores-CohlwXJK.cjs");exports.PALETA_CORES_PADRAO=r.PALETA_CORES_PADRAO;exports.UISeletorCor=r.UISeletorCor;exports.abrirSeletorCor=r.abrirSeletorCor;exports.coresUnicas=r.coresUnicas;exports.escaparHtml=r.escaparHtml;exports.fecharSeletorCor=r.fecharSeletorCor;exports.normalizarCor=r.normalizarCor;exports.normalizarEspessura=r.normalizarEspessura;exports.normalizarOpacidade=r.normalizarOpacidade;exports.UIControleCores=e.UIControleCores;

package/dist/cores.js

@@ -1,13 +1,15 @@
 /* empty css               */
-import { P as e, U as s, a as l, b as t, c as C, e as c, f as i, n as m, d as n } from "./ui-controle-cores-DgEza3wF.js";
+import { P as s, U as e, a as l, c as t, e as i, f as m, n as C, b as c, d as n } from "./ui-seletor-cor-D9iI7yew.js";
+import { U } from "./ui-controle-cores-DMtTUtLk.js";
 export {
-  e as PALETA_CORES_PADRAO,
-  s as UIControleCores,
-  l as UISeletorCor,
-  t as abrirSeletorCor,
-  C as coresUnicas,
-  c as escaparHtml,
-  i as fecharSeletorCor,
-  m as normalizarCor,
+  s as PALETA_CORES_PADRAO,
+  U as UIControleCores,
+  e as UISeletorCor,
+  l as abrirSeletorCor,
+  t as coresUnicas,
+  i as escaparHtml,
+  m as fecharSeletorCor,
+  C as normalizarCor,
+  c as normalizarEspessura,
   n as normalizarOpacidade
 };