@atom63/ui-foundation 0.1.1-beta.3 → 0.1.1-beta.4

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.
package/dist/index.js CHANGED
@@ -870,7 +870,7 @@ var crossRendererContracts = [
870
870
  "foundationAxis": "states",
871
871
  "catalogItem": "radioGroup",
872
872
  "reactRenderer": "RadioGroup / Radio",
873
- "swiftUIRenderer": "Picker(.inline) / AtomSelectionRow group",
873
+ "swiftUIRenderer": "Picker(.inline) in a Form / AtomSelectionRow group",
874
874
  "intent": "Choose exactly one value from a visible set of mutually exclusive options.",
875
875
  "parity": "platform-adaptive",
876
876
  "requiredStates": [
@@ -893,7 +893,7 @@ var crossRendererContracts = [
893
893
  "Uses radiogroup and radio semantics with circular indicators and keyboard movement."
894
894
  ],
895
895
  "swiftUI": [
896
- "Uses an inline Picker or grouped AtomSelectionRow controls with native selected traits and touch targets."
896
+ "Uses an inline Picker inside a Form or List, where each option is a row with the native selected trait (outside one, iOS draws a wheel), or grouped AtomSelectionRow controls."
897
897
  ]
898
898
  }
899
899
  },
@@ -1073,7 +1073,7 @@ var crossRendererContracts = [
1073
1073
  "foundationAxis": "states",
1074
1074
  "catalogItem": "tabs",
1075
1075
  "reactRenderer": "Tabs",
1076
- "swiftUIRenderer": "TabView",
1076
+ "swiftUIRenderer": "Picker(.segmented) with the selected content",
1077
1077
  "intent": "Switch between peer destinations or content views while keeping one selection active.",
1078
1078
  "parity": "platform-adaptive",
1079
1079
  "requiredStates": [
@@ -1095,7 +1095,7 @@ var crossRendererContracts = [
1095
1095
  "Uses tablist, tab, and tabpanel semantics with keyboard navigation and a visual indicator."
1096
1096
  ],
1097
1097
  "swiftUI": [
1098
- "Uses native TabView presentation, which may render as a tab bar, sidebar, or page control by platform and context."
1098
+ "In-page sections use a segmented Picker above the content it selects, so each tab is a named, selectable button. TabView stays the renderer for app-level sections such as a tab bar or sidebar."
1099
1099
  ]
1100
1100
  }
1101
1101
  },
@@ -1513,7 +1513,55 @@ var accordionPattern = {
1513
1513
  result: "Moves focus to the previous focusable element: past a collapsed panel, the previous header.",
1514
1514
  then: { focus: { part: "header", at: 1 } }
1515
1515
  }
1516
- ]
1516
+ ],
1517
+ ios: {
1518
+ parts: {
1519
+ header: {
1520
+ description: "A disclosure group header: a button named by its label. iOS does not report expanded state to XCUITest, so the checks follow the content it reveals.",
1521
+ name: "required",
1522
+ type: "button"
1523
+ },
1524
+ panel: {
1525
+ description: "Text of a disclosure group's content.",
1526
+ name: "required",
1527
+ type: "staticText"
1528
+ }
1529
+ },
1530
+ structure: [
1531
+ { target: { part: "header", label: "Implementation details" }, enabled: true },
1532
+ { target: { part: "header", label: "Unavailable details" }, enabled: false },
1533
+ {
1534
+ target: { part: "panel", label: "Native SwiftUI renderer with shared product intent." },
1535
+ exists: false
1536
+ }
1537
+ ],
1538
+ interactions: [
1539
+ {
1540
+ id: "activation-expands",
1541
+ action: "tap",
1542
+ on: { part: "header", label: "Implementation details" },
1543
+ result: "Expands the section and shows its content.",
1544
+ then: [
1545
+ {
1546
+ target: { part: "panel", label: "Native SwiftUI renderer with shared product intent." },
1547
+ exists: true
1548
+ }
1549
+ ]
1550
+ },
1551
+ {
1552
+ id: "activation-collapses",
1553
+ action: "tap",
1554
+ on: { part: "header", label: "Implementation details" },
1555
+ result: "Collapses the section and hides its content.",
1556
+ then: [
1557
+ {
1558
+ target: { part: "panel", label: "Native SwiftUI renderer with shared product intent." },
1559
+ exists: false
1560
+ }
1561
+ ]
1562
+ }
1563
+ ]
1564
+ }
1517
1565
  };
1518
1566
 
1519
1567
  // src/a11y/dialog.ts
@@ -1587,7 +1635,51 @@ var dialogModalPattern = {
1587
1635
  equals: "true"
1588
1636
  }
1589
1637
  ],
1590
- keyboard: modalDialogKeyboard("dialog")
1638
+ keyboard: modalDialogKeyboard("dialog"),
1639
+ ios: {
1640
+ parts: {
1641
+ trigger: {
1642
+ description: "The button that opens the sheet.",
1643
+ name: "required",
1644
+ type: "button"
1645
+ },
1646
+ title: {
1647
+ description: "The sheet's title, which names it.",
1648
+ name: "required",
1649
+ scope: "app",
1650
+ type: "staticText"
1651
+ },
1652
+ close: {
1653
+ description: "The sheet's close action.",
1654
+ name: "required",
1655
+ scope: "app",
1656
+ type: "button"
1657
+ }
1658
+ },
1659
+ structure: [{ target: { part: "trigger", label: "Open project sheet" }, exists: true }],
1660
+ interactions: [
1661
+ {
1662
+ id: "activation-opens-sheet",
1663
+ action: "tap",
1664
+ on: { part: "trigger", label: "Open project sheet" },
1665
+ result: "Opens the sheet, named by its title, with a way to close it.",
1666
+ then: [
1667
+ { target: { part: "title", label: "Project details" }, exists: true },
1668
+ { target: { part: "close", label: "Done" }, exists: true }
1669
+ ]
1670
+ },
1671
+ {
1672
+ id: "close-dismisses-sheet",
1673
+ action: "tap",
1674
+ on: { part: "close", label: "Done" },
1675
+ result: "Closes the sheet and returns to the view that opened it.",
1676
+ then: [
1677
+ { target: { part: "title", label: "Project details" }, exists: false },
1678
+ { target: { part: "trigger", label: "Open project sheet" }, exists: true }
1679
+ ]
1680
+ }
1681
+ ]
1682
+ }
1591
1683
  };
1592
1684
 
1593
1685
  // src/a11y/alert-dialog.ts
@@ -1629,7 +1721,45 @@ var alertDialogPattern = {
1629
1721
  resolves: true
1630
1722
  }
1631
1723
  ],
1632
- keyboard: modalDialogKeyboard("dialog")
1724
+ keyboard: modalDialogKeyboard("dialog"),
1725
+ ios: {
1726
+ parts: {
1727
+ trigger: {
1728
+ description: "The button that asks for confirmation.",
1729
+ name: "required",
1730
+ type: "button"
1731
+ },
1732
+ alert: {
1733
+ description: "The system alert, named by its title.",
1734
+ name: "required",
1735
+ scope: "app",
1736
+ type: "alert"
1737
+ },
1738
+ cancel: {
1739
+ description: "The alert's cancel action.",
1740
+ name: "required",
1741
+ scope: "app",
1742
+ type: "button"
1743
+ }
1744
+ },
1745
+ structure: [{ target: { part: "trigger", at: "first" }, exists: true }],
1746
+ interactions: [
1747
+ {
1748
+ id: "activation-opens-alert",
1749
+ action: "tap",
1750
+ on: { part: "trigger", at: "first" },
1751
+ result: "Opens the alert dialog, named by its title.",
1752
+ then: [{ target: { part: "alert", at: "first" }, exists: true }]
1753
+ },
1754
+ {
1755
+ id: "cancel-closes-alert",
1756
+ action: "tap",
1757
+ on: { part: "cancel", label: "Cancel" },
1758
+ result: "Closes the alert without performing the action.",
1759
+ then: [{ target: { part: "alert" }, exists: false }]
1760
+ }
1761
+ ]
1762
+ }
1633
1763
  };
1634
1764
 
1635
1765
  // src/a11y/checkbox.ts
@@ -1931,7 +2061,49 @@ var comboboxSelectOnlyPattern = {
1931
2061
  attributes: [COLLAPSED, selected("first")]
1932
2062
  }
1933
2063
  }
1934
- ]
2064
+ ],
2065
+ ios: {
2066
+ parts: {
2067
+ trigger: {
2068
+ description: "A menu-style picker: a button named by its label, with the current value in the label.",
2069
+ name: "required",
2070
+ type: "button"
2071
+ },
2072
+ option: {
2073
+ description: "An option in the list the picker opens; the current one is selected.",
2074
+ name: "required",
2075
+ scope: "popup",
2076
+ type: "button"
2077
+ }
2078
+ },
2079
+ structure: [
2080
+ { target: { part: "trigger", at: "first" }, labelIncludes: "Draft" },
2081
+ { target: { part: "trigger", at: "last" }, enabled: false }
2082
+ ],
2083
+ interactions: [
2084
+ {
2085
+ id: "activation-opens-options",
2086
+ action: "tap",
2087
+ on: { part: "trigger", at: "first" },
2088
+ result: "Opens the list of options with the current one selected.",
2089
+ then: [
2090
+ { target: { part: "option" }, exists: true },
2091
+ { target: { part: "option", label: "Draft" }, selected: true },
2092
+ { target: { part: "option", label: "Active" }, selected: false }
2093
+ ]
2094
+ },
2095
+ {
2096
+ id: "choosing-an-option-closes-and-updates",
2097
+ action: "tap",
2098
+ on: { part: "option", label: "Active" },
2099
+ result: "Selects the option, closes the list and shows the new value.",
2100
+ then: [
2101
+ { target: { part: "option" }, exists: false },
2102
+ { target: { part: "trigger", at: "first" }, labelIncludes: "Active" }
2103
+ ]
2104
+ }
2105
+ ]
2106
+ }
1935
2107
  };
1936
2108
 
1937
2109
  // src/a11y/menu.ts
@@ -2134,7 +2306,43 @@ var menuButtonPattern = {
2134
2306
  result: "Moves focus out of the menu and closes it.",
2135
2307
  then: { open: false }
2136
2308
  }
2137
- ]
2309
+ ],
2310
+ ios: {
2311
+ parts: {
2312
+ trigger: {
2313
+ description: "The menu button, named by its label.",
2314
+ name: "required",
2315
+ type: "button"
2316
+ },
2317
+ item: {
2318
+ description: "A menu item: a button named by its label; a checked choice is selected and an unavailable one disabled.",
2319
+ name: "required",
2320
+ scope: "popup",
2321
+ type: "button"
2322
+ }
2323
+ },
2324
+ structure: [{ target: { part: "trigger", at: "first" }, exists: true }],
2325
+ interactions: [
2326
+ {
2327
+ id: "activation-opens-menu",
2328
+ action: "tap",
2329
+ on: { part: "trigger", at: "first" },
2330
+ result: "Opens the menu.",
2331
+ then: [
2332
+ { target: { part: "item" }, exists: true },
2333
+ { target: { part: "item", label: "Show details" }, selected: true },
2334
+ { target: { part: "item", label: "Unavailable action" }, enabled: false }
2335
+ ]
2336
+ },
2337
+ {
2338
+ id: "activating-an-item-closes-menu",
2339
+ action: "tap",
2340
+ on: { part: "item", label: "Duplicate" },
2341
+ result: "Performs the action and closes the menu.",
2342
+ then: [{ target: { part: "item" }, exists: false }]
2343
+ }
2344
+ ]
2345
+ }
2138
2346
  };
2139
2347
 
2140
2348
  // src/a11y/radio.ts
@@ -2254,7 +2462,39 @@ var radioPattern = {
2254
2462
  "last",
2255
2463
  "On the first radio, moves focus to the last radio and checks it."
2256
2464
  )
2257
- ]
2465
+ ],
2466
+ ios: {
2467
+ parts: {
2468
+ group: {
2469
+ description: "The group's label, shown as the heading of its options.",
2470
+ name: "required",
2471
+ type: "staticText"
2472
+ },
2473
+ option: {
2474
+ description: "An option: a button named by its label; the chosen one is selected and an unavailable one disabled.",
2475
+ name: "required",
2476
+ type: "button"
2477
+ }
2478
+ },
2479
+ structure: [
2480
+ { target: { part: "group", label: "Default project view" }, exists: true },
2481
+ { target: { part: "option", label: "Grid" }, selected: true },
2482
+ { target: { part: "option", label: "List" }, selected: false },
2483
+ { target: { part: "option", label: "Timeline" }, enabled: false }
2484
+ ],
2485
+ interactions: [
2486
+ {
2487
+ id: "activation-selects-option",
2488
+ action: "tap",
2489
+ on: { part: "option", label: "List" },
2490
+ result: "Selects the option and clears the previous selection.",
2491
+ then: [
2492
+ { target: { part: "option", label: "List" }, selected: true },
2493
+ { target: { part: "option", label: "Grid" }, selected: false }
2494
+ ]
2495
+ }
2496
+ ]
2497
+ }
2258
2498
  };
2259
2499
 
2260
2500
  // src/a11y/switch.ts
@@ -2302,7 +2542,36 @@ var switchPattern = {
2302
2542
  result: "Changes the state of the switch.",
2303
2543
  then: { focus: { part: "switch", at: "first" }, attributes: [checked3("false")] }
2304
2544
  }
2305
- ]
2545
+ ],
2546
+ ios: {
2547
+ parts: {
2548
+ switch: {
2549
+ description: "A switch, named by its title (and description), with a value of 1 or 0.",
2550
+ name: "required",
2551
+ type: "switch"
2552
+ }
2553
+ },
2554
+ structure: [
2555
+ { target: { part: "switch", at: "first" }, value: "1" },
2556
+ { target: { part: "switch", at: "last" }, value: "0" }
2557
+ ],
2558
+ interactions: [
2559
+ {
2560
+ id: "activation-turns-off",
2561
+ action: "tap",
2562
+ on: { part: "switch", at: "first" },
2563
+ result: "Changes the state of the switch.",
2564
+ then: [{ target: { part: "switch", at: "first" }, value: "0" }]
2565
+ },
2566
+ {
2567
+ id: "activation-turns-on",
2568
+ action: "tap",
2569
+ on: { part: "switch", at: "first" },
2570
+ result: "Changes the state of the switch back.",
2571
+ then: [{ target: { part: "switch", at: "first" }, value: "1" }]
2572
+ }
2573
+ ]
2574
+ }
2306
2575
  };
2307
2576
 
2308
2577
  // src/a11y/tabs.ts
@@ -2473,7 +2742,43 @@ var tabsPattern = {
2473
2742
  result: "Selects the focused tab and shows its panel.",
2474
2743
  then: { focus: { part: "tab", at: 1 }, attributes: [selected2(1)] }
2475
2744
  }
2476
- ]
2745
+ ],
2746
+ ios: {
2747
+ parts: {
2748
+ tab: {
2749
+ description: "A segment of the segmented picker above the content: a button named by its label; the shown section is selected.",
2750
+ name: "required",
2751
+ type: "button"
2752
+ },
2753
+ panel: {
2754
+ description: "Text of the selected section's content.",
2755
+ name: "required",
2756
+ type: "staticText"
2757
+ }
2758
+ },
2759
+ structure: [
2760
+ { target: { part: "tab", label: "Overview" }, selected: true },
2761
+ { target: { part: "tab", label: "Activity" }, selected: false },
2762
+ { target: { part: "panel", label: "Project summary and current status." }, exists: true }
2763
+ ],
2764
+ interactions: [
2765
+ {
2766
+ id: "activation-selects-tab",
2767
+ action: "tap",
2768
+ on: { part: "tab", label: "Activity" },
2769
+ result: "Selects the tab and shows its content in place of the previous one.",
2770
+ then: [
2771
+ { target: { part: "tab", label: "Activity" }, selected: true },
2772
+ { target: { part: "tab", label: "Overview" }, selected: false },
2773
+ { target: { part: "panel", label: "Recent project changes." }, exists: true },
2774
+ {
2775
+ target: { part: "panel", label: "Project summary and current status." },
2776
+ exists: false
2777
+ }
2778
+ ]
2779
+ }
2780
+ ]
2781
+ }
2477
2782
  };
2478
2783
 
2479
2784
  // src/a11y/index.ts
@@ -2580,10 +2885,7 @@ var accordionVisualArchetypes = [
2580
2885
  "trigger"
2581
2886
  ];
2582
2887
  var accordionContract = {
2583
- accessibility: {
2584
- pattern: "accordion",
2585
- options: { collapse: "collapsible", expand: "single" }
2586
- },
2888
+ accessibility: { pattern: "accordion", options: { collapse: "collapsible", expand: "single" } },
2587
2889
  defaultIconVariant: "chevron",
2588
2890
  iconVariants: accordionIconVariants,
2589
2891
  slots: accordionSlots,
@@ -2622,7 +2924,12 @@ var autocompleteStates = [
2622
2924
  "empty",
2623
2925
  "loading"
2624
2926
  ];
2625
- var autocompleteVisualArchetypes = ["field", "trigger", "overlay", "menu"];
2927
+ var autocompleteVisualArchetypes = [
2928
+ "field",
2929
+ "trigger",
2930
+ "overlay",
2931
+ "menu"
2932
+ ];
2626
2933
  var autocompleteContract = {
2627
2934
  defaultSize: "default",
2628
2935
  sizes: autocompleteSizes,
@@ -2758,7 +3065,10 @@ var buttonGroupSlots = [
2758
3065
  "button-group-separator"
2759
3066
  ];
2760
3067
  var buttonGroupStates = ["rest", "focus-within"];
2761
- var buttonGroupVisualArchetypes = ["action", "segment"];
3068
+ var buttonGroupVisualArchetypes = [
3069
+ "action",
3070
+ "segment"
3071
+ ];
2762
3072
  var buttonGroupContract = {
2763
3073
  defaultOrientation: "horizontal",
2764
3074
  defaultSize: "default",
@@ -2890,7 +3200,11 @@ var carouselStates = [
2890
3200
  "cursor-active",
2891
3201
  "can-scroll"
2892
3202
  ];
2893
- var carouselVisualArchetypes = ["surface", "overlay", "action"];
3203
+ var carouselVisualArchetypes = [
3204
+ "surface",
3205
+ "overlay",
3206
+ "action"
3207
+ ];
2894
3208
  var carouselContract = {
2895
3209
  defaultOrientation: "horizontal",
2896
3210
  orientations: carouselOrientations,
@@ -2930,7 +3244,11 @@ var calendarStates = [
2930
3244
  "outside",
2931
3245
  "disabled"
2932
3246
  ];
2933
- var calendarVisualArchetypes = ["surface", "action", "choice"];
3247
+ var calendarVisualArchetypes = [
3248
+ "surface",
3249
+ "action",
3250
+ "choice"
3251
+ ];
2934
3252
  var calendarContract = {
2935
3253
  defaultSelectionMode: "single",
2936
3254
  selectionModes: calendarSelectionModes,
@@ -2987,7 +3305,12 @@ var commandStates = [
2987
3305
  "disabled",
2988
3306
  "focus-visible"
2989
3307
  ];
2990
- var commandVisualArchetypes = ["overlay", "surface", "field", "menu"];
3308
+ var commandVisualArchetypes = [
3309
+ "overlay",
3310
+ "surface",
3311
+ "field",
3312
+ "menu"
3313
+ ];
2991
3314
  var commandContract = {
2992
3315
  slots: commandSlots,
2993
3316
  states: commandStates,
@@ -3025,7 +3348,10 @@ var contextMenuStates = [
3025
3348
  "submenu-open",
3026
3349
  "destructive"
3027
3350
  ];
3028
- var contextMenuVisualArchetypes = ["menu", "overlay"];
3351
+ var contextMenuVisualArchetypes = [
3352
+ "menu",
3353
+ "overlay"
3354
+ ];
3029
3355
  var contextMenuContract = {
3030
3356
  slots: contextMenuSlots,
3031
3357
  states: contextMenuStates,
@@ -3127,9 +3453,7 @@ var dialogVisualArchetypes = [
3127
3453
  "action"
3128
3454
  ];
3129
3455
  var dialogContract = {
3130
- accessibility: {
3131
- pattern: "dialog-modal"
3132
- },
3456
+ accessibility: { pattern: "dialog-modal" },
3133
3457
  defaultFooterVariant: "default",
3134
3458
  defaultMobilePlacement: "bottom",
3135
3459
  defaultSize: "default",
@@ -3396,6 +3720,8 @@ var frameContract = {
3396
3720
  visualArchetypes: frameVisualArchetypes,
3397
3721
  presets: framePresets
3398
3722
  };
3723
+
3724
+ // src/components/frame/frame-chrome.ts
3399
3725
  function resolveFrameChrome({
3400
3726
  variant = frameContract.defaultVariant,
3401
3727
  tray,
@@ -3426,14 +3752,6 @@ var inputTokenSlots = [
3426
3752
  "field.fontSize"
3427
3753
  ];
3428
3754
  var inputVisualArchetypes = ["field"];
3429
- var inputGroupSlots = [
3430
- "input-group",
3431
- "input-group-addon",
3432
- "input-group-button",
3433
- "input-group-text"
3434
- ];
3435
- var inputGroupAligns = ["inline-start", "inline-end", "block-start", "block-end"];
3436
- var inputGroupVisualArchetypes = ["field"];
3437
3755
  var inputContract = {
3438
3756
  defaultSize: "md",
3439
3757
  slots: inputSlots,
@@ -3442,6 +3760,14 @@ var inputContract = {
3442
3760
  sizes: inputSizes,
3443
3761
  visualArchetypes: inputVisualArchetypes
3444
3762
  };
3763
+ var inputGroupSlots = [
3764
+ "input-group",
3765
+ "input-group-addon",
3766
+ "input-group-button",
3767
+ "input-group-text"
3768
+ ];
3769
+ var inputGroupAligns = ["inline-start", "inline-end", "block-start", "block-end"];
3770
+ var inputGroupVisualArchetypes = ["field"];
3445
3771
  var inputGroupContract = {
3446
3772
  aligns: inputGroupAligns,
3447
3773
  slots: inputGroupSlots,