@atlaskit/top-layer 0.3.0 → 0.5.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.
@@ -6,10 +6,15 @@
6
6
  * including timing semantics validated against Chromium via Playwright.
7
7
  *
8
8
  * Behaviour:
9
- * - beforetoggle: sync, cancelable on show only. toggle: async task, not cancelable.
9
+ * - beforetoggle: sync, cancelable on popover show only. toggle: async task, never cancelable.
10
10
  * - Rapid show/hide coalesces into one toggle event (originalOldState to finalNewState).
11
11
  * - Dialog: showModal/show fire beforetoggle+toggle. close fires toggle then close event.
12
12
  * - Popover open state tracked via `data-popover-open` (no `:popover-open` in jsdom).
13
+ * - Auto popovers: maintain an open stack, perform light-dismiss on document mousedown
14
+ * outside the open chain, and dismiss the topmost on Escape.
15
+ * - On open, removes any inline `opacity: 0` from the popover element so callers that
16
+ * rely on a `ResizeObserver` reveal callback (e.g. `use-anchor-positioning`) become
17
+ * visible in jsdom, where layout-driven RO callbacks never fire.
13
18
  *
14
19
  * Companion `toBeVisible` patch lives at `./to-be-visible`.
15
20
  *
@@ -17,32 +22,4 @@
17
22
  * prototypes. It is safe to import multiple times; each branch is guarded
18
23
  * to avoid overwriting native implementations or re-patching.
19
24
  */
20
- type TToggleState = 'open' | 'closed';
21
- /**
22
- * e.g. `<div#my-id.class-a.class-b>`
23
- */
24
- declare function describeElement({ element }: {
25
- element: Element;
26
- }): string;
27
- type TToggleEventInit = {
28
- type: string;
29
- oldState: TToggleState;
30
- newState: TToggleState;
31
- cancelable: boolean;
32
- };
33
- declare function createToggleEvent({ type, oldState, newState, cancelable }: TToggleEventInit): Event;
34
- declare function fireToggleEvent({ element, type, oldState, newState, cancelable, }: {
35
- element: Element;
36
- } & TToggleEventInit): boolean;
37
- declare function oppositeState({ state }: {
38
- state: TToggleState;
39
- }): TToggleState;
40
- declare function createToggleScheduler(): (args: {
41
- element: Element;
42
- newState: TToggleState;
43
- }) => void;
44
- declare function createDialogToggleScheduler(): (args: {
45
- dialog: HTMLDialogElement;
46
- newState: TToggleState;
47
- shouldFireCloseEvent: boolean;
48
- }) => void;
25
+ export {};
@@ -6,10 +6,15 @@
6
6
  * including timing semantics validated against Chromium via Playwright.
7
7
  *
8
8
  * Behaviour:
9
- * - beforetoggle: sync, cancelable on show only. toggle: async task, not cancelable.
9
+ * - beforetoggle: sync, cancelable on popover show only. toggle: async task, never cancelable.
10
10
  * - Rapid show/hide coalesces into one toggle event (originalOldState to finalNewState).
11
11
  * - Dialog: showModal/show fire beforetoggle+toggle. close fires toggle then close event.
12
12
  * - Popover open state tracked via `data-popover-open` (no `:popover-open` in jsdom).
13
+ * - Auto popovers: maintain an open stack, perform light-dismiss on document mousedown
14
+ * outside the open chain, and dismiss the topmost on Escape.
15
+ * - On open, removes any inline `opacity: 0` from the popover element so callers that
16
+ * rely on a `ResizeObserver` reveal callback (e.g. `use-anchor-positioning`) become
17
+ * visible in jsdom, where layout-driven RO callbacks never fire.
13
18
  *
14
19
  * Companion `toBeVisible` patch lives at `./to-be-visible`.
15
20
  *
@@ -17,32 +22,4 @@
17
22
  * prototypes. It is safe to import multiple times; each branch is guarded
18
23
  * to avoid overwriting native implementations or re-patching.
19
24
  */
20
- type TToggleState = 'open' | 'closed';
21
- /**
22
- * e.g. `<div#my-id.class-a.class-b>`
23
- */
24
- declare function describeElement({ element }: {
25
- element: Element;
26
- }): string;
27
- type TToggleEventInit = {
28
- type: string;
29
- oldState: TToggleState;
30
- newState: TToggleState;
31
- cancelable: boolean;
32
- };
33
- declare function createToggleEvent({ type, oldState, newState, cancelable }: TToggleEventInit): Event;
34
- declare function fireToggleEvent({ element, type, oldState, newState, cancelable, }: {
35
- element: Element;
36
- } & TToggleEventInit): boolean;
37
- declare function oppositeState({ state }: {
38
- state: TToggleState;
39
- }): TToggleState;
40
- declare function createToggleScheduler(): (args: {
41
- element: Element;
42
- newState: TToggleState;
43
- }) => void;
44
- declare function createDialogToggleScheduler(): (args: {
45
- dialog: HTMLDialogElement;
46
- newState: TToggleState;
47
- shouldFireCloseEvent: boolean;
48
- }) => void;
25
+ export {};
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atlaskit/top-layer",
3
- "version": "0.3.0",
3
+ "version": "0.5.0",
4
4
  "description": "Low-level layering primitives based on popover and dialog",
5
5
  "homepage": "https://atlassian.design/components/top-layer",
6
6
  "repository": "https://bitbucket.org/atlassian/atlassian-frontend-mirror",