@cparra/apexdocs 2.25.0-alpha.1 → 2.25.0-alpha.10

package/dist/defaults-DUwru49Q.js

@@ -0,0 +1,12 @@
+'use strict';
+
+const defaults = {
+  targetGenerator: "markdown",
+  targetDir: "./docs/",
+  scope: ["global"],
+  defaultGroupName: "Miscellaneous",
+  includeMetadata: false,
+  sortMembersAlphabetically: false
+};
+
+exports.defaults = defaults;

package/dist/defaults-SH0Rsi5E.js

@@ -0,0 +1,11 @@
+'use strict';
+
+const defaults = {
+  targetGenerator: "markdown",
+  targetDir: "./docs/",
+  scope: ["global"],
+  defaultGroupName: "Miscellaneous",
+  includeMetadata: false
+};
+
+exports.defaults = defaults;

package/dist/defaults-jLXD2y8-.js

@@ -0,0 +1,13 @@
+'use strict';
+
+const defaults = {
+  targetGenerator: "markdown",
+  targetDir: "./docs/",
+  scope: ["global"],
+  defaultGroupName: "Miscellaneous",
+  includeMetadata: false,
+  sortMembersAlphabetically: false,
+  documentationRootDir: ""
+};
+
+exports.defaults = defaults;

package/dist/index.d.ts

@@ -0,0 +1,101 @@
+import { SetOptional } from 'type-fest';
+
+/**
+ * The configurable hooks that can be used to modify the output of the generator.
+ */
+type ConfigurableHooks = {
+  transformReferenceGuide: TransformReferenceGuide;
+  transformDocs: TransformDocs;
+  transformDocPage: TransformDocPage;
+  transformReference: TransformReference;
+};
+
+type UserDefinedMarkdownConfig = {
+  targetGenerator: 'markdown';
+  sourceDir: string;
+  targetDir: string;
+  scope: string[];
+  defaultGroupName: string;
+  namespace?: string;
+  sortMembersAlphabetically: boolean;
+  includeMetadata: boolean;
+  documentationRootDir: string;
+} & Partial<ConfigurableHooks>;
+
+type SourceFileMetadata = {
+  filePath: string;
+  name: string;
+  type: 'interface' | 'class' | 'enum';
+};
+
+type DocPageReference = {
+  source: SourceFileMetadata;
+  // The name under which the type should be displayed in the documentation.
+  // By default, this will match the source.name, but it can be configured by the user.
+  displayName: string;
+  // The location of the file relative to the root of the documentation.
+  pathFromRoot: string;
+};
+
+type Frontmatter = string | Record<string, unknown> | null;
+
+type ReferenceGuidePageData = {
+  frontmatter: Frontmatter;
+  content: string;
+  filePath: string;
+};
+
+type DocPageData = {
+  source: SourceFileMetadata;
+  group: string | null;
+  filePath: string;
+  frontmatter: Frontmatter;
+  content: string;
+};
+
+/**
+ * Represents a file to be skipped.
+ */
+type Skip = {
+  readonly _tag: 'Skip';
+};
+
+// Configurable Hooks
+
+type ConfigurableDocPageReference = Omit<DocPageReference, 'source'>;
+
+type ConfigurableDocPageData = Omit<DocPageData, 'source' | 'filePath'>;
+
+/**
+ * Allows changing where the files are written to.
+ */
+type TransformReference = (
+  reference: DocPageReference,
+) => Partial<ConfigurableDocPageReference> | Promise<ConfigurableDocPageReference>;
+
+/**
+ * Allows changing the frontmatter and content of the reference guide, or even if creating a reference
+ * guide will be skipped altogether.
+ */
+type TransformReferenceGuide = (
+  referenceGuide: ReferenceGuidePageData,
+) => Partial<ReferenceGuidePageData> | Skip | Promise<Partial<ReferenceGuidePageData> | Skip>;
+
+/**
+ * The main purpose if for allowing for doc pages to be skipped, but it can also be used to change the frontmatter
+ * and content of the doc pages.
+ */
+type TransformDocs = (docs: DocPageData[]) => DocPageData[] | Promise<DocPageData[]>;
+
+/**
+ * Allows changing the frontmatter and content of the doc pages.
+ */
+type TransformDocPage = (
+  doc: DocPageData,
+) => Partial<ConfigurableDocPageData> | Promise<Partial<ConfigurableDocPageData>>;
+
+type ConfigurableMarkdownConfig = Omit<SetOptional<UserDefinedMarkdownConfig, 'targetDir' | 'scope' | 'defaultGroupName' | 'includeMetadata' | 'sortMembersAlphabetically' | 'documentationRootDir'>, 'targetGenerator'>;
+declare function defineMarkdownConfig(config: ConfigurableMarkdownConfig): UserDefinedMarkdownConfig;
+declare function skip(): Skip;
+
+export { type ConfigurableHooks, type DocPageData, type DocPageReference, type ReferenceGuidePageData, defineMarkdownConfig, skip };

package/dist/index.js

@@ -0,0 +1,36 @@
+'use strict';
+
+var defaults = require('./defaults-jLXD2y8-.js');
+
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+function defineMarkdownConfig(config) {
+  return __spreadProps(__spreadValues(__spreadValues({}, defaults.defaults), config), {
+    targetGenerator: "markdown"
+  });
+}
+function skip() {
+  return {
+    _tag: "Skip"
+  };
+}
+
+exports.defineMarkdownConfig = defineMarkdownConfig;
+exports.skip = skip;

package/examples/markdown/docs/index.md

@@ -0,0 +1,109 @@
+# Apex Reference Guide
+
+## Miscellaneous
+
+### [BaseClass](miscellaneous/BaseClass.md)
+
+### [MultiInheritanceClass](miscellaneous/MultiInheritanceClass.md)
+
+### [ParentInterface](miscellaneous/ParentInterface.md)
+
+### [ReferencedEnum](miscellaneous/ReferencedEnum.md)
+
+### [SampleException](miscellaneous/SampleException.md)
+
+This is a sample exception.
+
+### [SampleInterface](miscellaneous/SampleInterface.md)
+
+This is a sample interface
+
+### [Url](miscellaneous/Url.md)
+
+Represents a uniform resource locator (URL) and provides access to parts of the URL. 
+Enables access to the base URL used to access your Salesforce org. 
+ 
+## Usage 
+Use the methods of the `System.URL` class to create links to objects in your organization. Such objects can be files, images, 
+logos, or records that you want to include in external emails, in activities, or in Chatter posts. For example, you can create 
+a link to a file uploaded as an attachment to a Chatter post by concatenating the Salesforce base URL with the file ID: 
+ 
+```apex
+// Get a file uploaded through Chatter.
+ContentDocument doc = [SELECT Id FROM ContentDocument
+        WHERE Title = 'myfile'];
+// Create a link to the file.
+String fullFileURL = URL.getOrgDomainURL().toExternalForm() +
+'/' + doc.id;
+system.debug(fullFileURL);
+```
+
+ 
+The following example creates a link to a Salesforce record. The full URL is created by concatenating the Salesforce base 
+URL with the record ID. 
+ 
+```ape
+Account acct = [SELECT Id FROM Account WHERE Name = 'Acme' LIMIT 1];
+String fullRecordURL = URL.getOrgDomainURL().toExternalForm() + '/' + acct.Id;
+```
+
+ 
+## Example 
+In this example, the base URL and the full request URL of the current Salesforce server instance are retrieved. Next, a URL 
+pointing to a specific account object is created. Finally, components of the base and full URL are obtained. This example 
+prints out all the results to the debug log output. 
+ 
+```apex
+// Create a new account called Acme that we will create a link for later.
+Account myAccount = new Account(Name='Acme');
+insert myAccount;
+
+// Get the base URL.
+String sfdcBaseURL = URL.getOrgDomainURL().toExternalForm();
+System.debug('Base URL: ' + sfdcBaseURL );
+
+// Get the URL for the current request.
+String currentRequestURL = URL.getCurrentRequestUrl().toExternalForm();
+System.debug('Current request URL: ' + currentRequestURL);
+
+// Create the account URL from the base URL.
+String accountURL = URL.getOrgDomainURL().toExternalForm() +
+                       '/' + myAccount.Id;
+System.debug('URL of a particular account: ' + accountURL);
+
+// Get some parts of the base URL.
+System.debug('Host: ' + URL.getOrgDomainURL().getHost());
+System.debug('Protocol: ' + URL.getOrgDomainURL().getProtocol());
+
+// Get the query string of the current request.
+System.debug('Query: ' + URL.getCurrentRequestUrl().getQuery());
+```
+
+ 
+## Version Behavior Changes 
+In API version 41.0 and later, Apex URL objects are represented by the java.net.URI type, not the java.net.URL type. 
+The API version in which the URL object was instantiated determines the behavior of subsequent method calls to the 
+specific instance. Salesforce strongly encourages you to use API 41.0 and later versions for fully RFC-compliant URL 
+parsing that includes proper handling of edge cases of complex URL structures. API 41.0 and later versions also enforce 
+that inputs are valid, RFC-compliant URL or URI strings. 
+ 
+* [URL Constructors](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_url.htm#apex_System_URL_constructors) 
+* [URL Methods](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_url.htm#apex_System_URL_methods) 
+ 
+**See Also** 
+* [URL Class](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_classes_url.htm)
+
+## Sample Enums
+
+### [SampleEnum](sample-enums/SampleEnum.md)
+
+This is a sample enum. This references [ReferencedEnum](miscellaneous/ReferencedEnum.md) . 
+ 
+This description has several lines
+
+## SampleGroup
+
+### [SampleClass](samplegroup/SampleClass.md)
+
+aliquip ex sunt officia ullamco anim deserunt magna aliquip nisi eiusmod in sit officia veniam ex 
+deserunt ea officia exercitation laboris enim in duis quis enim eiusmod eu amet cupidatat.

package/examples/{plain-markdown/docs/Miscellaneous/ns.BaseClass.md → markdown/docs/miscellaneous/BaseClass.md}

@@ -13,4 +13,4 @@ public sampleEnumFromBase
 ```
 
 #### Type
-[ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)
+[SampleEnum](../sample-enums/SampleEnum.md)

package/examples/markdown/docs/miscellaneous/MultiInheritanceClass.md

@@ -0,0 +1,72 @@
+# MultiInheritanceClass Class
+
+## Namespace
+ns
+
+**Inheritance**
+
+[SampleClass](../samplegroup/SampleClass.md) < [BaseClass](../miscellaneous/BaseClass.md)
+
+## Fields
+### `sampleEnumFromBase`
+
+*Inherited*
+
+#### Signature
+```apex
+public sampleEnumFromBase
+```
+
+#### Type
+[SampleEnum](../sample-enums/SampleEnum.md)
+
+## Properties
+### Group Name
+#### `someProperty`
+
+*Inherited*
+
+##### Signature
+```apex
+public someProperty
+```
+
+##### Type
+String
+
+## Methods
+### Available Methods
+#### `doSomething()`
+
+*Inherited*
+
+##### Signature
+```apex
+public void doSomething()
+```
+
+##### Return Type
+**void**
+
+### Deprecated Methods
+#### `sayHello()`
+
+*Inherited*
+
+`DEPRECATED`
+
+This is a sample method.
+
+##### Signature
+```apex
+public virtual String sayHello()
+```
+
+##### Return Type
+**String**
+
+A string value.
+
+##### Example
+SampleClass sample &#x3D; new SampleClass(); 
+sample.doSomething();

package/examples/{plain-markdown/docs/Miscellaneous/ns.ParentInterface.md → markdown/docs/miscellaneous/ParentInterface.md}

@@ -12,4 +12,4 @@ public void sampleParentMethod()
 ```
 
 #### Return Type
-**void**
+**void**

package/examples/{plain-markdown/docs/Miscellaneous/ns.ReferencedEnum.md → markdown/docs/miscellaneous/ReferencedEnum.md}

@@ -5,4 +5,4 @@ ns
 
 ## Values
 | Value | Description |
-|-------|-------------|
+|-------|-------------|

package/examples/markdown/docs/miscellaneous/SampleException.md

@@ -0,0 +1,24 @@
+# SampleException Class
+
+This is a sample exception.
+
+**Usage** 
+
+You can use the exception the following way. 
+You can also take a look at [SampleClass](../samplegroup/SampleClass.md) to see how it is used. 
+This is a dangerous HTML tag: <script>alert('Hello');</script> 
+ 
+```apex
+try {
+   throw new SampleException();
+} catch (SampleException e) {
+  System.debug('Caught exception');
+}
+```
+
+## Namespace
+ns
+
+**Inheritance**
+
+Exception

package/examples/{plain-markdown/docs/Miscellaneous/ns.SampleInterface.md → markdown/docs/miscellaneous/SampleInterface.md}

@@ -4,33 +4,30 @@
 
 This is a sample interface
 
+**Mermaid** 
+
+graph TD 
+A[SampleInterface] -->|extends| B[ParentInterface] 
+B -->|extends| C[GrandParentInterface] 
+C -->|extends| D[GreatGrandParentInterface]
+
 **Author** John Doe
 
 **Date** 2020-01-01
 
-**See** [ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)
+**See** [SampleEnum](../sample-enums/SampleEnum.md)
 
-**See** [ns.ReferencedEnum](./ns.ReferencedEnum.md)
+**See** [ReferencedEnum](../miscellaneous/ReferencedEnum.md)
 
 ## Namespace
 ns
 
-## Diagram
-```mermaid
-graph TD
-   A[SampleInterface] -->|extends| B[ParentInterface]
-   B -->|extends| C[GrandParentInterface]
-   C -->|extends| D[GreatGrandParentInterface]
-```
-
 ## Example
-```apex
-SampleInterface sampleInterface = new SampleInterface();
+SampleInterface sampleInterface = new SampleInterface(); 
 sampleInterface.sampleMethod();
-```
 
 **Extends**
-[ns.ParentInterface](./ns.ParentInterface.md)
+[ParentInterface](../miscellaneous/ParentInterface.md)
 
 ## Methods
 ### `sampleMethod()`
@@ -39,9 +36,20 @@ sampleInterface.sampleMethod();
 
 This is a sample method
 
-**Custom Tag** This is a custom tag
+**Custom Tag** 
+
+This is a custom tag
+
+**Another Custom Tag** 
 
-**Another Custom Tag** This is another custom tag
+This is another custom tag
+
+**Mermaid** 
+
+graph TD 
+A[SampleInterface] -->|extends| B[ParentInterface] 
+B -->|extends| C[GrandParentInterface] 
+C -->|extends| D[GreatGrandParentInterface]
 
 #### Signature
 ```apex
@@ -54,23 +62,13 @@ public String sampleMethod()
 Some return value
 
 #### Throws
-[ns.SampleException](./ns.SampleException.md): This is a sample exception
+[SampleException](../miscellaneous/SampleException.md): This is a sample exception
 
 AnotherSampleException: This is another sample exception
 
-#### Diagram
-```mermaid
-graph TD
-  A[SampleInterface] -->|extends| B[ParentInterface]
-  B -->|extends| C[GrandParentInterface]
-  C -->|extends| D[GreatGrandParentInterface]
-```
-
 #### Example
-```apex
-SampleInterface sampleInterface = new SampleInterface();
+SampleInterface sampleInterface = new SampleInterface(); 
 sampleInterface.sampleMethod();
-```
 
 ---
 
@@ -80,7 +78,6 @@ sampleInterface.sampleMethod();
 `DEPRECATED`
 
 This is a sample method with parameters 
-
 Sometimes it won't be possible to find a NonExistent link.
 
 #### Signature
@@ -93,10 +90,10 @@ public SampleEnum sampleMethodWithParams(String param1, Integer param2, SampleEn
 |------|------|-------------|
 | param1 | String | This is the first parameter |
 | param2 | Integer | This is the second parameter |
-| theEnum | [ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md) | This is an enum parameter |
+| theEnum | [SampleEnum](../sample-enums/SampleEnum.md) | This is an enum parameter |
 
 #### Return Type
-**[ns.SampleEnum](../Sample-Enums/ns.SampleEnum.md)**
+**[SampleEnum](../sample-enums/SampleEnum.md)**
 
 Some return value
 
@@ -112,4 +109,4 @@ public void sampleParentMethod()
 ```
 
 #### Return Type
-**void**
+**void**