@pantheon-systems/pds-toolkit-react 1.0.0-dev.18 → 1.0.0-dev.181

package/README.md

@@ -1,7 +1,37 @@
 # pds-toolkit-react
 
-React Toolkit for the Pantheon Design System
+## React Toolkit for the Pantheon Design System
 
 This toolkit provides assets for use within a React project and a Storybook instance to preview the components.
 
 [Published Storybook](https://live-pds-toolkit-react.appa.pantheon.site/)
+
+## Toolkit philosophy and scope
+
+The intent of this toolkit is to provide a React-based implementation of the Pantheon Design System (PDS) with a focus on semantics, accessibility, visual design, and user-interface design.
+
+This toolkit should not contain processes or mechanisms used for data manipulation, business logic, or similar. Therefore, processes such as form handling, routing, and language translation should be handled within the application that is consuming the toolkit.
+
+Each component will contain a documentation page within Storybook that provides usage notes, implementation instructions, and expected data structure for that particular component.
+
+### Content within components
+
+Content should not live within components with a few exceptions — the Social Links component and the links in the legal section of the SiteFooter component. To maintain consistency between all of our digital properties, these links will originate from the design system.
+
+## Implementation instructions
+
+The toolkit consists of a global stylesheet and React components. Both are required for the toolkit to function as intended.
+
+The global stylesheet — `pds-core.css` — provides the base styles for the toolkit including foundations, utilities, and color variables. This stylesheet should be applied at the root of the application.
+
+The React components are imported and used within the application as needed. Component-specific styles are imported and applied automatically when the component is used.
+
+Components should be imported using named imports. For example:
+
+```js
+import { Container, SidebarLayout } from '@pantheon-systems/pds-toolkit-react';
+```
+
+### Avoid style conflicts
+
+This toolkit is not intended to be used in conjunction with other CSS frameworks. Doing so may result in unexpected behavior and/or visual conflicts.

package/_dist/components/Avatar/Avatar.d.ts

@@ -0,0 +1,29 @@
+import React, { ComponentPropsWithoutRef, ReactNode } from 'react';
+import './avatar.css';
+interface AvatarProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * Avatar size.
+     */
+    size?: 'xs' | 'sm' | 'md' | 'lg';
+    /**
+     * Avatar image.
+     */
+    imageSrc?: string;
+    /**
+     * A link element using the router of your choice. Leave empty for no link.
+     */
+    linkContent?: ReactNode;
+    /**
+     * Unique ID associated with the avatar. Can be workspace ID, user ID, email, etc.
+     */
+    uniqueId?: string;
+    /**
+     * Additional class names
+     */
+    className?: string;
+}
+/**
+ * Avatar UI component
+ */
+export declare const Avatar: ({ size, imageSrc, linkContent, uniqueId, className, ...props }: AvatarProps) => React.JSX.Element;
+export {};

package/_dist/components/Breadcrumbs/Breadcrumbs.d.ts

@@ -0,0 +1,9 @@
+export function Breadcrumbs({ ariaLabel, crumbs, ...props }: import("./BreadcrumbsContext").Crumb): React.JSX.Element;
+export namespace Breadcrumbs {
+    namespace propTypes {
+        let ariaLabel: PropTypes.Validator<string>;
+        let crumbs: PropTypes.Requireable<any[]>;
+    }
+}
+import React from 'react';
+import PropTypes from 'prop-types';

package/_dist/components/Breadcrumbs/BreadcrumbsContent.d.ts

@@ -0,0 +1,12 @@
+export function BreadcrumbsContent({ ariaLabel, ...rest }: {
+    [x: string]: any;
+    ariaLabel: any;
+}): React.JSX.Element;
+export namespace BreadcrumbsContent {
+    namespace propTypes {
+        let ariaLabel: PropTypes.Validator<string>;
+        let crumbs: PropTypes.Requireable<any[]>;
+    }
+}
+import React from 'react';
+import PropTypes from 'prop-types';

package/_dist/components/Breadcrumbs/BreadcrumbsContext.d.ts

@@ -0,0 +1,17 @@
+export default BreadcrumbsContext;
+export type Crumb = {
+    uri: string;
+    label: string;
+};
+export type BreadcrumbsContextType = {
+    crumbs: Crumb[];
+    deferredCrumbIds: string[];
+    register: (...args, []) => void;
+    unregister: (...args, []) => void;
+    deferCrumb: (...args, []) => void;
+    resolveCrumb: (...args, []) => void;
+};
+/**
+ * @type {React.Context<BreadcrumbsContextType>} BreadcrumbsContext
+ */
+declare const BreadcrumbsContext: React.Context<BreadcrumbsContextType>;

package/_dist/components/Breadcrumbs/ListItem.d.ts

@@ -0,0 +1,14 @@
+export function ListItem({ crumb, lastCrumb, classes }: {
+    crumb: any;
+    lastCrumb: any;
+    classes: any;
+}): React.JSX.Element;
+export namespace ListItem {
+    namespace propTypes {
+        let crumb: PropTypes.Requireable<object>;
+        let lastCrumb: PropTypes.Requireable<boolean>;
+        let classes: PropTypes.Requireable<string>;
+    }
+}
+import React from 'react';
+import PropTypes from 'prop-types';

package/_dist/components/Breadcrumbs/MobileCrumbs.d.ts

@@ -0,0 +1,2 @@
+export function MobileCrumbs(lastCrumb: any): React.JSX.Element;
+import React from 'react';

package/_dist/components/CTALink/CTALink.d.ts

@@ -0,0 +1,20 @@
+import React, { ComponentPropsWithoutRef, ReactNode } from 'react';
+import './cta-link.css';
+export interface CTALinkProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * A link element using the router of your choice.
+     */
+    linkContent?: ReactNode;
+    /**
+     * Size of link
+     */
+    size?: 'sm' | 'md';
+    /**
+     * Additional class names
+     */
+    className?: string;
+}
+/**
+ * CTA Link UI component
+ */
+export declare const CTALink: ({ linkContent, size, className, ...props }: CTALinkProps) => React.JSX.Element;

package/_dist/components/CTASlice/CTASlice.d.ts

@@ -0,0 +1,34 @@
+export function CTASlice({ backgroundColor, containerWidth, headingLevel, headingText, leadText, primaryLink, secondaryLink, className, ...props }: {
+    [x: string]: any;
+    backgroundColor?: string;
+    containerWidth?: string;
+    headingLevel?: string;
+    headingText: any;
+    leadText: any;
+    primaryLink: any;
+    secondaryLink: any;
+    className: any;
+}): React.JSX.Element;
+export namespace CTASlice {
+    namespace propTypes {
+        export let backgroundColor: PropTypes.Requireable<string>;
+        export { ContainerWidth as containerWidth };
+        export let headingLevel: PropTypes.Requireable<string>;
+        export let headingText: PropTypes.Validator<string>;
+        export let leadText: PropTypes.Requireable<string>;
+        export let primaryLink: PropTypes.Validator<NonNullable<PropTypes.InferProps<{
+            text: PropTypes.Requireable<string>;
+            url: PropTypes.Requireable<string>;
+            target: PropTypes.Requireable<string>;
+        }>>>;
+        export let secondaryLink: PropTypes.Requireable<PropTypes.InferProps<{
+            text: PropTypes.Requireable<string>;
+            url: PropTypes.Requireable<string>;
+            target: PropTypes.Requireable<string>;
+        }>>;
+        export let className: PropTypes.Requireable<string>;
+    }
+}
+import React from 'react';
+import PropTypes from 'prop-types';
+import { ContainerWidth } from '@libs/components/customPropTypes';

package/_dist/components/Callout/Callout.d.ts

@@ -0,0 +1,24 @@
+import React, { ComponentPropsWithoutRef } from 'react';
+import './callout.css';
+export interface CalloutProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * Callout main content.
+     */
+    children: React.ReactNode;
+    /**
+     * Callout title.
+     */
+    title: string;
+    /**
+     * Callout type.
+     */
+    type?: 'info' | 'success' | 'warning' | 'critical' | 'discovery' | 'code' | 'earlyAccess';
+    /**
+     * Additional class names
+     */
+    className?: string;
+}
+/**
+ * Callout UI component
+ */
+export declare const Callout: ({ children, title, type, className, ...props }: CalloutProps) => React.JSX.Element;

package/_dist/components/Callout/sample-callout-content.d.ts

@@ -0,0 +1,2 @@
+import React from 'react';
+export declare const infoCalloutSample: React.JSX.Element;

package/_dist/components/ComparisonList/ComparisonList.d.ts

@@ -0,0 +1,42 @@
+import React, { ComponentPropsWithoutRef, ReactNode } from 'react';
+import './comparison-list.css';
+interface TypeLabels {
+    included: string;
+    notIncluded: string;
+    addon: string;
+}
+interface ListItems {
+    text: string;
+    type: 'included' | 'notIncluded' | 'addon';
+}
+export interface ComparisonListProps extends ComponentPropsWithoutRef<'div'> {
+    /**
+     * Icon labels
+     */
+    typeLabels?: TypeLabels;
+    /**
+     * List items
+     */
+    listItems?: ListItems[];
+    /**
+     * Text preceding the list. Optional.
+     */
+    listLabel: string;
+    /**
+     * A link element using the router of your choice. Will be displayed below the list. Optional.
+     */
+    moreLink: ReactNode;
+    /**
+     * Render the icon labels for screen readers.
+     */
+    renderTypeLabels: boolean;
+    /**
+     * Additional class names
+     */
+    className?: string;
+}
+/**
+ * ComparisonList UI component
+ */
+export declare const ComparisonList: ({ listItems, listLabel, moreLink, renderTypeLabels, typeLabels, className, ...props }: ComparisonListProps) => React.JSX.Element;
+export {};

package/_dist/components/Heading/Heading.d.ts

@@ -0,0 +1,15 @@
+export function Heading({ children, level, className, ...props }: {
+    [x: string]: any;
+    children: any;
+    level: any;
+    className: any;
+}): React.JSX.Element;
+export namespace Heading {
+    namespace propTypes {
+        let children: PropTypes.Validator<NonNullable<PropTypes.ReactNodeLike>>;
+        let level: PropTypes.Validator<string>;
+        let className: PropTypes.Requireable<string>;
+    }
+}
+import React from 'react';
+import PropTypes from 'prop-types';