@muxima-ui/core 1.1.0 → 1.3.0

package/types/muxima-ui-core-sidebar.d.ts

@@ -0,0 +1,115 @@
+import * as i0 from '@angular/core';
+
+/**
+ * Navegação lateral que recolhe para só ícones. O conteúdo fica dentro de um `<nav>`;
+ * recolhida, os nomes continuam lá para o leitor de ecrã e aparecem numa dica ao passar
+ * o rato ou com o foco.
+ *
+ * ```html
+ * <mx-sidebar [(collapsed)]="recolhida" aria-label="Principal">
+ *   <div mxSidebarHeader>Kianda</div>
+ *   <mx-sidebar-group label="Gestão">
+ *     <li><a mxSidebarItem routerLink="/facturas" routerLinkActive ariaCurrentWhenActive="page">
+ *       <svg mxSidebarIcon>...</svg><span mxSidebarLabel>Facturas</span>
+ *     </a></li>
+ *   </mx-sidebar-group>
+ *   <div mxSidebarFooter>...</div>
+ * </mx-sidebar>
+ * <button mxSidebarToggle [sidebar]="menu">...</button>
+ * ```
+ *
+ * O item da página actual leva aria-current="page" (o routerLinkActive faz isso com
+ * ariaCurrentWhenActive).
+ */
+declare class MxSidebar {
+    readonly collapsed: i0.ModelSignal<boolean>;
+    readonly ariaLabel: i0.InputSignal<string>;
+    /** `default` com fundo de superfície; `subtle` com o fundo do papel. */
+    readonly variant: i0.InputSignal<"default" | "subtle">;
+    readonly id: i0.InputSignal<string>;
+    private readonly doc;
+    /** A dica vive no body, para não ser cortada nem deslocada por contentores da página. */
+    private tipEl?;
+    constructor();
+    toggle(): void;
+    /** Mostra a dica de um item (só com a barra recolhida). */
+    showTip(el: HTMLElement): void;
+    hideTip(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebar, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MxSidebar, "mx-sidebar", ["mxSidebar"], { "collapsed": { "alias": "collapsed"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, { "collapsed": "collapsedChange"; }, never, ["[mxSidebarHeader]", "*", "[mxSidebarFooter]"], true, never>;
+}
+/** Link ou botão da barra. Põe o texto em `mxSidebarLabel` e o ícone em `mxSidebarIcon`. */
+declare class MxSidebarItem {
+    protected readonly sidebar: MxSidebar | null;
+    protected readonly el: HTMLElement;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarItem, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarItem, "a[mxSidebarItem], button[mxSidebarItem]", ["mxSidebarItem"], {}, {}, never, never, true, never>;
+}
+declare class MxSidebarLabel {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarLabel, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarLabel, "[mxSidebarLabel]", never, {}, {}, never, never, true, never>;
+}
+declare class MxSidebarIcon {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarIcon, "[mxSidebarIcon]", never, {}, {}, never, never, true, never>;
+}
+/** Contagem ou estado à direita do item; recolhida, passa a ponto. */
+declare class MxSidebarBadge {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarBadge, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarBadge, "[mxSidebarBadge]", never, {}, {}, never, never, true, never>;
+}
+declare class MxSidebarHeader {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarHeader, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarHeader, "[mxSidebarHeader]", never, {}, {}, never, never, true, never>;
+}
+declare class MxSidebarFooter {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarFooter, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarFooter, "[mxSidebarFooter]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Grupo de itens com título. O título dá nome à lista (aria-labelledby); recolhida,
+ * o título fica escondido só visualmente. Os itens vão em `<li>`.
+ */
+declare class MxSidebarGroup {
+    readonly label: i0.InputSignal<string>;
+    protected readonly labelId: string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarGroup, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MxSidebarGroup, "mx-sidebar-group", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}
+/**
+ * Secção que abre e fecha (botão com aria-expanded). Com a barra recolhida, carregar na
+ * secção expande a barra e abre a secção.
+ *
+ * ```html
+ * <li><mx-sidebar-section label="Relatórios" [(open)]="aberta">
+ *   <svg mxSidebarIcon>...</svg>
+ *   <li><a mxSidebarItem routerLink="/vendas"><span mxSidebarLabel>Vendas</span></a></li>
+ * </mx-sidebar-section></li>
+ * ```
+ */
+declare class MxSidebarSection {
+    readonly label: i0.InputSignal<string>;
+    readonly open: i0.ModelSignal<boolean>;
+    readonly disabled: i0.InputSignalWithTransform<boolean, unknown>;
+    private readonly sidebar;
+    protected readonly listId: string;
+    /** Recolhida, a secção não mostra os filhos. */
+    protected readonly isOpen: i0.Signal<boolean>;
+    protected toggle(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarSection, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MxSidebarSection, "mx-sidebar-section", never, { "label": { "alias": "label"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "open": "openChange"; }, never, ["[mxSidebarIcon]", "*"], true, never>;
+}
+/**
+ * Botão que recolhe e expande a barra. Tem aria-expanded e aria-controls; o nome muda
+ * entre "Recolher menu" e "Expandir menu" (ou os textos que passares).
+ */
+declare class MxSidebarToggle {
+    readonly sidebar: i0.InputSignal<MxSidebar>;
+    readonly collapseLabel: i0.InputSignal<string>;
+    readonly expandLabel: i0.InputSignal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxSidebarToggle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxSidebarToggle, "button[mxSidebarToggle]", ["mxSidebarToggle"], { "sidebar": { "alias": "sidebar"; "required": true; "isSignal": true; }; "collapseLabel": { "alias": "collapseLabel"; "required": false; "isSignal": true; }; "expandLabel": { "alias": "expandLabel"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+declare const MX_SIDEBAR: readonly [typeof MxSidebar, typeof MxSidebarItem, typeof MxSidebarLabel, typeof MxSidebarIcon, typeof MxSidebarBadge, typeof MxSidebarHeader, typeof MxSidebarFooter, typeof MxSidebarGroup, typeof MxSidebarSection, typeof MxSidebarToggle];
+
+export { MX_SIDEBAR, MxSidebar, MxSidebarBadge, MxSidebarFooter, MxSidebarGroup, MxSidebarHeader, MxSidebarIcon, MxSidebarItem, MxSidebarLabel, MxSidebarSection, MxSidebarToggle };

package/types/muxima-ui-core-timeline.d.ts

@@ -0,0 +1,59 @@
+import * as i0 from '@angular/core';
+
+type MxTimelineVariant = 'default' | 'accent' | 'success' | 'warning' | 'danger';
+/**
+ * Acontecimentos por ordem, sobre uma lista ordenada nativa: o leitor de ecrã anuncia
+ * "lista, 4 itens" e a posição de cada um.
+ *
+ * ```html
+ * <ol mxTimeline>
+ *   <li mxTimelineItem variant="success">
+ *     <time mxTimelineTime datetime="2026-10-27T09:40">27 out, 09:40</time>
+ *     <p mxTimelineTitle>Factura paga</p>
+ *     <p mxTimelineDescription>Banco Mutamba pagou FT 2026/0196.</p>
+ *   </li>
+ * </ol>
+ * ```
+ */
+declare class MxTimeline {
+    readonly orientation: i0.InputSignal<"vertical" | "horizontal">;
+    readonly size: i0.InputSignal<"sm" | "md">;
+    /** `alternate` põe os itens alternadamente dos dois lados da linha (só vertical, ecrãs largos). */
+    readonly align: i0.InputSignal<"start" | "alternate">;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimeline, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimeline, "ol[mxTimeline], ul[mxTimeline]", ["mxTimeline"], { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Um acontecimento. O marcador fica na linha; com `pending` aparece tracejado
+ * (passo ainda por acontecer). Diz isso também no texto, para o leitor de ecrã.
+ */
+declare class MxTimelineItem {
+    readonly variant: i0.InputSignal<MxTimelineVariant>;
+    readonly pending: i0.InputSignalWithTransform<boolean, unknown>;
+    /** Marcador maior, com espaço para um ícone (mxTimelineIcon). */
+    readonly icon: i0.InputSignalWithTransform<boolean, unknown>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimelineItem, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimelineItem, "li[mxTimelineItem]", ["mxTimelineItem"], { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "pending": { "alias": "pending"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Ícone dentro do marcador (svg decorativo). Usa com `icon` no item. */
+declare class MxTimelineIcon {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimelineIcon, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimelineIcon, "[mxTimelineIcon]", never, {}, {}, never, never, true, never>;
+}
+/** Data ou hora do acontecimento. Usa um `<time datetime>`. */
+declare class MxTimelineTime {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimelineTime, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimelineTime, "[mxTimelineTime]", never, {}, {}, never, never, true, never>;
+}
+declare class MxTimelineTitle {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimelineTitle, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimelineTitle, "[mxTimelineTitle]", never, {}, {}, never, never, true, never>;
+}
+declare class MxTimelineDescription {
+    static ɵfac: i0.ɵɵFactoryDeclaration<MxTimelineDescription, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<MxTimelineDescription, "[mxTimelineDescription]", never, {}, {}, never, never, true, never>;
+}
+declare const MX_TIMELINE: readonly [typeof MxTimeline, typeof MxTimelineItem, typeof MxTimelineIcon, typeof MxTimelineTime, typeof MxTimelineTitle, typeof MxTimelineDescription];
+
+export { MX_TIMELINE, MxTimeline, MxTimelineDescription, MxTimelineIcon, MxTimelineItem, MxTimelineTime, MxTimelineTitle };
+export type { MxTimelineVariant };

package/types/muxima-ui-core.d.ts

@@ -1,3 +1,3 @@
-declare const MUXIMA_VERSION = "1.1.0";
+declare const MUXIMA_VERSION = "1.3.0";
 
 export { MUXIMA_VERSION };