@metapages/metapage 1.8.24 → 1.8.26

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 (67) hide show
  1. package/README.md +96 -3
  2. package/dist/index.js +952 -925
  3. package/dist/index.js.map +1 -1
  4. package/dist/metapage/Constants.d.ts.map +1 -1
  5. package/dist/metapage/Metaframe.d.ts +5 -5
  6. package/dist/metapage/Metaframe.d.ts.map +1 -1
  7. package/dist/metapage/MetapageTools.d.ts +4 -4
  8. package/dist/metapage/MetapageTools.d.ts.map +1 -1
  9. package/dist/metapage/Shared.d.ts +4 -4
  10. package/dist/metapage/core.d.ts +1 -1
  11. package/dist/metapage/data.d.ts.map +1 -1
  12. package/dist/metapage/errors/MissingMetaframeJson.d.ts.map +1 -1
  13. package/dist/metapage/errors/RootMetapageError.d.ts.map +1 -1
  14. package/dist/metapage/jsonrpc.d.ts +4 -4
  15. package/dist/metapage/jsonrpc.d.ts.map +1 -1
  16. package/dist/metapage/metapageRenderer.d.ts +14 -0
  17. package/dist/metapage/metapageRenderer.d.ts.map +1 -1
  18. package/dist/metapage/v0_1_0/all.d.ts +1 -1
  19. package/dist/metapage/v0_1_0/all.d.ts.map +1 -1
  20. package/dist/metapage/v0_2/all.d.ts +1 -1
  21. package/dist/metapage/v0_2/all.d.ts.map +1 -1
  22. package/dist/metapage/v0_3/JsonRpcMethods.d.ts +3 -3
  23. package/dist/metapage/v0_3/JsonRpcMethods.d.ts.map +1 -1
  24. package/dist/metapage/v0_3/all.d.ts +2 -2
  25. package/dist/metapage/v0_3/all.d.ts.map +1 -1
  26. package/dist/metapage/v0_4/metaframe.d.ts +3 -3
  27. package/dist/metapage/v0_4/metaframe.d.ts.map +1 -1
  28. package/dist/metapage/v0_4/metapage.d.ts +3 -3
  29. package/dist/metapage/v0_4/metapage.d.ts.map +1 -1
  30. package/dist/metapage/v1/metaframe.d.ts +3 -3
  31. package/dist/metapage/v1/metapage.d.ts +3 -3
  32. package/dist/metapage/v2/metaframe.d.ts +3 -3
  33. package/dist/metapage/v2/metapage.d.ts +3 -3
  34. package/dist/metapage/versions.d.ts.map +1 -1
  35. package/package.json +2 -1
  36. package/src/metapage/Constants.ts +5 -6
  37. package/src/metapage/Metaframe.ts +50 -58
  38. package/src/metapage/Metapage.ts +36 -36
  39. package/src/metapage/MetapageIFrameRpcClient.ts +12 -12
  40. package/src/metapage/MetapageTools.ts +15 -18
  41. package/src/metapage/README.md +5 -5
  42. package/src/metapage/Shared.ts +5 -5
  43. package/src/metapage/conversions-metaframe.ts +35 -35
  44. package/src/metapage/conversions-metapage.ts +25 -25
  45. package/src/metapage/core.ts +1 -1
  46. package/src/metapage/data.ts +38 -48
  47. package/src/metapage/errors/MissingMetaframeJson.ts +11 -12
  48. package/src/metapage/errors/RootMetapageError.ts +11 -12
  49. package/src/metapage/jsonrpc.ts +6 -12
  50. package/src/metapage/metapageRenderer.ts +107 -63
  51. package/src/metapage/metapageRendererExample.ts +1 -1
  52. package/src/metapage/util.ts +6 -6
  53. package/src/metapage/v0_1_0/all.ts +6 -6
  54. package/src/metapage/v0_2/all.ts +15 -13
  55. package/src/metapage/v0_3/JsonRpcMethods.ts +6 -10
  56. package/src/metapage/v0_3/all.ts +7 -10
  57. package/src/metapage/v0_4/README.md +1 -0
  58. package/src/metapage/v0_4/index.ts +0 -1
  59. package/src/metapage/v0_4/metaframe.ts +3 -6
  60. package/src/metapage/v0_4/metapage.ts +3 -6
  61. package/src/metapage/v1/index.ts +0 -1
  62. package/src/metapage/v1/metaframe.ts +3 -4
  63. package/src/metapage/v1/metapage.ts +3 -3
  64. package/src/metapage/v2/index.ts +0 -1
  65. package/src/metapage/v2/metaframe.ts +3 -4
  66. package/src/metapage/v2/metapage.ts +3 -3
  67. package/src/metapage/versions.ts +11 -4
package/README.md CHANGED
@@ -1,7 +1,100 @@
1
1
  # [Metapages](https://docs.metapage.io/docs)
2
2
 
3
- A *metapage* is a set of connected webpages (*metaframes*).
3
+ A _metapage_ is a set of connected iframes (_metaframes_).
4
4
 
5
- Documentation and examples: [https://docs.metapage.io/docs](https://docs.metapage.io/docs)
5
+ - Examples: [https://metapage.io](https://metapage.io)
6
+ - Documentation: [https://docs.metapage.io/docs](https://docs.metapage.io/docs)
7
+ - Online tests and conversion tools: [https://module.metapage.io](https://module.metapage.io)
8
+ - Example javascript component: [https://js.mtfm.io](https://js.mtfm.io)
6
9
 
7
- Online tests and conversion tools: [https://module.metapage.io](https://module.metapage.io)
10
+ Each component iframe runs the metapage module and establishes input/output pipes. Now you can create, edit, and embed whole complex applications directly in your own apps, or simply create using the [metapage editor]((https://metapage.io) and publish and share immediately.
11
+
12
+ ## Quickstart metapage
13
+
14
+ Load and render a metapage definition
15
+
16
+ ```javascript
17
+ import { renderMetapage } from "https://cdn.jsdelivr.net/npm/@metapages/metapage@1.8.15";
18
+
19
+ // download a metapage definition from metapage.io
20
+ // or just use your own definition JSON
21
+ const response = await fetch(
22
+ "https://metapage.io/m/87ae11673508447e883b598bf7da9c5d/metapage.json",
23
+ );
24
+ const metapageDefinition = await response.json();
25
+ await renderMetapage({
26
+ definition: metapageDefinition,
27
+ rootDiv: document.getElementById("metapage-container"),
28
+ });
29
+ ```
30
+
31
+ The rendered workflow:
32
+
33
+ ![Logo](https://unpkg.com/@metapages/metapage/assets/example-01.png)
34
+
35
+ ## Full example
36
+
37
+ ```html
38
+ <!DOCTYPE html>
39
+ <html lang="en">
40
+ <head>
41
+ <meta charset="utf-8" />
42
+ <style>
43
+ * {
44
+ box-sizing: border-box;
45
+ margin: 0;
46
+ padding: 0;
47
+ }
48
+
49
+ body {
50
+ width: 100vw;
51
+ height: 100vh;
52
+ }
53
+
54
+ iframe {
55
+ overflow: hidden;
56
+ border: 0;
57
+ height: 100%;
58
+ width: 100%;
59
+ }
60
+ </style>
61
+ </head>
62
+
63
+ <body>
64
+ <div style="width: 100%; height: 100%" id="metapage-container"></div>
65
+
66
+ <script type="module">
67
+ // the only function you need to import to render a metapage
68
+ import { renderMetapage } from "https://cdn.jsdelivr.net/npm/@metapages/metapage@1.8.15";
69
+
70
+ // download a metapage definition from metapage.io
71
+ // or just use your own definition JSON
72
+ const response = await fetch(
73
+ "https://metapage.io/m/87ae11673508447e883b598bf7da9c5d/metapage.json",
74
+ );
75
+ const metapageDefinition = await response.json();
76
+
77
+ // handle metapage outputs
78
+ const onOutputs = (outputs) => {
79
+ // do something with the outputs
80
+ console.log("outputs", outputs);
81
+ };
82
+ // set input values with the provided setInputs function
83
+ // dispose removes all event listeners and unloads the metapage
84
+ const { setInputs, dispose } = await renderMetapage({
85
+ definition: metapageDefinition,
86
+ onOutputs,
87
+ rootDiv: document.getElementById("metapage-container"),
88
+ options: {
89
+ hideBorder: true,
90
+ hideFrameBorders: true,
91
+ hideOptions: true,
92
+ hideMetaframeLabels: true,
93
+ },
94
+ });
95
+ </script>
96
+ </body>
97
+ </html>
98
+ ```
99
+
100
+ Online tests and conversion tools: [https://module.metapage.io](https://module.metapage.io)