@powerhousedao/academy 2.5.0-dev.2 → 2.5.0-dev.21
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.
- package/CHANGELOG.md +124 -0
- package/docs/academy/01-GetStarted/00-ExploreDemoPackage.md +18 -10
- package/docs/academy/01-GetStarted/01-CreateNewPowerhouseProject.md +36 -39
- package/docs/academy/01-GetStarted/02-DefineToDoListDocumentModel.md +21 -6
- package/docs/academy/01-GetStarted/03-ImplementOperationReducers.md +5 -0
- package/docs/academy/01-GetStarted/04-BuildToDoListEditor.md +148 -420
- package/docs/academy/01-GetStarted/_04-BuildToDoListEditor +495 -0
- package/docs/academy/01-GetStarted/home.mdx +15 -15
- package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/01-WhatIsADocumentModel.md +11 -2
- package/docs/academy/02-MasteryTrack/02-DocumentModelCreation/02-SpecifyTheStateSchema.md +5 -0
- package/docs/academy/02-MasteryTrack/03-BuildingUserExperiences/01-BuildingDocumentEditors.md +5 -37
- package/docs/academy/02-MasteryTrack/05-Launch/02-PublishYourProject.md +70 -5
- package/docs/academy/02-MasteryTrack/05-Launch/03-SetupEnvironment.md +159 -73
- package/docs/academy/02-MasteryTrack/05-Launch/{03-RunOnACloudServer.md → _03-RunOnACloudServer} +8 -5
- package/docs/academy/04-APIReferences/00-PowerhouseCLI.md +7 -40
- package/docs/academy/06-ComponentLibrary/00-DocumentEngineering.md +67 -21
- package/docs/academy/06-ComponentLibrary/02-CreateCustomScalars.md +403 -0
- package/docs/academy/06-ComponentLibrary/{02-BuildingWithScalars.md → 02-ScalarComponent.mdx} +10 -12
- package/docs/academy/06-ComponentLibrary/{04-Complex-Components/01-sidebar.mdx → 03-ComplexComponent.mdx} +3 -1
- package/docs/academy/06-ComponentLibrary/03-IntegrateIntoAReactComponent.md +1 -0
- package/docs/academy/06-ComponentLibrary/04-LayoutComponent.mdx +5 -0
- package/docs/academy/06-ComponentLibrary/05-FragmentsComponent.mdx +5 -0
- package/docs/academy/07-Cookbook.md +0 -4
- package/docs/academy/08-Glossary.md +4 -1
- package/docs/academy/09-AIResources +23 -0
- package/package.json +1 -1
- package/sidebars.ts +6 -45
- package/docs/academy/06-ComponentLibrary/03-Scalar-Components/01-phid-field.mdx +0 -72
- package/docs/academy/06-ComponentLibrary/03-Scalar-Components/02-input-field.mdx +0 -0
- package/docs/academy/06-ComponentLibrary/05-Layout-Components/01-test-toupdate.mdx +0 -61
- package/docs/academy/06-ComponentLibrary/06-Fragments/01-test-toupdate.mdx +0 -61
- /package/docs/academy/02-MasteryTrack/05-Launch/{02-IntroductionToPackages.md → 01-IntroductionToPackages.md} +0 -0
- /package/docs/academy/02-MasteryTrack/05-Launch/{00-IntegrateInAFront-End → _00-IntegrateInAFront-End} +0 -0
- /package/docs/academy/02-MasteryTrack/05-Launch/{01-IntroducingFusion → _01-IntroducingFusion} +0 -0
- /package/docs/academy/02-MasteryTrack/05-Launch/{04-GraphQLNamespacing → _04-GraphQLNamespacing} +0 -0
- /package/docs/academy/02-MasteryTrack/05-Launch/{05-LaunchYourBackend.md → _05-LaunchYourBackend} +0 -0
- /package/docs/academy/02-MasteryTrack/05-Launch/{06-LaunchYourFrontend.md → _06-LaunchYourFrontend} +0 -0
- /package/docs/academy/04-APIReferences/{01-ReactHooks.md → 01-ReactHooks} +0 -0
- /package/docs/academy/04-APIReferences/{02-ReactorAPI.md → 02-ReactorAPI} +0 -0
- /package/docs/academy/04-APIReferences/{03-Configuration.md → 03-Configuration} +0 -0
package/sidebars.ts
CHANGED
|
@@ -68,27 +68,7 @@ const sidebars = {
|
|
|
68
68
|
link: {
|
|
69
69
|
type: 'generated-index',
|
|
70
70
|
},
|
|
71
|
-
items: [
|
|
72
|
-
'academy/MasteryTrack/BuildingUserExperiences/BuildingDocumentEditors',
|
|
73
|
-
'academy/MasteryTrack/BuildingUserExperiences/ConfiguringDrives',
|
|
74
|
-
'academy/MasteryTrack/BuildingUserExperiences/BuildingADriveExplorer',
|
|
75
|
-
]
|
|
76
|
-
},
|
|
77
|
-
{
|
|
78
|
-
type: 'category',
|
|
79
|
-
label: 'Document Tools',
|
|
80
|
-
link: {
|
|
81
|
-
type: 'generated-index',
|
|
82
|
-
},
|
|
83
|
-
items: [{ type: 'autogenerated', dirName: 'academy/02-MasteryTrack/03-BuildingUserExperiences/07-DocumentTools' }]
|
|
84
|
-
},
|
|
85
|
-
{
|
|
86
|
-
type: 'category',
|
|
87
|
-
label: 'Authorization',
|
|
88
|
-
link: {
|
|
89
|
-
type: 'generated-index',
|
|
90
|
-
},
|
|
91
|
-
items: [{ type: 'autogenerated', dirName: 'academy/02-MasteryTrack/03-BuildingUserExperiences/08-Authorization' }]
|
|
71
|
+
items: [{ type: 'autogenerated', dirName: 'academy/02-MasteryTrack/03-BuildingUserExperiences' }]
|
|
92
72
|
},
|
|
93
73
|
{
|
|
94
74
|
type: 'category',
|
|
@@ -140,30 +120,11 @@ const sidebars = {
|
|
|
140
120
|
</a>
|
|
141
121
|
`,
|
|
142
122
|
},
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
type: 'category',
|
|
149
|
-
label: 'Scalar Components',
|
|
150
|
-
items: [{type: 'autogenerated', dirName: 'academy/06-ComponentLibrary/03-Scalar-Components'}],
|
|
151
|
-
},
|
|
152
|
-
{
|
|
153
|
-
type: 'category',
|
|
154
|
-
label: 'Complex Components',
|
|
155
|
-
items: [{type: 'autogenerated', dirName: 'academy/06-ComponentLibrary/04-Complex-Components'}],
|
|
156
|
-
},
|
|
157
|
-
{
|
|
158
|
-
type: 'category',
|
|
159
|
-
label: 'Layout Components',
|
|
160
|
-
items: [{type: 'autogenerated', dirName: 'academy/06-ComponentLibrary/05-Layout-Components'}],
|
|
161
|
-
},
|
|
162
|
-
{
|
|
163
|
-
type: 'category',
|
|
164
|
-
label: 'Fragments',
|
|
165
|
-
items: [{type: 'autogenerated', dirName: 'academy/06-ComponentLibrary/06-Fragments'}],
|
|
166
|
-
},
|
|
123
|
+
'academy/ComponentLibrary/CreateCustomScalars',
|
|
124
|
+
'academy/ComponentLibrary/ScalarComponent',
|
|
125
|
+
'academy/ComponentLibrary/ComplexComponent',
|
|
126
|
+
'academy/ComponentLibrary/LayoutComponent',
|
|
127
|
+
'academy/ComponentLibrary/FragmentsComponent',
|
|
167
128
|
],
|
|
168
129
|
},
|
|
169
130
|
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
sidebar_label: 'PHID Field'
|
|
3
|
-
sidebar_position: 1
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
import { Tabs, TabItem } from '@theme/Tabs';
|
|
7
|
-
|
|
8
|
-
# PHID Field Example
|
|
9
|
-
|
|
10
|
-
### **Scalar Definition**
|
|
11
|
-
|
|
12
|
-
- **Name:** `PHID` (Powerhouse ID)
|
|
13
|
-
- **Purpose:** Represents a unique identifier pointing to a document, branch, scope, or data object within the Powerhouse system.
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
<details>
|
|
17
|
-
<summary>**Formatting of the component:**</summary>
|
|
18
|
-
- **Basic Notation:** `phd:<documentID>`
|
|
19
|
-
- **Branch and Scope:** Optional components appended using colons `:`.
|
|
20
|
-
- **Full Notation:** `phd:<documentID>:<branch>:<scope>`
|
|
21
|
-
- **Branch:** Defaults to `main` if omitted.
|
|
22
|
-
- **Scope:** Defaults to `public` if omitted.
|
|
23
|
-
- **Data Object Reference:** `phd:<documentID>/<dataObjectID>`
|
|
24
|
-
- **URL Format:** `phd://<domain>/<documentID>`
|
|
25
|
-
- Example: `phd://switchboard.powerhouse.xyz/baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
26
|
-
|
|
27
|
-
**Examples of the component formatting:**
|
|
28
|
-
- **Basic PHID:** `phd:baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
29
|
-
- **With Branch:** `phd:baefc2a4...:draft`
|
|
30
|
-
- **With Scope:** `phd:baefc2a4...::local`
|
|
31
|
-
- **With Branch and Scope:** `phd:baefc2a4...:draft:local`
|
|
32
|
-
- **With Data Object ID:** `phd:baefc2a4.../3cf05e40...`
|
|
33
|
-
</details>
|
|
34
|
-
|
|
35
|
-
<details>
|
|
36
|
-
<summary>**Validation of the Component:**</summary>
|
|
37
|
-
- **Validate each format:**
|
|
38
|
-
1. **PHID only:** Ensure the document ID is a valid UUID.
|
|
39
|
-
2. **PHID with data element (OID):** Validate both the document ID and the data object ID.
|
|
40
|
-
3. **PHID with branch:** Validate the document ID and check if the branch is properly formatted.
|
|
41
|
-
4. **PHID with scope:** Validate the document ID and check if the scope is valid.
|
|
42
|
-
5. **PHID with branch and scope:** Validate all three components: document ID, branch, and scope.
|
|
43
|
-
- **Error Message Example:** "Invalid PHID format. Please check the document ID, branch, or scope."
|
|
44
|
-
</details>
|
|
45
|
-
|
|
46
|
-
The following is a the UI component for the PHID field and scalar in a storybook.
|
|
47
|
-
We use Storybook as our component development environment.
|
|
48
|
-
It allows us to build and test UI components in isolation, making it easier to develop, test, and document reusable components.
|
|
49
|
-
In our stories you'll find first find a basic UI implementation example of the component, followed by the component's properties, events, and validation options.
|
|
50
|
-
|
|
51
|
-
- A list of the **default properties** and their descriptions, and a list of the available events that can be triggered.
|
|
52
|
-
- A list of the **component's specific properties** and attributes based on the components functionality.
|
|
53
|
-
- A list of **validation options**, or ways to validate the component's desired input values.
|
|
54
|
-
|
|
55
|
-
Additionally, you'll find various **stories of the components in different states**.
|
|
56
|
-
|
|
57
|
-
<div style={{
|
|
58
|
-
border: '1px solid #E5E7EB',
|
|
59
|
-
borderRadius: '8px',
|
|
60
|
-
padding: '16px',
|
|
61
|
-
marginBottom: '20px',
|
|
62
|
-
}}>
|
|
63
|
-
<iframe
|
|
64
|
-
src="https://storybook.powerhouse.academy/iframe.html?id=scalars-phid-field--readme&viewMode=story"
|
|
65
|
-
style={{
|
|
66
|
-
width: '100%',
|
|
67
|
-
height: '4500px',
|
|
68
|
-
border: 'none',
|
|
69
|
-
}}
|
|
70
|
-
title="PhidField Component Demo"
|
|
71
|
-
/>
|
|
72
|
-
</div>
|
|
File without changes
|
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
sidebar_label: 'PHID Field'
|
|
3
|
-
sidebar_position: 1
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
import { Tabs, TabItem } from '@theme/Tabs';
|
|
7
|
-
|
|
8
|
-
# PHID Field Example
|
|
9
|
-
|
|
10
|
-
### **Scalar Definition**
|
|
11
|
-
|
|
12
|
-
- **Name:** `PHID` (Powerhouse ID)
|
|
13
|
-
- **Purpose:** Represents a unique identifier pointing to a document, branch, scope, or data object within the Powerhouse system.
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
<details>
|
|
17
|
-
<summary>**Formatting of the component:**</summary>
|
|
18
|
-
- **Basic Notation:** `phd:<documentID>`
|
|
19
|
-
- **Branch and Scope:** Optional components appended using colons `:`.
|
|
20
|
-
- **Full Notation:** `phd:<documentID>:<branch>:<scope>`
|
|
21
|
-
- **Branch:** Defaults to `main` if omitted.
|
|
22
|
-
- **Scope:** Defaults to `public` if omitted.
|
|
23
|
-
- **Data Object Reference:** `phd:<documentID>/<dataObjectID>`
|
|
24
|
-
- **URL Format:** `phd://<domain>/<documentID>`
|
|
25
|
-
- Example: `phd://switchboard.powerhouse.xyz/baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
26
|
-
|
|
27
|
-
**Examples of the component formatting:**
|
|
28
|
-
- **Basic PHID:** `phd:baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
29
|
-
- **With Branch:** `phd:baefc2a4...:draft`
|
|
30
|
-
- **With Scope:** `phd:baefc2a4...::local`
|
|
31
|
-
- **With Branch and Scope:** `phd:baefc2a4...:draft:local`
|
|
32
|
-
- **With Data Object ID:** `phd:baefc2a4.../3cf05e40...`
|
|
33
|
-
</details>
|
|
34
|
-
|
|
35
|
-
<details>
|
|
36
|
-
<summary>**Validation of the Component:**</summary>
|
|
37
|
-
- **Validate each format:**
|
|
38
|
-
1. **PHID only:** Ensure the document ID is a valid UUID.
|
|
39
|
-
2. **PHID with data element (OID):** Validate both the document ID and the data object ID.
|
|
40
|
-
3. **PHID with branch:** Validate the document ID and check if the branch is properly formatted.
|
|
41
|
-
4. **PHID with scope:** Validate the document ID and check if the scope is valid.
|
|
42
|
-
5. **PHID with branch and scope:** Validate all three components: document ID, branch, and scope.
|
|
43
|
-
- **Error Message Example:** "Invalid PHID format. Please check the document ID, branch, or scope."
|
|
44
|
-
</details>
|
|
45
|
-
|
|
46
|
-
<div style={{
|
|
47
|
-
border: '1px solid #E5E7EB',
|
|
48
|
-
borderRadius: '8px',
|
|
49
|
-
padding: '16px',
|
|
50
|
-
marginBottom: '20px',
|
|
51
|
-
}}>
|
|
52
|
-
<iframe
|
|
53
|
-
src="https://dspot-scalars-storybook.vercel.app/iframe.html?args=name:amount-field;placeholder:test;label:Enter%20Amount%20and%20Select%20Currency;type:Amount;placeholderSelect:CUR;allowedTokens:!null;tokenIcons.Sol:1;value.amount:3454564564;value.currency:BTC&id=document-engineering-simple-components-phid-field--readme&viewMode=story"
|
|
54
|
-
style={{
|
|
55
|
-
width: '100%',
|
|
56
|
-
height: '4500px',
|
|
57
|
-
border: 'none',
|
|
58
|
-
}}
|
|
59
|
-
title="PhidField Component Demo"
|
|
60
|
-
/>
|
|
61
|
-
</div>
|
|
@@ -1,61 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
sidebar_label: 'PHID Field'
|
|
3
|
-
sidebar_position: 1
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
import { Tabs, TabItem } from '@theme/Tabs';
|
|
7
|
-
|
|
8
|
-
# PHID Field Example
|
|
9
|
-
|
|
10
|
-
### **Scalar Definition**
|
|
11
|
-
|
|
12
|
-
- **Name:** `PHID` (Powerhouse ID)
|
|
13
|
-
- **Purpose:** Represents a unique identifier pointing to a document, branch, scope, or data object within the Powerhouse system.
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
<details>
|
|
17
|
-
<summary>**Formatting of the component:**</summary>
|
|
18
|
-
- **Basic Notation:** `phd:<documentID>`
|
|
19
|
-
- **Branch and Scope:** Optional components appended using colons `:`.
|
|
20
|
-
- **Full Notation:** `phd:<documentID>:<branch>:<scope>`
|
|
21
|
-
- **Branch:** Defaults to `main` if omitted.
|
|
22
|
-
- **Scope:** Defaults to `public` if omitted.
|
|
23
|
-
- **Data Object Reference:** `phd:<documentID>/<dataObjectID>`
|
|
24
|
-
- **URL Format:** `phd://<domain>/<documentID>`
|
|
25
|
-
- Example: `phd://switchboard.powerhouse.xyz/baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
26
|
-
|
|
27
|
-
**Examples of the component formatting:**
|
|
28
|
-
- **Basic PHID:** `phd:baefc2a4-f9a0-4950-8161-fd8d8cc7dea9`
|
|
29
|
-
- **With Branch:** `phd:baefc2a4...:draft`
|
|
30
|
-
- **With Scope:** `phd:baefc2a4...::local`
|
|
31
|
-
- **With Branch and Scope:** `phd:baefc2a4...:draft:local`
|
|
32
|
-
- **With Data Object ID:** `phd:baefc2a4.../3cf05e40...`
|
|
33
|
-
</details>
|
|
34
|
-
|
|
35
|
-
<details>
|
|
36
|
-
<summary>**Validation of the Component:**</summary>
|
|
37
|
-
- **Validate each format:**
|
|
38
|
-
1. **PHID only:** Ensure the document ID is a valid UUID.
|
|
39
|
-
2. **PHID with data element (OID):** Validate both the document ID and the data object ID.
|
|
40
|
-
3. **PHID with branch:** Validate the document ID and check if the branch is properly formatted.
|
|
41
|
-
4. **PHID with scope:** Validate the document ID and check if the scope is valid.
|
|
42
|
-
5. **PHID with branch and scope:** Validate all three components: document ID, branch, and scope.
|
|
43
|
-
- **Error Message Example:** "Invalid PHID format. Please check the document ID, branch, or scope."
|
|
44
|
-
</details>
|
|
45
|
-
|
|
46
|
-
<div style={{
|
|
47
|
-
border: '1px solid #E5E7EB',
|
|
48
|
-
borderRadius: '8px',
|
|
49
|
-
padding: '16px',
|
|
50
|
-
marginBottom: '20px',
|
|
51
|
-
}}>
|
|
52
|
-
<iframe
|
|
53
|
-
src="https://dspot-scalars-storybook.vercel.app/iframe.html?args=name:amount-field;placeholder:test;label:Enter%20Amount%20and%20Select%20Currency;type:Amount;placeholderSelect:CUR;allowedTokens:!null;tokenIcons.Sol:1;value.amount:3454564564;value.currency:BTC&id=document-engineering-simple-components-phid-field--readme&viewMode=story"
|
|
54
|
-
style={{
|
|
55
|
-
width: '100%',
|
|
56
|
-
height: '4500px',
|
|
57
|
-
border: 'none',
|
|
58
|
-
}}
|
|
59
|
-
title="PhidField Component Demo"
|
|
60
|
-
/>
|
|
61
|
-
</div>
|
|
File without changes
|
|
File without changes
|
/package/docs/academy/02-MasteryTrack/05-Launch/{01-IntroducingFusion → _01-IntroducingFusion}
RENAMED
|
File without changes
|
/package/docs/academy/02-MasteryTrack/05-Launch/{04-GraphQLNamespacing → _04-GraphQLNamespacing}
RENAMED
|
File without changes
|
/package/docs/academy/02-MasteryTrack/05-Launch/{05-LaunchYourBackend.md → _05-LaunchYourBackend}
RENAMED
|
File without changes
|
/package/docs/academy/02-MasteryTrack/05-Launch/{06-LaunchYourFrontend.md → _06-LaunchYourFrontend}
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|