@atlaskit/help 7.2.0 → 7.2.1

package/dist/types-ts4.0/i18n/languages.d.ts

@@ -0,0 +1,27 @@
+declare const _default: {
+    zh: string;
+    cs: string;
+    da: string;
+    nl: string;
+    en: string;
+    en_GB: string;
+    et: string;
+    fi: string;
+    fr: string;
+    de: string;
+    hu: string;
+    is: string;
+    it: string;
+    ja: string;
+    ko: string;
+    nb: string;
+    pl: string;
+    pt_BR: string;
+    pt_PT: string;
+    ro: string;
+    ru: string;
+    sk: string;
+    es: string;
+    sv: string;
+};
+export default _default;

package/dist/types-ts4.0/i18n/nb.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/nl.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/pl.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/pt_BR.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/pt_PT.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/ro.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/ru.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/sk.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/sv.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/i18n/zh.d.ts

@@ -0,0 +1,2 @@
+declare const _default: {};
+export default _default;

package/dist/types-ts4.0/index.d.ts

@@ -0,0 +1,11 @@
+export { default } from './components/Help';
+export { default as ArticlesListItem } from './components/ArticlesList/ArticlesListItem';
+export { default as RelatedArticles } from './components/RelatedArticles';
+export { default as HelpContentButton } from './components/HelpContentButton';
+export { DividerLine } from './util/styled';
+export { ARTICLE_TYPE } from './model/Help';
+export { ARTICLE_ITEM_TYPES } from './model/Article';
+export type { Help, HistoryItem, articleId } from './model/Help';
+export type { Article, ArticleItem, ArticleFeedback } from './model/Article';
+export { WHATS_NEW_ITEM_TYPES } from './model/WhatsNew';
+export type { WhatsNewArticle, WhatsNewArticleItem } from './model/WhatsNew';

package/dist/types-ts4.0/messages.d.ts

@@ -0,0 +1,262 @@
+export declare const messages: {
+    help_loading: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_header: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_header_whats_new: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_close: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_navigation_back: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_placeholder: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_title: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_option_yes: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_option_no: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_title: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_accurate: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_clear: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_relevant: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_submit: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_Success: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_failed: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_failed_try_again: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_cancel: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_rating_form_contact_me: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_list_item_type_whats_new: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_list_item_type_help_article: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_related_article_title: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_related_article_endpoint_error_title: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_related_article_endpoint_error_description: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_related_article_endpoint_error_button_label: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_results_search_external_site: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_results_no_results: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_results_no_results_line_two: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_results_external_site_link: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_error_title: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_error_text: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_article_error_button_label: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_error: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_error_line_two: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_search_error_button_label: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_button_label: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_button_label_without_product_name: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_button_tooltip: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_all: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_new: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_improvement: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_fix: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_removed: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_filter_select_option_experiment: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_no_results: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_no_results_info: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_no_results_clear_filter_button_label: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_no_results_clear_filter_info: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_related_link_support: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_whats_new_related_link_community: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_show_more_button_label_more: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+    help_show_more_button_label_less: {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+};

package/dist/types-ts4.0/model/Article.d.ts

@@ -0,0 +1,30 @@
+import { BODY_FORMAT_TYPES } from '@atlaskit/help-article';
+import type { AdfDoc } from '@atlaskit/help-article';
+export interface Article extends ArticleItem {
+    body: string | AdfDoc;
+    bodyFormat?: BODY_FORMAT_TYPES;
+    relatedArticles?: ArticleItem[];
+}
+export declare enum ARTICLE_ITEM_TYPES {
+    topicInProduct = "topicInProduct"
+}
+export interface ArticleItem {
+    description?: string;
+    id: string;
+    lastPublished: string;
+    title: string;
+    type: ARTICLE_ITEM_TYPES;
+    routes?: {
+        routeName: string;
+        routeGroup: string;
+    }[];
+    topicId?: string;
+    productName?: string;
+    href?: string;
+}
+export interface ArticleFeedback {
+    wasHelpful: boolean;
+    feedbackReason: string;
+    feedbackReasonText: string;
+    contactMe: boolean;
+}

package/dist/types-ts4.0/model/Help.d.ts

@@ -0,0 +1,74 @@
+/// <reference types="react" />
+import { Article, ArticleItem, ArticleFeedback } from './Article';
+import { WhatsNewArticleItem, WhatsNewArticle, WHATS_NEW_ITEM_TYPES, whatsNewSearchResult } from './WhatsNew';
+import { REQUEST_STATE } from './Requests';
+import { UIAnalyticsEvent } from '@atlaskit/analytics-next';
+import { NotificationLogProvider } from '@atlaskit/notification-log-client';
+import type { Props as HelpContentButtonProps } from '../components/HelpContentButton';
+export declare enum ARTICLE_TYPE {
+    HELP_ARTICLE = "HELP_ARTICLE",
+    WHATS_NEW = "WHATS_NEW"
+}
+export interface HistoryItem {
+    uid: number;
+    id: string;
+    state: REQUEST_STATE;
+    type: ARTICLE_TYPE;
+    article?: Article | WhatsNewArticle;
+}
+export interface articleId {
+    id: string;
+    type: ARTICLE_TYPE;
+}
+export interface Help {
+    header?: {
+        onCloseButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent): void;
+        onBackButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent): void;
+    };
+    footer?: React.ReactNode;
+    home?: {
+        homeOptions?: HelpContentButtonProps[];
+    };
+    search?: {
+        onSearch?(value: string): Promise<ArticleItem[]>;
+        onSearchInputChanged?(event: React.KeyboardEvent<HTMLInputElement>, analyticsEvent: UIAnalyticsEvent, value: string): void;
+        onSearchInputCleared?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent): void;
+        onSearchResultItemClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, articleData: ArticleItem): void;
+        onSearchExternalUrlClick?(event?: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent?: UIAnalyticsEvent): void;
+        searchExternalUrl?: string;
+    };
+    navigation?: {
+        navigationData?: {
+            articleId: articleId;
+            history: HistoryItem[];
+        };
+        setNavigationData?(navigationData: {
+            articleId?: articleId;
+            history?: HistoryItem[];
+        }): void;
+    };
+    helpArticle?: {
+        onGetHelpArticle?(articleId: articleId): Promise<Article>;
+        onHelpArticleLoadingFailTryAgainButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, articleId: articleId): void;
+        onWasHelpfulSubmit?(analyticsEvent: UIAnalyticsEvent, articleFeedback: ArticleFeedback, articleData: ArticleItem): Promise<boolean>;
+        onWasHelpfulYesButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, ArticleItem: ArticleItem): void;
+        onWasHelpfulNoButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, ArticleItem: ArticleItem): void;
+    };
+    relatedArticles?: {
+        routeGroup?: string;
+        routeName?: string;
+        onGetRelatedArticles?(routeGroup?: string, routeName?: string): Promise<ArticleItem[]>;
+        onRelatedArticlesShowMoreClick?(event: React.MouseEvent<HTMLElement>, analyticsEvent: UIAnalyticsEvent, isCollapsed: boolean): void;
+        onRelatedArticlesListItemClick?: (event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, articleData: ArticleItem) => void;
+    };
+    whatsNew?: {
+        whatsNewGetNotificationProvider?: Promise<NotificationLogProvider>;
+        productName?: string;
+        onWhatsNewButtonClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent): void;
+        onSearchWhatsNewArticles?(filter?: WHATS_NEW_ITEM_TYPES | '', numberOfItems?: number, page?: string): Promise<whatsNewSearchResult>;
+        onWhatsNewResultItemClick?(event: React.MouseEvent<HTMLElement, MouseEvent>, analyticsEvent: UIAnalyticsEvent, whatsNewArticleData: WhatsNewArticleItem): void;
+        onSearchWhatsNewShowMoreClick?(event: React.MouseEvent<HTMLElement>, analyticsEvent: UIAnalyticsEvent): void;
+        onGetWhatsNewArticle?(id: articleId): Promise<WhatsNewArticle>;
+    };
+    children?: React.ReactNode;
+}

package/dist/types-ts4.0/model/Requests.d.ts

@@ -0,0 +1,7 @@
+export declare enum REQUEST_STATE {
+    done = "done",
+    loading = "loading",
+    load = "load",
+    error = "error",
+    reload = "reload"
+}

package/dist/types-ts4.0/model/WhatsNew.d.ts

@@ -0,0 +1,29 @@
+import { BODY_FORMAT_TYPES } from '@atlaskit/help-article';
+import type { AdfDoc } from '@atlaskit/help-article';
+export declare enum WHATS_NEW_ITEM_TYPES {
+    NEW_FEATURE = "Announcement",
+    IMPROVEMENT = "Improvement",
+    FIX = "Fix",
+    REMOVED = "Removed",
+    EXPERIMENT = "Experiment"
+}
+export interface WhatsNewArticle extends WhatsNewArticleItem {
+    description: string | AdfDoc;
+    bodyFormat?: BODY_FORMAT_TYPES;
+}
+export interface WhatsNewArticleItem {
+    title?: string;
+    changeTargetSchedule?: string;
+    type?: WHATS_NEW_ITEM_TYPES;
+    status?: string;
+    featureRolloutDate?: string;
+    relatedExternalLinks?: string;
+    communityUrl?: string;
+    href?: string;
+    id: string;
+}
+export interface whatsNewSearchResult {
+    articles: WhatsNewArticleItem[];
+    nextPage: string;
+    hasNextPage: boolean;
+}

package/dist/types-ts4.0/util/hooks/cancellablePromise.d.ts

@@ -0,0 +1,7 @@
+export declare function makeCancelable(promise: Promise<any>): {
+    promise: Promise<unknown>;
+    cancel(): void;
+};
+export default function useCancellablePromise(cancelable?: typeof makeCancelable): {
+    cancellablePromise: (p: Promise<any>) => Promise<any>;
+};

package/dist/types-ts4.0/util/hooks/ctx.d.ts

@@ -0,0 +1,5 @@
+/// <reference types="react" />
+export declare function createCtx<ContextType>(): readonly [
+    () => ContextType,
+    import("react").Provider<ContextType | undefined>
+];

package/dist/types-ts4.0/util/hooks/previous.d.ts

@@ -0,0 +1 @@
+export declare function usePrevious(value: any): undefined;

package/dist/types-ts4.0/util/i18n-util.d.ts

@@ -0,0 +1,17 @@
+declare type LanguageCode = 'zh' | 'cs' | 'da' | 'nl' | 'en' | 'en_GB' | 'et' | 'fi' | 'fr' | 'de' | 'hu' | 'is' | 'it' | 'ja' | 'ko' | 'nb' | 'pl' | 'pt_BR' | 'pt_PT' | 'ro' | 'ru' | 'sk' | 'es' | 'sv';
+export declare type LangCode = LanguageCode | 'pt-BR' | 'pt-PT';
+declare type LocaleMessages = {
+    [key: string]: string;
+};
+/**
+ * Tries to get the most specific messages bundle for a given locale.
+ *
+ * Strategy:
+ * 1. Try to find messages with the exact string (i.e. 'fr_FR')
+ * 2. If that doesn't work, try to find messages for the country locale (i.e. 'fr')
+ * 3. If that doesn't work, return english messages as a fallback.
+ *
+ * @param locale string specifying the locale like 'en_GB', or 'fr'.
+ */
+export declare const getMessagesForLocale: (locale: LangCode) => LocaleMessages;
+export {};

package/dist/types-ts4.0/util/index.d.ts

@@ -0,0 +1,8 @@
+/// <reference types="react" />
+import { WHATS_NEW_ITEM_TYPES } from '../model/WhatsNew';
+export declare const getTypeIcon: (itemType?: WHATS_NEW_ITEM_TYPES | undefined) => "" | JSX.Element;
+export declare const getTypeTitle: (itemType: WHATS_NEW_ITEM_TYPES) => {
+    id: string;
+    defaultMessage: string;
+    description: string;
+};

package/dist/types-ts4.0/util/styled.d.ts

@@ -0,0 +1,29 @@
+/// <reference types="react" />
+/** @jsx jsx */
+import { WHATS_NEW_ITEM_TYPES } from '../model/WhatsNew';
+export declare const DividerLine: import("@emotion/styled-base").StyledComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, Pick<import("react").ClassAttributes<HTMLDivElement> & import("react").HTMLAttributes<HTMLDivElement>, keyof import("react").HTMLAttributes<HTMLDivElement>>, object>;
+/**
+ * Loading container
+ */
+declare type LoadingRectangleProps = {
+    contentWidth?: string;
+    contentHeight?: string;
+    marginTop?: string;
+};
+export declare const LoadingRectangle: import("@emotion/styled-base").StyledComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, LoadingRectangleProps, object>;
+/**
+ * Loading Circle
+ */
+declare type LoadingCircleProps = {
+    radius?: string;
+    marginTop?: string;
+};
+export declare const LoadingCircle: import("@emotion/styled-base").StyledComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, LoadingCircleProps, object>;
+/**
+ * What's new icon
+ */
+declare type WhatsNewTypeIconProps = {
+    type?: WHATS_NEW_ITEM_TYPES;
+};
+export declare const WhatsNewTypeIcon: import("@emotion/styled-base").StyledComponent<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, WhatsNewTypeIconProps, object>;
+export {};

package/dist/types-ts4.0/util/testing/mock.d.ts

@@ -0,0 +1,8 @@
+import { Article, ArticleItem } from '../../model/Article';
+import { WHATS_NEW_ITEM_TYPES, WhatsNewArticleItem } from '../../model/WhatsNew';
+export declare const getMockArticle: (id: string, routeName?: string, routeGroup?: string, productName?: string, href?: string) => Article;
+export declare const getMockArticleItem: (id: string, routeName?: string, routeGroup?: string, productName?: string, href?: string) => ArticleItem;
+export declare const getMockArticleItemList: (numberOfItems: number) => ArticleItem[];
+export declare const getMockWhatsNewArticle: (id: string, routeName?: string, routeGroup?: string, productName?: string, href?: string) => Article;
+export declare const getMockWhatsNewArticleItem: (id: string, type?: WHATS_NEW_ITEM_TYPES | undefined, title?: string, description?: string, changeTargetSchedule?: string, status?: string, featureRolloutDate?: string, href?: string) => WhatsNewArticleItem;
+export declare const getMockWhatsNewArticleItemList: (numberOfItems: number) => WhatsNewArticleItem[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/help",
-  "version": "7.2.0",
+  "version": "7.2.1",
   "description": "A cross-product help component",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -80,7 +80,8 @@
   "techstack": {
     "@repo/internal": {
       "design-tokens": [
-        "color"
+        "color",
+        "spacing"
       ]
     }
   }