@acropole/skills 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -138,9 +138,9 @@ interface BubbleReaction {
138
138
  - `ButtonGroupRegistry` — Registro de um `hm-button` no `hm-button-group` que o contém (ver button-group.component.ts).
139
139
 
140
140
  ```ts
141
- interface ButtonGroupRegistry {
142
- register(button: ButtonComponent): void;
143
- unregister(button: ButtonComponent): void;
141
+ interface ButtonGroupRegistry {
142
+ register(button: ButtonComponent): void;
143
+ unregister(button: ButtonComponent): void;
144
144
  }
145
145
  ```
146
146
 
@@ -640,93 +640,93 @@ type HermesDropAccepts = string | readonly string[] | ((data: unknown, type: str
640
640
  - `HermesDropEvent` — Item solto numa zona (`[hmDropZone]` → `dropped`).
641
641
 
642
642
  ```ts
643
- interface HermesDropEvent<T = unknown> {
644
- readonly data: T;
645
- readonly type: string;
646
- readonly index: number;
647
- readonly previousIndex: number;
648
- readonly via: HermesDragVia;
643
+ interface HermesDropEvent<T = unknown> {
644
+ readonly data: T;
645
+ readonly type: string;
646
+ readonly index: number;
647
+ readonly previousIndex: number;
648
+ readonly via: HermesDragVia;
649
649
  }
650
650
  ```
651
651
 
652
652
  - `HermesDropOverEvent` — Ponteiro sobre uma zona (`[hmDropZone]` → `overPoint`), a cada movimento enquanto o item está sobre ela.
653
653
 
654
654
  ```ts
655
- interface HermesDropOverEvent<T = unknown> {
656
- readonly data: T;
657
- readonly type: string;
658
- readonly point: DragPoint;
659
- readonly offset: DragPoint;
660
- readonly rect: DOMRect;
655
+ interface HermesDropOverEvent<T = unknown> {
656
+ readonly data: T;
657
+ readonly type: string;
658
+ readonly point: DragPoint;
659
+ readonly offset: DragPoint;
660
+ readonly rect: DOMRect;
661
661
  }
662
662
  ```
663
663
 
664
664
  - `HermesSortEvent` — Item solto numa lista ordenável (`[hmSortable]` → `sorted`), na mesma lista ou vindo de outra do grupo.
665
665
 
666
666
  ```ts
667
- interface HermesSortEvent<T = unknown> extends HermesDropEvent<T> {
668
- readonly container: readonly T[];
669
- readonly previousContainer: readonly unknown[];
670
- readonly sameContainer: boolean;
667
+ interface HermesSortEvent<T = unknown> extends HermesDropEvent<T> {
668
+ readonly container: readonly T[];
669
+ readonly previousContainer: readonly unknown[];
670
+ readonly sameContainer: boolean;
671
671
  }
672
672
  ```
673
673
 
674
674
  - `HermesDragTemplateContext` — Contexto dos templates `hmDragPreview`/`hmDragPlaceholder`: `let-data`.
675
675
 
676
676
  ```ts
677
- interface HermesDragTemplateContext<T = unknown> {
678
- readonly $implicit: T;
677
+ interface HermesDragTemplateContext<T = unknown> {
678
+ readonly $implicit: T;
679
679
  }
680
680
  ```
681
681
 
682
682
  - `HermesDragItemRef` — @internal Um item arrastável, visto pelo serviço.
683
683
 
684
684
  ```ts
685
- interface HermesDragItemRef {
686
- readonly element: HTMLElement;
687
- readonly container: HermesDropTargetRef | null;
688
- data(): unknown;
689
- type(): string;
690
- label(): string;
691
- disabled(): boolean;
692
- contained(): boolean;
693
- focusTarget(): HTMLElement;
694
- previewTemplate(): TemplateRef<HermesDragTemplateContext> | null;
695
- setDragging(via: HermesDragVia | null): void;
696
- started(via: HermesDragVia): void;
697
- ended(dropped: boolean): void;
685
+ interface HermesDragItemRef {
686
+ readonly element: HTMLElement;
687
+ readonly container: HermesDropTargetRef | null;
688
+ data(): unknown;
689
+ type(): string;
690
+ label(): string;
691
+ disabled(): boolean;
692
+ contained(): boolean;
693
+ focusTarget(): HTMLElement;
694
+ previewTemplate(): TemplateRef<HermesDragTemplateContext> | null;
695
+ setDragging(via: HermesDragVia | null): void;
696
+ started(via: HermesDragVia): void;
697
+ ended(dropped: boolean): void;
698
698
  }
699
699
  ```
700
700
 
701
701
  - `HermesDropTargetRef` — @internal Um destino (zona simples ou lista ordenável), visto pelo serviço.
702
702
 
703
703
  ```ts
704
- interface HermesDropTargetRef {
705
- readonly element: HTMLElement;
706
- label(): string;
707
- disabled(): boolean;
708
- accepts(item: HermesDragItemRef): boolean;
709
- orientation(): DragListOrientation | null;
710
- columns(): number;
711
- items(): readonly HermesDragItemRef[];
712
- placeholderTemplate(): TemplateRef<HermesDragTemplateContext> | null;
713
- setState(active: boolean, over: boolean): void;
714
- drop(item: HermesDragItemRef, index: number, previousIndex: number, via: HermesDragVia): void;
715
- pointerIndex?(item: HermesDragItemRef, point: DragPoint): number | null;
716
- keyboardIndex?(item: HermesDragItemRef, index: number, key: string): number | null;
717
- originIndex?(item: HermesDragItemRef): number;
718
- announcement?(kind: 'grabbed' | 'over' | 'dropped', item: HermesDragItemRef, index: number): string | null;
719
- indicate?(index: number | null): void;
720
- pointerOver?(item: HermesDragItemRef, point: DragPoint): void;
704
+ interface HermesDropTargetRef {
705
+ readonly element: HTMLElement;
706
+ label(): string;
707
+ disabled(): boolean;
708
+ accepts(item: HermesDragItemRef): boolean;
709
+ orientation(): DragListOrientation | null;
710
+ columns(): number;
711
+ items(): readonly HermesDragItemRef[];
712
+ placeholderTemplate(): TemplateRef<HermesDragTemplateContext> | null;
713
+ setState(active: boolean, over: boolean): void;
714
+ drop(item: HermesDragItemRef, index: number, previousIndex: number, via: HermesDragVia): void;
715
+ pointerIndex?(item: HermesDragItemRef, point: DragPoint): number | null;
716
+ keyboardIndex?(item: HermesDragItemRef, index: number, key: string): number | null;
717
+ originIndex?(item: HermesDragItemRef): number;
718
+ announcement?(kind: 'grabbed' | 'over' | 'dropped', item: HermesDragItemRef, index: number): string | null;
719
+ indicate?(index: number | null): void;
720
+ pointerOver?(item: HermesDragItemRef, point: DragPoint): void;
721
721
  }
722
722
  ```
723
723
 
724
724
  - `HermesSortableContainer` — @internal A lista ordenável que contém um `[hmDraggable]` (o item se registra nela).
725
725
 
726
726
  ```ts
727
- interface HermesSortableContainer extends HermesDropTargetRef {
728
- register(item: HermesDragItemRef): void;
729
- unregister(item: HermesDragItemRef): void;
727
+ interface HermesSortableContainer extends HermesDropTargetRef {
728
+ register(item: HermesDragItemRef): void;
729
+ unregister(item: HermesDragItemRef): void;
730
730
  }
731
731
  ```
732
732
 
@@ -791,14 +791,14 @@ type DrawerPosition = 'end' | 'start' | 'bottom';
791
791
  - `DropdownPosition` — Posição no formato do hermes-ui antigo (`hermesPosition`): `<lado>-<alinhamento>`.
792
792
 
793
793
  ```ts
794
- type DropdownPosition =
795
- | 'bottom-left'
796
- | 'bottom-right'
797
- | 'top-left'
798
- | 'top-right'
799
- | 'left-top'
800
- | 'left-bottom'
801
- | 'right-top'
794
+ type DropdownPosition =
795
+ | 'bottom-left'
796
+ | 'bottom-right'
797
+ | 'top-left'
798
+ | 'top-right'
799
+ | 'left-top'
800
+ | 'left-bottom'
801
+ | 'right-top'
802
802
  | 'right-bottom';
803
803
  ```
804
804
 
@@ -846,17 +846,17 @@ type EmptyHeadingLevel = 0 | 2 | 3 | 4 | 5 | 6;
846
846
  - `EventCalendarDateClick` — O que `dateClick` emite: o dia e, quando o clique foi na grade de horas, o horário (`'HH:mm'`, em meia hora).
847
847
 
848
848
  ```ts
849
- interface EventCalendarDateClick {
850
- readonly date: IsoDate;
851
- readonly time: string | null;
849
+ interface EventCalendarDateClick {
850
+ readonly date: IsoDate;
851
+ readonly time: string | null;
852
852
  }
853
853
  ```
854
854
 
855
855
  - `EventCalendarRangeChange` — O que `rangeChange` emite: o intervalo visível (fim exclusivo) e a visão — o que o app busca no servidor.
856
856
 
857
857
  ```ts
858
- interface EventCalendarRangeChange extends EventCalendarRange {
859
- readonly view: EventCalendarView;
858
+ interface EventCalendarRangeChange extends EventCalendarRange {
859
+ readonly view: EventCalendarView;
860
860
  }
861
861
  ```
862
862
 
@@ -864,13 +864,13 @@ interface EventCalendarRangeChange extends EventCalendarRange {
864
864
  - `CalendarEvent` _(de `@trismegisto/primitives`)_ — Um evento da agenda.
865
865
 
866
866
  ```ts
867
- interface CalendarEvent {
868
- readonly id: string;
869
- readonly title: string;
870
- readonly start: Date | string;
871
- readonly end?: Date | string | null;
872
- readonly allDay?: boolean;
873
- readonly color?: CalendarEventColor;
867
+ interface CalendarEvent {
868
+ readonly id: string;
869
+ readonly title: string;
870
+ readonly start: Date | string;
871
+ readonly end?: Date | string | null;
872
+ readonly allDay?: boolean;
873
+ readonly color?: CalendarEventColor;
874
874
  }
875
875
  ```
876
876
 
@@ -883,9 +883,9 @@ type CalendarEventColor = 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
883
883
  - `EventCalendarRange` _(de `@trismegisto/primitives`)_ — Intervalo de datas, fim **exclusivo** (`{ start: '2026-10-01', end: '2026-11-01' }` = outubro).
884
884
 
885
885
  ```ts
886
- interface EventCalendarRange {
887
- readonly start: IsoDate;
888
- readonly end: IsoDate;
886
+ interface EventCalendarRange {
887
+ readonly start: IsoDate;
888
+ readonly end: IsoDate;
889
889
  }
890
890
  ```
891
891
 
@@ -1522,9 +1522,9 @@ type MessageStatus = 'sending' | 'sent' | 'delivered' | 'read' | 'failed';
1522
1522
  - `MessageContext` — O que um `hm-bubble` dentro de um `hm-message` lê do pai (lado e autor).
1523
1523
 
1524
1524
  ```ts
1525
- interface MessageContext {
1526
- readonly align: Signal<MessageAlign>;
1527
- readonly author: Signal<string>;
1525
+ interface MessageContext {
1526
+ readonly align: Signal<MessageAlign>;
1527
+ readonly author: Signal<string>;
1528
1528
  }
1529
1529
  ```
1530
1530
 
@@ -1947,13 +1947,13 @@ abstract class HermesSidebarGroup {
1947
1947
  - `SidebarNode` — Um nó da árvore de navegação que o `hm-sidebar-node` sabe desenhar. Genérico: não conhece rota nem domínio.
1948
1948
 
1949
1949
  ```ts
1950
- interface SidebarNode {
1951
- id: string;
1952
- label: string;
1953
- icon?: string;
1954
- route: string | readonly unknown[];
1955
- children?: readonly SidebarNode[];
1956
- hidden?: boolean;
1950
+ interface SidebarNode {
1951
+ id: string;
1952
+ label: string;
1953
+ icon?: string;
1954
+ route: string | readonly unknown[];
1955
+ children?: readonly SidebarNode[];
1956
+ hidden?: boolean;
1957
1957
  }
1958
1958
  ```
1959
1959
 
@@ -3243,32 +3243,32 @@ type ModalSize = 'small' | 'medium' | 'large' | 'xlarge' | 'full';
3243
3243
  - `MenuItem` — Pop-over e menu de contexto: posicionamento e teclado, sem DOM nem framework.
3244
3244
 
3245
3245
  ```ts
3246
- interface MenuItem {
3247
- readonly id: string;
3248
- readonly label: string;
3249
- readonly icon?: string;
3250
- readonly shortcut?: string;
3251
- readonly disabled?: boolean;
3252
- readonly danger?: boolean;
3253
- readonly separatorAbove?: boolean;
3254
- readonly groupTitle?: string;
3255
- readonly children?: readonly MenuItem[];
3256
- readonly type?: MenuItemType;
3257
- readonly checked?: boolean;
3258
- readonly group?: string;
3259
- readonly value?: string;
3246
+ interface MenuItem {
3247
+ readonly id: string;
3248
+ readonly label: string;
3249
+ readonly icon?: string;
3250
+ readonly shortcut?: string;
3251
+ readonly disabled?: boolean;
3252
+ readonly danger?: boolean;
3253
+ readonly separatorAbove?: boolean;
3254
+ readonly groupTitle?: string;
3255
+ readonly children?: readonly MenuItem[];
3256
+ readonly type?: MenuItemType;
3257
+ readonly checked?: boolean;
3258
+ readonly group?: string;
3259
+ readonly value?: string;
3260
3260
  }
3261
3261
  ```
3262
3262
 
3263
3263
  - `MenuItemChange` — O que mudou ao marcar um item de estado (`checkbox`/`radio`).
3264
3264
 
3265
3265
  ```ts
3266
- interface MenuItemChange {
3267
- readonly id: string;
3268
- readonly type: MenuItemType;
3269
- readonly checked: boolean;
3270
- readonly group?: string;
3271
- readonly value?: string;
3266
+ interface MenuItemChange {
3267
+ readonly id: string;
3268
+ readonly type: MenuItemType;
3269
+ readonly checked: boolean;
3270
+ readonly group?: string;
3271
+ readonly value?: string;
3272
3272
  }
3273
3273
  ```
3274
3274
 
@@ -3287,13 +3287,13 @@ type PopoverAlign = 'start' | 'center' | 'end';
3287
3287
  - `PopoverAnchor` — Onde o menu abre, em coordenadas de viewport.
3288
3288
 
3289
3289
  ```ts
3290
- interface PopoverAnchor {
3291
- readonly x: number;
3292
- readonly y: number;
3293
- readonly right?: number;
3294
- readonly bottom?: number;
3295
- readonly side?: PopoverSide;
3296
- readonly align?: PopoverAlign;
3290
+ interface PopoverAnchor {
3291
+ readonly x: number;
3292
+ readonly y: number;
3293
+ readonly right?: number;
3294
+ readonly bottom?: number;
3295
+ readonly side?: PopoverSide;
3296
+ readonly align?: PopoverAlign;
3297
3297
  }
3298
3298
  ```
3299
3299
 
@@ -3466,9 +3466,9 @@ interface PaginationState {
3466
3466
  - `DateRange` — Intervalo de datas (`hm-date-range-picker`): as duas pontas no formato do controle (`valueFormat`).
3467
3467
 
3468
3468
  ```ts
3469
- interface DateRange {
3470
- readonly start: string | null;
3471
- readonly end: string | null;
3469
+ interface DateRange {
3470
+ readonly start: string | null;
3471
+ readonly end: string | null;
3472
3472
  }
3473
3473
  ```
3474
3474
 
@@ -3487,9 +3487,9 @@ type IsoDate = string;
3487
3487
  - `DisplayDatePattern` — Como a data é digitada/exibida num idioma: ordem das partes e separador (pt-BR `dd/mm/aaaa`, en-US `mm/dd/yyyy`, de-DE `dd.mm.yyyy`). Sai do `Intl`, não de uma tabela cravada.
3488
3488
 
3489
3489
  ```ts
3490
- interface DisplayDatePattern {
3491
- readonly order: readonly ('day' | 'month' | 'year')[];
3492
- readonly separator: string;
3490
+ interface DisplayDatePattern {
3491
+ readonly order: readonly ('day' | 'month' | 'year')[];
3492
+ readonly separator: string;
3493
3493
  }
3494
3494
  ```
3495
3495
 
@@ -3666,11 +3666,11 @@ type TimelineStatus = 'completed' | 'current' | 'pending' | 'error';
3666
3666
  - `DualListItem`
3667
3667
 
3668
3668
  ```ts
3669
- interface DualListItem {
3670
- readonly id: string;
3671
- readonly label: string;
3672
- readonly description?: string;
3673
- readonly disabled?: boolean;
3669
+ interface DualListItem {
3670
+ readonly id: string;
3671
+ readonly label: string;
3672
+ readonly description?: string;
3673
+ readonly disabled?: boolean;
3674
3674
  }
3675
3675
  ```
3676
3676
 
@@ -3689,30 +3689,30 @@ type ShortcutDisplayStep = readonly ShortcutKeyLabel[];
3689
3689
  - `ShortcutKeyLabel` — Uma tecla como aparece: o rótulo (`⌘`, `Ctrl`, `K`) e, se houver, o nome para leitor de tela.
3690
3690
 
3691
3691
  ```ts
3692
- interface ShortcutKeyLabel {
3693
- readonly label: string;
3694
- readonly name: ShortcutKeyName | null;
3692
+ interface ShortcutKeyLabel {
3693
+ readonly label: string;
3694
+ readonly name: ShortcutKeyName | null;
3695
3695
  }
3696
3696
  ```
3697
3697
 
3698
3698
  - `ShortcutKeyName` — Nome falado de uma tecla cujo rótulo é símbolo ou abreviação — chave do catálogo `shortcuts.keys`.
3699
3699
 
3700
3700
  ```ts
3701
- type ShortcutKeyName =
3702
- | 'command'
3703
- | 'control'
3704
- | 'option'
3705
- | 'alt'
3706
- | 'shift'
3707
- | 'meta'
3708
- | 'up'
3709
- | 'down'
3710
- | 'left'
3711
- | 'right'
3712
- | 'space'
3713
- | 'enter'
3714
- | 'escape'
3715
- | 'backspace'
3701
+ type ShortcutKeyName =
3702
+ | 'command'
3703
+ | 'control'
3704
+ | 'option'
3705
+ | 'alt'
3706
+ | 'shift'
3707
+ | 'meta'
3708
+ | 'up'
3709
+ | 'down'
3710
+ | 'left'
3711
+ | 'right'
3712
+ | 'space'
3713
+ | 'enter'
3714
+ | 'escape'
3715
+ | 'backspace'
3716
3716
  | 'tab';
3717
3717
  ```
3718
3718