From 66b671da940c845bde58c5c92d846b2008f96919 Mon Sep 17 00:00:00 2001
From: Micheal Parks <103450731+micheal-parks@users.noreply.github.com>
Date: Wed, 21 Feb 2024 14:50:04 -0500
Subject: [PATCH] Design maintenance: add radio icon and description options
 (#485)

---
 packages/core/package.json                    |  2 +-
 packages/core/src/lib/radio.svelte            | 63 +++++++++++++------
 packages/storybook/src/stories/radio.mdx      |  8 +++
 .../src/stories/radio.stories.svelte          | 45 +++++++++++++
 4 files changed, 99 insertions(+), 19 deletions(-)

diff --git a/packages/core/package.json b/packages/core/package.json
index 8b1b7dd4..dd9a6753 100644
--- a/packages/core/package.json
+++ b/packages/core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@viamrobotics/prime-core",
-  "version": "0.0.91",
+  "version": "0.0.92",
   "publishConfig": {
     "access": "public"
   },
diff --git a/packages/core/src/lib/radio.svelte b/packages/core/src/lib/radio.svelte
index 122a2aae..57a08061 100644
--- a/packages/core/src/lib/radio.svelte
+++ b/packages/core/src/lib/radio.svelte
@@ -19,8 +19,17 @@ import Label from '$lib/label.svelte';
 import { Icon, type IconName } from '$lib/icon';
 import { preventHandler, preventKeyboardHandler } from '$lib/prevent-handler';
 
+interface Option {
+  label: string;
+  value: string;
+  description?: string;
+  icon?: IconName;
+}
+
+type Options = (string | Option)[];
+
 /** The set of options that is available in the radio button. */
-export let options: string[];
+export let options: Options;
 
 /** The name for the inputs in the fieldset of radio options. */
 export let name: string;
@@ -41,11 +50,13 @@ export let direction: 'col' | 'row' = 'col';
 let extraClasses: cx.Argument = '';
 export { extraClasses as cx };
 
-$: isSelected = (option: string) => option === selected;
+let optionsInternal: Option[] = [];
+
+$: optionsInternal = options.map((option) =>
+  typeof option === 'string' ? { label: option, value: option } : option
+);
 $: handleDisabled = preventHandler(disabled);
 $: handleDisabledKeydown = preventKeyboardHandler(disabled);
-$: getIcon = (option: string): IconName =>
-  isSelected(option) ? 'radiobox-marked' : 'radiobox-blank';
 </script>
 
 <fieldset
@@ -56,7 +67,7 @@ $: getIcon = (option: string): IconName =>
   {#if $$slots.legend}
     <legend
       class={cx(
-        cx('mb-1 flex text-xs text-subtle-1', {
+        cx('mb-2 flex text-xs text-subtle-1', {
           'after:text-danger-dark after:content-["*"]': required,
         })
       )}
@@ -66,31 +77,31 @@ $: getIcon = (option: string): IconName =>
   {/if}
 
   <div
-    class={cx('flex', {
+    class={cx('flex gap-2', {
       'flex-col': direction === 'col',
-      'flex-row gap-2': direction === 'row',
+      'flex-row': direction === 'row',
     })}
   >
-    {#each options as option}
+    {#each optionsInternal as { label, value, description, icon }}
+      {@const isSelected = value === selected}
+      {@const radioIcon = isSelected ? 'radiobox-marked' : 'radiobox-blank'}
       <Label
         position="left"
         {disabled}
         cx={[
-          'h-7.5 whitespace-nowrap text-xs',
+          'whitespace-nowrap text-xs',
           {
-            'font-semibold': isSelected(option),
-            'text-default': isSelected(option) && !disabled,
-            'text-subtle-1': !isSelected(option) && !disabled,
+            'text-subtle-1': !isSelected && !disabled,
             'cursor-not-allowed text-disabled-dark': disabled,
           },
         ]}
       >
         <input
           {name}
+          {value}
           type="radio"
-          value={option}
           class="peer appearance-none"
-          checked={isSelected(option)}
+          checked={isSelected}
           readonly={disabled ? true : undefined}
           aria-disabled={disabled ? true : undefined}
           bind:group={selected}
@@ -100,15 +111,31 @@ $: getIcon = (option: string): IconName =>
           on:keydown|capture={handleDisabledKeydown}
         />
         <Icon
-          name={getIcon(option)}
+          name={radioIcon}
           cx={cx({
             'text-disabled-dark': disabled,
-            'text-gray-9': !disabled && option === selected,
-            'text-gray-6': !disabled && option !== selected,
+            'text-gray-9': !disabled && isSelected,
+            'text-gray-6': !disabled && !isSelected,
           })}
         />
         <span class="pl-1.5">
-          {option}
+          <span class="flex gap-1.5">
+            {#if icon}
+              <Icon
+                cx="text-gray-7"
+                name={icon}
+              />
+            {/if}
+            <span
+              class={cx({
+                'font-semibold': isSelected,
+                'text-default': isSelected && !disabled,
+              })}>{label}</span
+            >
+          </span>
+          {#if description}
+            <p class="mt-0.5 text-subtle-2">{description}</p>
+          {/if}
         </span>
       </Label>
     {/each}
diff --git a/packages/storybook/src/stories/radio.mdx b/packages/storybook/src/stories/radio.mdx
index 6fc185ec..f536898a 100644
--- a/packages/storybook/src/stories/radio.mdx
+++ b/packages/storybook/src/stories/radio.mdx
@@ -26,3 +26,11 @@ import { Radio } from '@viamrobotics/prime-core';
 <Canvas>
   <Story of={RadioStories.Disabled} />
 </Canvas>
+
+<Canvas>
+  <Story of={RadioStories.WithDescription} />
+</Canvas>
+
+<Canvas>
+  <Story of={RadioStories.WithIcon} />
+</Canvas>
diff --git a/packages/storybook/src/stories/radio.stories.svelte b/packages/storybook/src/stories/radio.stories.svelte
index 1346679a..d0580948 100644
--- a/packages/storybook/src/stories/radio.stories.svelte
+++ b/packages/storybook/src/stories/radio.stories.svelte
@@ -44,3 +44,48 @@ import { Radio } from '@viamrobotics/prime-core';
     <svelte:fragment slot="legend">Favorite animal</svelte:fragment>
   </Radio>
 </Story>
+
+<Story name="With description">
+  <Radio
+    name="Upload model"
+    options={[
+      {
+        label: 'New model',
+        value: 'new model',
+        description: 'Upload a new model',
+      },
+      {
+        label: 'New version',
+        value: 'new version',
+        description:
+          'Upload a new version of a model that already exists in Viam',
+      },
+    ]}
+    selected="new model"
+  >
+    <svelte:fragment slot="legend">Upload model</svelte:fragment>
+  </Radio>
+</Story>
+
+<Story name="With icon">
+  <Radio
+    name="Visibility"
+    options={[
+      {
+        label: 'Public',
+        value: 'public',
+        description: 'Can be used by external organizations',
+        icon: 'earth',
+      },
+      {
+        label: 'Private',
+        value: 'private',
+        description: 'Only for internal use within this organization',
+        icon: 'lock',
+      },
+    ]}
+    selected="public"
+  >
+    <svelte:fragment slot="legend">Visibility</svelte:fragment>
+  </Radio>
+</Story>