@salesforcedevs/docs-components 0.3.12 → 0.3.14-banner-alpha1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (107) hide show
  1. package/lwc.config.json +12 -3
  2. package/package.json +17 -7
  3. package/src/modules/README.md +41 -0
  4. package/src/modules/doc/amfReference/amfReference.css +5 -0
  5. package/src/modules/doc/amfReference/amfReference.html +47 -0
  6. package/src/modules/doc/amfReference/amfReference.ts +1361 -0
  7. package/src/modules/doc/amfReference/constants.ts +76 -0
  8. package/src/modules/doc/amfReference/types.ts +133 -0
  9. package/src/modules/doc/amfReference/utils.ts +669 -0
  10. package/src/modules/doc/amfTopic/amfTopic.css +1 -0
  11. package/src/modules/doc/amfTopic/amfTopic.html +3 -0
  12. package/src/modules/doc/amfTopic/amfTopic.ts +94 -0
  13. package/src/modules/doc/amfTopic/types.ts +54 -0
  14. package/src/modules/doc/amfTopic/utils.ts +130 -0
  15. package/src/modules/doc/breadcrumbItem/breadcrumbItem.css +51 -0
  16. package/src/modules/doc/breadcrumbItem/breadcrumbItem.html +5 -0
  17. package/src/modules/doc/breadcrumbItem/breadcrumbItem.ts +64 -0
  18. package/src/modules/doc/breadcrumbs/breadcrumbs.css +27 -0
  19. package/src/modules/doc/breadcrumbs/breadcrumbs.html +60 -0
  20. package/src/modules/doc/breadcrumbs/breadcrumbs.ts +187 -0
  21. package/src/modules/doc/content/content.css +58 -103
  22. package/src/modules/doc/content/content.ts +261 -174
  23. package/src/modules/doc/contentCallout/contentCallout.css +7 -24
  24. package/src/modules/doc/contentCallout/contentCallout.html +4 -2
  25. package/src/modules/doc/contentCallout/contentCallout.ts +8 -2
  26. package/src/modules/doc/contentLayout/contentLayout.css +98 -0
  27. package/src/modules/doc/contentLayout/contentLayout.html +51 -0
  28. package/src/modules/doc/contentLayout/contentLayout.ts +322 -0
  29. package/src/modules/doc/header/header.css +103 -0
  30. package/src/modules/doc/header/header.html +160 -0
  31. package/src/modules/doc/header/header.ts +146 -0
  32. package/src/modules/doc/heading/heading.css +54 -0
  33. package/src/modules/doc/heading/heading.html +14 -0
  34. package/src/modules/doc/heading/heading.ts +65 -0
  35. package/src/modules/doc/headingAnchor/headingAnchor.css +33 -0
  36. package/src/modules/doc/headingAnchor/headingAnchor.html +19 -0
  37. package/src/modules/doc/headingAnchor/headingAnchor.ts +43 -0
  38. package/src/modules/doc/headingContent/headingContent.css +53 -0
  39. package/src/modules/doc/headingContent/headingContent.html +13 -0
  40. package/src/modules/doc/headingContent/headingContent.ts +30 -0
  41. package/src/modules/doc/phase/phase.css +55 -0
  42. package/src/modules/doc/phase/phase.html +28 -0
  43. package/src/modules/doc/phase/phase.ts +57 -0
  44. package/src/modules/doc/sprigSurvey/sprigSurvey.html +20 -0
  45. package/src/modules/doc/sprigSurvey/sprigSurvey.scoped.css +12 -0
  46. package/src/modules/doc/sprigSurvey/sprigSurvey.ts +16 -0
  47. package/src/modules/doc/toc/toc.html +3 -1
  48. package/src/modules/doc/toolbar/toolbar.ts +6 -6
  49. package/src/modules/doc/xmlContent/types.ts +114 -0
  50. package/src/modules/doc/xmlContent/utils.ts +161 -0
  51. package/src/modules/doc/xmlContent/xmlContent.css +32 -0
  52. package/src/modules/doc/xmlContent/xmlContent.html +40 -0
  53. package/src/modules/doc/xmlContent/xmlContent.ts +677 -0
  54. package/src/modules/docBaseElements/lightningElementWithState/lightningElementWithState.ts +93 -0
  55. package/src/modules/docHelpers/amfStyle/amfStyle.css +355 -0
  56. package/src/modules/docHelpers/phaseContentLayout/phaseContentLayout.css +39 -0
  57. package/src/modules/docHelpers/status/status.css +22 -0
  58. package/src/modules/docUtils/SearchSyncer/SearchSyncer.ts +85 -0
  59. package/LICENSE +0 -12
  60. package/src/modules/doc/container/__benchmarks__/container.benchmark.js +0 -43
  61. package/src/modules/doc/container/__mocks__/mockAvailableLanguages.js +0 -8
  62. package/src/modules/doc/container/__mocks__/mockAvailableVersions.js +0 -122
  63. package/src/modules/doc/container/__mocks__/mockContentFetchResponse.json +0 -5
  64. package/src/modules/doc/container/__mocks__/mockDocContent.js +0 -29
  65. package/src/modules/doc/container/__mocks__/mockNavigationFetchResponse.json +0 -4061
  66. package/src/modules/doc/container/__mocks__/mockPageReference.js +0 -8
  67. package/src/modules/doc/container/__mocks__/mockPdfUrl.js +0 -1
  68. package/src/modules/doc/container/__mocks__/mockSelectedLanguage.js +0 -8
  69. package/src/modules/doc/container/__mocks__/mockSelectedVersion.js +0 -8
  70. package/src/modules/doc/container/__mocks__/mockToc.js +0 -146
  71. package/src/modules/doc/container/__tests__/container.test.ts +0 -117
  72. package/src/modules/doc/container/container.css +0 -37
  73. package/src/modules/doc/container/container.html +0 -28
  74. package/src/modules/doc/container/container.stories.ts +0 -44
  75. package/src/modules/doc/container/container.ts +0 -367
  76. package/src/modules/doc/content/__tests__/content.test.ts +0 -99
  77. package/src/modules/doc/content/__tests__/mockDocContent.ts +0 -258
  78. package/src/modules/doc/content/__tests__/mockPageReference.ts +0 -8
  79. package/src/modules/doc/content/content.stories.ts +0 -82
  80. package/src/modules/doc/contentCallout/__tests__/contentCallout.test.ts +0 -80
  81. package/src/modules/doc/contentCallout/__tests__/mockProps.ts +0 -14
  82. package/src/modules/doc/contentCallout/contentCallout.stories.ts +0 -29
  83. package/src/modules/doc/contentMedia/__tests__/contentMedia.test.ts +0 -97
  84. package/src/modules/doc/contentMedia/contentMedia.stories.ts +0 -113
  85. package/src/modules/doc/landing/__tests__/landing.test.ts +0 -60
  86. package/src/modules/doc/landing/__tests__/mockFetch.json +0 -370
  87. package/src/modules/doc/landing/landing.css +0 -63
  88. package/src/modules/doc/landing/landing.html +0 -122
  89. package/src/modules/doc/landing/landing.stories.ts +0 -21
  90. package/src/modules/doc/landing/landing.ts +0 -222
  91. package/src/modules/doc/nav/__tests__/mockAvailableLanguages.ts +0 -8
  92. package/src/modules/doc/nav/__tests__/mockAvailableVersions.ts +0 -122
  93. package/src/modules/doc/nav/__tests__/mockPageReference.ts +0 -8
  94. package/src/modules/doc/nav/__tests__/mockPdfUrl.ts +0 -1
  95. package/src/modules/doc/nav/__tests__/mockSelectedLanguage.ts +0 -8
  96. package/src/modules/doc/nav/__tests__/mockSelectedVersion.ts +0 -8
  97. package/src/modules/doc/nav/__tests__/mockToc.ts +0 -146
  98. package/src/modules/doc/nav/__tests__/nav.test.ts +0 -58
  99. package/src/modules/doc/toc/__tests__/mockPageReference.ts +0 -8
  100. package/src/modules/doc/toc/__tests__/mockToc.ts +0 -146
  101. package/src/modules/doc/toc/__tests__/toc.test.ts +0 -29
  102. package/src/modules/doc/toolbar/__tests__/mockAvailableLanguages.ts +0 -8
  103. package/src/modules/doc/toolbar/__tests__/mockAvailableVersions.ts +0 -122
  104. package/src/modules/doc/toolbar/__tests__/mockPdfUrl.ts +0 -1
  105. package/src/modules/doc/toolbar/__tests__/mockSelectedLanguage.ts +0 -8
  106. package/src/modules/doc/toolbar/__tests__/mockSelectedVersion.ts +0 -8
  107. package/src/modules/doc/toolbar/__tests__/toolbar.test.ts +0 -44
@@ -1,8 +0,0 @@
1
- export default {
2
- domain: "http://localhost:3000",
3
- page: "docs",
4
- docId: "atlas.en-us.apexcode.meta",
5
- deliverable: "apexcode",
6
- contentDocumentId: "apex_dev_guide.htm",
7
- hash: ""
8
- };
@@ -1 +0,0 @@
1
- export default "https://resources.docs.salesforce.com/228/latest/en-us/sfdc/pdf/salesforce_apex_language_reference.pdf";
@@ -1,8 +0,0 @@
1
- export default [
2
- {
3
- label: "ENGLISH",
4
- code: "EN",
5
- locale: "en-us",
6
- url: "atlas.en-us.228.0.apexcode.meta"
7
- }
8
- ];
@@ -1,8 +0,0 @@
1
- export default [
2
- {
3
- version_text: "Winter '21 (API version 50.0)",
4
- release_version: "50.0",
5
- doc_version: "228.0",
6
- version_url: "atlas.en-us.apexcode.meta"
7
- }
8
- ];
@@ -1,146 +0,0 @@
1
- export default [
2
- {
3
- children: [
4
- {
5
- text: "Overview",
6
- a_attr: {
7
- href: "actions_intro_overview.htm"
8
- },
9
- id: "actions_intro_overview"
10
- },
11
- {
12
- text: "Invoking Actions",
13
- a_attr: {
14
- href: "actions_intro_invoking.htm"
15
- },
16
- id: "actions_intro_invoking"
17
- },
18
- {
19
- text: "Available Actions",
20
- a_attr: {
21
- href: "actions_intro_list.htm"
22
- },
23
- id: "actions_intro_list"
24
- }
25
- ],
26
- text: "Introducing Actions",
27
- a_attr: {
28
- href: "actions_intro.htm"
29
- },
30
- id: "actions_intro"
31
- },
32
- {
33
- children: [
34
- {
35
- text: "Apex Actions",
36
- a_attr: {
37
- href: "actions_obj_apex.htm"
38
- },
39
- id: "actions_obj_apex"
40
- },
41
- {
42
- text: "Create Service Report Actions",
43
- a_attr: {
44
- href: "actions_obj_create_service_report.htm"
45
- },
46
- id: "actions_obj_create_service_report"
47
- },
48
- {
49
- text: "Custom Notification Actions",
50
- a_attr: {
51
- href: "actions_obj_custom_notification.htm"
52
- },
53
- id: "actions_obj_custom_notification"
54
- },
55
- {
56
- text: "Email Alert Actions",
57
- a_attr: {
58
- href: "actions_obj_email_alert.htm"
59
- },
60
- id: "actions_obj_email_alert"
61
- },
62
- {
63
- text: "Flow Actions",
64
- a_attr: {
65
- href: "actions_obj_flow.htm"
66
- },
67
- id: "actions_obj_flow"
68
- },
69
- {
70
- text: "Generate Work Orders Actions",
71
- a_attr: {
72
- href: "actions_obj_generate_work_orders.htm"
73
- },
74
- id: "actions_obj_generate_work_orders"
75
- },
76
- {
77
- text: "Knowledge Actions",
78
- a_attr: {
79
- href: "actions_obj_knowledge.htm"
80
- },
81
- id: "actions_obj_knowledge"
82
- },
83
- {
84
- text: "Omni-Channel Action",
85
- a_attr: {
86
- href: "actions_obj_omni_channel.htm"
87
- },
88
- id: "actions_obj_omni_channel"
89
- },
90
- {
91
- text: "PlatformAction",
92
- a_attr: {
93
- href: "sforce_api_objects_platformaction.htm"
94
- },
95
- id: "sforce_api_objects_platformaction"
96
- },
97
- {
98
- text: "Post to Chatter Actions",
99
- a_attr: {
100
- href: "actions_obj_post_to_chatter.htm"
101
- },
102
- id: "actions_obj_post_to_chatter"
103
- },
104
- {
105
- text: "Quick Actions",
106
- a_attr: {
107
- href: "actions_obj_quick_action.htm"
108
- },
109
- id: "actions_obj_quick_action"
110
- },
111
- {
112
- text: "Refresh Metric Actions",
113
- a_attr: {
114
- href: "actions_obj_refresh_metric.htm"
115
- },
116
- id: "actions_obj_refresh_metric"
117
- },
118
- {
119
- text: "Salesforce Order Management Actions",
120
- a_attr: {
121
- href: "actions_obj_order_management.htm"
122
- },
123
- id: "actions_obj_order_management"
124
- },
125
- {
126
- text: "Simple Email Actions",
127
- a_attr: {
128
- href: "actions_obj_email_simple.htm"
129
- },
130
- id: "actions_obj_email_simple"
131
- },
132
- {
133
- text: "Submit for Approval Actions",
134
- a_attr: {
135
- href: "actions_obj_submit_for_approval.htm"
136
- },
137
- id: "actions_obj_submit_for_approval"
138
- }
139
- ],
140
- text: "Action Objects",
141
- a_attr: {
142
- href: "actions_obj.htm"
143
- },
144
- id: "actions_obj"
145
- }
146
- ];
@@ -1,117 +0,0 @@
1
- /* eslint-disable jest/no-mocks-import */
2
- import { createElement } from "lwc";
3
- import Container from "../container";
4
- import mockAvailableLanguages from "../__mocks__/mockAvailableLanguages";
5
- import mockAvailableVersions from "../__mocks__/mockAvailableVersions";
6
- import mockSelectedLanguage from "../__mocks__/mockSelectedLanguage";
7
- import mockSelectedVersion from "../__mocks__/mockSelectedVersion";
8
- import mockPdfUrl from "../__mocks__/mockPdfUrl";
9
- import mockToc from "../__mocks__/mockToc";
10
- import mockDocContent from "../__mocks__/mockDocContent";
11
- import mockPageReference from "../__mocks__/mockPageReference";
12
- window.scrollTo = jest.fn();
13
-
14
- const mockContentFetchResponse = require("../__mocks__/mockContentFetchResponse.json");
15
- const mockNavigationFetchResponse = require("../__mocks__/mockNavigationFetchResponse.json");
16
- const DEFAULT_DOMAIN_API = "https://developer.salesforce.com/";
17
- const ALTERNATE_DOMAIN_API = "https://staging.developer.salesforce.com/";
18
-
19
- const create = (props?: object) => {
20
- const component = createElement("doc-container", {
21
- is: Container
22
- });
23
-
24
- Object.assign(component, {
25
- selectedLanguage: mockSelectedLanguage,
26
- selectedVersion: mockSelectedVersion,
27
- availableLanguages: mockAvailableLanguages,
28
- availableVersion: mockAvailableVersions,
29
- pdfUrl: mockPdfUrl,
30
- toc: mockToc,
31
- docContent: mockDocContent,
32
- pageReference: mockPageReference,
33
- storybookDomain: "https://developer.salesforce.com",
34
- storybookPage: "docs",
35
- storybookDocId: "atlas.en-us.228.0.apexcode.meta",
36
- storybookDeliverable: "apexcode",
37
- storybookContentDocumentId: "apex_dev_guide.htm",
38
- ...(props || {})
39
- });
40
-
41
- return component;
42
- };
43
-
44
- function mockFetch() {
45
- return jest.fn().mockImplementation((url) => {
46
- let data = mockContentFetchResponse;
47
- switch (url) {
48
- case "https://developer.salesforce.com/docs/get_document/atlas.en-us.228.0.apexcode.meta":
49
- data = mockNavigationFetchResponse;
50
- break;
51
- default:
52
- data = mockContentFetchResponse;
53
- }
54
- return Promise.resolve({
55
- ok: true,
56
- json: () => data
57
- });
58
- });
59
- }
60
-
61
- describe("doc-container", () => {
62
- afterEach(() => {
63
- jest.clearAllMocks();
64
- });
65
-
66
- it("renders the content", async () => {
67
- global.fetch = mockFetch();
68
- const component = create();
69
- document.body.appendChild(component);
70
- expect(global.fetch).toHaveBeenCalledTimes(1);
71
- expect(global.fetch).toHaveBeenCalledWith(
72
- `${DEFAULT_DOMAIN_API}docs/get_document/atlas.en-us.228.0.apexcode.meta`
73
- );
74
- return Promise.resolve(() => {
75
- const contentEl = component.shadowRoot.querySelector(
76
- ".doc-content"
77
- );
78
- expect(contentEl).not.toBeNull();
79
- });
80
- });
81
-
82
- it("renders the navigation", async () => {
83
- global.fetch = mockFetch();
84
- const component = create();
85
- document.body.appendChild(component);
86
- expect(global.fetch).toHaveBeenCalledTimes(1);
87
- expect(global.fetch).toHaveBeenCalledWith(
88
- `${DEFAULT_DOMAIN_API}docs/get_document/atlas.en-us.228.0.apexcode.meta`
89
- );
90
- return Promise.resolve(() => {
91
- const navEl = component.shadowRoot.querySelector(".doc-nav");
92
- expect(navEl).not.toBeNull();
93
- });
94
- });
95
-
96
- it("renders the correct default value domainApi", () => {
97
- global.fetch = mockFetch();
98
- const component = create();
99
- document.body.appendChild(component);
100
- expect(global.fetch).toHaveBeenCalledTimes(1);
101
- expect(global.fetch).toHaveBeenCalledWith(
102
- `${DEFAULT_DOMAIN_API}docs/get_document/atlas.en-us.228.0.apexcode.meta`
103
- );
104
- expect(component.domainApi).toBe(DEFAULT_DOMAIN_API);
105
- });
106
-
107
- it("renders the correct values for domainApi", () => {
108
- global.fetch = mockFetch();
109
- const component = create({ domainApi: ALTERNATE_DOMAIN_API });
110
- document.body.appendChild(component);
111
- expect(global.fetch).toHaveBeenCalledTimes(1);
112
- expect(global.fetch).toHaveBeenCalledWith(
113
- `${ALTERNATE_DOMAIN_API}docs/get_document/atlas.en-us.228.0.apexcode.meta`
114
- );
115
- expect(component.domainApi).toBe(ALTERNATE_DOMAIN_API);
116
- });
117
- });
@@ -1,37 +0,0 @@
1
- div {
2
- display: flex;
3
- }
4
-
5
- .doc-nav {
6
- margin: 10px;
7
- min-width: 270px;
8
- width: 20%;
9
- }
10
-
11
- .doc-content {
12
- margin: 10px;
13
- width: 100%;
14
- }
15
-
16
- doc-nav {
17
- min-width: 100% !important;
18
- max-width: 100% !important;
19
- }
20
-
21
- doc-content {
22
- min-width: 100% !important;
23
- max-width: 100% !important;
24
- }
25
-
26
- @media screen and (max-width: 768px) {
27
- .container {
28
- flex-direction: column;
29
- }
30
-
31
- .doc-nav {
32
- margin-top: 0;
33
- margin-right: 0;
34
- margin-left: 0;
35
- width: 100%;
36
- }
37
- }
@@ -1,28 +0,0 @@
1
- <template>
2
- <template if:false={showLandingPage}>
3
- <div if:true={loaded} class="container">
4
- <div class="doc-nav">
5
- <doc-nav
6
- toc={toc}
7
- available-languages={availableLanguages}
8
- selected-language={selectedLanguage}
9
- pdf-url={pdfUrl}
10
- available-versions={availableVersions}
11
- selected-version={selectedVersion}
12
- page-reference={pageReference}
13
- selected-navigation-item={selectedNavigationItem}
14
- ></doc-nav>
15
- </div>
16
- <div class="doc-content">
17
- <doc-content
18
- docs-data={docContent}
19
- page-reference={pageReference}
20
- is-storybook={_isStorybook}
21
- ></doc-content>
22
- </div>
23
- </div>
24
- </template>
25
- <template if:true={showLandingPage}>
26
- <doc-landing></doc-landing>
27
- </template>
28
- </template>
@@ -1,44 +0,0 @@
1
- export default {
2
- title: "docs/doc-container",
3
- component: "doc-container"
4
- };
5
-
6
- export const Base = (args: any) => {
7
- return `
8
- <doc-container
9
- storybook-domain='${args.domain}'
10
- storybook-page='${args.page}'
11
- storybook-doc-id='${args.docId}'
12
- storybook-deliverable='${args.deliverable}'
13
- storybook-content-document-id='${args.contentDocumentId}'
14
- ></doc-container>`;
15
- };
16
-
17
- Base.args = {
18
- domain: "https://developer.salesforce.com",
19
- page: "docs",
20
- docId: "atlas.en-us.226.0.apexcode.meta",
21
- deliverable: "apexcode",
22
- contentDocumentId: "apex_dev_guide.htm"
23
- };
24
-
25
- export const DomainApi = (args: any) => {
26
- return `
27
- <doc-container
28
- domain-api='${args.domainApi}'
29
- storybook-domain='${args.domain}'
30
- storybook-page='${args.page}'
31
- storybook-doc-id='${args.docId}'
32
- storybook-deliverable='${args.deliverable}'
33
- storybook-content-document-id='${args.contentDocumentId}'
34
- ></doc-container>`;
35
- };
36
-
37
- DomainApi.args = {
38
- domain: "https://staging.developer.salesforce.com/",
39
- page: "docs",
40
- docId: "atlas.en-us.226.0.apexcode.meta",
41
- deliverable: "apexcode",
42
- contentDocumentId: "apex_dev_guide.htm",
43
- domainApi: "https://staging.developer.salesforce.com/"
44
- };