playbook_ui_docs 14.15.0.pre.alpha.play1907passglobalpropstotooltiprails6706 → 14.15.0.pre.alpha.play1910emptystatekitreactbeta6579

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: playbook_ui_docs
 version: !ruby/object:Gem::Version
-  version: 14.15.0.pre.alpha.play1907passglobalpropstotooltiprails6706
+  version: 14.15.0.pre.alpha.play1910emptystatekitreactbeta6579
 platform: ruby
 authors:
 - Power UX
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-03-14 00:00:00.000000000 Z
+date: 2025-03-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: playbook_ui
@@ -59,8 +59,6 @@ files:
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_expanded_control.jsx
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_expanded_control.md
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_infinite_scroll.jsx
-- app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_editing.jsx
-- app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_editing.md
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_row_loading.jsx
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_row_loading.md
 - app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_loading.html.erb
@@ -539,10 +537,8 @@ files:
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_month_and_year.html.erb
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_month_and_year.jsx
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_month_and_year.md
-- app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.html.erb
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.jsx
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.md
-- app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_close.html.erb
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_close.jsx
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_close.md
 - app/pb_kits/playbook/pb_date_picker/docs/_date_picker_positions.html.erb
@@ -790,6 +786,11 @@ files:
 - app/pb_kits/playbook/pb_dropdown/docs/_dropdown_with_label.md
 - app/pb_kits/playbook/pb_dropdown/docs/example.yml
 - app/pb_kits/playbook/pb_dropdown/docs/index.js
+- app/pb_kits/playbook/pb_empty_state/docs/_empty_state_alignment.jsx
+- app/pb_kits/playbook/pb_empty_state/docs/_empty_state_orientation.jsx
+- app/pb_kits/playbook/pb_empty_state/docs/_empty_state_size.jsx
+- app/pb_kits/playbook/pb_empty_state/docs/example.yml
+- app/pb_kits/playbook/pb_empty_state/docs/index.js
 - app/pb_kits/playbook/pb_file_upload/docs/_description.md
 - app/pb_kits/playbook/pb_file_upload/docs/_file_upload_accept.jsx
 - app/pb_kits/playbook/pb_file_upload/docs/_file_upload_custom.html.erb
@@ -1267,8 +1268,6 @@ files:
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_default.md
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_disabled.html.erb
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_disabled.jsx
-- app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_react_hook.jsx
-- app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_react_hook.md
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_reset.html.erb
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_reset.md
 - app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_return_all_selected.html.erb
@@ -1475,8 +1474,6 @@ files:
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_format.html.erb
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_format.jsx
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_format.md
-- app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_hidden_inputs.html.erb
-- app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_hidden_inputs.md
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_initial_country.html.erb
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_initial_country.jsx
 - app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_initial_country.md
@@ -2099,9 +2096,9 @@ files:
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_delay.md
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_delay_rails.html.erb
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_delay_rails.md
+- app/pb_kits/playbook/pb_tooltip/docs/_tooltip_icon.erb
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_icon.jsx
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_icon.md
-- app/pb_kits/playbook/pb_tooltip/docs/_tooltip_icon_rails.html.erb
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_interaction.html.erb
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_interaction.jsx
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_interaction.md
@@ -2113,7 +2110,6 @@ files:
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip.md
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip_react.jsx
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_show_tooltip_react.md
-- app/pb_kits/playbook/pb_tooltip/docs/_tooltip_sizing.html.erb
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_sizing.jsx
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_sizing.md
 - app/pb_kits/playbook/pb_tooltip/docs/_tooltip_with_icon_circle.html.erb
@@ -2157,8 +2153,6 @@ files:
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_margin_bottom.jsx
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_multi_kit.html.erb
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_multi_kit.jsx
-- app/pb_kits/playbook/pb_typeahead/docs/_typeahead_react_hook.jsx
-- app/pb_kits/playbook/pb_typeahead/docs/_typeahead_react_hook.md
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_truncated_text.html.erb
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_truncated_text.jsx
 - app/pb_kits/playbook/pb_typeahead/docs/_typeahead_truncated_text.md

data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_editing.jsx

@@ -1,102 +0,0 @@
-import React, { useState } from "react";
-import { AdvancedTable, TextInput, Body } from "playbook-ui";
-import MOCK_DATA from "./advanced_table_mock_data.json";
-
-const AdvancedTableInlineEditing = (props) => {
-  const [editedValues, setEditedValues] = useState({});
-
-  const EditableCell = ({ rowId, originalValue, onSave }) => {
-    const [localValue, setLocalValue] = useState(originalValue);
-
-    const handleChange = (e) => setLocalValue(e.target.value);
-
-    const handleBlur = () => {
-      originalValue !== localValue && onSave(rowId, localValue);
-    };
-
-    return (
-      <TextInput inline
-          marginBottom="none"
-          {...props}
-      >
-        <input 
-            onBlur={handleBlur} 
-            onChange={handleChange} 
-            onKeyDown={(e) => e.key === 'Enter' && handleBlur()}
-            value={localValue} 
-        />
-      </TextInput>
-    );
-  };
-
-  const columnDefinitions = [
-    {
-      accessor: "year",
-      label: "Year",
-      cellAccessors: ["quarter", "month", "day"],
-    },
-    {
-      accessor: "newEnrollments",
-      label: "New Enrollments",
-    },
-    {
-      accessor: "scheduledMeetings",
-      label: "Scheduled Meetings",
-      editable: true,
-      customRenderer: (row) => {
-        return (
-          <EditableCell
-              onSave={(id, val) => {
-                setEditedValues((prev) => ({ ...prev, [id]: val }));
-              }}
-              originalValue={
-                editedValues[row.id] ?? row.original.scheduledMeetings
-              }
-              rowId={row.id}
-          />
-        );
-      },
-    },
-    {
-      accessor: "attendanceRate",
-      label: "Attendance Rate",
-    },
-    {
-      accessor: "completedClasses",
-      label: "Completed Classes",
-    },
-    {
-      accessor: "classCompletionRate",
-      label: "Class Completion Rate",
-    },
-    {
-      accessor: "graduatedStudents",
-      label: "Graduated Students",
-    },
-  ];
-
-  return (
-    <div className="App">
-      <AdvancedTable
-          columnDefinitions={columnDefinitions}
-          tableData={MOCK_DATA}
-          {...props}
-      />
-      {
-        editedValues && Object.keys(editedValues).length > 0 && (
-          <>
-            <Body 
-                marginTop="md"
-                {...props}
-            >
-              Edited Values by Row Id:
-            </Body>
-            <pre style={{color: 'white'}}>{JSON.stringify(editedValues, null, 2)}</pre>
-          </>
-        )
-      }
-    </div>
-  );
-};
-
-export default AdvancedTableInlineEditing;

data/app/pb_kits/playbook/pb_advanced_table/docs/_advanced_table_inline_editing.md

@@ -1,4 +0,0 @@
-Inline Cell Editing can be achieved with a combination of our `TextInput` kit and the `customRenderer` method available through columnDefinitions. 
-
-Hover over any cell within the 'Scheduled Meetings' column to see the TextInput and type in to change values. Values can be saved by clicking away from the TextInput or by hitting 'Enter'.
-See the code snippet below to see how this was achieved. Devs must manage state themselves as shown.

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_change.html.erb

@@ -1,39 +0,0 @@
-<%= pb_rails("date_picker", props: {
-  label: "Date Picker",
-  picker_id: "date-picker-onchange",
-  margin_bottom: "lg"
-}) %>
-<%= pb_rails("caption", props: { text: "Date Object" }) %>
-<%= pb_rails("body", props: {
-  label: "Date Object",
-  text: "Select Date",
-  margin_bottom: "lg",
-  id: "date-picker-onchange-object",
-}) %>
-<%= pb_rails("caption", props: { text: "Date String" }) %>
-<%= pb_rails("body", props: {
-  label: "Date String",
-  text: "Select Date",
-  margin_bottom: "lg",
-  id: "date-picker-onchange-string",
-}) %>
-
-
-<%= javascript_tag do %>
-  window.addEventListener("DOMContentLoaded", () => {
-    <%# Access flatpickr instance with picker id and assign it a variable %>
-    const fp = document.querySelector("#date-picker-onchange")._flatpickr
-
-    <%# Define Hook %>
-    const changeHook = (selectedDates, dateStr) => {
-      const object = document.querySelector('#date-picker-onchange-object')
-      object.textContent = selectedDates[0] ? selectedDates[0].toString() : ''
-
-      const string = document.querySelector('#date-picker-onchange-string')
-      string.textContent = dateStr
-    }
-    
-    <%# Push one or more hooks to onChange config array %>
-    fp.config.onChange.push(changeHook)
-  })
-<% end %>

data/app/pb_kits/playbook/pb_date_picker/docs/_date_picker_on_close.html.erb

@@ -1,39 +0,0 @@
-<%= pb_rails("date_picker", props: {
-  label: "Date Picker",
-  picker_id: "date-picker-onclose",
-  margin_bottom: "lg"
-}) %>
-<%= pb_rails("caption", props: { text: "Date Object" }) %>
-<%= pb_rails("body", props: {
-  label: "Date Object",
-  text: "Select Date",
-  margin_bottom: "lg",
-  id: "date-picker-onclose-object",
-}) %>
-<%= pb_rails("caption", props: { text: "Date String" }) %>
-<%= pb_rails("body", props: {
-  label: "Date String",
-  text: "Select Date",
-  margin_bottom: "lg",
-  id: "date-picker-onclose-string",
-}) %>
-
-
-<%= javascript_tag do %>
-  window.addEventListener("DOMContentLoaded", () => {
-    <%# Access flatpickr instance with picker id and assign it a variable %>
-    const fp = document.querySelector("#date-picker-onclose")._flatpickr
-
-    <%# Define Hook %>
-    const closeHook = (selectedDates, dateStr) => {
-      const object = document.querySelector('#date-picker-onclose-object')
-      object.textContent = selectedDates[0] ? selectedDates[0].toString() : ''
-
-      const string = document.querySelector('#date-picker-onclose-string')
-      string.textContent = dateStr
-    }
-    
-    <%# Push one or more hooks to onClose config array %>
-    fp.config.onClose.push(closeHook)
-  })
-<% end %>

data/app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_react_hook.jsx

@@ -1,91 +0,0 @@
-import React from "react"
-import MultiLevelSelect from "../_multi_level_select"
-import { useForm } from "react-hook-form"
-
-const treeData = [
-  {
-    label: "Power Home Remodeling",
-    value: "Power Home Remodeling",
-    id: "powerhome1",
-    expanded: true,
-    children: [
-      {
-        label: "People",
-        value: "People",
-        id: "people1",
-        expanded: true,
-        children: [
-          {
-            label: "Talent Acquisition",
-            value: "Talent Acquisition",
-            id: "talent1",
-          },
-          {
-            label: "Business Affairs",
-            value: "Business Affairs",
-            id: "business1",
-            children: [
-              {
-                label: "Initiatives",
-                value: "Initiatives",
-                id: "initiative1",
-              },
-              {
-                label: "Learning & Development",
-                value: "Learning & Development",
-                id: "development1",
-              },
-            ],
-          },
-          {
-            label: "People Experience",
-            value: "People Experience",
-            id: "experience1",
-          },
-        ],
-      },
-      {
-        label: "Contact Center",
-        value: "Contact Center",
-        id: "contact1",
-        children: [
-          {
-            label: "Appointment Management",
-            value: "Appointment Management",
-            id: "appointment1",
-          },
-          {
-            label: "Customer Service",
-            value: "Customer Service",
-            id: "customer1",
-          },
-          {
-            label: "Energy",
-            value: "Energy",
-            id: "energy1",
-          },
-        ],
-      },
-    ],
-  },
-]
-
-const MultiLevelSelectReactHook = (props) => {
-  const { register, watch } = useForm()
-  const selectedItems = watch("departments")
-  selectedItems && console.log("Selected Items", selectedItems)
-
-  return (
-    <div>
-      <MultiLevelSelect
-          id="multiselect-default"
-          marginBottom="md"
-          treeData={treeData}
-          {...register("departments")}
-          {...props}
-      />
-    </div>
-  )
-}
-
-export default MultiLevelSelectReactHook

data/app/pb_kits/playbook/pb_multi_level_select/docs/_multi_level_select_react_hook.md

@@ -1 +0,0 @@
-You can pass `react-hook-form` props to the MultiLevelSelect kit. Check your console to see the full data selected from this example.

data/app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_hidden_inputs.html.erb

@@ -1,5 +0,0 @@
-<%= pb_rails("phone_number_input", props: {
-    hidden_inputs: true,
-    id: "hidden_inputs",
-    name: "hidden_inputs",
-}) %>

data/app/pb_kits/playbook/pb_phone_number_input/docs/_phone_number_input_hidden_inputs.md

@@ -1 +0,0 @@
-The `hidden_inputs` boolean prop generates two hidden input fields, {field_name}_full and {field_name}_country_code. The value passed when the form is submitted contains the full phone number including the country code. Because it requires the submission of a form to function, only use this prop on Rails phone number elements within html form tags `<form>/<form>` or [pb_forms](https://playbook.powerapp.cloud/kits/form). Read the [intl-tel-input](https://intl-tel-input.com/examples/hidden-input.html) docs for more information.

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_icon_rails.html.erb

@@ -1,22 +0,0 @@
-<%= pb_rails "flex", props: { flex_direction: "row", gap: "md", wrap: true } do %>
-  <%= pb_rails "button", props: { id: "tool-tip-with-icon-1", text: "Tooltip With Icon" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-with-icon-1", tooltip_id: "tool-tip-with-icon-1", position: "top" } do %>
-    <%= pb_rails("icon", props: { icon: "paper-plane", fixed_width: true, color: "white", size: "1x", padding_right: "xxs" }) %>
-    Send Email
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-with-icon-2", text: "Tooltip With Icon" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-with-icon-2", tooltip_id: "tool-tip-with-icon-2", position: "bottom" } do %>
-    <%= pb_rails("icon", props: { icon: "paper-plane", fixed_width: true, color: "white", size: "1x", padding_right: "xxs" }) %>
-    Send Email
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-with-icon-3", text: "Tooltip With Icon" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-with-icon-3", tooltip_id: "tool-tip-with-icon-3", position: "left" } do %>
-    <%= pb_rails("icon", props: { icon: "paper-plane", fixed_width: true, color: "white", size: "1x", padding_right: "xxs" }) %>
-    Send Email
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-with-icon-4", text: "Tooltip With Icon" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-with-icon-4", tooltip_id: "tool-tip-with-icon-4", position: "right" } do %>
-    <%= pb_rails("icon", props: { icon: "paper-plane", fixed_width: true, color: "white", size: "1x", padding_right: "xxs" }) %>
-    Send Email
-  <% end %>
-<% end %>

data/app/pb_kits/playbook/pb_tooltip/docs/_tooltip_sizing.html.erb

@@ -1,22 +0,0 @@
-<%= pb_rails "flex", props: { flex_direction: "row", gap: "md", wrap: true } do %>
-  <%= pb_rails "button", props: { id: "tool-tip-sizing-1", text: "Height and Width" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-sizing-1", tooltip_id: "tool-tip-sizing-1", position: "top", height: "150px", width: "100px" } do %>
-    I'm 150px high and 100px wide!
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-sizing-2", text: "max_height" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-sizing-2", tooltip_id: "tool-tip-sizing-2", position: "top", width: "250px", max_height: "100px" } do %>
-    I have a max_height of 100px! Lorem ipsum dolor sit amet consectetur adipisicing elit.
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-sizing-3", text: "max_width" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-sizing-3", tooltip_id: "tool-tip-sizing-3", position: "top", max_width: "150px" } do %>
-    I have a max_width of 150px! Lorem ipsum dolor sit amet consectetur adipisicing elit.
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-sizing-4", text: "min_width" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-sizing-4", tooltip_id: "tool-tip-sizing-4", position: "top", min_width: "300px" } do %>
-    I have a min_width of 300px!
-  <% end %>
-  <%= pb_rails "button", props: { id: "tool-tip-sizing-5", text: "min_height" } %>
-  <%= pb_rails "tooltip", props: { trigger_element_selector: "#tool-tip-sizing-5", tooltip_id: "tool-tip-sizing-5", position: "top", min_height: "300px", height: "200px", html_options: { tab_index: 5, style: { color: "blue" }},  } do %>
-    I have a min_height of 300px!
-  <% end %>
-<% end %>

data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_react_hook.jsx

@@ -1,66 +0,0 @@
-import React from 'react'
-
-import { Typeahead, Title } from 'playbook-ui'
-import { useForm } from 'react-hook-form'
-
-const languages = [
-  { label: 'JavaScript', value: '1995', category: 'Web Development' },
-  { label: 'Python', value: '1991', category: 'General Purpose' },
-  { label: 'Java', value: '1995', category: 'Enterprise' },
-  { label: 'C++', value: '1985', category: 'Systems Programming' },
-  { label: 'Go', value: '2009', category: 'Systems Programming' },
-  { label: 'Rust', value: '2010', category: 'Systems Programming' },
-  { label: 'Swift', value: '2014', category: 'Mobile Development' },
-  { label: 'Kotlin', value: '2011', category: 'Mobile Development' },
-  { label: 'Ruby', value: '1995', category: 'General Purpose' },
-  { label: 'PHP', value: '1995', category: 'Web Development' },
-]
-
-const colors = [
-  { label: 'Orange', value: '#FFA500' },
-  { label: 'Red', value: '#FF0000' },
-  { label: 'Green', value: '#00FF00' },
-  { label: 'Blue', value: '#0000FF' },
-]
-
-const TypeaheadReactHook = (props) => {
-  const { register, watch } = useForm()
-
-  const selectedLanguages = watch('languages')
-  const selectedColor = watch('color')
-
-  return (
-    <>
-      <Typeahead
-          isMulti
-          label="Multi Select Languages"
-          multiKit="language"
-          options={languages}
-          {...props}
-          {...register('languages')}
-      />
-      <Title 
-          size={4} 
-          text='Selected Languages' 
-      />
-      {selectedLanguages && selectedLanguages.map(language => (
-        <p key={language.label}>{`${language.label} - ${language.value} - ${language.category}`}</p>
-      ))}
-
-      <Typeahead
-          label="Colors"
-          marginTop="lg"
-          options={colors}
-          {...props}
-          {...register('color')}
-      />
-      <Title 
-          size={4} 
-          text='Selected Color' 
-      />
-      <p>{ selectedColor && `${selectedColor.label} - ${selectedColor.value}`}</p>
-    </>
-  )
-}
-
-export default TypeaheadReactHook

data/app/pb_kits/playbook/pb_typeahead/docs/_typeahead_react_hook.md

@@ -1 +0,0 @@
-You can pass `react-hook-form` props to the Typeahead kit.