playbook_ui 13.12.0 → 13.13.0.pre.alpha.play900startratingasinput1657

data/app/pb_kits/playbook/pb_star_rating/star_rating.html.erb

@@ -1,31 +1,53 @@
 <%= content_tag(:div,
-    id: object.id,
-    data: object.data,
-    class: object.classname) do %>
-    <%# Rating value %>
-    <% if !object.hide_rating %>
-      <%= content_tag(:div, object.rating, class: "pb_star_rating_number") %>
+  id: object.id,
+  data: object.data,
+  class: object.classname) do %>
+  <% if layout_option == "number" %>
+    <% case object.size %>
+      <% when "xs", "sm" %>
+      <%= pb_rails("caption", props: { text: object.rating,
+                                        size: "sm",
+                                        classname: "pb_star_rating_number_#{size}",
+                                        dark: dark,
+                                        padding_right: "xxs" }) %>
+      <% when "md" %>
+      <%= pb_rails("body", props: { text: object.rating,
+                                    dark: dark,
+                                    classname: "pb_star_rating_number_#{size}",
+                                    padding_right: "xxs" }) %>
+      <% when "lg" %>
+      <%= pb_rails("title", props: { text: object.rating,
+                                      size: 2,
+                                      dark: dark,
+                                      classname: "pb_star_rating_number_#{size}",
+                                      padding_right: "sm" }) %>
     <% end %>
-
-    <%= content_tag(:div, class: "pb_star_rating_wrapper") do %>
-      <%# Gold stars generated by rating value %>
-      <%= content_tag(:div, class: "pb_star_rating_highlight") do %>
-        <% object.star_count.times do %>
-          <%= pb_rails("icon", props: { icon: "star" }) %>
-        <% end %>
-        <% unless object.star_full %>
-          <%= pb_rails("icon", props: { icon: "star-half" }) %>
-        <% end %>
-      <% end %>
-
-      <%# Grey background stars as base %>
-      <%= content_tag(:div, class: "pb_star_rating_base") do %>
-        <%= pb_rails("icon", props: { icon: "star" }) %>
-        <%= pb_rails("icon", props: { icon: "star" }) %>
-        <%= pb_rails("icon", props: { icon: "star" }) %>
-        <%= pb_rails("icon", props: { icon: "star" }) %>
-        <%= pb_rails("icon", props: { icon: "star" }) %>
+  <% end %>
+  <%= pb_rails("flex", props: { }) do %>
+    <% object.star_count.times do %>
+        <%= pb_rails("icon", props: { classname: "#{star_color} pb_star_#{size}" , custom_icon: Playbook::Engine.root.join(star_svg_path) } ) %>
+    <% end %>
+    <% object.empty_stars.times do %>
+        <%= pb_rails("icon", props: { classname: "#{background_star_color} pb_star_#{size}", custom_icon: Playbook::Engine.root.join(background_star_path) } ) %>
+    <% end %>
+  <% end %>
+  <% if layout_option == "onestar" %>
+    <%= content_tag(:div, class: "pb_star_rating_number_#{size}") do %>
+      <% case object.size %>
+        <% when "xs", "sm" %>
+        <%= pb_rails("caption", props: { text: "#{object.rating} of #{object.denominator}",
+                                          size: "sm",
+                                          dark: dark,
+                                          padding_left: "xxs" }) %>
+        <% when "md" %>
+        <%= pb_rails("body", props: { text: "#{object.rating} of #{object.denominator}",
+                                      dark: dark,
+                                      padding_left: "xxs" }) %>
+        <% when "lg" %>
+        <%= pb_rails("title", props: { text: "#{object.rating} of #{object.denominator}",
+                                        size: 2,
+                                        dark: dark }) %>
       <% end %>
-
     <% end %>
+  <% end %>
 <% end %>

data/app/pb_kits/playbook/pb_star_rating/star_rating.rb

@@ -3,18 +3,94 @@
 module Playbook
   module PbStarRating
     class StarRating < Playbook::KitBase
-      prop :hide_rating, type: Playbook::Props::Boolean,
-                         default: false
-
       prop :rating, type: Playbook::Props::Numeric,
                     default: 0
 
+      prop :denominator, type: Playbook::Props::Numeric,
+                         default: 5
+
+      prop :layout_option, type: Playbook::Props::Enum,
+                           values: %w[default onestar number],
+                           default: "default"
+
+      prop :color_option, type: Playbook::Props::Enum,
+                          values: %w[yellow primary subtle],
+                          default: "yellow"
+
+      prop :size, type: Playbook::Props::Enum,
+                  values: %w[xs sm md lg],
+                  default: "sm"
+
+      prop :background_type, type: Playbook::Props::Enum,
+                             values: %w[fill outline],
+                             default: "fill"
+
       def star_count
-        rating.floor
+        rating.floor > denominator_style ? denominator_style : rating.floor
+      end
+
+      def denominator_style
+        layout_option == "onestar" ? 1 : denominator
+      end
+
+      def empty_stars
+        (denominator_style - rating.floor).negative? ? 0 : denominator_style - rating.floor
+      end
+
+      def star_color
+        case color_option
+        when "yellow"
+          "yellow_star"
+        when "primary"
+          "primary_star"
+        when "subtle"
+          dark ? "suble_star_dark" : "suble_star_light"
+        end
+      end
+
+      def background_star_color
+        if background_type === "outline"
+          dark ? "outline_empty_star_dark" : "outline_empty_star_light"
+        else
+          dark ? "empty_star_dark" : "empty_star_light"
+        end
+      end
+
+      def svg_size
+        sizes = { "xs": "pb_star_xs",
+                  "sm": "pb_star_sm",
+                  "md": "pb_star_md",
+                  "lg": "pb_star_lg" }
+        sizes[size.to_sym]
+      end
+
+      def svg_class
+        "pb_star_#{size}"
+      end
+
+      def background_star_path
+        if background_type === "outline"
+          "app/pb_kits/playbook/pb_star_rating/stars/star_outline.svg"
+        else
+          "app/pb_kits/playbook/pb_star_rating/stars/yellow_star.svg"
+        end
       end
 
-      def star_full
-        (rating.to_f % 1).zero?
+      def star_svg_path
+        case color_option
+        when "yellow"
+          "app/pb_kits/playbook/pb_star_rating/stars/yellow_star.svg"
+        when "primary"
+          "app/pb_kits/playbook/pb_star_rating/stars/primary_star.svg"
+        when "subtle"
+          if dark == true
+            "app/pb_kits/playbook/pb_star_rating/stars/subtle_dark_star.svg"
+          else
+            "app/pb_kits/playbook/pb_star_rating/stars/subtle_star.svg"
+          end
+        else
+          "app/pb_kits/playbook/pb_star_rating/stars/primary_star.svg"
+        end
       end
 
       def classname

data/app/pb_kits/playbook/pb_star_rating/star_rating.test.js

@@ -1,24 +1,22 @@
-import React from "react";
-import { render, screen } from "../utilities/test-utils";
+import React from "react"
+import { render, screen } from "../utilities/test-utils"
 
-import StarRating from "./_star_rating";
+import StarRating from "./_star_rating"
 
-const testId = "star-rating-kit";
+const testId = "star-rating-kit"
 
 describe("Star Rating Kit", () => {
   test("Expects to have correct classname", () => {
     render(
       <StarRating
           data={{ testid: testId }}
-          rating={2}
       />
-    );
-
+    )
 
-    const kit = screen.getByTestId(testId);
-    expect(kit).toHaveClass("pb_star_rating_kit");
+    const kit = screen.getByTestId(testId)
+    expect(kit.className).toBe("pb_star_rating_kit")
 
-  });
+  })
 
   test('should render aria-label', () => {
     render(
@@ -27,45 +25,47 @@ describe("Star Rating Kit", () => {
           data={{ testid: testId }}
           rating={2}
       />
-    );
+    )
 
     const kit = screen.getByTestId(testId)
     expect(kit).toHaveAttribute('aria-label', testId)
-  });
+  })
 
-  test("Displays two highlighted stars", () => {
+  test("Displays correct denominator", () => {
     render(
       <StarRating
           data={{ testid: testId }}
+          denominator={4}
           rating={2}
+          size="xs"
       />
-    );
-
+    )
 
-    const kit = screen.getByTestId(testId);
-    const highlight = kit.querySelector(".pb_star_rating_highlight");
-    const stars = highlight.querySelectorAll(".far.fa-star");
-    const count = stars.length;
+    const kit = screen.getByTestId(testId)
+    const highlight = kit.querySelector(".star_flex_area")
+    const stars = highlight.querySelectorAll(".pb_star_xs")
+    const count = stars.length
 
-    expect(count).toBe(2);
-  });
+    expect(count).toBe(4)
+  })
 
-  test("Displays three highlighted stars and a half star", () => {
+  test("Uses correct size", () => {
     render(
       <StarRating
           data={{ testid: testId }}
-          rating={3.5}
+          layoutOption="number"
+          rating={2}
+          size="lg"
       />
-    );
+    )
 
-    const kit = screen.getByTestId(testId);
-    const highlight = kit.querySelector(".pb_star_rating_highlight");
-    const stars = highlight.querySelectorAll(".far.fa-star");
-    const halfStars = highlight.querySelectorAll(".far.fa-star-half");
-    const starCount = stars.length;
-    const halfStarCount = halfStars.length;
+    const kit = screen.getByTestId(testId)
+    const highlight = kit.querySelector(".star_flex_area")
+    const title = kit.querySelector(".pb_star_rating_number_lg")
+    const stars = highlight.querySelectorAll(".pb_star_lg")
+    const count = stars.length
 
-    expect(starCount).toBe(3);
-    expect(halfStarCount).toBe(1);
-  });
-});
+    expect(title.className).toBe("pb_title_kit_size_2 pr_sm pb_star_rating_number_lg")
+    expect(count).toBe(5)
+  })
+})

data/app/pb_kits/playbook/pb_star_rating/stars/primary_star.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path fillRule="evenodd" clipRule="evenodd" d="M9.86015 0.4371C9.73527 0.187329 9.4855 0 9.17328 0C8.89229 0 8.64252 0.187329 8.51763 0.4371L6.36335 4.83932L1.58647 5.55742C1.30547 5.58864 1.08692 5.80719 0.99326 6.05696C0.899595 6.33795 0.962038 6.61895 1.18059 6.8375L4.64617 10.2719L3.80319 15.1112C3.77197 15.3922 3.89685 15.7044 4.11541 15.8605C4.36518 16.0166 4.64617 16.0478 4.89594 15.9229L9.17328 13.6126L13.4506 15.9229C13.7004 16.0478 14.0126 16.0166 14.2624 15.8605C14.4809 15.7044 14.6058 15.3922 14.5434 15.1112L13.7316 10.2719L17.1972 6.8375C17.4157 6.61895 17.4782 6.33795 17.3845 6.05696C17.2909 5.80719 17.0723 5.58864 16.7913 5.55742L12.0144 4.83932L9.86015 0.4371Z" fill="#0056CF"/>
+</svg>

data/app/pb_kits/playbook/pb_star_rating/stars/star_outline.svg

@@ -0,0 +1,3 @@
+<svg width="17" height="16" viewBox="0 0 17 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M5.91323 5.33377L6.17269 5.29477L6.28801 5.0591L8.44116 0.659187C8.49971 0.543364 8.59517 0.5 8.64884 0.5C8.74499 0.5 8.83506 0.555009 8.88775 0.659235L11.0409 5.0591L11.1562 5.29477L11.4157 5.33377L16.1925 6.05186L16.2021 6.0533L16.2117 6.05436C16.2359 6.05706 16.2671 6.06847 16.3024 6.09973C16.3374 6.13062 16.3686 6.17476 16.3886 6.22412C16.4186 6.32162 16.401 6.40181 16.3198 6.48332C16.3196 6.48353 16.3194 6.48374 16.3192 6.48395L12.8552 9.91671L12.6712 10.0991L12.7141 10.3546L13.5258 15.1939L13.528 15.2068L13.5308 15.2196C13.5488 15.3004 13.5074 15.402 13.4567 15.4462C13.3391 15.5132 13.2227 15.5096 13.1546 15.4781L8.88646 13.1726L8.64884 13.0443L8.41121 13.1726L4.14274 15.4782C4.07877 15.5083 3.99031 15.5147 3.87267 15.4466C3.82302 15.4033 3.76655 15.2914 3.77463 15.1781L4.61431 10.3577L4.65911 10.1005L4.47368 9.91671L1.0097 6.48394C1.00947 6.48372 1.00925 6.4835 1.00903 6.48327C0.927878 6.40178 0.91031 6.3216 0.94026 6.22412C0.960274 6.17476 0.99154 6.13062 1.02646 6.09973C1.0618 6.06847 1.09296 6.05706 1.11724 6.05436L1.12682 6.0533L1.13635 6.05186L5.91323 5.33377Z" stroke="#C1CDD6"/>
+</svg>

data/app/pb_kits/playbook/pb_star_rating/stars/subtle_dark_star.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path class="" fillRule="evenodd" clipRule="evenodd" d="M9.86015 0.4371C9.73527 0.187329 9.4855 0 9.17328 0C8.89229 0 8.64252 0.187329 8.51763 0.4371L6.36335 4.83932L1.58647 5.55742C1.30547 5.58864 1.08692 5.80719 0.99326 6.05696C0.899595 6.33795 0.962038 6.61895 1.18059 6.8375L4.64617 10.2719L3.80319 15.1112C3.77197 15.3922 3.89685 15.7044 4.11541 15.8605C4.36518 16.0166 4.64617 16.0478 4.89594 15.9229L9.17328 13.6126L13.4506 15.9229C13.7004 16.0478 14.0126 16.0166 14.2624 15.8605C14.4809 15.7044 14.6058 15.3922 14.5434 15.1112L13.7316 10.2719L17.1972 6.8375C17.4157 6.61895 17.4782 6.33795 17.3845 6.05696C17.2909 5.80719 17.0723 5.58864 16.7913 5.55742L12.0144 4.83932L9.86015 0.4371Z" fill="#F9BB00"/>
+</svg>

data/app/pb_kits/playbook/pb_star_rating/stars/subtle_star.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path fillRule="evenodd" clipRule="evenodd" d="M9.86015 0.4371C9.73527 0.187329 9.4855 0 9.17328 0C8.89229 0 8.64252 0.187329 8.51763 0.4371L6.36335 4.83932L1.58647 5.55742C1.30547 5.58864 1.08692 5.80719 0.99326 6.05696C0.899595 6.33795 0.962038 6.61895 1.18059 6.8375L4.64617 10.2719L3.80319 15.1112C3.77197 15.3922 3.89685 15.7044 4.11541 15.8605C4.36518 16.0166 4.64617 16.0478 4.89594 15.9229L9.17328 13.6126L13.4506 15.9229C13.7004 16.0478 14.0126 16.0166 14.2624 15.8605C14.4809 15.7044 14.6058 15.3922 14.5434 15.1112L13.7316 10.2719L17.1972 6.8375C17.4157 6.61895 17.4782 6.33795 17.3845 6.05696C17.2909 5.80719 17.0723 5.58864 16.7913 5.55742L12.0144 4.83932L9.86015 0.4371Z" fill="#F9BB00"/>
+</svg>

data/app/pb_kits/playbook/pb_star_rating/stars/yellow_star.svg

@@ -0,0 +1,3 @@
+<svg viewBox="0 0 18 16" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path fillRule="evenodd" clipRule="evenodd" d="M9.86015 0.4371C9.73527 0.187329 9.4855 0 9.17328 0C8.89229 0 8.64252 0.187329 8.51763 0.4371L6.36335 4.83932L1.58647 5.55742C1.30547 5.58864 1.08692 5.80719 0.99326 6.05696C0.899595 6.33795 0.962038 6.61895 1.18059 6.8375L4.64617 10.2719L3.80319 15.1112C3.77197 15.3922 3.89685 15.7044 4.11541 15.8605C4.36518 16.0166 4.64617 16.0478 4.89594 15.9229L9.17328 13.6126L13.4506 15.9229C13.7004 16.0478 14.0126 16.0166 14.2624 15.8605C14.4809 15.7044 14.6058 15.3922 14.5434 15.1112L13.7316 10.2719L17.1972 6.8375C17.4157 6.61895 17.4782 6.33795 17.3845 6.05696C17.2909 5.80719 17.0723 5.58864 16.7913 5.55742L12.0144 4.83932L9.86015 0.4371Z" />
+</svg>

data/app/pb_kits/playbook/pb_stat_change/_stat_change.tsx

@@ -1,7 +1,7 @@
 import React from 'react'
 import classnames from 'classnames'
 
-import { buildCss } from '../utilities/props'
+import { buildCss, buildHtmlProps } from '../utilities/props'
 import { globalProps } from '../utilities/globalProps'
 
 import Body from '../pb_body/_body'
@@ -22,18 +22,29 @@ type StatChangeProps = {
   change?: 'increase' | 'decrease' | 'neutral',
   className?: string,
   icon?: string,
+  htmlOptions?: {[key: string]: string | number | boolean | Function},
   id?: string,
   value?: string | number,
 }
 
 const StatChange = (props: StatChangeProps): React.ReactElement => {
-  const { change = 'neutral', className, icon, id, value } = props
+  const { 
+    change = 'neutral', 
+    className, 
+    htmlOptions = {},
+    icon, 
+    id, 
+    value 
+  } = props
+
   const status = statusMap[change as keyof typeof statusMap]
   let returnedIcon = iconMap[change as keyof typeof iconMap]
   if (icon) {
     returnedIcon = icon
   }
 
+  const htmlProps = buildHtmlProps(htmlOptions)
+
   return (
     <>
       {value &&
@@ -44,6 +55,7 @@ const StatChange = (props: StatChangeProps): React.ReactElement => {
               className
               )}
             id={id}
+            {...htmlProps}
         >
           <Body status={status}>
             {returnedIcon &&

data/app/pb_kits/playbook/pb_stat_value/_stat_value.tsx

@@ -2,10 +2,12 @@ import React from 'react'
 import classnames from 'classnames'
 
 import { globalProps } from '../utilities/globalProps'
+import { buildHtmlProps } from '../utilities/props'
 import Title from '../pb_title/_title'
 
 type StatValueProps = {
   className?: string,
+  htmlOptions?: {[key: string]: string | number | boolean | Function},
   id?: string,
   unit?: string,
   value: string | number,
@@ -14,11 +16,14 @@ type StatValueProps = {
 const StatValue = (props: StatValueProps): React.ReactElement => {
   const {
     className,
+    htmlOptions = {},
     id,
     unit,
     value = 0,
   } = props
 
+  const htmlProps = buildHtmlProps(htmlOptions)
+
   const displayValue = function(value: string | number) {
     if (value || value === 0) {
       return (
@@ -47,6 +52,7 @@ const StatValue = (props: StatValueProps): React.ReactElement => {
     <div
         className={classnames('pb_stat_value_kit', globalProps(props), className)}
         id={id}
+        {...htmlProps}
     >
       <div className="pb_stat_value_wrapper">
         {displayValue(value)}

data/app/pb_kits/playbook/pb_table/_table.tsx

@@ -1,6 +1,6 @@
 import React, { useEffect } from 'react'
 import classnames from 'classnames'
-import { buildAriaProps, buildDataProps } from '../utilities/props'
+import { buildAriaProps, buildDataProps, buildHtmlProps } from '../utilities/props'
 import { globalProps } from '../utilities/globalProps'
 import PbTable from '.'
 
@@ -14,6 +14,7 @@ type TableProps = {
   data?: { [key: string]: string },
   dataTable: boolean,
   disableHover: boolean,
+  htmlOptions?: {[key: string]: string | number | boolean | Function},
   id?: string,
   responsive: "collapse" | "scroll" | "none",
   singleLine: boolean,
@@ -33,6 +34,7 @@ const Table = (props: TableProps) => {
     data = {},
     dataTable = false,
     disableHover = false,
+    htmlOptions = {},
     id,
     responsive = 'collapse',
     singleLine = false,
@@ -43,6 +45,7 @@ const Table = (props: TableProps) => {
 
   const ariaProps = buildAriaProps(aria)
   const dataProps = buildDataProps(data)
+  const htmlProps = buildHtmlProps(htmlOptions)
   const tableCollapseCss = responsive !== 'none' ? `table-collapse-${collapse}` : ''
   const verticalBorderCss = verticalBorder ? 'vertical-border' : ''
 
@@ -55,6 +58,7 @@ const Table = (props: TableProps) => {
     <table
       {...ariaProps}
       {...dataProps}
+      {...htmlProps}
       className={classnames(
         'pb_table',
         `table-${size}`,

data/app/pb_kits/playbook/pb_table/_table_row.tsx

@@ -1,6 +1,6 @@
 import React from 'react'
 import classnames from 'classnames'
-import { buildAriaProps, buildCss, buildDataProps } from '../utilities/props'
+import { buildAriaProps, buildCss, buildDataProps, buildHtmlProps } from '../utilities/props'
 import { globalProps } from '../utilities/globalProps'
 
 type TableRowPropTypes = {
@@ -8,6 +8,7 @@ type TableRowPropTypes = {
   children: React.ReactNode[] | React.ReactNode,
   className: string,
   data?: { [key: string]: string },
+  htmlOptions?: {[key: string]: string | number | boolean | Function},
   id?: string,
   sideHighlightColor: string,
 }
@@ -18,12 +19,14 @@ const TableRow = (props: TableRowPropTypes) => {
     children,
     className,
     data = {},
+    htmlOptions = {},
     id,
     sideHighlightColor = 'windows',
   } = props
 
   const ariaProps = buildAriaProps(aria)
   const dataProps = buildDataProps(data)
+  const htmlProps = buildHtmlProps(htmlOptions)
   const sideHighlightClass =
     sideHighlightColor != '' ? `side_highlight_${sideHighlightColor}` : null
   const classes = classnames(buildCss('pb_table_row_kit', sideHighlightClass), globalProps(props), className)
@@ -32,6 +35,7 @@ const TableRow = (props: TableRowPropTypes) => {
     <tr
       {...ariaProps}
       {...dataProps}
+      {...htmlProps}
       className={classes}
       id={id}
     >

data/app/pb_kits/playbook/pb_text_input/_text_input.tsx

@@ -2,7 +2,7 @@ import React, { forwardRef } from 'react'
 import classnames from 'classnames'
 
 import { globalProps, GlobalProps, domSafeProps } from '../utilities/globalProps'
-import { buildAriaProps, buildDataProps } from '../utilities/props'
+import { buildAriaProps, buildDataProps, buildHtmlProps } from '../utilities/props'
 
 import Flex from '../pb_flex/_flex'
 import Card from '../pb_card/_card'
@@ -17,6 +17,7 @@ type TextInputProps = {
   dark?: boolean,
   disabled?: boolean,
   error?: string,
+  htmlOptions?: {[key: string]: string | number | boolean | Function},
   id?: string,
   inline?: boolean,
   name: string,
@@ -43,6 +44,7 @@ const TextInput = (props: TextInputProps, ref: React.LegacyRef<HTMLInputElement>
     data = {},
     disabled,
     error,
+    htmlOptions = {},
     id,
     inline = false,
     name,
@@ -57,6 +59,7 @@ const TextInput = (props: TextInputProps, ref: React.LegacyRef<HTMLInputElement>
 
   const ariaProps = buildAriaProps(aria)
   const dataProps = buildDataProps(data)
+  const htmlProps = buildHtmlProps(htmlOptions)
 
   const { alignment, border, icon } = addOn
   const addOnAlignment = alignment === 'left' ? 'left' : 'right'
@@ -138,6 +141,7 @@ const TextInput = (props: TextInputProps, ref: React.LegacyRef<HTMLInputElement>
     <div
         {...ariaProps}
         {...dataProps}
+        {...htmlProps}
         className={css}
     >
       {label && 

data/app/pb_kits/playbook/pb_text_input/docs/_text_input_add_on_swift.md

@@ -0,0 +1,35 @@
+![text-input-add-on](https://github.com/powerhome/playbook/assets/92755007/65a28e6a-9e65-4ca1-af8d-91dae6eac4f5)
+
+```swift
+
+PBTextInput(
+  "ADD ON WITH DEFAULTS",
+  text: $textAddOn,
+  style: .rightIcon(.user, divider: true)
+)
+
+PBTextInput(
+  "RIGHT-ALIGNED ADD ON WITH BORDER",
+  text: $textAddOnRight,
+  style: .rightIcon(.user, divider: true)
+)
+
+PBTextInput(
+  "RIGHT-ALIGNED ADD ON WITH NO BORDER",
+  text: $textAddOnRightNoBorder,
+  style: .rightIcon(.user, divider: false)
+)
+
+PBTextInput(
+  "LEFT-ALIGNED ADD ON WITH NO BORDER",
+  text: $textAddOnLeft,
+  style: .leftIcon(.user, divider: false)
+)
+
+PBTextInput(
+  "LEFT-ALIGNED ADD ON WITH BORDER",
+  text: $textAddOnLeftNoBorder,
+  style: .leftIcon(.user, divider: true)
+)
+
+```

data/app/pb_kits/playbook/pb_text_input/docs/_text_input_default_swift.md

@@ -0,0 +1,29 @@
+![text-input-default](https://github.com/powerhome/playbook/assets/92755007/625a246e-9d5c-42ea-8c6e-7afcf0984c9a)
+
+
+```swift
+
+@State private var textFirstName: String = ""
+@State private var textLastName: String = ""
+@State private var textPhone: String = ""
+
+PBTextInput(
+  "First name",
+  text: $textFirstName,
+  placeholder: "Enter first name"
+)
+
+PBTextInput(
+  "Last name",
+  text: $textLastName,
+  placeholder: "Enter last name"
+)
+
+PBTextInput(
+  "Phone number",
+  text: $textPhone,
+  placeholder: "Enter phone number",
+  keyboardType: .phonePad
+)
+
+```

data/app/pb_kits/playbook/pb_text_input/docs/_text_input_disabled_swift.md

@@ -0,0 +1,13 @@
+![text-input-disabled](https://github.com/powerhome/playbook/assets/92755007/0e08256e-dd76-4528-b748-826f38bbe6a0)
+
+
+```swift
+
+PBTextInput(
+  "Last name",
+  text: $textDisabled,
+  placeholder: "Enter last name",
+  style: .disabled
+)
+
+```

data/app/pb_kits/playbook/pb_text_input/docs/_text_input_error_swift.md

@@ -0,0 +1,24 @@
+![text-input-error](https://github.com/powerhome/playbook/assets/92755007/7c664f75-1d7a-4a94-bc59-6f845a68ce19)
+
+
+```swift
+
+@State private var textError: String = ""
+@State private var textConfirmError: String = ""
+
+PBTextInput(
+  "Email address",
+  text: $textError,
+  placeholder: "Enter email address",
+  error: (true, "Insert a valid email"),
+  style: .leftIcon(.user, divider: true)
+)
+
+PBTextInput(
+  "Confirm email address",
+  text: $textConfirmError,
+  placeholder: "Confirm email address",
+  style: .leftIcon(.user, divider: true)
+)
+
+```

data/app/pb_kits/playbook/pb_text_input/docs/_text_input_props_swift.md

@@ -0,0 +1,13 @@
+### Props
+| Name | Type | Description | Default | Values |
+| --- | ----------- | --------- | --------- | --------- |
+| **title** | `String` | Adds a title | `nil` |  |
+| **placeholder** | `String` | Adds placeholder text | `""` |  |
+| **error** | `(Bool, String)` | Changes the style of the Text Input | `nil` |  |
+| **style** | `Style` | Changes the style of the Text Input | `.default` | `.default` `.rightIcon` `.leftIcon` `.inline` `.disabled` |
+| **onChange** | `Bool` | Adds an event handler | `nil` |  |
+| **keyboardType** | `UIKeyboardType` | Speficies the keyboard type (ios only) | `.default` |  |
+| **text** | `String` | Sets the Text Input's text value |  |  |
+| **selected** | `Bool` | Changes the style of the Text Input |  | `true` `false` |
+| **isHovering** | `Bool` | Changes the style of the Text Input | `false` | `true` `false` |
+| **isIconHovering** | `Bool` | Changes the style of the Text Input | `false` | `true` `false` |

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

@@ -16,3 +16,10 @@ examples:
   - text_input_add_on: Add On
   - text_input_inline: Inline
   - text_input_no_label: No Label
+
+  swift:
+    - text_input_default_swift: Default
+    - text_input_error_swift: With Error
+    - text_input_disabled_swift: Disabled
+    - text_input_add_on_swift: Add On
+    - text_input_props_swift: ""