@apollion-dsi/core 3.0.0

package/lib/elements/Tooltip/Tooltip.style.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Seta do tooltip.
+ *
+ * Renderiza um quadrado rotacionado 45° via pseudo-elemento — o `z-index: -1`
+ * garante que a seta fique atrás do container (e visualmente "saindo" dele).
+ * Posicionamento absoluto é controlado pelo Tippy via `data-popper-arrow`.
+ */
+export declare const Arrow: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;
+/**
+ * Container do tooltip.
+ *
+ * Os seletores `&[data-placement^='...']` ajustam a posição da seta conforme
+ * o lado onde o Tippy posicionou o tooltip — sem isso, a seta apareceria
+ * sempre no mesmo lugar independente da direção.
+ */
+export declare const TooltipContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, "theme" | keyof import("./Tooltip.interface").TooltipProps> & Partial<import("./Tooltip.interface").TooltipProps> & {
+    theme: import("../..").Theme;
+}, never> & Partial<Pick<import("styled-components").FastOmit<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, "theme" | keyof import("./Tooltip.interface").TooltipProps> & Partial<import("./Tooltip.interface").TooltipProps> & {
+    theme: import("../..").Theme;
+}, never>>> & string;

package/lib/elements/Tooltip/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Barrel público do componente `Tooltip`.
+ *
+ * Reexporta o componente (renomeando `TooltipComponent` → `Tooltip` por
+ * compatibilidade), suas interfaces e o style — usados pelo `Popover` para
+ * compor uma variante estruturada.
+ */
+export { TooltipComponent as Tooltip } from './Tooltip';
+export * from './Tooltip.interface';
+export * from './Tooltip.style';

package/lib/elements/Tooltip/index.esm.js

@@ -0,0 +1 @@
+import{a,b,c}from"../../chunks/chunk-HK3DHNXU.esm.js";import"../../chunks/chunk-XNBK5E7D.esm.js";import"../../chunks/chunk-WTWPQ4EL.esm.js";import"../../chunks/chunk-5OKRFXLL.esm.js";import"../../chunks/chunk-ELYUJKST.esm.js";import"../../chunks/chunk-TGTH3E4X.esm.js";import"../../chunks/chunk-752Z7BQF.esm.js";import"../../chunks/chunk-BNB3KNKE.esm.js";import"../../chunks/chunk-W663AGNE.esm.js";import"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-U27SLYIV.esm.js";import"../../chunks/chunk-JB7G6UGV.esm.js";import"../../chunks/chunk-GP7NECT4.esm.js";import"../../chunks/chunk-WAHR5LIT.esm.js";import"../../chunks/chunk-QUHHEZMP.esm.js";import"../../chunks/chunk-44EW3LMK.esm.js";import"../../chunks/chunk-OEH5ARPF.esm.js";import"../../chunks/chunk-V5AWVNU6.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{a as Arrow,c as Tooltip,b as TooltipContainer};

package/lib/elements/index.d.ts

@@ -0,0 +1,16 @@
+export * from './Avatar';
+export * from './Button';
+export * from './Dropdown';
+export * from './Icon';
+export * from './IconButton';
+export * from './Image';
+export * from './Label';
+export * from './Link';
+export * from './List';
+export * from './Modal';
+export * from './Popover';
+export * from './ProgressBar';
+export * from './Spinner';
+export * from './Svg';
+export * from './Tooltip';
+export * from './Text';

package/lib/elements/index.esm.js

@@ -0,0 +1 @@
+import"../chunks/chunk-GXCDUA3V.esm.js";import{a as J,b as K,c as L,d as M,e as N,f as O,g as P,h as Q}from"../chunks/chunk-EWFUWYNO.esm.js";import{a as U}from"../chunks/chunk-BKF5RIHP.esm.js";import{a as V}from"../chunks/chunk-7PD7R2RB.esm.js";import{a as C}from"../chunks/chunk-CSVGEHXH.esm.js";import{a as G}from"../chunks/chunk-OMBZMCKV.esm.js";import{a as D,b as E,c as F}from"../chunks/chunk-7VYSPE3B.esm.js";import{a as H,b as I}from"../chunks/chunk-JIDBKHKA.esm.js";import"../chunks/chunk-LKD55J4V.esm.js";import{a as R,b as S,c as T}from"../chunks/chunk-HK3DHNXU.esm.js";import"../chunks/chunk-SKV75I6W.esm.js";import"../chunks/chunk-DEAAQK5J.esm.js";import{a as h,b as i,m as j,n as k,o as p}from"../chunks/chunk-LZTZMWTK.esm.js";import"../chunks/chunk-G3IXCOJI.esm.js";import"../chunks/chunk-Q3FXXXUX.esm.js";import"../chunks/chunk-Z5OQHLDW.esm.js";import"../chunks/chunk-SHDMTEPB.esm.js";import"../chunks/chunk-DP6AXK72.esm.js";import"../chunks/chunk-NQBO2D7L.esm.js";import"../chunks/chunk-3DUB5C4Z.esm.js";import"../chunks/chunk-KT6QQ3UJ.esm.js";import"../chunks/chunk-FPQPDMPB.esm.js";import"../chunks/chunk-WZALORLW.esm.js";import{a as l,b as m,c as n,d as o}from"../chunks/chunk-KDYOOGW7.esm.js";import{a as v,b as w}from"../chunks/chunk-6KYLIXBS.esm.js";import{a as x,b as y,c as z,d as A,e as B}from"../chunks/chunk-FVRWVTQD.esm.js";import{a as q,b as r,c as s,d as t,e as u}from"../chunks/chunk-5XXISYUW.esm.js";import"../chunks/chunk-2ROOI4B2.esm.js";import"../chunks/chunk-KQQ7V7VG.esm.js";import"../chunks/chunk-3V3ZEGHO.esm.js";import"../chunks/chunk-A3OJEVGQ.esm.js";import"../chunks/chunk-KFFUMDHD.esm.js";import"../chunks/chunk-2FQC32AA.esm.js";import"../chunks/chunk-V77X6UJ2.esm.js";import"../chunks/chunk-GWCDFVWM.esm.js";import"../chunks/chunk-SPHHNZVP.esm.js";import"../chunks/chunk-I2E5B4NH.esm.js";import"../chunks/chunk-3QSPHURU.esm.js";import"../chunks/chunk-EKTJ3A6R.esm.js";import"../chunks/chunk-KR2X2UQG.esm.js";import"../chunks/chunk-BE2JDTVA.esm.js";import{a,b,c,d}from"../chunks/chunk-XNBK5E7D.esm.js";import"../chunks/chunk-3HHYBI4E.esm.js";import{a as e,b as f,c as g}from"../chunks/chunk-3XS7RVYS.esm.js";import"../chunks/chunk-QZYXRYI7.esm.js";import"../chunks/chunk-JTQYUIZP.esm.js";import"../chunks/chunk-VTRVGJA6.esm.js";import"../chunks/chunk-TAVNLEMI.esm.js";import"../chunks/chunk-WTWPQ4EL.esm.js";import"../chunks/chunk-5OKRFXLL.esm.js";import"../chunks/chunk-ELYUJKST.esm.js";import"../chunks/chunk-TGTH3E4X.esm.js";import"../chunks/chunk-752Z7BQF.esm.js";import"../chunks/chunk-BNB3KNKE.esm.js";import"../chunks/chunk-W663AGNE.esm.js";import"../chunks/chunk-A6Z2M2XU.esm.js";import"../chunks/chunk-U27SLYIV.esm.js";import"../chunks/chunk-JB7G6UGV.esm.js";import"../chunks/chunk-GP7NECT4.esm.js";import"../chunks/chunk-WAHR5LIT.esm.js";import"../chunks/chunk-QUHHEZMP.esm.js";import"../chunks/chunk-44EW3LMK.esm.js";import"../chunks/chunk-OEH5ARPF.esm.js";import"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{R as Arrow,C as Avatar,a as BaseText,u as Button,t as ButtonStyle,G as Dropdown,A as ExternalLinkButtonStyle,y as ExternalLinkStyle,m as GroupStyle,p as Icon,w as IconButton,v as IconButtonStyle,h as IconStyle,j as Image,k as ImageLazy,i as ImageStyle,I as Label,H as LabelStyle,B as Link,z as LinkButtonStyle,x as LinkStyle,F as List,E as ListItemStyle,D as ListStyle,Q as Modal,M as ModalBody,O as ModalContainer,K as ModalContentStyle,J as ModalDialogStyle,L as ModalHeader,N as ModalIconStyle,P as ModalOverlayStyle,n as PathStyle,U as Popover,V as ProgressBar,g as Spinner,f as SpinnerCircle,e as SpinnerStyle,o as Svg,l as SvgStyle,d as Text,T as Tooltip,S as TooltipContainer,s as buttonBaseStyles,q as buttonSize,r as buttonVariant,c as getTextProps,b as variantStyleProps};

package/lib/entities/debounce.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Cria uma versão debounce da função recebida — apenas a última invocação
+ * dentro do intervalo `wait` (em ms) é, de fato, executada.
+ *
+ * Diferenças em relação a um debounce clássico:
+ * - Retorna sempre uma `Promise` que resolve com o valor de `callback`.
+ *   Isso permite encadear `await` em handlers (`await debouncedFn(...)`).
+ * - Se `immediate` for `true`, a primeira invocação roda na hora E a próxima
+ *   só sai após o cooldown — útil para abrir um menu imediatamente e
+ *   ignorar cliques duplos rápidos.
+ *
+ * @example
+ * ```ts
+ * const search = debounce((q: string) => api.search(q), 300);
+ * input.addEventListener('input', (e) => search(e.target.value));
+ * ```
+ */
+export declare function debounce(callback: any, wait: any, immediate?: boolean): (...args: any[]) => Promise<unknown>;

package/lib/entities/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Barrel público das "entities" do `@apollion/core`.
+ *
+ * Concentra valores e funções que dependem (ou se protegem) do ambiente de
+ * execução: `debounce`, `timer` e as referências SSR-safe a `window`/
+ * `document.body`. Demais arquivos do projeto devem importar daqui — nunca
+ * de paths internos como `./window`.
+ */
+export * from './debounce';
+export * from './window';
+export * from './timer';

package/lib/entities/index.esm.js

@@ -0,0 +1 @@
+import{a,b,c,d,e}from"../chunks/chunk-V5AWVNU6.esm.js";import"../chunks/chunk-GZONWSRB.esm.js";export{d as $documentBody,c as $window,b as canuseDom,a as debounce,e as timer};

package/lib/entities/timer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Opções aceitas pela função `timer`.
+ *
+ * `step` é o intervalo (em ms) entre cada tick do contador — padrão `1000`,
+ * o que dá um pulso por segundo (ideal para countdowns de UI).
+ */
+type options = {
+    next: (t: number) => void;
+    onComplete?: () => void;
+    step?: number;
+};
+/**
+ * Cria um contador progressivo de `0` até `timeout` (inclusive), chamando
+ * `next(n)` a cada tick e `onComplete()` ao terminar.
+ *
+ * É escrito em cima de `setTimeout` agendados sequencialmente (em vez de um
+ * único `setInterval`) — evita drift cumulativo em pausas longas e permite
+ * cancelar o ciclo de forma limpa.
+ *
+ * Retorna uma função "cancel" que limpa o `setTimeout` pendente.
+ *
+ * @example
+ * ```ts
+ * const cancel = timer(5, {
+ *   next: (n) => console.log('faltam', 5 - n),
+ *   onComplete: () => console.log('done'),
+ * });
+ *
+ * // ...em algum lugar:
+ * cancel();
+ * ```
+ */
+export declare function timer(timeout: number, { step, ...opt }: options): () => void;
+export {};

package/lib/entities/window.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `true` quando o módulo está rodando num ambiente com `document` (browser ou
+ * jsdom). Usado como guarda em SSR para evitar erros do tipo
+ * "`document is not defined`".
+ */
+export declare const canuseDom: boolean;
+/**
+ * Referência ao `window` global quando disponível; `undefined` em SSR.
+ *
+ * É calculado uma vez no carregamento do módulo — preferimos esta referência
+ * a `globalThis.window` porque mantém um único ponto de checagem de
+ * disponibilidade e ajuda na narrowing dos consumidores.
+ */
+export declare const $window: Window & typeof globalThis;
+/**
+ * Referência ao `document.body` quando disponível; `undefined` em SSR.
+ *
+ * O cast para `HTMLElement` simplifica o uso em chamadas como `appendChild`,
+ * com a contrapartida de exigir do consumidor checar `canuseDom` antes em
+ * código que rode no servidor.
+ */
+export declare const $documentBody: HTMLElement;

package/lib/factory/BackgroundFactory/BackgroundFactory.d.ts

@@ -0,0 +1,28 @@
+import { BackgroundFactoryProps, BackgroundThemePropsType } from './BackgroundFactory.interface';
+/**
+ * Lista canônica das chaves controladas pelo `BackgroundFactory`.
+ *
+ * Consumida pelo `System` para distinguir entre props customizadas da Apollion
+ * e atributos HTML "puros" — props presentes nesta lista NÃO são repassadas
+ * ao DOM via `shouldForwardProp`.
+ */
+export declare const backgroundKeys: Array<keyof BackgroundFactoryProps>;
+/**
+ * Fábrica de estilos de fundo para componentes `styled` da Apollion.
+ *
+ * Retorna uma função que o `styled-components` invoca recebendo `theme` + props
+ * de contexto. Aceita `customProps` estáticas ou uma função que deriva as
+ * props a partir do contexto atual — o segundo formato é usado quando o valor
+ * depende, por exemplo, de uma variante.
+ *
+ * @example
+ * ```ts
+ * const Bg = styled.div(BackgroundFactory({ bgColor: 'primary' }));
+ *
+ * // Forma dinâmica:
+ * styled.div(BackgroundFactory(({ active }) => ({ bgColor: active ? 'primary' : 'neutral' })));
+ * ```
+ */
+export declare const BackgroundFactory: (customProps: BackgroundFactoryProps | ((o: any) => BackgroundFactoryProps)) => ({ theme, ...context }: BackgroundThemePropsType) => {
+    backgroundColor: string;
+};

package/lib/factory/BackgroundFactory/BackgroundFactory.interface.d.ts

@@ -0,0 +1,27 @@
+import { BgColorsTypes } from '../../themes/Colors';
+import { WithTheme } from '../../themes/ThemeProvider';
+/**
+ * Props consumidas pelo `BackgroundFactory`.
+ *
+ * Concentram apenas as propriedades de pintura de fundo que a fábrica conhece.
+ * Outras dimensões visuais (borda, espaçamento, etc.) ficam a cargo das suas
+ * respectivas fábricas — mantemos cada factory pequena e focada para compor
+ * estilos em camadas.
+ */
+export type BackgroundFactoryProps = {
+    /**
+     * Token do tema (`theme.colors`) usado como `background-color`. Aceita
+     * qualquer chave válida da paleta corrente — a resolução real acontece via
+     * `theme.colors(bgColor)`, permitindo trocar a paleta sem alterar
+     * componentes.
+     */
+    bgColor?: BgColorsTypes;
+};
+/**
+ * Variante de `BackgroundFactoryProps` enriquecida com o `theme` injetado pelo
+ * `ThemeProvider`.
+ *
+ * Use este tipo em assinaturas que precisam acessar o tema corrente; use
+ * `BackgroundFactoryProps` em chamadas estáticas (sem `theme`).
+ */
+export type BackgroundThemePropsType = WithTheme<BackgroundFactoryProps>;

package/lib/factory/BackgroundFactory/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Barrel público do módulo `BackgroundFactory`.
+ *
+ * Reexporta a fábrica (`BackgroundFactory`), a lista de chaves controladas
+ * (`backgroundKeys`) e os tipos de props. Demais arquivos do projeto devem
+ * importar daqui — nunca de paths internos como `./BackgroundFactory.interface`.
+ */
+export * from './BackgroundFactory';
+export * from './BackgroundFactory.interface';

package/lib/factory/BackgroundFactory/index.esm.js

@@ -0,0 +1 @@
+import{a,b}from"../../chunks/chunk-A6Z2M2XU.esm.js";import"../../chunks/chunk-GZONWSRB.esm.js";export{b as BackgroundFactory,a as backgroundKeys};