playbook_ui 13.11.1 → 13.12.0.pre.alpha.PLAY880cardkithighlightzindex1655

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0ee8e7e286c406057d392df39a78b5386ccab676d22aa828c988d7ee705ef968
-  data.tar.gz: ee9a52e005b2d69eebf688975b86bb2e6690cbc36213745e099c53a9148b71f7
+  metadata.gz: 2df1a239bdc2543fe0c643adbd48ecf1083b5627a3aaff5018f4bc4b5c6f3501
+  data.tar.gz: '095f3ef35c2083b78218da353d974108a2ca70127e12d760f07eef70e31b423a'
 SHA512:
-  metadata.gz: d56962a2defca43883e75b975d30829a1222671ebcc55b08258ec18d581937cd73252ee556ca113788388ff6f1dcc3952ca0f446ae1eba5c91acac03d5131e5e
-  data.tar.gz: 2295ee61c45223e3000b277bec93ac715d0f0cd134494b2d746172f93af2d979e9edc9ef76be7bfe67a689dca148063e3bac03f4ae3050e5db05f59ea4907f76
+  metadata.gz: 5643ac4dd6cd99c4164f7b0125a1d37cfeb3b4b7b7960cc7a27572ddab5847f4b9f429f4b77d8d6ba04a3303a66dc101f8f57d7354da12be7f3ccaf227d221fd
+  data.tar.gz: b7f61a87d132dc21a018945ecd1ffa5aca675ff883ed07cc5a829ec488aa5a1e241bfdacddf81fdd74a8eb25bc91d86a6ca1aae3e5940a8005954af316823de4

data/app/pb_kits/playbook/pb_card/_card_mixin.scss

@@ -80,7 +80,6 @@ $pb_card_header_colors: map-merge(map-merge($product_colors, $additional_colors)
   width: $width;
   height: $height;
   background: $background;
-  z-index: 10;
 }
 
 @mixin pb_card_header_color($header_color) {

data/app/pb_kits/playbook/pb_collapsible/collapsible_content.rb

@@ -3,6 +3,8 @@
 module Playbook
   module PbCollapsible
     class CollapsibleContent < Playbook::KitBase
+      prop :collapsed, type: Playbook::Props::Boolean,
+                       default: true
       def data
         Hash(values[:data]).merge(
           collapsible_content: true
@@ -10,7 +12,7 @@ module Playbook
       end
 
       def classname
-        generate_classname("pb_collapsible_content_kit", "toggle-content", padding, separator: " ")
+        generate_classname("pb_collapsible_content_kit", "toggle-content", collapsed ? nil : "is-visible", padding, separator: " ")
       end
     end
   end

data/app/pb_kits/playbook/pb_collapsible/docs/_collapsible_external_controls.html.erb

@@ -0,0 +1,22 @@
+<div onclick="toggleCollapsibleById('collapsed-toggle')">
+    <%= pb_rails("button", props: { text: "Toggle Collapsible", variant:"link"}) %>
+</div>
+
+<%= pb_rails("collapsible", props: { name: "default-example" }) do %>
+    <%= pb_rails("collapsible/collapsible_main", props: { padding: "md", name: "default-main"}) do %>
+      <%= pb_rails("body", props: { text: "Main Section"}) %>
+    <% end %>
+    <%= pb_rails("collapsible/collapsible_content", props: { padding: "md", collapsed: false, id:"collapsed-toggle" }) do %>
+      Lorem ipsum dolor sit amet, consectetur adipiscing elit. Donec iaculis, risus a fringilla luctus, sapien eros sodales ex, quis molestie est nulla non turpis. Vestibulum aliquet at ipsum eget posuere. Morbi sed laoreet erat. Sed commodo posuere lectus, at porta nulla ornare a. Suspendisse quam est, sollicitudin ut enim sit amet, commodo placerat enim. Donec laoreet metus ac mauris pellentesque mattis. Pellentesque luctus vel mauris non aliquam. Mauris hendrerit mattis porttitor. Curabitur vehicula justo non ex consectetur commodo. Quisque posuere aliquet quam. Maecenas malesuada magna mauris, ac tempor metus euismod at.
+      <br><br>
+      Cras ornare fermentum magna mollis efficitur. Sed vitae nulla vel purus ultrices mollis. Maecenas id nulla id libero faucibus feugiat quis sit amet turpis. In commodo pellentesque risus at fringilla. Integer non interdum leo, non commodo ante. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut mi augue, dignissim at orci vel, egestas aliquam mi. Proin finibus aliquet tempor. Integer cursus, ex quis gravida rhoncus, nisi elit viverra ipsum, non efficitur est ex ac tortor. Praesent vitae odio massa.
+    <% end %>
+<% end %>
+  
+
+  
+  <script>
+  const toggleCollapsibleById = (id) => {
+    document.dispatchEvent(new CustomEvent(id));
+  };
+  </script>

data/app/pb_kits/playbook/pb_collapsible/docs/_collapsible_external_controls.md

@@ -0,0 +1,3 @@
+The `collapsed` prop (boolean; default = true) handles the collapsed state of a collapsible. Set it to 'false' and the collapsible will render in an expanded state on page load.
+
+You can also control the collapsed state using an external control (like a button). To do this, you must first apply a unique id to the collapsible/collapsible_content child element. You can then attach an eventListner to the external control of your choice, pass it the id as an argument and use `document.dispatchEvent(new CustomEvent(id))` to trigger the action. See the code example below for details.

data/app/pb_kits/playbook/pb_collapsible/docs/_collapsible_external_controls_multiple.html.erb

@@ -0,0 +1,40 @@
+<%= pb_rails("button", props: { variant:"link", text: "Toggle All", id: "toggle-button-example"}) %>
+
+<%= pb_rails("collapsible", props: { name: "default-example" }) do %>
+    <%= pb_rails("collapsible/collapsible_main", props: { padding: "xs", name: "default-main"}) do %>
+      <%= pb_rails("body", props: { text: "Main Section"}) %>
+    <% end %>
+    <%= pb_rails("collapsible/collapsible_content", props: { padding: "md", id:"collapse-toggle-1" }) do %>
+      Cras ornare fermentum magna mollis efficitur. Sed vitae nulla vel purus ultrices mollis. Maecenas id nulla id libero faucibus feugiat quis sit amet turpis. In commodo pellentesque risus at fringilla. Integer non interdum leo, non commodo ante. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut mi augue, dignissim at orci vel, egestas aliquam mi. Proin finibus aliquet tempor. Integer cursus, ex quis gravida rhoncus, nisi elit viverra ipsum, non efficitur est ex ac tortor. Praesent vitae odio massa.
+    <% end %>
+<% end %>
+<%= pb_rails("collapsible", props: { name: "default-example-2" }) do %>
+    <%= pb_rails("collapsible/collapsible_main", props: { padding: "xs", name: "default-main"}) do %>
+      <%= pb_rails("body", props: { text: "Main Section"}) %>
+    <% end %>
+    <%= pb_rails("collapsible/collapsible_content", props: { padding: "md", id:"collapse-toggle-2" }) do %>
+      Cras ornare fermentum magna mollis efficitur. Sed vitae nulla vel purus ultrices mollis. Maecenas id nulla id libero faucibus feugiat quis sit amet turpis. In commodo pellentesque risus at fringilla. Integer non interdum leo, non commodo ante. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut mi augue, dignissim at orci vel, egestas aliquam mi. Proin finibus aliquet tempor. Integer cursus, ex quis gravida rhoncus, nisi elit viverra ipsum, non efficitur est ex ac tortor. Praesent vitae odio massa.
+    <% end %>
+<% end %>
+<%= pb_rails("collapsible", props: { name: "default-example-3" }) do %>
+    <%= pb_rails("collapsible/collapsible_main", props: { padding: "xs", name: "default-main"}) do %>
+      <%= pb_rails("body", props: { text: "Main Section"}) %>
+    <% end %>
+    <%= pb_rails("collapsible/collapsible_content", props: { padding: "md", id:"collapse-toggle-3" }) do %>
+      Cras ornare fermentum magna mollis efficitur. Sed vitae nulla vel purus ultrices mollis. Maecenas id nulla id libero faucibus feugiat quis sit amet turpis. In commodo pellentesque risus at fringilla. Integer non interdum leo, non commodo ante. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Ut mi augue, dignissim at orci vel, egestas aliquam mi. Proin finibus aliquet tempor. Integer cursus, ex quis gravida rhoncus, nisi elit viverra ipsum, non efficitur est ex ac tortor. Praesent vitae odio massa.
+    <% end %>
+<% end %>
+  
+
+  
+<script>
+  window.addEventListener('DOMContentLoaded', () => {
+    const collapsibles = document.querySelectorAll('[id^="collapse-toggle"]');
+    const button = document.querySelector("#toggle-button-example");
+    button.addEventListener("click", () => {
+      collapsibles.forEach(collapsible => {
+        document.dispatchEvent(new CustomEvent(collapsible.id));
+      })
+    })
+  })
+</script>

data/app/pb_kits/playbook/pb_collapsible/docs/_collapsible_external_controls_multiple.md

@@ -0,0 +1 @@
+The external control functionality can also be used to toggle multiple collapsibles with the same control. See the code example below to see this in action.

data/app/pb_kits/playbook/pb_collapsible/docs/example.yml

@@ -5,6 +5,8 @@ examples:
   - collapsible_size: Icon Size
   - collapsible_color: Icon Color
   - collapsible_icons: Custom Icons
+  - collapsible_external_controls: Toggle Collapsible With External Controls
+  - collapsible_external_controls_multiple: Toggle All Collapsibles With One Control
 
   react:
   - collapsible_default: Default

data/app/pb_kits/playbook/pb_collapsible/index.js

@@ -15,6 +15,10 @@ export default class PbCollapsible extends PbEnhancedElement {
       this.toggleElement(this.target)
     })
     this.displayDownArrow()
+    // Listen for a custom event to toggle the collapsible
+    document.addEventListener(`${this.target.id}`, () => {
+      this.toggleElement(this.target)
+    })
   }
 
   get target() {

data/app/pb_kits/playbook/pb_icon/docs/_icon_border_swift.md

@@ -0,0 +1,7 @@
+![card-border](https://github.com/powerhome/playbook/assets/92755007/442640c8-1b4f-455d-8517-5ca5cd120664)
+
+```swift
+
+PBIcon(FontAwesome.user, border: true)
+
+```

data/app/pb_kits/playbook/pb_icon/docs/_icon_default_swift.md

@@ -0,0 +1,7 @@
+![card-default](https://github.com/powerhome/playbook/assets/92755007/8c7e5454-1d42-4d13-9107-ffc5773a136a)
+
+```swift
+
+PBIcon.fontAwesome(.user, size: .x1)
+
+```

data/app/pb_kits/playbook/pb_icon/docs/_icon_flip_swift.md

@@ -0,0 +1,11 @@
+![icon-flipped](https://github.com/powerhome/playbook/assets/92755007/2776fb83-942d-4a38-9dff-9dcb73940dfe)
+
+```swift
+
+ HStack(spacing: Spacing.xSmall) {
+  PBIcon(FontAwesome.questionCircle, flipped: [.horizontal])
+  PBIcon(FontAwesome.questionCircle, flipped: [.vertical])
+  PBIcon(FontAwesome.questionCircle, flipped: [.horizontal, .vertical])
+}
+
+```

data/app/pb_kits/playbook/pb_icon/docs/_icon_props_swift.md

@@ -0,0 +1,8 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **Icon** | `PlaybookGenericIcon` | Sets the kit's Icon |  |  |
+| **Size** | `IconSize` | Changes the size of the Icon | `.x1` | `xSmall` `small` `large` `x1` `x2` `x3` `x4` `x5` `x6` `x7` `x8` `x9` `x10` |
+| **Rotation** | `IconRotation` | Rotates the Icon | `.zero` | `.zero` `.right` `.straight` `.obtuse` |
+| **Border** | `Bool` | Adds a border | `false` | `true` `false` |
+| **Flipped** | `[Axis]` | Flips the Icon | `nil` | `[.horizontal]` `[.vertical]` `[.horizontal, .vertical]` |

data/app/pb_kits/playbook/pb_icon/docs/_icon_rotate_swift.md

@@ -0,0 +1,11 @@
+![icon-rotate](https://github.com/powerhome/playbook/assets/92755007/29a6c127-a8a0-4dd9-a8cb-6401f772f11e)
+
+```swift
+
+HStack(spacing: Spacing.xSmall) {
+  PBIcon(FontAwesome.user, rotation: .right)
+  PBIcon(FontAwesome.user, rotation: .zero)
+  PBIcon(FontAwesome.user, rotation: .obtuse) 
+}
+
+```

data/app/pb_kits/playbook/pb_icon/docs/_icon_sizes_swift.md

@@ -0,0 +1,46 @@
+![icon-size](https://github.com/powerhome/playbook/assets/92755007/b3aa3933-56b1-4fe4-bb8b-00d786abb23a)
+
+```swift
+
+HStack(spacing: Spacing.xSmall) {
+  PBIcon.fontAwesome(.atlas, size: .xSmall)
+  Text("xSmall")
+
+  PBIcon.fontAwesome(.atlas, size: .small)
+  Text("small")
+
+  PBIcon.fontAwesome(.atlas, size: .large)
+  Text("large")
+
+  PBIcon.fontAwesome(.atlas, size: .x1)
+  Text("x1")
+
+  PBIcon.fontAwesome(.atlas, size: .x2)
+  Text("x2")
+
+  PBIcon.fontAwesome(.atlas, size: .x3)
+  Text("x3")
+
+  PBIcon.fontAwesome(.atlas, size: .x4)
+  Text("x4")
+
+  PBIcon.fontAwesome(.atlas, size: .x5)
+  Text("x5")
+
+  PBIcon.fontAwesome(.atlas, size: .x6)
+  Text("x6")
+  
+  PBIcon.fontAwesome(.atlas, size: .x7)
+  Text("x7")
+
+  PBIcon.fontAwesome(.atlas, size: .x8)
+  Text("x8")
+
+  PBIcon.fontAwesome(.atlas, size: .x9)
+  Text("x9")
+
+  PBIcon.fontAwesome(.atlas, size: .x10)
+  Text("x10")
+}
+
+``` 

data/app/pb_kits/playbook/pb_icon/docs/example.yml

@@ -20,3 +20,11 @@ examples:
   - icon_sizes: Icon Sizes
   - icon_custom: Icon Custom
   - icon_fa_kit: Icon with FontAwesome Kit
+
+  swift:
+  - icon_default_swift: Icon Default
+  - icon_rotate_swift: Icon Rotate
+  - icon_flip_swift: Icon Flip
+  - icon_border_swift: Icon Border
+  - icon_sizes_swift: Icon Sizes
+  - icon_props_swift: Props

data/app/pb_kits/playbook/pb_image/docs/_image_props_swift.md

@@ -0,0 +1,7 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **Image** | `Image` | Sets the Image |  |  |
+| **Place Holder** | `Image` | sets the placeholder Image | `nil` |  |
+| **Size** | `Size` | Changes the size of the Image | `nil` | `.xSmall` `.small` `.medium` `.large` `.xLarge` |
+| **Rounded** | `ImageCornerRadius` | Adds rounded corners to the Image | `.sharp` | `.rounded` `.sharp` |

data/app/pb_kits/playbook/pb_image/docs/_rounded_image_swift.md

@@ -0,0 +1,47 @@
+![image-rounded](https://github.com/powerhome/playbook/assets/92755007/ee2cff73-2702-4a09-b654-f151bbdf90f2)
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  Text("xSmall").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .xSmall,
+    rounded: .rounded
+  )
+
+  Text("small").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .small,
+    rounded: .rounded
+  )
+
+  Text("medium").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .medium,
+    rounded: .rounded
+  )
+
+  Text("large").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .large,
+    rounded: .rounded
+  )
+
+  Text("xLarge").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .xLarge,
+    rounded: .rounded
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_image/docs/_size_image_swift.md

@@ -0,0 +1,47 @@
+![image-size](https://github.com/powerhome/playbook/assets/92755007/261600b9-b49c-4f5b-8c80-9ecc65dc424a)
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  Text("xSmall").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .xSmall,
+    rounded: .sharp
+  )
+
+  Text("small").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .small,
+    rounded: .sharp
+  )
+
+  Text("medium").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .medium,
+    rounded: .sharp
+  )
+
+  Text("large").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .large,
+    rounded: .sharp
+  )
+
+  Text("xLarge").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .xLarge,
+    rounded: .sharp
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_image/docs/_size_none_image_swift.md

@@ -0,0 +1,15 @@
+![image-size-none](https://github.com/powerhome/playbook/assets/92755007/442ff028-028a-4ccb-9733-d408d32966d6)
+
+```swift
+
+VStack(alignment: .leading) {
+  Text("None").pbFont(.detail(true), color: .text(.default))
+  PBImage(
+    image: nil,
+    placeholder: Image("Forest", bundle: .module),
+    size: .none,
+    rounded: .sharp
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_image/docs/example.yml

@@ -9,3 +9,8 @@ examples:
   - rounded_image: Rounded
   - custom_error_image: Error Handling
   - transition_image: Transition
+  swift:
+  - size_image_swift: Size
+  - size_none_image_swift: Size None
+  - rounded_image_swift: Rounded
+  - image_props_swift: ""

data/app/pb_kits/playbook/pb_label_value/docs/_label_value_default_swift.md

@@ -0,0 +1,11 @@
+![label-value-default](https://github.com/powerhome/playbook/assets/92755007/7a515a30-f1a1-4b08-a73a-6b13e6cff125)
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  PBLabelValue("Role", "Administrator, Moderator")
+  PBLabelValue("Email", "anna.black@powerhrg.com")
+  PBLabelValue("Bio", longText)
+}
+
+```

data/app/pb_kits/playbook/pb_label_value/docs/_label_value_details_examples_swift.md

@@ -0,0 +1,72 @@
+![label-value-examples](https://github.com/powerhome/playbook/assets/92755007/1810abee-c45a-45ac-bb12-eef88d6a254e)
+
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  Text("Patient Profile")
+  .pbFont(.title4)
+  .padding(.bottom, Spacing.xSmall)
+
+  PBLabelValue(
+    "Age",
+    variant: .details,
+    icon: FontAwesome.user,
+    title: "24 yrs old"
+  )
+
+  PBLabelValue(
+    "Blood",
+    variant: .details,
+    icon: FontAwesome.tint,
+    title: "A +"
+  )
+
+  PBLabelValue(
+    "Weight",
+    variant: .details,
+    icon: FontAwesome.weight,
+    title: "91 kg"
+  )
+
+  PBLabelValue(
+    "Height",
+    variant: .details,
+    icon: FontAwesome.arrowsAltV,
+    title: "187 cm"
+  )
+
+  Text("Workout Schedule")
+  .pbFont(.title4)
+  .padding(.top, Spacing.large)
+  .padding(.bottom, Spacing.xSmall)
+
+  PBLabelValue(
+    "Chest",
+    variant: .details,
+    icon: FontAwesome.dumbbell,
+    description: "6 sets • 8 reps • 40-100 kg",
+    title: "Bench Press",
+    active: true
+  )
+
+  PBLabelValue(
+    "Biceps",
+    variant: .details,
+    icon: FontAwesome.dumbbell,
+    description: "5 sets • 12 reps • 20-40 kg",
+    title: "Barbell Curl",
+    active: true
+  )
+
+  PBLabelValue(
+    "Back",
+    variant: .details,
+    icon: FontAwesome.dumbbell,
+    description: "8 sets • 8 reps • 40-120 kg",
+    title: "Back Squat",
+    active: true
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_label_value/docs/_label_value_details_swift.md

@@ -0,0 +1,41 @@
+![label-value-details](https://github.com/powerhome/playbook/assets/92755007/bc1628f8-8698-4ac2-a236-d93687e6f165)
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  PBLabelValue(
+    "Installer",
+    variant: .details,
+    icon: FontAwesome.truck,
+    title: "JD Installations LLC"
+  )
+
+  PBLabelValue(
+    "Project",
+    variant: .details,
+    icon: FontAwesome.home,
+    description: "33-12345",
+    title: "Jefferson-Smith"
+  )
+
+  PBLabelValue(
+    "Project",
+    variant: .details,
+    icon: FontAwesome.home,
+    description: "33-12345",
+    title: "Jefferson-Smith",
+    date: Date()
+  )
+
+  PBLabelValue(
+    "Project",
+    variant: .details,
+    icon: FontAwesome.home,
+    description: "33-12345",
+    title: "Jefferson-Smith",
+    date: Date(),
+    active: true
+  )
+}
+
+```

data/app/pb_kits/playbook/pb_label_value/docs/_label_value_props_swift.md

@@ -0,0 +1,11 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **Label** | `String` | Sets the label text |  |  |
+| **Value** | `String` | Sets the value | `nil` |  |
+| **Variant** | `Variant` | Changes the style of the Label Value  | `.default` | `.default` `.details` |
+| **Icon** | `PlaybookGenericIcon` | Adds an icon next to the title | `nil` |  |
+| **Description** | `String` | Sets the description | `nil` |  |
+| **Title** | `String` | Sets the title | `nil` |  |
+| **Date** | `Date` | Adds a date | `nil` |  |
+| **Active** | `Bool` | Changes the style of the Label Value | `false` | `true` `false` |

data/app/pb_kits/playbook/pb_label_value/docs/example.yml

@@ -11,3 +11,9 @@ examples:
   - label_value_default: Default
   - label_value_details: Details
   - label_value_details_examples: Other Examples
+
+  swift:
+  - label_value_default_swift: Default
+  - label_value_details_swift: Details
+  - label_value_details_examples_swift: Other Examples
+  - label_value_props_swift: ""

data/app/pb_kits/playbook/pb_message/docs/_message_default_swift.md

@@ -0,0 +1,57 @@
+![message-default](https://github.com/powerhome/playbook/assets/92755007/a50c7439-a429-4e8a-b8d4-ef8323199745)
+
+```swift
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  PBMessage(
+    avatar: AnyView(picAnna),
+    label: "Anna Black",
+    message: "How can we assist you today?",
+    timestamp: Date().addingTimeInterval(-20)
+  )
+
+  PBMessage(
+    avatar: AnyView(picPatric),
+    label: "Patrick Welch",
+    message: "We will escalate this issue to a Senior Support agent.",
+    timestamp: Date().addingTimeInterval(-540),
+    timestampAlignment: .leading
+  )
+
+  PBMessage(
+    avatar: AnyView(picLuccile),
+    label: "Lucille Sanchez",
+    message: "Application for Kate Smith is waiting for your approval",
+    timestamp: Date().addingTimeInterval(-200000)
+  )
+
+  PBMessage(
+    avatar: AnyView(PBAvatar(name: "Beverly Reyes", size: .xSmall)),
+    label: "Beverly Reyes",
+    message: "We are so sorry you had a bad experience!",
+    timestamp: Date().addingTimeInterval(-200000)
+  )
+
+  PBMessage(
+    label: "Keith Craig",
+    message: "Please hold for one moment, I will check with my manager.",
+    timestamp: Date().addingTimeInterval(-200000)
+  ) {}
+
+  PBMessage(
+    label: "Keith Craig",
+    timestamp: Date().addingTimeInterval(-200000)
+  ) {
+    Image("Forest", bundle: .module).resizable().frame(width: 240, height: 240)
+  }
+
+  PBMessage(
+    label: "Keith Craig",
+    message: "Please hold for one moment, I will check with my manager.",
+    timestamp: Date().addingTimeInterval(-200000)
+  ) {
+    Image("Forest", bundle: .module).resizable().frame(width: 240, height: 240)
+  }
+}
+
+```

data/app/pb_kits/playbook/pb_message/docs/_message_props_swift.md

@@ -0,0 +1,12 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **Avatar** | `AnyView` | Sets avatar image | `nil` |  |
+| **Label** | `String` | Sets the name of the sender | `""` |  |
+| **Message** | `String` | Sets the message text | `nil` |  |
+| **Timestamp** | `Date` | Adds a date |  | `nil` |
+| **Timestamp Alignment** | `TimestampAlignment` | Changes the style of the timestamp | `.trailing` | `.leading` `.trailing` |
+| **Change TimeStamp On Hover** | `Bool` | Changes the timestamp hover functionality | `false` | `true` `false` |
+| **Vertical Padding** | `CGFloat` | Changes vertical padding | `Spacing.xSmall` | `Spacing.none` `Spacing.xxSmall` `Spacing.xSmall` `Spacing.small` `Spacing.medium` `Spacing.large` `Spacing.xLarge` |
+| **Horizontal Padding** | `CGFloat` | Changes horizontal padding | `Spacing.xSmall` | `Spacing.none` `Spacing.xxSmall` `Spacing.xSmall` `Spacing.small` `Spacing.medium` `Spacing.large` `Spacing.xLarge` |
+| **Timestamp Variant** | `PBTimestamp.Variant` | Changes the style of the Message | `.standard` | `.standard` `.hideUserElapsed` |

data/app/pb_kits/playbook/pb_message/docs/example.yml

@@ -11,3 +11,7 @@ examples:
   - message_timestamp: With Timestamp Hover
   - message_hover: Hover
   - message_mentions: Mentions
+
+  swift:
+   - message_default_swift: Default
+   - message_props_swift: ""

data/app/pb_kits/playbook/pb_multiple_users/docs/_multiple_users_default_swift.md

@@ -0,0 +1,11 @@
+![mulitple-users-default](https://github.com/powerhome/playbook/assets/92755007/73dffd55-14f7-468e-b6ea-4e700980183d)
+
+```swift
+
+let twoUsers = [andrew, picAndrew]
+
+PBDoc(title: "xSmall") {
+  PBMultipleUsers(users: twoUsers, size: .xSmall)
+}
+
+```

data/app/pb_kits/playbook/pb_multiple_users/docs/_multiple_users_props_swift.md

@@ -0,0 +1,7 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **Users** | `[PBUser]` | Sets the user's avatars |  |  |
+| **Size** | `AvatarSize` | Changes the size of the avatars  | `.small` | `.xSmall` `.small` |
+| **Reversed** | `Bool` | Changes the order of the avatars | `false` | `true` `false` |
+| **Max Displayed Users** | `Int` | Limits the number of avatars displayed | `4` |  |

data/app/pb_kits/playbook/pb_multiple_users/docs/_multiple_users_reverse_swift.md

@@ -0,0 +1,13 @@
+![multiple-users-reverse](https://github.com/powerhome/playbook/assets/92755007/be3f6f7d-f699-40f2-bbb6-8a99144a8744)
+
+```swift
+
+let multipleUsers = [andrew, picAndrew, andrew, andrew]
+let twoUsers = [andrew, picAndrew]
+
+VStack(alignment: .leading, spacing: Spacing.small) {
+  PBMultipleUsers(users: multipleUsers, size: .small, reversed: true)
+  PBMultipleUsers(users: twoUsers, size: .small, reversed: true)
+}
+
+```

data/app/pb_kits/playbook/pb_multiple_users/docs/_multiple_users_size_swift.md

@@ -0,0 +1,11 @@
+![mulitple-users-size](https://github.com/powerhome/playbook/assets/92755007/5c15b862-fb32-4e0a-a826-bc25b1db555e)
+
+```swift
+
+let multipleUsers = [andrew, picAndrew, andrew, andrew]
+
+PBDoc(title: "Small") {
+  PBMultipleUsers(users: multipleUsers, size: .small)
+}
+
+```