forma-diagrams 0.5.2

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 (109) hide show
  1. package/Dockerfile +16 -0
  2. package/LICENSE +21 -0
  3. package/README.md +113 -0
  4. package/THIRD_PARTY_NOTICES.md +20 -0
  5. package/bin/forma +3 -0
  6. package/deploy/.env.example +11 -0
  7. package/deploy/Caddyfile +4 -0
  8. package/deploy/compose.yml +38 -0
  9. package/dist/assets/IBMPlexSans-Regular-Bl2SjS7V.ttf +0 -0
  10. package/dist/assets/IBMPlexSans-SemiBold-B9auKknr.ttf +0 -0
  11. package/dist/assets/elk.bundled-Y7ymokgr.js +24 -0
  12. package/dist/assets/index-_kg9cdik.css +1 -0
  13. package/dist/assets/index-al0xDdTG.js +452 -0
  14. package/dist/fonts/IBMPlexSans-Regular.ttf +0 -0
  15. package/dist/fonts/IBMPlexSans-SemiBold.ttf +0 -0
  16. package/dist/fonts/OFL.txt +93 -0
  17. package/dist/index.html +14 -0
  18. package/dist/licenses/FORMA_LICENSE.txt +21 -0
  19. package/dist/licenses/THIRD_PARTY_LICENSES.txt +11601 -0
  20. package/docs/api.md +41 -0
  21. package/docs/decisions/001-foundation.md +57 -0
  22. package/docs/decisions/002-composition-and-human-edits.md +47 -0
  23. package/docs/decisions/003-general-composition.md +30 -0
  24. package/docs/decisions/004-library-and-distribution.md +33 -0
  25. package/docs/decisions/005-organizational-hosting.md +33 -0
  26. package/docs/decisions/006-hosted-agent-access.md +25 -0
  27. package/docs/format.md +132 -0
  28. package/docs/gallery.md +73 -0
  29. package/docs/images/architecture.png +0 -0
  30. package/docs/images/editor.png +0 -0
  31. package/docs/images/gallery/architecture.png +0 -0
  32. package/docs/images/gallery/decision.png +0 -0
  33. package/docs/images/gallery/development-signal.png +0 -0
  34. package/docs/images/gallery/development.png +0 -0
  35. package/docs/images/gallery/editor-roundtrip.png +0 -0
  36. package/docs/images/gallery/entities.png +0 -0
  37. package/docs/images/gallery/mindmap.png +0 -0
  38. package/docs/images/gallery/organization.png +0 -0
  39. package/docs/images/gallery/timeline.png +0 -0
  40. package/docs/images/release.png +0 -0
  41. package/docs/install.md +50 -0
  42. package/docs/plans/mvp.md +24 -0
  43. package/docs/self-hosting.md +167 -0
  44. package/docs/verification-v2.md +41 -0
  45. package/docs/verification-v3.md +16 -0
  46. package/docs/verification-v4.1.md +35 -0
  47. package/docs/verification-v4.2.md +20 -0
  48. package/docs/verification-v4.3.md +5 -0
  49. package/docs/verification-v4.md +31 -0
  50. package/docs/verification-v5.1.md +7 -0
  51. package/docs/verification-v5.2.md +7 -0
  52. package/docs/verification-v5.md +7 -0
  53. package/docs/verification.md +91 -0
  54. package/examples/design-systems/atelier.json +53 -0
  55. package/examples/design-systems/signal.json +53 -0
  56. package/examples/gallery/architecture.forma.json +178 -0
  57. package/examples/gallery/decision.forma.json +182 -0
  58. package/examples/gallery/development-signal.forma.json +299 -0
  59. package/examples/gallery/development.forma.json +299 -0
  60. package/examples/gallery/entities.forma.json +123 -0
  61. package/examples/gallery/mindmap.forma.json +158 -0
  62. package/examples/gallery/organization.forma.json +151 -0
  63. package/examples/gallery/timeline.forma.json +138 -0
  64. package/examples/platform.forma.json +116 -0
  65. package/examples/release.forma.json +58 -0
  66. package/examples/roundtrip/agent-continued.forma.json +310 -0
  67. package/examples/roundtrip/agent-patch.json +7 -0
  68. package/examples/roundtrip/human-edited.forma.json +309 -0
  69. package/package.json +81 -0
  70. package/packages/cli/bin.mjs +3 -0
  71. package/packages/cli/src/agent-access.ts +232 -0
  72. package/packages/cli/src/blob-store.ts +241 -0
  73. package/packages/cli/src/file-library.ts +179 -0
  74. package/packages/cli/src/google.ts +51 -0
  75. package/packages/cli/src/hosted.ts +498 -0
  76. package/packages/cli/src/http.ts +67 -0
  77. package/packages/cli/src/index.ts +397 -0
  78. package/packages/cli/src/mcp.ts +114 -0
  79. package/packages/cli/src/remote.ts +228 -0
  80. package/packages/cli/src/server.ts +69 -0
  81. package/packages/cli/src/signed-cookie.ts +42 -0
  82. package/packages/core/src/align.ts +237 -0
  83. package/packages/core/src/document.ts +408 -0
  84. package/packages/core/src/font-metrics.json +1 -0
  85. package/packages/core/src/geometry.ts +463 -0
  86. package/packages/core/src/index.ts +12 -0
  87. package/packages/core/src/inspect.ts +230 -0
  88. package/packages/core/src/layout.ts +450 -0
  89. package/packages/core/src/render.ts +182 -0
  90. package/packages/core/src/resolve-style.ts +29 -0
  91. package/packages/core/src/scene.ts +40 -0
  92. package/packages/core/src/styles.ts +122 -0
  93. package/packages/core/src/text.ts +81 -0
  94. package/packages/core/src/theme.ts +33 -0
  95. package/public/fonts/IBMPlexSans-Regular.ttf +0 -0
  96. package/public/fonts/IBMPlexSans-SemiBold.ttf +0 -0
  97. package/public/fonts/OFL.txt +93 -0
  98. package/schema/design-system.v1.schema.json +734 -0
  99. package/schema/forma.v1.schema.json +273 -0
  100. package/schema/forma.v2.schema.json +1756 -0
  101. package/skills/forma/SKILL.md +20 -0
  102. package/skills/forma/references/composition.md +11 -0
  103. package/skills/forma/references/hosted.md +28 -0
  104. package/skills/forma-architecture/SKILL.md +14 -0
  105. package/skills/forma-entities/SKILL.md +14 -0
  106. package/skills/forma-flow/SKILL.md +14 -0
  107. package/skills/forma-mindmap/SKILL.md +14 -0
  108. package/skills/forma-organization/SKILL.md +14 -0
  109. package/skills/forma-timeline/SKILL.md +14 -0
@@ -0,0 +1,299 @@
1
+ {
2
+ "description": "A custom visual explanation / Parallel generation changes where engineering attention is needed.",
3
+ "edges": [
4
+ {
5
+ "id": "brief-implement",
6
+ "source": "brief",
7
+ "style": "solid",
8
+ "target": "implement"
9
+ },
10
+ {
11
+ "id": "implement-review",
12
+ "source": "implement",
13
+ "style": "solid",
14
+ "target": "review"
15
+ },
16
+ {
17
+ "id": "review-deliver",
18
+ "source": "review",
19
+ "style": "solid",
20
+ "target": "deliver"
21
+ },
22
+ {
23
+ "id": "intent-streamA",
24
+ "source": "intent",
25
+ "style": "solid",
26
+ "target": "streamA"
27
+ },
28
+ {
29
+ "id": "intent-streamB",
30
+ "source": "intent",
31
+ "style": "solid",
32
+ "target": "streamB"
33
+ },
34
+ {
35
+ "id": "intent-streamC",
36
+ "source": "intent",
37
+ "style": "solid",
38
+ "target": "streamC"
39
+ },
40
+ {
41
+ "id": "streamA-verify",
42
+ "source": "streamA",
43
+ "style": "solid",
44
+ "target": "verify"
45
+ },
46
+ {
47
+ "id": "streamB-verify",
48
+ "source": "streamB",
49
+ "style": "solid",
50
+ "target": "verify"
51
+ },
52
+ {
53
+ "id": "streamC-verify",
54
+ "source": "streamC",
55
+ "style": "solid",
56
+ "target": "verify"
57
+ },
58
+ {
59
+ "appearance": {
60
+ "arrowEnd": "open",
61
+ "dash": "dotted",
62
+ "strokeWidth": 2
63
+ },
64
+ "id": "verify-release",
65
+ "source": "verify",
66
+ "style": "solid",
67
+ "target": "release"
68
+ }
69
+ ],
70
+ "groups": [
71
+ {
72
+ "color": "slate",
73
+ "id": "traditional",
74
+ "label": "Traditional"
75
+ },
76
+ {
77
+ "color": "slate",
78
+ "id": "enabled",
79
+ "label": "AI-enabled"
80
+ }
81
+ ],
82
+ "layout": {
83
+ "direction": "DOWN",
84
+ "mode": "grid",
85
+ "spacing": "comfortable"
86
+ },
87
+ "nodes": [
88
+ {
89
+ "description": "One work stream",
90
+ "emphasis": "normal",
91
+ "group": "traditional",
92
+ "id": "brief",
93
+ "kind": "service",
94
+ "label": "Brief",
95
+ "placement": {
96
+ "column": 0,
97
+ "row": 0
98
+ },
99
+ "role": "quiet",
100
+ "style": {
101
+ "width": 150
102
+ }
103
+ },
104
+ {
105
+ "description": "Serial development",
106
+ "emphasis": "normal",
107
+ "group": "traditional",
108
+ "id": "implement",
109
+ "kind": "service",
110
+ "label": "Implement",
111
+ "placement": {
112
+ "column": 0,
113
+ "row": 1
114
+ },
115
+ "style": {
116
+ "width": 150
117
+ }
118
+ },
119
+ {
120
+ "description": "One change at a time",
121
+ "emphasis": "normal",
122
+ "group": "traditional",
123
+ "id": "review",
124
+ "kind": "service",
125
+ "label": "Review",
126
+ "placement": {
127
+ "column": 0,
128
+ "row": 2
129
+ },
130
+ "style": {
131
+ "width": 150
132
+ }
133
+ },
134
+ {
135
+ "description": "Steady throughput",
136
+ "emphasis": "normal",
137
+ "group": "traditional",
138
+ "id": "deliver",
139
+ "kind": "service",
140
+ "label": "Deliver",
141
+ "placement": {
142
+ "column": 0,
143
+ "row": 3
144
+ },
145
+ "role": "quiet",
146
+ "style": {
147
+ "width": 150
148
+ }
149
+ },
150
+ {
151
+ "description": "One clear specification",
152
+ "emphasis": "normal",
153
+ "group": "enabled",
154
+ "id": "intent",
155
+ "kind": "service",
156
+ "label": "Shared intent",
157
+ "placement": {
158
+ "column": 2,
159
+ "row": 0
160
+ },
161
+ "role": "emphasis"
162
+ },
163
+ {
164
+ "description": "Alternative approaches",
165
+ "emphasis": "normal",
166
+ "group": "enabled",
167
+ "id": "streamA",
168
+ "kind": "service",
169
+ "label": "Explore",
170
+ "placement": {
171
+ "column": 1,
172
+ "row": 1
173
+ }
174
+ },
175
+ {
176
+ "description": "Parallel work packages",
177
+ "emphasis": "normal",
178
+ "group": "enabled",
179
+ "id": "streamB",
180
+ "kind": "service",
181
+ "label": "Implement",
182
+ "placement": {
183
+ "column": 2,
184
+ "row": 1
185
+ }
186
+ },
187
+ {
188
+ "description": "Independent checks",
189
+ "emphasis": "normal",
190
+ "group": "enabled",
191
+ "id": "streamC",
192
+ "kind": "service",
193
+ "label": "Test",
194
+ "placement": {
195
+ "column": 3,
196
+ "row": 1
197
+ }
198
+ },
199
+ {
200
+ "description": "Human attention is finite",
201
+ "emphasis": "normal",
202
+ "group": "enabled",
203
+ "id": "verify",
204
+ "kind": "service",
205
+ "label": "Verify & integrate",
206
+ "placement": {
207
+ "column": 2,
208
+ "row": 2
209
+ },
210
+ "role": "caution",
211
+ "style": {
212
+ "dash": "dashed",
213
+ "fill": "#fff0be",
214
+ "fontFamily": "IBM Plex Sans",
215
+ "fontSize": 18,
216
+ "radius": 0,
217
+ "secondary": "#657367",
218
+ "stroke": "#4a4a45",
219
+ "strokeWidth": 2,
220
+ "text": "#243b30"
221
+ }
222
+ },
223
+ {
224
+ "description": "Verified outcomes, not generated volume",
225
+ "emphasis": "normal",
226
+ "group": "enabled",
227
+ "id": "release",
228
+ "kind": "service",
229
+ "label": "Release with confidence",
230
+ "placement": {
231
+ "column": 2,
232
+ "row": 3
233
+ },
234
+ "role": "emphasis"
235
+ }
236
+ ],
237
+ "presentation": {
238
+ "designSystem": {
239
+ "canvas": {
240
+ "background": "#f7f5ef",
241
+ "border": "#d8ded4",
242
+ "secondary": "#69736b",
243
+ "text": "#242c29"
244
+ },
245
+ "edge": {
246
+ "arrowEnd": "filled",
247
+ "routing": "straight",
248
+ "stroke": "#64776a",
249
+ "strokeWidth": 1.6
250
+ },
251
+ "group": {
252
+ "dash": "solid",
253
+ "fill": "#eeeee5",
254
+ "radius": 4,
255
+ "stroke": "#cdd3c6",
256
+ "text": "#526849"
257
+ },
258
+ "id": "atelier",
259
+ "name": "Atelier / editorial",
260
+ "node": {
261
+ "fill": "#fffef9",
262
+ "fontFamily": "IBM Plex Sans",
263
+ "fontSize": 16,
264
+ "padding": 22,
265
+ "radius": 2,
266
+ "secondary": "#657367",
267
+ "shape": "rect",
268
+ "stroke": "#c7d0c3",
269
+ "text": "#243b30",
270
+ "width": 220
271
+ },
272
+ "revision": "1.0.0",
273
+ "roles": {
274
+ "caution": {
275
+ "fill": "#fae4b6",
276
+ "stroke": "#d8b977"
277
+ },
278
+ "emphasis": {
279
+ "fill": "#dce9b9",
280
+ "stroke": "#a7be78"
281
+ },
282
+ "quiet": {
283
+ "fill": "#eeeee8",
284
+ "stroke": "#d0d3c9"
285
+ }
286
+ },
287
+ "spacing": {
288
+ "layer": 80,
289
+ "node": 64
290
+ },
291
+ "version": 1
292
+ },
293
+ "nodes": {},
294
+ "theme": "paper"
295
+ },
296
+ "title": "More creation. The same verification bottleneck.",
297
+ "type": "diagram",
298
+ "version": 2
299
+ }
@@ -0,0 +1,123 @@
1
+ {
2
+ "description": "04 / DATA MODEL Keys and cardinalities describe ownership without hiding the data.",
3
+ "edges": [
4
+ {
5
+ "id": "customers-orders",
6
+ "label": "1 → many",
7
+ "source": "customers",
8
+ "style": "solid",
9
+ "target": "orders"
10
+ },
11
+ {
12
+ "id": "orders-items",
13
+ "label": "1 → many",
14
+ "source": "orders",
15
+ "style": "solid",
16
+ "target": "items"
17
+ },
18
+ {
19
+ "id": "products-items",
20
+ "label": "1 → many",
21
+ "source": "products",
22
+ "style": "solid",
23
+ "target": "items"
24
+ }
25
+ ],
26
+ "groups": [],
27
+ "layout": {
28
+ "direction": "RIGHT",
29
+ "spacing": "comfortable"
30
+ },
31
+ "nodes": [
32
+ {
33
+ "description": "PK customer_id\nname\nemail",
34
+ "emphasis": "normal",
35
+ "id": "customers",
36
+ "kind": "entity",
37
+ "label": "Customer"
38
+ },
39
+ {
40
+ "description": "PK order_id\nFK customer_id\nplaced_at · status",
41
+ "emphasis": "normal",
42
+ "id": "orders",
43
+ "kind": "entity",
44
+ "label": "Order",
45
+ "role": "emphasis"
46
+ },
47
+ {
48
+ "description": "PK item_id\nFK order_id\nFK product_id\nquantity · unit_price",
49
+ "emphasis": "normal",
50
+ "id": "items",
51
+ "kind": "entity",
52
+ "label": "Order item"
53
+ },
54
+ {
55
+ "description": "PK product_id\nname\ncurrent_price",
56
+ "emphasis": "normal",
57
+ "id": "products",
58
+ "kind": "entity",
59
+ "label": "Product"
60
+ }
61
+ ],
62
+ "presentation": {
63
+ "designSystem": {
64
+ "canvas": {
65
+ "background": "#f7f5ef",
66
+ "border": "#d8ded4",
67
+ "secondary": "#69736b",
68
+ "text": "#242c29"
69
+ },
70
+ "edge": {
71
+ "arrowEnd": "none",
72
+ "stroke": "#64776a",
73
+ "strokeWidth": 1.6
74
+ },
75
+ "group": {
76
+ "dash": "solid",
77
+ "fill": "#eeeee5",
78
+ "radius": 4,
79
+ "stroke": "#cdd3c6",
80
+ "text": "#526849"
81
+ },
82
+ "id": "atelier",
83
+ "name": "Atelier / editorial",
84
+ "node": {
85
+ "fill": "#fffef9",
86
+ "fontFamily": "IBM Plex Sans",
87
+ "fontSize": 16,
88
+ "padding": 22,
89
+ "radius": 2,
90
+ "secondary": "#657367",
91
+ "shape": "rect",
92
+ "stroke": "#c7d0c3",
93
+ "text": "#243b30",
94
+ "width": 240
95
+ },
96
+ "revision": "1.0.0",
97
+ "roles": {
98
+ "caution": {
99
+ "fill": "#fae4b6",
100
+ "stroke": "#d8b977"
101
+ },
102
+ "emphasis": {
103
+ "fill": "#dce9b9",
104
+ "stroke": "#a7be78"
105
+ },
106
+ "quiet": {
107
+ "fill": "#eeeee8",
108
+ "stroke": "#d0d3c9"
109
+ }
110
+ },
111
+ "spacing": {
112
+ "layer": 80,
113
+ "node": 44
114
+ },
115
+ "version": 1
116
+ },
117
+ "nodes": {},
118
+ "theme": "paper"
119
+ },
120
+ "title": "Orders are the center of the model",
121
+ "type": "diagram",
122
+ "version": 2
123
+ }
@@ -0,0 +1,158 @@
1
+ {
2
+ "description": "06 / EXPLORATION Read from the central question to the contributing capabilities.",
3
+ "edges": [
4
+ {
5
+ "id": "center-feedback",
6
+ "source": "center",
7
+ "style": "solid",
8
+ "target": "feedback"
9
+ },
10
+ {
11
+ "id": "center-flow",
12
+ "source": "center",
13
+ "style": "solid",
14
+ "target": "flow"
15
+ },
16
+ {
17
+ "id": "center-clarity",
18
+ "source": "center",
19
+ "style": "solid",
20
+ "target": "clarity"
21
+ },
22
+ {
23
+ "id": "center-safety",
24
+ "source": "center",
25
+ "style": "solid",
26
+ "target": "safety"
27
+ }
28
+ ],
29
+ "groups": [],
30
+ "layout": {
31
+ "direction": "RIGHT",
32
+ "mode": "grid",
33
+ "spacing": "comfortable"
34
+ },
35
+ "nodes": [
36
+ {
37
+ "description": "Fast feedback. Clear intent.",
38
+ "emphasis": "normal",
39
+ "id": "center",
40
+ "kind": "service",
41
+ "label": "Developer experience",
42
+ "placement": {
43
+ "column": 1,
44
+ "row": 1
45
+ },
46
+ "role": "emphasis",
47
+ "style": {
48
+ "shape": "ellipse",
49
+ "width": 270
50
+ }
51
+ },
52
+ {
53
+ "description": "Tests · preview · observability",
54
+ "emphasis": "normal",
55
+ "id": "feedback",
56
+ "kind": "service",
57
+ "label": "Feedback",
58
+ "placement": {
59
+ "column": 1,
60
+ "row": 0
61
+ }
62
+ },
63
+ {
64
+ "description": "Small batches · fewer handoffs",
65
+ "emphasis": "normal",
66
+ "id": "flow",
67
+ "kind": "service",
68
+ "label": "Flow",
69
+ "placement": {
70
+ "column": 0,
71
+ "row": 1
72
+ }
73
+ },
74
+ {
75
+ "description": "Ownership · documentation",
76
+ "emphasis": "normal",
77
+ "id": "clarity",
78
+ "kind": "service",
79
+ "label": "Clarity",
80
+ "placement": {
81
+ "column": 2,
82
+ "row": 1
83
+ }
84
+ },
85
+ {
86
+ "description": "Reversible changes · guardrails",
87
+ "emphasis": "normal",
88
+ "id": "safety",
89
+ "kind": "service",
90
+ "label": "Safety",
91
+ "placement": {
92
+ "column": 1,
93
+ "row": 2
94
+ }
95
+ }
96
+ ],
97
+ "presentation": {
98
+ "designSystem": {
99
+ "canvas": {
100
+ "background": "#f7f5ef",
101
+ "border": "#d8ded4",
102
+ "secondary": "#69736b",
103
+ "text": "#242c29"
104
+ },
105
+ "edge": {
106
+ "arrowEnd": "none",
107
+ "routing": "straight",
108
+ "stroke": "#64776a",
109
+ "strokeWidth": 1.6
110
+ },
111
+ "group": {
112
+ "dash": "solid",
113
+ "fill": "#eeeee5",
114
+ "radius": 4,
115
+ "stroke": "#cdd3c6",
116
+ "text": "#526849"
117
+ },
118
+ "id": "atelier",
119
+ "name": "Atelier / editorial",
120
+ "node": {
121
+ "fill": "#fffef9",
122
+ "fontFamily": "IBM Plex Sans",
123
+ "fontSize": 16,
124
+ "padding": 22,
125
+ "radius": 2,
126
+ "secondary": "#657367",
127
+ "shape": "rect",
128
+ "stroke": "#c7d0c3",
129
+ "text": "#243b30"
130
+ },
131
+ "revision": "1.0.0",
132
+ "roles": {
133
+ "caution": {
134
+ "fill": "#fae4b6",
135
+ "stroke": "#d8b977"
136
+ },
137
+ "emphasis": {
138
+ "fill": "#dce9b9",
139
+ "stroke": "#a7be78"
140
+ },
141
+ "quiet": {
142
+ "fill": "#eeeee8",
143
+ "stroke": "#d0d3c9"
144
+ }
145
+ },
146
+ "spacing": {
147
+ "layer": 80,
148
+ "node": 44
149
+ },
150
+ "version": 1
151
+ },
152
+ "nodes": {},
153
+ "theme": "paper"
154
+ },
155
+ "title": "What makes an effective developer experience?",
156
+ "type": "diagram",
157
+ "version": 2
158
+ }