@apollion-dsi/core 3.0.0

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

@@ -0,0 +1,10 @@
+/**
+ * Barrel público do componente `Link`.
+ *
+ * Reexporta o componente (renomeando `LinkComponent` → `Link` por
+ * compatibilidade), suas interfaces e os styles. O `Link.Button` é acessado
+ * como propriedade estática do `Link`, não como export separado.
+ */
+export { LinkComponent as Link } from './Link';
+export * from './Link.interface';
+export * from './Link.style';

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

@@ -0,0 +1 @@
+import{a,b,c,d,e}from"../../chunks/chunk-FVRWVTQD.esm.js";import"../../chunks/chunk-5XXISYUW.esm.js";import"../../chunks/chunk-XNBK5E7D.esm.js";import"../../chunks/chunk-3HHYBI4E.esm.js";import"../../chunks/chunk-3XS7RVYS.esm.js";import"../../chunks/chunk-QZYXRYI7.esm.js";import"../../chunks/chunk-VTRVGJA6.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{d as ExternalLinkButtonStyle,b as ExternalLinkStyle,e as Link,c as LinkButtonStyle,a as LinkStyle};

package/lib/elements/List/List.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import { ListInterface } from './List.interface';
+/**
+ * Lista de itens selecionáveis ou navegáveis.
+ *
+ * Renderiza um `<ul>` com itens descritos via `content`. Cada item pode ser:
+ * - selecionável (clique alterna `isSelected`) — single ou múltipla via `multiple`;
+ * - navegável (item.to vira um `<Link>`);
+ * - executável (item.action é chamado após o toggle).
+ *
+ * O estado de seleção é interno; use `onSelectItems`/`onItemClick` para
+ * observar mudanças.
+ *
+ * @example
+ * ```tsx
+ * <List content={[{ title: 'Item 1' }, { title: 'Item 2' }]} />
+ * <List multiple showCheckIcon content={items} onSelectItems={setSelected} />
+ * <List content={[{ title: 'Página', to: '/pagina' }]} />
+ * ```
+ *
+ * @see {@link ListInterface} para o detalhamento das props.
+ */
+export declare const List: React.ForwardRefExoticComponent<ListInterface & React.RefAttributes<HTMLUListElement>>;

package/lib/elements/List/List.interface.d.ts

@@ -0,0 +1,81 @@
+import { BaseContainerProps } from '../../containers/Base';
+import { FlexPropsInterface } from '../../containers/Flex';
+/**
+ * Forma mínima de um item da lista (sem callbacks/ícone).
+ *
+ * É o que callsites informam em `content` — a `List` adiciona `id` (nanoid)
+ * internamente se não vier.
+ */
+export type ItemContent = {
+    /** Identificador estável. Se omitido, é gerado via `nanoid`. */
+    id?: string;
+    /** URL de destino. Quando presente, o item vira um link e ignora o toggle. */
+    to?: string;
+    /** Conteúdo visível do item. Pode ser texto ou qualquer ReactNode. */
+    title: React.ReactNode;
+    /**
+     * Estado de seleção. Quando `showCheckIcon` é verdadeiro, itens selecionados
+     * exibem um ícone de check.
+     */
+    isSelected?: boolean;
+};
+/**
+ * Item completo. Adiciona o callback de ação (executado após o toggle) e o
+ * ícone customizado (substitui o check padrão).
+ */
+export interface ListContentType extends ItemContent {
+    /**
+     * Função chamada após o toggle do item. Recebe o item sem `action`/`icon`
+     * (para não serem serializados em logs).
+     */
+    action?: (item: ItemContent) => void;
+    /** Ícone customizado à esquerda do `title`. Substitui o check automático. */
+    icon?: React.ReactNode;
+}
+/**
+ * Props do componente `List`.
+ *
+ * @example
+ * ```tsx
+ * <List content={[{ title: 'Item 1' }, { title: 'Item 2' }]} />
+ * <List multiple showCheckIcon content={items} onSelectItems={setSelected} />
+ * ```
+ */
+export interface ListInterface extends FlexPropsInterface, Omit<React.ComponentPropsWithoutRef<'ul'>, 'children' | 'content'> {
+    /** Itens da lista. */
+    content: ListContentType[];
+    /**
+     * Permite selecionar mais de um item simultaneamente. Sem ela, selecionar
+     * um item desmarca os demais.
+     *
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * Exibe um ícone de check à esquerda dos itens selecionados (apenas em
+     * itens sem `to`).
+     *
+     * @default false
+     */
+    showCheckIcon?: boolean;
+    /**
+     * Chamado a cada mudança no array de seleção. Recebe a lista inteira com
+     * `isSelected` atualizado.
+     */
+    onSelectItems?: (l: ListContentType[]) => void;
+    /** Chamado quando um item é clicado. Recebe apenas o item clicado. */
+    onItemClick?: (l: ListContentType) => void;
+}
+/**
+ * Props do `ListItem` interno. Não é uma API pública — é o "shape" recebido do
+ * `List` que precisa estar tipado para o styled-component.
+ */
+export interface ListItemInterface extends BaseContainerProps, React.ComponentPropsWithoutRef<'li'> {
+    item: ListContentType;
+    action?: () => void;
+    showCheckIcon?: boolean;
+}
+/** Props recebidas pelo `ListItemStyle` para destacar itens selecionados. */
+export type LisItemStyle = {
+    isSelected?: boolean;
+};

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

@@ -0,0 +1,54 @@
+import { LisItemStyle } from './List.interface';
+/**
+ * Container da lista.
+ *
+ * Reseta os defaults do `<ul>` (`list-style`, `padding`, `margin`) porque
+ * herdar a aparência de "lista de navegação" do navegador raramente é
+ * desejado; o componente compõe o visual via `Flex`.
+ */
+export declare const ListStyle: 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;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, 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;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>>> & string;
+/**
+ * Item da lista.
+ *
+ * Usa `BackgroundFactory` condicional para aplicar o realce do estado
+ * selecionado (`neutral.40`) e o hover (`neutral.10` apenas em itens não
+ * selecionados — preserva a leitura de "qual está selecionado" mesmo durante
+ * o hover).
+ */
+export declare const ListItemStyle: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<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;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, "isSelected"> & LisItemStyle, never> & Partial<Pick<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;
+}, never> & Partial<Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement> & import("../..").ApollionProps & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, never>> & {
+    as?: import("styled-components").WebTarget;
+    forwardedAs?: import("styled-components").WebTarget;
+}, "isSelected"> & LisItemStyle, never>>> & string;

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

@@ -0,0 +1,9 @@
+/**
+ * Barrel público do componente `List`.
+ *
+ * Reexporta o componente, suas interfaces e o style. O `ListStyle`/`ListItemStyle`
+ * são expostos para que outros componentes (`Dropdown`) possam compor variantes.
+ */
+export * from './List';
+export * from './List.interface';
+export * from './List.style';

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

@@ -0,0 +1 @@
+import{a,b,c}from"../../chunks/chunk-7VYSPE3B.esm.js";import"../../chunks/chunk-LKD55J4V.esm.js";import"../../chunks/chunk-SKV75I6W.esm.js";import"../../chunks/chunk-DEAAQK5J.esm.js";import"../../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"../../chunks/chunk-KDYOOGW7.esm.js";import"../../chunks/chunk-6KYLIXBS.esm.js";import"../../chunks/chunk-FVRWVTQD.esm.js";import"../../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"../../chunks/chunk-XNBK5E7D.esm.js";import"../../chunks/chunk-3HHYBI4E.esm.js";import"../../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{c as List,b as ListItemStyle,a as ListStyle};

package/lib/elements/Modal/Modal.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+import { ModalComponentProps, ModalDialogProps } from './Modal.interface';
+/**
+ * Variante "controlada" do Modal — usa `isOpen`/`onDismiss` informados pelo
+ * pai. O componente é montado/desmontado via portal no `document.body` para
+ * escapar do `stacking context` do componente pai.
+ *
+ * O `mounted` state é necessário para evitar problemas de SSR: o portal só
+ * pode ser criado após hidratar.
+ */
+export declare const ModalBaseComponent: ({ isOpen, onDismiss, ...props }: ModalDialogProps) => React.ReactPortal;
+/**
+ * Variante "uncontrolled" — recebe um `trigger` (elemento ou função-render) e
+ * gerencia o estado internamente via `useToggle`. Loga aviso se o consumidor
+ * misturar `isOpen`/`onDismiss` com `trigger`.
+ */
+export declare const ModalTriggerVariant: ({ defaultOpen, trigger, isOpen, onDismiss, onModalOpen, ...props }: ModalComponentProps) => React.JSX.Element;
+/**
+ * Diálogo modal sobreposto à página.
+ *
+ * Aceita uso "controlado" (`isOpen`/`onDismiss` no pai) ou "uncontrolled"
+ * (`trigger` interno via `useToggle`). Renderiza via portal no
+ * `document.body` para escapar do `stacking context` do pai.
+ *
+ * O header inclui ícone, título, tagline e botão de fechar; o body tem scroll
+ * customizado; o footer (opcional) tem layout `right`/`expanded`/`full` e se
+ * adapta em mobile para `column-reverse`.
+ *
+ * @example
+ * ```tsx
+ * // Controlado
+ * <Modal isOpen={open} onDismiss={close} title="Título">
+ *   <Text text="Conteúdo" />
+ * </Modal>
+ *
+ * // Uncontrolled — usa um trigger
+ * <Modal trigger={<Button text="Abrir" />} title="Modal Title">
+ *   <Text text="Conteúdo" />
+ * </Modal>
+ * ```
+ *
+ * @see {@link ModalComponentProps} para o detalhamento das props.
+ */
+export declare const ModalComponent: {
+    ({ noCloseButton, secondaryText, primaryText, variant, footer, ...rest }: ModalComponentProps): React.JSX.Element;
+    displayName: string;
+};

package/lib/elements/Modal/Modal.interface.d.ts

@@ -0,0 +1,121 @@
+import React from 'react';
+import { NotificationVariants } from '../../containers';
+import { Theme } from '../../themes';
+/** Largura semântica do modal. Cada valor mapeia para min/max-width em `Modal.style`. */
+type ModalSizeType = 'small' | 'base' | 'medium' | 'large';
+/**
+ * Props do diálogo modal (sem o `trigger`).
+ *
+ * Usada na variante "controlada" — quando o estado de abertura é gerenciado
+ * pelo pai via `isOpen`/`onDismiss`.
+ */
+export type ModalDialogProps = {
+    /** Ícone exibido à esquerda do título no header. */
+    icon?: React.ReactNode;
+    /** Controla a abertura quando NÃO está usando `trigger`. */
+    isOpen?: boolean;
+    /** Chamado ao clicar no overlay ou no botão de fechar. */
+    onDismiss?: () => void;
+    /**
+     * Callback do botão primário do footer. Receber `{ close }` permite
+     * disparar a ação e fechar o modal na mesma função.
+     */
+    primaryAction?: (props: {
+        close: () => void;
+    }) => void;
+    /** Callback do botão secundário do footer. */
+    secondaryAction?: (props: {
+        close: () => void;
+    }) => void;
+    /** Substitui o botão primário padrão. Recebe `onClick` e `fullWidth` injetados. */
+    primaryButton?: React.ReactNode;
+    /** Substitui o botão secundário padrão (aceita render-prop). */
+    secondaryButton?: React.ReactNode | ((p: {
+        close: () => void;
+    }) => React.ReactNode);
+    /**
+     * Texto do botão primário (ignorado se `primaryButton` for informado).
+     *
+     * @default 'Confirmar'
+     */
+    primaryText?: string;
+    /**
+     * Texto do botão secundário (ignorado se `secondaryButton` for informado).
+     *
+     * @default 'Cancelar'
+     */
+    secondaryText?: string;
+    /**
+     * Disposição dos botões do footer.
+     * - `right`: ambos à direita (padrão).
+     * - `expanded`: secundário à esquerda, primário à direita.
+     * - `full`: apenas o primário, ocupando toda a largura.
+     *
+     * @default 'right'
+     */
+    footer?: 'expanded' | 'right' | 'full';
+    /** Texto auxiliar exibido abaixo do título. */
+    tagline?: string;
+    /** Corpo do modal. */
+    children?: React.ReactNode;
+    /**
+     * Cor temática (usada no ícone e no botão primário).
+     *
+     * @default 'primary'
+     */
+    variant?: NotificationVariants;
+    /**
+     * Largura semântica do modal.
+     *
+     * @default 'base'
+     */
+    size?: ModalSizeType;
+    /** Título exibido no header. */
+    title?: string;
+    /**
+     * Esconde o botão de fechar do header. Reservado para fluxos onde o modal
+     * só pode sair via ação confirmada (ex.: aceitar termos).
+     *
+     * @default false
+     */
+    noCloseButton?: boolean;
+    /** Callback disparado quando o modal abre — útil para tracking. */
+    onModalOpen?: () => void;
+    /** `aria-role` customizado (ex.: `alertdialog`). */
+    role?: React.AriaRole;
+};
+/**
+ * Props completas do `Modal`.
+ *
+ * Estende {@link ModalDialogProps} adicionando `trigger` e `defaultOpen` para
+ * a variante "uncontrolled". Se `trigger` for informado, `isOpen`/`onDismiss`
+ * são ignorados (com aviso no console).
+ *
+ * @example
+ * ```tsx
+ * <Modal trigger={<Button text="Abrir" />} title="Confirmação">
+ *   <Text text="Tem certeza?" />
+ * </Modal>
+ * ```
+ */
+export type ModalComponentProps = {
+    /** Estado inicial do modal na variante uncontrolled. */
+    defaultOpen?: boolean;
+    /**
+     * Elemento ou função-render que abre o modal. Quando função, recebe
+     * `{ isOpen, open }`. Sua presença chaveia o componente para a variante
+     * "uncontrolled" — `isOpen`/`onDismiss` deixam de ter efeito.
+     */
+    trigger?: React.ReactNode | ((props: {
+        isOpen: boolean;
+        open: () => void;
+    }) => React.ReactNode);
+} & ModalDialogProps;
+/**
+ * Props recebidas pelos styled-components. Combina {@link ModalComponentProps}
+ * com o `theme` injetado pelo `ThemeProvider`.
+ */
+export type ModalStyleProps = {
+    theme: Theme;
+} & ModalComponentProps;
+export {};