@contentful/experiences-core 1.5.0 → 1.5.1-dev-20240520T1741-e8bafca.0
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/README.md +13 -3
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -1,7 +1,17 @@
|
|
|
1
1
|
# @contentful/experiences-core
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
### Purpose
|
|
4
|
+
- To contain shared code and utilities across the Experience-builder packages such as constants, types, transformers, and hooks.
|
|
5
|
+
- This means additions to core should be framework agnostic. For example, code that is only compatible with React does not belong in the core package.
|
|
4
6
|
|
|
5
|
-
|
|
7
|
+
### Concepts
|
|
8
|
+
- **Deep binding**: Relates to the ability to resolve n references. Such an entry containing a reference to another entry which may also contain a reference to another entry and so on.
|
|
9
|
+
- **Component definition** Baseline definition to outline what is needed to define all component types whether it is a structure, built-in, or custom component.
|
|
10
|
+
- **Entity**: Contentful entries that get converted into an experience object that can be used within the experience builder packages.
|
|
11
|
+
- **Fetchers**: The helper classes and functions in the Entity directory get consumed by the fetchers which get bundled up into either `fetchBySlug` or `fetchById`. The listed fetchers are the two main functions that are exposed to the end user in the sdk to fetch a user's experience which is stored in Contentful as an entry.
|
|
12
|
+
- **Registries**: An in memory storage technique that the user can decide to provide for themselves or other personas in the editor canvas. Design Tokens is an useful example where a user can provide their own thematic values with regards to text size, component sizes, spacing, colors, and borders in a json format that is resolved by the registry and provided as options in the ui editor sidebar.
|
|
13
|
+
- **Exporting types and constants**: Notice in the `package.json` there is a `typesVersions` definition that separates the constants and types as separated bundled packages where the rollup is defined in the `rollup.config.mjs` file. This effectively means in practice consuming the types and constants have different imports - namely `@contentful/experiences-core/constants` and `@contentful/experiences-core/types`.
|
|
6
14
|
|
|
7
|
-
|
|
15
|
+
### Relevant Contentful Documentation Links
|
|
16
|
+
- [Data Structures](https://www.contentful.com/developers/docs/experiences/data-structures/)
|
|
17
|
+
- [Design Tokens](https://www.contentful.com/developers/docs/experiences/design-tokens/)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@contentful/experiences-core",
|
|
3
|
-
"version": "1.5.0",
|
|
3
|
+
"version": "1.5.1-dev-20240520T1741-e8bafca.0",
|
|
4
4
|
"description": "",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"module": "dist/index.js",
|
|
@@ -65,11 +65,11 @@
|
|
|
65
65
|
"vitest": "^1.0.4"
|
|
66
66
|
},
|
|
67
67
|
"dependencies": {
|
|
68
|
-
"@contentful/experiences-validators": "
|
|
68
|
+
"@contentful/experiences-validators": "1.5.1-dev-20240520T1741-e8bafca.0",
|
|
69
69
|
"@contentful/rich-text-types": "^16.3.0"
|
|
70
70
|
},
|
|
71
71
|
"peerDependencies": {
|
|
72
72
|
"contentful": ">=10.6.0"
|
|
73
73
|
},
|
|
74
|
-
"gitHead": "
|
|
74
|
+
"gitHead": "e8bafca8a2ccdafa7794b5b181438331571dadff"
|
|
75
75
|
}
|