@sproutsocial/racine 13.3.0 → 13.4.2

package/CHANGELOG.md

@@ -1,5 +1,62 @@
 # Change Log
 
+## 13.4.2
+
+### Patch Changes
+
+- e26d0ef6: Triggering a forced NPM deploy for the changes in 13.4.1 due to a deployment issue
+
+## 13.4.1
+
+### Patch Changes
+
+- 6b1e15e9: Update tasks-check icon to remove fill that was preventing changing its color.
+- ff903949: Added 'route' icon to the Icon Component.
+- 5a9a805b: Allow consumers to reference Google and Apple App Store network colors using theme tokens
+- 164e6cd9: This patch adds new spot illustrations for:
+
+  - variable-table
+  - user-team
+
+## 13.4.0
+
+### Minor Changes
+
+- b6f0228d: Adds Icon Library codemod to address upcoming breaking changes
+
+  **Deprecation Notice**: Upcoming breaking changes to the Icon component and tooling
+
+  In Q1 2023, we will be making several major changes to the Icon component. Key changes:
+
+  - Icon assets will be stored in a new package called @sproutsocial/seeds-icons. This will allow consumers of Racine to update to the latest icons without waiting for Racine to release an update. @sproutsocial/seeds-icons will be a peer and dev dependency of Racine.
+  - Most icons will have solid and outline variants, with outline being the default. Variants can be included in the icon name (e.g., `bell-solid`) or as a prop (e.g., `<Icon name=”bell” variant=”solid” />`).
+  - Icons will be renamed to use descriptive instead of prescriptive naming. For instance, the `ads` icon will be renamed to `dollar-outline` so that its name will visually describe the icon instead of prescribing its intended usage.
+
+  Due to the scale of the changes, we are unable to make the changes backwards-compatible. You can preview the migration process below, but you should not complete the migration until these changes are released.
+
+  Migration steps:
+
+  - Dependencies: Add @sproutsocial/seeds-icons to your application’s dependencies.
+  - Sprites: Instead of using icon.svg from Racine’s dist/ directory, the sprites should be imported from @sproutsocial/seeds-icons for each category of icons you want to include. Attach these spritesheets to the DOM in the same way you do icon.svg.
+  - Icon names: Most icon names are changing as a part of this refactor. Run the `icon-library` codemod to automatically update as many icon names as possible. For more information on how to use Racine codemods, view [our Migration docs on Seeds](https://seeds.sproutsocial.com/components/migration).
+
+- f84feaf3: Adds icon-name-substitution codemod
+  - This codemod complements the existing icon-library codemod, helping to automate icon name updates that cannot be automatically handled by the icon-library codemod.
+  - The codemod replaces string literals that are deprecated icon names with their updated names. Please note that this codemod will change any strings that happen to match a deprecated icon name, even if they are unrelated to icons, so we recommend running it against specific files (not your entire codebase) and carefully checking the results.
+  - Use `racine-codemod icon-name-substitution` to run this codemod and view the docs
+
+### Patch Changes
+
+- f84feaf3: Fixes icon-library codemod bugs
+
+  The following unwanted behaviors have been removed:
+
+  - Erroneously removing the first comment in a file
+  - Erroneously removing the Icon import when Icon is still being used for a styled component or for "typeof Icon"
+  - Incorrect parsing of the "components" argument, leading to it not being used
+  - Adding multiple shim imports if there are multiple @sproutsocial/racine imports in the same file
+  - Breaking aliased and type imports from @sproutsocial/racine
+
 ## 13.3.0
 
 ### Minor Changes

package/__flow__/EnumIconNames.js

@@ -1,2 +1,2 @@
 // @flow
-export type EnumIconNames = "active-listener" | "add-item" | "add-keyword" | "add-team-member" | "add-variable" | "address-card-outline" | "address-card-solid" | "adobe-experience-manager" | "ads" | "advocacy-outline" | "advocacy" | "android" | "apple" | "approval-indicator-outline" | "approval-indicator" | "archive" | "arrow-down-line" | "arrow-down" | "arrow-left-line" | "arrow-left" | "arrow-right-line" | "arrow-right" | "arrow-up-line" | "arrow-up" | "arrows" | "asset-library-outline" | "asset-library" | "assign" | "atom" | "audio" | "back-to-top" | "bambu-icon-outline" | "bambu-icon" | "barcode" | "basketball" | "bell-outline" | "bigcommerce" | "bitly" | "bold" | "book" | "bookmark" | "bot" | "browser" | "business" | "calendar-outline" | "calendar" | "camera-outline" | "camera-story" | "camera" | "campaign" | "canva" | "carousel" | "cart-plus-outline" | "cart-plus" | "check" | "chevron-down-filled" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up-down-filled" | "chevron-up-filled" | "chevron-up" | "circle-check-outline" | "circle-check" | "circle" | "circle+" | "circles" | "circlex" | "click-to-view" | "clicks" | "clipboard-outline" | "clipboard" | "clock" | "closed-captioning" | "cloud" | "code" | "columns" | "comment-alt-outline" | "comment-alt" | "comment-lines-alt-outline" | "comment" | "compact-density" | "compact-indicator" | "comparison" | "competitor" | "compose" | "content-suggestions" | "credit-card" | "crop" | "crown" | "dashboard" | "deconstructed-negative-sentiment" | "deconstructed-neutral-sentiment" | "deconstructed-positive-sentiment" | "discovery" | "dislike-outline" | "dislike" | "dm-link-outline" | "dm-link" | "dotdotdot" | "download" | "drafts-outline" | "drafts" | "dropbox" | "duplicate-outline" | "duplicate" | "emoji-outline" | "emoji" | "empty-image" | "engagement-per-post" | "engagements" | "error" | "exchange-alt" | "expanded-indicator" | "export" | "extended-circles" | "external-link-alt" | "external-link" | "extreme-negative-sentiment" | "eye-outline" | "eye-slash-outline" | "eye-slash" | "eye" | "facebook-audience-network" | "facebook-branded-content-outline" | "facebook-branded-content" | "facebook-groups" | "facebook" | "fb-reactions-angry" | "fb-reactions-haha" | "fb-reactions-like" | "fb-reactions-love" | "fb-reactions-sad" | "fb-reactions-wow" | "feedly" | "feeds" | "female" | "file-chart-line" | "file-edit" | "file-times-solid" | "filter" | "flag-outline" | "flag" | "flat-negative-sentiment-outline" | "flat-negative-sentiment" | "flat-neutral-sentiment-outline" | "flat-neutral-sentiment" | "flat-positive-sentiment-outline" | "flat-positive-sentiment" | "folder-open" | "folder" | "follow-outline" | "follow" | "follower-increase" | "following" | "font" | "full-access" | "gear" | "gears" | "github" | "glassdoor" | "glasses" | "globe" | "google-analytics-color" | "google-business-messages" | "google-drive" | "google-my-business" | "grip" | "h1" | "h2" | "h3" | "h4" | "hamburger" | "hashtag" | "headset" | "heart-outline" | "heart" | "heartbeat" | "help-alt" | "help" | "hiking" | "history" | "home" | "hourglass" | "hubspot" | "image-caption" | "image" | "images" | "impressions-per-post" | "impressions" | "inactive-listener" | "inbox-action" | "inbox-views" | "inbox" | "indicator" | "industry" | "info" | "instagram" | "internal-activity-outline" | "internal-activity" | "italic" | "key" | "keyboard" | "laptop-phone" | "large-density" | "lift" | "like-outline" | "like" | "link" | "linkedin-audience-network" | "linkedin" | "list-ol" | "listening" | "lists" | "location-outline" | "location" | "lock" | "magic-wand" | "male" | "marketo" | "mention" | "message-preview-outline" | "message-preview" | "message" | "messages-outline" | "messages" | "messenger" | "metric-table" | "microsoft-dynamics" | "minus" | "mobile" | "monitor" | "moon" | "negative-sentiment" | "neutral-positive-sentiment" | "neutral-sentiment" | "new-trend" | "newspaper" | "no-access" | "notepad" | "notifications-publishing-outline" | "notifications-publishing" | "notifications" | "offline" | "online" | "paid-promotion-outline" | "paid-promotion" | "paid" | "paint" | "palette" | "paperclip" | "pause" | "pencil-outline" | "pencil" | "person" | "phone" | "pinterest-boards-outline" | "pinterest-boards" | "pinterest" | "play-circle" | "play" | "plug" | "plus" | "positive-sentiment" | "power-up-outline" | "power-up" | "profile-connect" | "profile-disconnect" | "publishing-outline" | "publishing" | "puzzle-piece" | "qr-code" | "queue" | "recommendation" | "reddit-alien" | "reddit" | "reels-outline" | "reels" | "referrals" | "refresh" | "rejected" | "reply-outline" | "reply" | "reporting-period" | "reporting" | "reports-home" | "reports" | "retweet" | "rss" | "sales" | "salesforce-cloud" | "salesforce" | "save-assets" | "saved-messages" | "saved-reply-outline" | "saved-reply" | "search" | "send-again-outline" | "send-again" | "sent-message-outline" | "sent-message" | "share" | "shopify" | "shopping-bag-outline" | "shopping-bag" | "show-navigation" | "slack" | "small-density" | "smiley" | "some-access" | "sparkles" | "spike-alert" | "star-half-alt-solid" | "star-of-life" | "star-outline" | "star" | "sticky-note-outline" | "sticky-note" | "stories" | "story" | "suggestions" | "sun" | "tag-outline" | "tag" | "targeting-outline" | "targeting" | "tasks-check" | "tasks-outline" | "tasks" | "team-conversation-outline" | "team-conversation" | "team" | "text-asset" | "text" | "tiktok" | "times" | "tools" | "trash-can-outline" | "trash-can" | "trend-down" | "trend-neutral" | "trend-up" | "trends" | "triangle-black" | "triangle" | "tripadvisor-circle-outline" | "tripadvisor-circle" | "tripadvisor" | "trophy-outline" | "tumblr" | "twitter-audience-network" | "twitter" | "underline" | "unfollow-outline" | "unfollow" | "unlink" | "unlock" | "upload" | "user-circle" | "users" | "verified" | "video-camera-story" | "video-camera" | "vip" | "weight" | "whatsapp" | "window-maximize" | "window-minimize" | "window-regular" | "window-restore" | "woocommerce" | "x" | "yelp-full-star" | "yelp-half-star" | "yelp" | "youtube" | "zendesk";
+export type EnumIconNames = "active-listener" | "add-item" | "add-keyword" | "add-team-member" | "add-variable" | "address-card-outline" | "address-card-solid" | "adobe-experience-manager" | "ads" | "advocacy-outline" | "advocacy" | "android" | "apple" | "approval-indicator-outline" | "approval-indicator" | "archive" | "arrow-down-line" | "arrow-down" | "arrow-left-line" | "arrow-left" | "arrow-right-line" | "arrow-right" | "arrow-up-line" | "arrow-up" | "arrows" | "asset-library-outline" | "asset-library" | "assign" | "atom" | "audio" | "back-to-top" | "bambu-icon-outline" | "bambu-icon" | "barcode" | "basketball" | "bell-outline" | "bigcommerce" | "bitly" | "bold" | "book" | "bookmark" | "bot" | "browser" | "business" | "calendar-outline" | "calendar" | "camera-outline" | "camera-story" | "camera" | "campaign" | "canva" | "carousel" | "cart-plus-outline" | "cart-plus" | "check" | "chevron-down-filled" | "chevron-down" | "chevron-left" | "chevron-right" | "chevron-up-down-filled" | "chevron-up-filled" | "chevron-up" | "circle-check-outline" | "circle-check" | "circle" | "circle+" | "circles" | "circlex" | "click-to-view" | "clicks" | "clipboard-outline" | "clipboard" | "clock" | "closed-captioning" | "cloud" | "code" | "columns" | "comment-alt-outline" | "comment-alt" | "comment-lines-alt-outline" | "comment" | "compact-density" | "compact-indicator" | "comparison" | "competitor" | "compose" | "content-suggestions" | "credit-card" | "crop" | "crown" | "dashboard" | "deconstructed-negative-sentiment" | "deconstructed-neutral-sentiment" | "deconstructed-positive-sentiment" | "discovery" | "dislike-outline" | "dislike" | "dm-link-outline" | "dm-link" | "dotdotdot" | "download" | "drafts-outline" | "drafts" | "dropbox" | "duplicate-outline" | "duplicate" | "emoji-outline" | "emoji" | "empty-image" | "engagement-per-post" | "engagements" | "error" | "exchange-alt" | "expanded-indicator" | "export" | "extended-circles" | "external-link-alt" | "external-link" | "extreme-negative-sentiment" | "eye-outline" | "eye-slash-outline" | "eye-slash" | "eye" | "facebook-audience-network" | "facebook-branded-content-outline" | "facebook-branded-content" | "facebook-groups" | "facebook" | "fb-reactions-angry" | "fb-reactions-haha" | "fb-reactions-like" | "fb-reactions-love" | "fb-reactions-sad" | "fb-reactions-wow" | "feedly" | "feeds" | "female" | "file-chart-line" | "file-edit" | "file-times-solid" | "filter" | "flag-outline" | "flag" | "flat-negative-sentiment-outline" | "flat-negative-sentiment" | "flat-neutral-sentiment-outline" | "flat-neutral-sentiment" | "flat-positive-sentiment-outline" | "flat-positive-sentiment" | "folder-open" | "folder" | "follow-outline" | "follow" | "follower-increase" | "following" | "font" | "full-access" | "gear" | "gears" | "github" | "glassdoor" | "glasses" | "globe" | "google-analytics-color" | "google-business-messages" | "google-drive" | "google-my-business" | "grip" | "h1" | "h2" | "h3" | "h4" | "hamburger" | "hashtag" | "headset" | "heart-outline" | "heart" | "heartbeat" | "help-alt" | "help" | "hiking" | "history" | "home" | "hourglass" | "hubspot" | "image-caption" | "image" | "images" | "impressions-per-post" | "impressions" | "inactive-listener" | "inbox-action" | "inbox-views" | "inbox" | "indicator" | "industry" | "info" | "instagram" | "internal-activity-outline" | "internal-activity" | "italic" | "key" | "keyboard" | "laptop-phone" | "large-density" | "lift" | "like-outline" | "like" | "link" | "linkedin-audience-network" | "linkedin" | "list-ol" | "listening" | "lists" | "location-outline" | "location" | "lock" | "magic-wand" | "male" | "marketo" | "mention" | "message-preview-outline" | "message-preview" | "message" | "messages-outline" | "messages" | "messenger" | "metric-table" | "microsoft-dynamics" | "minus" | "mobile" | "monitor" | "moon" | "negative-sentiment" | "neutral-positive-sentiment" | "neutral-sentiment" | "new-trend" | "newspaper" | "no-access" | "notepad" | "notifications-publishing-outline" | "notifications-publishing" | "notifications" | "offline" | "online" | "paid-promotion-outline" | "paid-promotion" | "paid" | "paint" | "palette" | "paperclip" | "pause" | "pencil-outline" | "pencil" | "person" | "phone" | "pinterest-boards-outline" | "pinterest-boards" | "pinterest" | "play-circle" | "play" | "plug" | "plus" | "positive-sentiment" | "power-up-outline" | "power-up" | "profile-connect" | "profile-disconnect" | "publishing-outline" | "publishing" | "puzzle-piece" | "qr-code" | "queue" | "recommendation" | "reddit-alien" | "reddit" | "reels-outline" | "reels" | "referrals" | "refresh" | "rejected" | "reply-outline" | "reply" | "reporting-period" | "reporting" | "reports-home" | "reports" | "retweet" | "route" | "rss" | "sales" | "salesforce-cloud" | "salesforce" | "save-assets" | "saved-messages" | "saved-reply-outline" | "saved-reply" | "search" | "send-again-outline" | "send-again" | "sent-message-outline" | "sent-message" | "share" | "shopify" | "shopping-bag-outline" | "shopping-bag" | "show-navigation" | "slack" | "small-density" | "smiley" | "some-access" | "sparkles" | "spike-alert" | "star-half-alt-solid" | "star-of-life" | "star-outline" | "star" | "sticky-note-outline" | "sticky-note" | "stories" | "story" | "suggestions" | "sun" | "tag-outline" | "tag" | "targeting-outline" | "targeting" | "tasks-check" | "tasks-outline" | "tasks" | "team-conversation-outline" | "team-conversation" | "team" | "text-asset" | "text" | "tiktok" | "times" | "tools" | "trash-can-outline" | "trash-can" | "trend-down" | "trend-neutral" | "trend-up" | "trends" | "triangle-black" | "triangle" | "tripadvisor-circle-outline" | "tripadvisor-circle" | "tripadvisor" | "trophy-outline" | "tumblr" | "twitter-audience-network" | "twitter" | "underline" | "unfollow-outline" | "unfollow" | "unlink" | "unlock" | "upload" | "user-circle" | "users" | "verified" | "video-camera-story" | "video-camera" | "vip" | "weight" | "whatsapp" | "window-maximize" | "window-minimize" | "window-regular" | "window-restore" | "woocommerce" | "x" | "yelp-full-star" | "yelp-half-star" | "yelp" | "youtube" | "zendesk";

package/__flow__/EnumIllustrationNames.js

@@ -1,2 +1,2 @@
 // @flow
-export type EnumIllustrationNames = "abacus" | "analytics-offering" | "asset-cards" | "astronaut" | "binoculars" | "brand-keyword" | "browser-doc" | "business" | "calendar-event" | "calendar-reporting" | "cat-error" | "cat-no-access" | "cat" | "checkbox-alert" | "coffee-cup" | "competitors" | "compose-window" | "compose" | "computer-error" | "connect" | "contact" | "conversation" | "custom-branding" | "customer-service" | "dashboard" | "exclamation-mark" | "face-happy" | "find-bookmark" | "flask" | "general-topic" | "global-features" | "global-trend" | "grow-large" | "grow" | "hands-raised" | "headset" | "heartbeat-connection" | "instagram-links" | "invoice" | "jewel" | "keyword-tracking" | "lightbulb-alt" | "lightbulb" | "like-conversation" | "link-broken" | "link-messages" | "link-sections" | "link-upload" | "listening-pendo" | "listening-sentiment" | "listening-topic-templates" | "listening-tour" | "listening" | "loading" | "mailbox-empty" | "mailbox-full" | "megaphone" | "message" | "molecule" | "network-data" | "no-messages-found" | "no-notifications" | "note" | "notification" | "notifications-onboarding" | "notifications" | "organize-message" | "outbox-queue" | "outbox-reviews" | "pdf" | "planning" | "podium" | "pointer" | "publish-assets" | "publish-links" | "publishing-notifications" | "publishing" | "puzzle-piece" | "question-mark" | "reporting-folder" | "reporting" | "review-location" | "review" | "robot-assembly" | "robot-error" | "robot-happy" | "rocket" | "schedule-date" | "schedule-messages" | "search-keywords" | "search-success" | "search-trends" | "search" | "security" | "sentiment" | "shopping-bag" | "spark-line" | "stamp" | "storefront" | "success" | "tag-message" | "tag" | "team-roles" | "team" | "telescope" | "tha-mel" | "thumbs-up" | "toggle-switch" | "toolset-strength" | "tracking-time" | "twitter-messages" | "twitter-profiles" | "under-construction" | "unsubscribe" | "upward-trend" | "user-task" | "view-connections" | "vip-list" | "warning" | "wifi" | "workflow-steps";
+export type EnumIllustrationNames = "abacus" | "analytics-offering" | "asset-cards" | "astronaut" | "binoculars" | "brand-keyword" | "browser-doc" | "business" | "calendar-event" | "calendar-reporting" | "cat-error" | "cat-no-access" | "cat" | "checkbox-alert" | "coffee-cup" | "competitors" | "compose-window" | "compose" | "computer-error" | "connect" | "contact" | "conversation" | "custom-branding" | "customer-service" | "dashboard" | "exclamation-mark" | "face-happy" | "find-bookmark" | "flask" | "general-topic" | "global-features" | "global-trend" | "grow-large" | "grow" | "hands-raised" | "headset" | "heartbeat-connection" | "instagram-links" | "invoice" | "jewel" | "keyword-tracking" | "lightbulb-alt" | "lightbulb" | "like-conversation" | "link-broken" | "link-messages" | "link-sections" | "link-upload" | "listening-pendo" | "listening-sentiment" | "listening-topic-templates" | "listening-tour" | "listening" | "loading" | "mailbox-empty" | "mailbox-full" | "megaphone" | "message" | "molecule" | "network-data" | "no-messages-found" | "no-notifications" | "note" | "notification" | "notifications-onboarding" | "notifications" | "organize-message" | "outbox-queue" | "outbox-reviews" | "pdf" | "planning" | "podium" | "pointer" | "publish-assets" | "publish-links" | "publishing-notifications" | "publishing" | "puzzle-piece" | "question-mark" | "reporting-folder" | "reporting" | "review-location" | "review" | "robot-assembly" | "robot-error" | "robot-happy" | "rocket" | "schedule-date" | "schedule-messages" | "search-keywords" | "search-success" | "search-trends" | "search" | "security" | "sentiment" | "shopping-bag" | "spark-line" | "stamp" | "storefront" | "success" | "tag-message" | "tag" | "team-roles" | "team" | "telescope" | "tha-mel" | "thumbs-up" | "toggle-switch" | "toolset-strength" | "tracking-time" | "twitter-messages" | "twitter-profiles" | "under-construction" | "unsubscribe" | "upward-trend" | "user-task" | "user-team" | "variable-table" | "view-connections" | "vip-list" | "warning" | "wifi" | "workflow-steps";

package/__flow__/IconViewBoxes.js

@@ -287,6 +287,7 @@ module.exports = {
   "reports-home": "0 0 16 16",
   "reports": "0 0 16 15",
   "retweet": "0 0 18 16",
+  "route": "0 0 18 18",
   "rss": "0 0 16 16",
   "sales": "0 0 9 16",
   "salesforce-cloud": "0 0 20 16",

package/__flow__/IllustrationViewBoxes.js

@@ -115,6 +115,8 @@ module.exports = {
   "unsubscribe": "0 0 212 163",
   "upward-trend": "0 0 65 49",
   "user-task": "0 0 313 176",
+  "user-team": "0 0 237 215",
+  "variable-table": "0 0 360 195",
   "view-connections": "0 0 356 201",
   "vip-list": "0 0 212 228",
   "warning": "0 0 55 38",

package/__flow__/SpotIllustration/illustrationNames.js

@@ -1,2 +1,2 @@
 // @flow
-export const illustrationNames = Object.freeze(['abacus', 'analytics-offering', 'asset-cards', 'astronaut', 'binoculars', 'brand-keyword', 'browser-doc', 'business', 'calendar-event', 'calendar-reporting', 'cat-error', 'cat-no-access', 'cat', 'checkbox-alert', 'coffee-cup', 'competitors', 'compose-window', 'compose', 'computer-error', 'connect', 'contact', 'conversation', 'custom-branding', 'customer-service', 'dashboard', 'exclamation-mark', 'face-happy', 'find-bookmark', 'flask', 'general-topic', 'global-features', 'global-trend', 'grow-large', 'grow', 'hands-raised', 'headset', 'heartbeat-connection', 'instagram-links', 'invoice', 'jewel', 'keyword-tracking', 'lightbulb-alt', 'lightbulb', 'like-conversation', 'link-broken', 'link-messages', 'link-sections', 'link-upload', 'listening-pendo', 'listening-sentiment', 'listening-topic-templates', 'listening-tour', 'listening', 'loading', 'mailbox-empty', 'mailbox-full', 'megaphone', 'message', 'molecule', 'network-data', 'no-messages-found', 'no-notifications', 'note', 'notification', 'notifications-onboarding', 'notifications', 'organize-message', 'outbox-queue', 'outbox-reviews', 'pdf', 'planning', 'podium', 'pointer', 'publish-assets', 'publish-links', 'publishing-notifications', 'publishing', 'puzzle-piece', 'question-mark', 'reporting-folder', 'reporting', 'review-location', 'review', 'robot-assembly', 'robot-error', 'robot-happy', 'rocket', 'schedule-date', 'schedule-messages', 'search-keywords', 'search-success', 'search-trends', 'search', 'security', 'sentiment', 'shopping-bag', 'spark-line', 'stamp', 'storefront', 'success', 'tag-message', 'tag', 'team-roles', 'team', 'telescope', 'tha-mel', 'thumbs-up', 'toggle-switch', 'toolset-strength', 'tracking-time', 'twitter-messages', 'twitter-profiles', 'under-construction', 'unsubscribe', 'upward-trend', 'user-task', 'view-connections', 'vip-list', 'warning', 'wifi', 'workflow-steps']);
+export const illustrationNames = Object.freeze(['abacus', 'analytics-offering', 'asset-cards', 'astronaut', 'binoculars', 'brand-keyword', 'browser-doc', 'business', 'calendar-event', 'calendar-reporting', 'cat-error', 'cat-no-access', 'cat', 'checkbox-alert', 'coffee-cup', 'competitors', 'compose-window', 'compose', 'computer-error', 'connect', 'contact', 'conversation', 'custom-branding', 'customer-service', 'dashboard', 'exclamation-mark', 'face-happy', 'find-bookmark', 'flask', 'general-topic', 'global-features', 'global-trend', 'grow-large', 'grow', 'hands-raised', 'headset', 'heartbeat-connection', 'instagram-links', 'invoice', 'jewel', 'keyword-tracking', 'lightbulb-alt', 'lightbulb', 'like-conversation', 'link-broken', 'link-messages', 'link-sections', 'link-upload', 'listening-pendo', 'listening-sentiment', 'listening-topic-templates', 'listening-tour', 'listening', 'loading', 'mailbox-empty', 'mailbox-full', 'megaphone', 'message', 'molecule', 'network-data', 'no-messages-found', 'no-notifications', 'note', 'notification', 'notifications-onboarding', 'notifications', 'organize-message', 'outbox-queue', 'outbox-reviews', 'pdf', 'planning', 'podium', 'pointer', 'publish-assets', 'publish-links', 'publishing-notifications', 'publishing', 'puzzle-piece', 'question-mark', 'reporting-folder', 'reporting', 'review-location', 'review', 'robot-assembly', 'robot-error', 'robot-happy', 'rocket', 'schedule-date', 'schedule-messages', 'search-keywords', 'search-success', 'search-trends', 'search', 'security', 'sentiment', 'shopping-bag', 'spark-line', 'stamp', 'storefront', 'success', 'tag-message', 'tag', 'team-roles', 'team', 'telescope', 'tha-mel', 'thumbs-up', 'toggle-switch', 'toolset-strength', 'tracking-time', 'twitter-messages', 'twitter-profiles', 'under-construction', 'unsubscribe', 'upward-trend', 'user-task', 'user-team', 'variable-table', 'view-connections', 'vip-list', 'warning', 'wifi', 'workflow-steps']);

package/__flow__/themes/light/theme.js

@@ -248,6 +248,8 @@ const colors = {
     glassdoor: NETWORKCOLORS.NETWORK_COLOR_GLASSDOOR,
     google_my_business: NETWORKCOLORS.NETWORK_COLOR_GOOGLE_MY_BUSINESS,
     google_business_messages: NETWORKCOLORS.NETWORK_COLOR_GOOGLE_BUSINESS_MESSAGES,
+    google_play_store: NETWORKCOLORS.NETWORK_COLOR_GOOGLE_PLAY_STORE,
+    apple_app_store: NETWORKCOLORS.NETWORK_COLOR_APPLE_APP_STORE,
     salesforce: NETWORKCOLORS.NETWORK_COLOR_SALESFORCE,
     zendesk: NETWORKCOLORS.NETWORK_COLOR_ZENDESK,
     hubspot: NETWORKCOLORS.NETWORK_COLOR_HUBSPOT,

package/bin/racine-codemod.js

@@ -6,6 +6,7 @@
 const childProcess = require('child_process');
 const fs = require('fs');
 const path = require('path');
+const docs = require('../codemods/codemod-docs');
 
 const currentDir = process.cwd();
 process.chdir(__dirname);
@@ -13,22 +14,46 @@ process.chdir(__dirname);
 const codemods = fs
   .readdirSync('../codemods')
   .filter((x) => x.slice(-3) === '.js')
-  .map((x) => x.slice(0, -3));
+  .map((x) => x.slice(0, -3))
+  .filter((x) => x !== 'codemod-docs');
 
 const transform = process.argv[2];
 const dest = process.argv[3];
-const usage = `npx racine-codemod <transform> <path/to/code>\n`;
+const usage = `racine-codemod <transformName> <path> <...otherArgs>\n`;
 if (!transform || codemods.indexOf(transform) === -1) {
   console.log(usage);
   console.error(
-    'missing/invalid transform name. Pick one of:\n' +
+    'Missing/invalid transform name. Pick one of:\n' +
       codemods.map((x) => '- ' + x).join('\n')
   );
   process.exit(1);
 }
+
+const formatCodemodDocs = (docs) => {
+  return `  Description: ${docs.description}
+  Usage: ${docs.example}
+  Arguments:
+${Object.entries(docs.arguments)
+  .map(([argumentName, argumentDocs]) => {
+    return `  --${argumentName}
+    Description: ${argumentDocs.description}
+    Default: ${argumentDocs.default}
+    ${
+      argumentDocs.options
+        ? `Options: ${argumentDocs.options}`
+        : `Example: ${argumentDocs.example}`
+    }`;
+  })
+  .join('\n')}`;
+};
+
+// If a path argument is not passed, log the available arguments and example usage for the codemod.
 if (!dest) {
-  console.log(usage);
-  console.error('missing path to code.');
+  console.log(
+    docs[transform]
+      ? formatCodemodDocs(docs[transform])
+      : 'Missing path argument'
+  );
   process.exit(1);
 }
 
@@ -39,6 +64,12 @@ const cmd = `npx jscodeshift -- --parser=flow -t ${path.join(
   ...process.argv,
 ]
   .slice(4)
+  // Remove any spaces from args. Otherwise, anything after the space will be treated as a path argument.
+  .map((arg) => arg.replace(/\s/g, ''))
   .join(' ')}`;
 console.log('running', cmd);
-childProcess.execSync(cmd);
+childProcess.execSync(cmd, {stdio: 'inherit'});
+
+console.log(
+  `Codemod complete! Please run prettier on "${dest}" to fix any formatting issues caused by the codemod.`
+);

package/codemods/__tests__/icon-library.test.js

@@ -0,0 +1,224 @@
+jest.autoMockOff();
+const defineInlineTest = require('jscodeshift/dist/testUtils').defineInlineTest;
+const transform = require('../icon-library');
+
+describe('icon-library codemod', () => {
+  function createTest(testName, input, output, options = {}) {
+    return defineInlineTest(
+      transform,
+      {parser: 'flow', ...options},
+      input,
+      output,
+      testName
+    );
+  }
+
+  createTest(
+    'No changes for already-migrated icons',
+    `<Icon name='dollar-outline' />`,
+    `<Icon name='dollar-outline' />`
+  );
+
+  createTest(
+    'Simple replacement',
+    `<Icon name='ads' />`,
+    `<Icon name='dollar-outline' />`
+  );
+
+  createTest(
+    'deprecatedIcons',
+    `<Icon name='backtotop' />`,
+    `<Icon name='arrow-up-outline' />`
+  );
+
+  createTest(
+    'Handle subcomponents',
+    `<Icon.Toggle activeName='like' inactiveName='like-outline'/>;`,
+    `<Icon.Toggle activeName='thumbs-up-solid' inactiveName='thumbs-up-outline'/>;`
+  );
+
+  createTest(
+    'ssiconsvg regex replacements',
+    `<use
+    xlink:href="#ssiconsvg-rejected"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+  />`,
+    `<use
+    xlink:href="#seeds-svgs_ban-outline"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+  />`
+  );
+
+  createTest(
+    'icon/iconName regex replacements',
+    `expect(queryByDataQaLabel({icon: 'dashboard'})).toBeFalsy();
+    const iconMap = {iconName: "like"};
+    const iconName = 'reply';`,
+    `expect(queryByDataQaLabel({icon: 'gauge-outline'})).toBeFalsy();
+    const iconMap = {iconName: "thumbs-up-solid"};
+    const iconName = 'reply-solid';`
+  );
+
+  createTest(
+    'Add comments',
+    `import { Badge, Icon } from '@sproutsocial/racine';
+
+<>
+  <Icon name='dashboard' />
+  <Icon name='not-a-real-name' />
+  <Badge iconName={iconName} />
+</>`,
+    `/*TODO (icon-library codemod): Please manually migrate icon names passed to 2 component(s) in this file.
+   Look for usages of these components: Icon, Badge*/
+import { Badge, Icon } from '@sproutsocial/racine';
+
+<>
+  <Icon name='gauge-outline' />
+  <Icon name='not-a-real-name' />
+  <Badge iconName={iconName} />
+</>`
+  );
+
+  // Test shim component adding behavior with a mix of cases.
+  // The valid name Icon is migrated.
+  // The invalid string name Icon prompts a comment. The shim would not help map an invalid string name.
+  // The variable name Icon is converted to IconShim and does not contribute to the count of issues in the comment.
+  createTest(
+    'Add shim component and add comments',
+    `import { Icon } from '@sproutsocial/racine';
+
+<>
+  <Icon name='dashboard' />
+  <Icon name='not-a-real-name' />
+  <Icon name={iconName} />
+</>`,
+    `/*TODO (icon-library codemod): Please manually migrate icon names passed to 1 component(s) in this file.
+   Look for usages of these components: Icon*/
+import { Icon } from '@sproutsocial/racine';
+
+import { IconShim } from 'script/core/react/IconShim';
+
+<>
+  <Icon name='gauge-outline' />
+  <Icon name='not-a-real-name' />
+  <IconShim name={iconName} />
+</>`,
+    {
+      shimName: 'IconShim',
+      shimImportPath: 'script/core/react/IconShim',
+    }
+  );
+
+  createTest(
+    'Add shim, remove Icon import',
+    `import { Icon } from '@sproutsocial/racine';
+
+<Icon name={iconName} />`,
+    `import { IconShim } from 'script/core/react/IconShim';
+
+<IconShim name={iconName} />
+`,
+    {
+      shimName: 'IconShim',
+      shimImportPath: 'script/core/react/IconShim',
+    }
+  );
+
+  createTest(
+    'Add shim, keep Icon import due to styled usage',
+    `import { Icon } from '@sproutsocial/racine';
+const StyledIcon = styled(Icon);
+<Icon name={iconName} />`,
+    `import { Icon } from '@sproutsocial/racine';
+import { IconShim } from 'script/core/react/IconShim';
+const StyledIcon = styled(Icon);
+<IconShim name={iconName} />
+`,
+    {
+      shimName: 'IconShim',
+      shimImportPath: 'script/core/react/IconShim',
+    }
+  );
+
+  createTest(
+    'Add shim, keep Icon import due to typeof Icon usage',
+    `import { Icon } from '@sproutsocial/racine';
+const iconType = typeof Icon;
+<Icon name={iconName} />;`,
+    `import { Icon } from '@sproutsocial/racine';
+import { IconShim } from 'script/core/react/IconShim';
+const iconType = typeof Icon;
+<IconShim name={iconName} />;
+`,
+    {
+      shimName: 'IconShim',
+      shimImportPath: 'script/core/react/IconShim',
+    }
+  );
+
+  createTest(
+    'Retain first comments when Icon import is removed',
+    `// @flow
+import { Icon } from '@sproutsocial/racine';
+
+<Icon name={iconName} />`,
+    `// @flow
+import { IconShim } from 'script/core/react/IconShim';
+
+<IconShim name={iconName} />
+`,
+    {
+      shimName: 'IconShim',
+      shimImportPath: 'script/core/react/IconShim',
+    }
+  );
+
+  createTest(
+    'Retain first comments and add new comments',
+    `// @flow
+import { Badge, Icon } from '@sproutsocial/racine';
+
+<>
+  <Icon name='dashboard' />
+  <Icon name='not-a-real-name' />
+  <Badge iconName={iconName} />
+</>`,
+    `// @flow
+/*TODO (icon-library codemod): Please manually migrate icon names passed to 2 component(s) in this file.
+   Look for usages of these components: Icon, Badge*/
+import { Badge, Icon } from '@sproutsocial/racine';
+
+<>
+  <Icon name='gauge-outline' />
+  <Icon name='not-a-real-name' />
+  <Badge iconName={iconName} />
+</>`
+  );
+
+  createTest(
+    'Test "components" option',
+    `
+<>
+  <Icon name='dashboard' />
+  <Message.Header iconName='reply' />
+  <SearchInput iconLeft='search' iconRight='x' />
+</>`,
+    `
+<>
+  <Icon name='gauge-outline' />
+  <Message.Header iconName='reply-solid' />
+  <SearchInput iconLeft='magnifying-glass-outline' iconRight='x-outline' />
+</>`,
+    {
+      // This tests if the following argument was passed to `racine-codemod`:
+      // --components="{'Message.Header':['iconName'],SearchInput:['iconLeft','iconRight']}"
+      // Unfortunately, because it's getting passed directly to the transform in this case,
+      // We need to simulate the way that it gets mangled when passed through the console.
+      components: [
+        'Message.Header:[iconName]',
+        'SearchInput:[iconLeft',
+        'iconRight]',
+      ],
+    }
+  );
+});

package/codemods/__tests__/icon-name-substitution.test.js

@@ -0,0 +1,39 @@
+jest.autoMockOff();
+const defineInlineTest = require('jscodeshift/dist/testUtils').defineInlineTest;
+const transform = require('../icon-name-substitution');
+
+describe('icon-name-substitution codemod', () => {
+  function createTest(testName, input, output, options = {}) {
+    return defineInlineTest(
+      transform,
+      {parser: 'flow', ...options},
+      input,
+      output,
+      testName
+    );
+  }
+
+  createTest(
+    'No changes for already-migrated icon names. Empty output due to returning null.',
+    `const IconMap = {ads: 'dollar-outline', draft: 'paper-solid'};`,
+    ''
+  );
+
+  createTest(
+    'Simple replacements',
+    `const IconMap = {ads: 'ads', draft: 'drafts'}`,
+    `const IconMap = {ads: 'dollar-outline', draft: 'paper-solid'}`
+  );
+
+  createTest(
+    'Example of an expected but unwanted change: the "ads" key and value are both mapped.',
+    `const IconMap = {'ads': 'ads', 'draft': 'drafts'}`,
+    `const IconMap = {'dollar-outline': 'dollar-outline', 'draft': 'paper-solid'}`
+  );
+
+  createTest(
+    'deprecatedIcons',
+    `const name = 'backtotop';`,
+    `const name = 'arrow-up-outline';`
+  );
+});

package/codemods/codemod-docs.js

@@ -0,0 +1,54 @@
+// Ideally, docs would be colocated with the codemod they are for, but I don't know how to make that work because
+// the transform needs to be the only export from the codemod file in order for jscodeshift to know how to find it.
+
+// Reused arguments
+const quote = {
+  default: 'single',
+  options: 'single|double',
+  description:
+    'What kind of quotation marks should be preferred when converting updated files back to JS?',
+};
+
+module.exports = {
+  'icon-library': {
+    description:
+      'Assists in migrating Icon names and usages. Due to abstraction such as using variables and mappings to define icon names, the codemod cannot automatically migrate every icon name. To help you identify these cases, the codemod can add comments or shim component usages.',
+    example:
+      "racine-codemod icon-library src --components=\"{IconButton:['name'],MessageMeta:['iconNameLeft','iconNameRight']}\" --shimComponent=IconShim --shimImportPath=src/components/IconShim --quote=double --addComments=false",
+    arguments: {
+      quote,
+      addComments: {
+        default: 'true',
+        options: 'true|false',
+        description:
+          'Should code comments be added when the codemod identifies a case that cannot be automatically migrated? Comments will include "icon-library" to help you locate and remediate them.',
+      },
+      components: {
+        default: '"{}"',
+        example:
+          "\"{IconButton:['name'],MessageMeta:['iconNameLeft','iconNameRight']}\"",
+        description:
+          'What additional component names + prop name combinations would you like the codemod to target for the migration? Wrap this argument in quotes.',
+      },
+      shimName: {
+        default: '""',
+        example: 'IconShim',
+        description:
+          "If you provide a shim component name, any Icon that has a variable for its `name` prop will be renamed to the shim component's name. You must create this component in your own codebase, it is not provided.",
+      },
+      shimImportPath: {
+        default: '""',
+        example: 'src/components/IconShim',
+        description:
+          'shimImportPath is the import path for your shim component (see "shimName") so that imports can be automatically when usages are added.',
+      },
+    },
+  },
+  'icon-name-substitution': {
+    description:
+      'Replaces string literals that are deprecated icon names with their updated names. Please note that this codemod will change any strings that happen to match a deprecated icon name, even if they are unrelated to icons, so we recommend running it against specific files (not your entire codebase) and carefully checking the results.',
+    example:
+      'racine-codemod icon-name-substitution src/constants.js --quote=double',
+    arguments: {quote},
+  },
+};