digital-tools 2.1.1 → 2.3.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.
Files changed (293) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +2 -0
  3. package/dist/client.d.ts +109 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +69 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/define.d.ts +2 -2
  8. package/dist/define.d.ts.map +1 -1
  9. package/dist/define.js +22 -20
  10. package/dist/define.js.map +1 -1
  11. package/dist/function-ref.d.ts +229 -0
  12. package/dist/function-ref.d.ts.map +1 -0
  13. package/dist/function-ref.js +28 -0
  14. package/dist/function-ref.js.map +1 -0
  15. package/dist/function-sugar.d.ts +57 -0
  16. package/dist/function-sugar.d.ts.map +1 -0
  17. package/dist/function-sugar.js +79 -0
  18. package/dist/function-sugar.js.map +1 -0
  19. package/dist/index.d.ts +10 -3
  20. package/dist/index.d.ts.map +1 -1
  21. package/dist/index.js +24 -4
  22. package/dist/index.js.map +1 -1
  23. package/dist/providers/analytics/mixpanel.d.ts.map +1 -1
  24. package/dist/providers/analytics/mixpanel.js +21 -18
  25. package/dist/providers/analytics/mixpanel.js.map +1 -1
  26. package/dist/providers/calendar/cal-com.d.ts.map +1 -1
  27. package/dist/providers/calendar/cal-com.js +10 -10
  28. package/dist/providers/calendar/cal-com.js.map +1 -1
  29. package/dist/providers/calendar/google-calendar.d.ts.map +1 -1
  30. package/dist/providers/calendar/google-calendar.js +4 -4
  31. package/dist/providers/calendar/google-calendar.js.map +1 -1
  32. package/dist/providers/crm/hubspot.d.ts.map +1 -1
  33. package/dist/providers/crm/hubspot.js +107 -85
  34. package/dist/providers/crm/hubspot.js.map +1 -1
  35. package/dist/providers/development/github.d.ts.map +1 -1
  36. package/dist/providers/development/github.js +40 -43
  37. package/dist/providers/development/github.js.map +1 -1
  38. package/dist/providers/ecommerce/shopify.d.ts.map +1 -1
  39. package/dist/providers/ecommerce/shopify.js +79 -62
  40. package/dist/providers/ecommerce/shopify.js.map +1 -1
  41. package/dist/providers/email/resend.d.ts.map +1 -1
  42. package/dist/providers/email/resend.js +20 -16
  43. package/dist/providers/email/resend.js.map +1 -1
  44. package/dist/providers/email/sendgrid.d.ts.map +1 -1
  45. package/dist/providers/email/sendgrid.js +12 -9
  46. package/dist/providers/email/sendgrid.js.map +1 -1
  47. package/dist/providers/finance/stripe.d.ts.map +1 -1
  48. package/dist/providers/finance/stripe.js +44 -42
  49. package/dist/providers/finance/stripe.js.map +1 -1
  50. package/dist/providers/forms/typeform.d.ts.map +1 -1
  51. package/dist/providers/forms/typeform.js +68 -58
  52. package/dist/providers/forms/typeform.js.map +1 -1
  53. package/dist/providers/knowledge/notion.d.ts.map +1 -1
  54. package/dist/providers/knowledge/notion.js +75 -41
  55. package/dist/providers/knowledge/notion.js.map +1 -1
  56. package/dist/providers/marketing/mailchimp.d.ts.map +1 -1
  57. package/dist/providers/marketing/mailchimp.js +74 -61
  58. package/dist/providers/marketing/mailchimp.js.map +1 -1
  59. package/dist/providers/media/cloudinary.d.ts.map +1 -1
  60. package/dist/providers/media/cloudinary.js +30 -28
  61. package/dist/providers/media/cloudinary.js.map +1 -1
  62. package/dist/providers/messaging/slack.d.ts.map +1 -1
  63. package/dist/providers/messaging/slack.js +75 -58
  64. package/dist/providers/messaging/slack.js.map +1 -1
  65. package/dist/providers/messaging/twilio-sms.d.ts.map +1 -1
  66. package/dist/providers/messaging/twilio-sms.js +33 -15
  67. package/dist/providers/messaging/twilio-sms.js.map +1 -1
  68. package/dist/providers/project-management/linear.d.ts.map +1 -1
  69. package/dist/providers/project-management/linear.js +31 -27
  70. package/dist/providers/project-management/linear.js.map +1 -1
  71. package/dist/providers/spreadsheet/google-sheets.d.ts.map +1 -1
  72. package/dist/providers/spreadsheet/google-sheets.js +21 -18
  73. package/dist/providers/spreadsheet/google-sheets.js.map +1 -1
  74. package/dist/providers/spreadsheet/xlsx.d.ts.map +1 -1
  75. package/dist/providers/spreadsheet/xlsx.js +4 -4
  76. package/dist/providers/spreadsheet/xlsx.js.map +1 -1
  77. package/dist/providers/storage/index.js +1 -0
  78. package/dist/providers/storage/index.js.map +1 -1
  79. package/dist/providers/storage/s3.d.ts.map +1 -1
  80. package/dist/providers/storage/s3.js +36 -27
  81. package/dist/providers/storage/s3.js.map +1 -1
  82. package/dist/providers/support/zendesk.d.ts.map +1 -1
  83. package/dist/providers/support/zendesk.js +24 -25
  84. package/dist/providers/support/zendesk.js.map +1 -1
  85. package/dist/providers/tasks/todoist.d.ts.map +1 -1
  86. package/dist/providers/tasks/todoist.js +18 -18
  87. package/dist/providers/tasks/todoist.js.map +1 -1
  88. package/dist/providers/video-conferencing/google-meet.d.ts.map +1 -1
  89. package/dist/providers/video-conferencing/google-meet.js +11 -11
  90. package/dist/providers/video-conferencing/google-meet.js.map +1 -1
  91. package/dist/providers/video-conferencing/jitsi.js +14 -14
  92. package/dist/providers/video-conferencing/jitsi.js.map +1 -1
  93. package/dist/providers/video-conferencing/teams.d.ts.map +1 -1
  94. package/dist/providers/video-conferencing/teams.js +9 -7
  95. package/dist/providers/video-conferencing/teams.js.map +1 -1
  96. package/dist/providers/video-conferencing/zoom.d.ts.map +1 -1
  97. package/dist/providers/video-conferencing/zoom.js +26 -24
  98. package/dist/providers/video-conferencing/zoom.js.map +1 -1
  99. package/dist/tools/data.d.ts.map +1 -1
  100. package/dist/tools/data.js +5 -12
  101. package/dist/tools/data.js.map +1 -1
  102. package/dist/tools/index.d.ts +1 -0
  103. package/dist/tools/index.d.ts.map +1 -1
  104. package/dist/tools/index.js +1 -0
  105. package/dist/tools/index.js.map +1 -1
  106. package/dist/tools/system.d.ts +289 -0
  107. package/dist/tools/system.d.ts.map +1 -0
  108. package/dist/tools/system.js +752 -0
  109. package/dist/tools/system.js.map +1 -0
  110. package/dist/tools/web.d.ts.map +1 -1
  111. package/dist/tools/web.js +22 -10
  112. package/dist/tools/web.js.map +1 -1
  113. package/dist/track-record.d.ts +101 -0
  114. package/dist/track-record.d.ts.map +1 -0
  115. package/dist/track-record.js +17 -0
  116. package/dist/track-record.js.map +1 -0
  117. package/dist/types.d.ts +210 -9
  118. package/dist/types.d.ts.map +1 -1
  119. package/dist/verb-registration.d.ts +122 -0
  120. package/dist/verb-registration.d.ts.map +1 -0
  121. package/dist/verb-registration.js +176 -0
  122. package/dist/verb-registration.js.map +1 -0
  123. package/dist/worker.d.ts +93 -0
  124. package/dist/worker.d.ts.map +1 -0
  125. package/dist/worker.js +315 -0
  126. package/dist/worker.js.map +1 -0
  127. package/dist/wrap.d.ts +89 -0
  128. package/dist/wrap.d.ts.map +1 -0
  129. package/dist/wrap.js +225 -0
  130. package/dist/wrap.js.map +1 -0
  131. package/package.json +21 -4
  132. package/src/client.ts +136 -0
  133. package/src/define.ts +31 -37
  134. package/src/function-ref.ts +264 -0
  135. package/src/function-sugar.ts +134 -0
  136. package/src/index.ts +132 -10
  137. package/src/providers/analytics/mixpanel.ts +19 -18
  138. package/src/providers/calendar/cal-com.ts +29 -18
  139. package/src/providers/calendar/google-calendar.ts +20 -14
  140. package/src/providers/crm/hubspot.ts +225 -99
  141. package/src/providers/development/github.ts +206 -135
  142. package/src/providers/ecommerce/shopify.ts +250 -89
  143. package/src/providers/email/resend.ts +101 -28
  144. package/src/providers/email/sendgrid.ts +12 -9
  145. package/src/providers/finance/stripe.ts +128 -49
  146. package/src/providers/forms/typeform.ts +74 -58
  147. package/src/providers/knowledge/notion.ts +340 -88
  148. package/src/providers/marketing/mailchimp.ts +86 -70
  149. package/src/providers/media/cloudinary.ts +99 -41
  150. package/src/providers/messaging/slack.ts +283 -85
  151. package/src/providers/messaging/twilio-sms.ts +35 -15
  152. package/src/providers/project-management/linear.ts +143 -55
  153. package/src/providers/spreadsheet/google-sheets.ts +222 -56
  154. package/src/providers/spreadsheet/xlsx.ts +47 -16
  155. package/src/providers/storage/s3.ts +119 -47
  156. package/src/providers/support/zendesk.ts +196 -46
  157. package/src/providers/tasks/todoist.ts +20 -26
  158. package/src/providers/video-conferencing/google-meet.ts +17 -20
  159. package/src/providers/video-conferencing/jitsi.ts +14 -14
  160. package/src/providers/video-conferencing/teams.ts +14 -13
  161. package/src/providers/video-conferencing/zoom.ts +54 -49
  162. package/src/tools/data.ts +6 -16
  163. package/src/tools/index.ts +1 -0
  164. package/src/tools/system.ts +887 -0
  165. package/src/tools/web.ts +22 -10
  166. package/src/track-record.ts +106 -0
  167. package/src/types.ts +241 -13
  168. package/src/verb-registration.ts +197 -0
  169. package/src/worker.ts +370 -0
  170. package/src/wrap.ts +260 -0
  171. package/test/client.test.ts +146 -0
  172. package/test/communication-tools-extended.test.ts +734 -0
  173. package/test/data-tools-extended.test.ts +743 -0
  174. package/test/define-extended.test.ts +819 -0
  175. package/test/define.test.ts +150 -41
  176. package/test/entities.test.ts +623 -0
  177. package/test/extended-entities.test.ts +1228 -0
  178. package/test/provider-implementations.test.ts +725 -0
  179. package/test/provider-registry-extended.test.ts +583 -0
  180. package/test/providers/google-sheets.test.ts +851 -0
  181. package/test/providers/helpers.ts +554 -0
  182. package/test/providers/hubspot.test.ts +576 -0
  183. package/test/providers/slack.test.ts +932 -0
  184. package/test/providers/stripe.test.ts +701 -0
  185. package/test/providers.test.ts +578 -0
  186. package/test/system-tools-extended.test.ts +632 -0
  187. package/test/system.test.ts +673 -0
  188. package/test/tools.test.ts +15 -11
  189. package/test/types.test.ts +402 -0
  190. package/test/verb-registration.test.ts +395 -0
  191. package/test/web-tools.test.ts +553 -0
  192. package/test/worker-extended.test.ts +699 -0
  193. package/test/worker.test.ts +576 -0
  194. package/test/wrap.test.ts +366 -0
  195. package/tsconfig.json +3 -13
  196. package/vitest.config.ts +37 -0
  197. package/wrangler.jsonc +9 -0
  198. package/.turbo/turbo-build.log +0 -5
  199. package/dist/providers/voice/vapi.d.ts +0 -27
  200. package/dist/providers/voice/vapi.d.ts.map +0 -1
  201. package/dist/providers/voice/vapi.js +0 -440
  202. package/dist/providers/voice/vapi.js.map +0 -1
  203. package/src/define.js +0 -267
  204. package/src/entities/advertising.js +0 -999
  205. package/src/entities/ai.js +0 -756
  206. package/src/entities/analytics.js +0 -1588
  207. package/src/entities/automation.js +0 -601
  208. package/src/entities/communication.js +0 -1150
  209. package/src/entities/crm.js +0 -1386
  210. package/src/entities/design.js +0 -546
  211. package/src/entities/development.js +0 -2212
  212. package/src/entities/document.js +0 -874
  213. package/src/entities/ecommerce.js +0 -1429
  214. package/src/entities/experiment.js +0 -1039
  215. package/src/entities/finance.js +0 -3478
  216. package/src/entities/forms.js +0 -1892
  217. package/src/entities/hr.js +0 -661
  218. package/src/entities/identity.js +0 -997
  219. package/src/entities/index.js +0 -282
  220. package/src/entities/infrastructure.js +0 -1153
  221. package/src/entities/knowledge.js +0 -1438
  222. package/src/entities/marketing.js +0 -1610
  223. package/src/entities/media.js +0 -1634
  224. package/src/entities/notification.js +0 -1199
  225. package/src/entities/presentation.js +0 -1274
  226. package/src/entities/productivity.js +0 -1317
  227. package/src/entities/project-management.js +0 -1136
  228. package/src/entities/recruiting.js +0 -736
  229. package/src/entities/shipping.js +0 -509
  230. package/src/entities/signature.js +0 -1102
  231. package/src/entities/site.js +0 -222
  232. package/src/entities/spreadsheet.js +0 -1341
  233. package/src/entities/storage.js +0 -1198
  234. package/src/entities/support.js +0 -1166
  235. package/src/entities/video-conferencing.js +0 -1750
  236. package/src/entities/video.js +0 -950
  237. package/src/entities.js +0 -1663
  238. package/src/index.js +0 -74
  239. package/src/providers/analytics/index.js +0 -17
  240. package/src/providers/analytics/mixpanel.js +0 -255
  241. package/src/providers/calendar/cal-com.js +0 -303
  242. package/src/providers/calendar/google-calendar.js +0 -335
  243. package/src/providers/calendar/index.js +0 -20
  244. package/src/providers/crm/hubspot.js +0 -566
  245. package/src/providers/crm/index.js +0 -17
  246. package/src/providers/development/github.js +0 -472
  247. package/src/providers/development/index.js +0 -17
  248. package/src/providers/ecommerce/index.js +0 -17
  249. package/src/providers/ecommerce/shopify.js +0 -378
  250. package/src/providers/email/index.js +0 -20
  251. package/src/providers/email/resend.js +0 -258
  252. package/src/providers/email/sendgrid.js +0 -161
  253. package/src/providers/finance/index.js +0 -17
  254. package/src/providers/finance/stripe.js +0 -549
  255. package/src/providers/forms/index.js +0 -17
  256. package/src/providers/forms/typeform.js +0 -500
  257. package/src/providers/index.js +0 -123
  258. package/src/providers/knowledge/index.js +0 -17
  259. package/src/providers/knowledge/notion.js +0 -389
  260. package/src/providers/marketing/index.js +0 -17
  261. package/src/providers/marketing/mailchimp.js +0 -443
  262. package/src/providers/media/cloudinary.js +0 -318
  263. package/src/providers/media/index.js +0 -17
  264. package/src/providers/messaging/index.js +0 -20
  265. package/src/providers/messaging/slack.js +0 -393
  266. package/src/providers/messaging/twilio-sms.js +0 -249
  267. package/src/providers/project-management/index.js +0 -17
  268. package/src/providers/project-management/linear.js +0 -575
  269. package/src/providers/registry.js +0 -86
  270. package/src/providers/spreadsheet/google-sheets.js +0 -375
  271. package/src/providers/spreadsheet/index.js +0 -20
  272. package/src/providers/spreadsheet/xlsx.js +0 -423
  273. package/src/providers/storage/index.js +0 -24
  274. package/src/providers/storage/s3.js +0 -419
  275. package/src/providers/support/index.js +0 -17
  276. package/src/providers/support/zendesk.js +0 -373
  277. package/src/providers/tasks/index.js +0 -17
  278. package/src/providers/tasks/todoist.js +0 -286
  279. package/src/providers/types.js +0 -9
  280. package/src/providers/video-conferencing/google-meet.js +0 -286
  281. package/src/providers/video-conferencing/index.js +0 -31
  282. package/src/providers/video-conferencing/jitsi.js +0 -254
  283. package/src/providers/video-conferencing/teams.js +0 -270
  284. package/src/providers/video-conferencing/zoom.js +0 -332
  285. package/src/registry.js +0 -128
  286. package/src/tools/communication.js +0 -184
  287. package/src/tools/data.js +0 -205
  288. package/src/tools/index.js +0 -11
  289. package/src/tools/web.js +0 -137
  290. package/src/types.js +0 -10
  291. package/test/define.test.js +0 -306
  292. package/test/registry.test.js +0 -357
  293. package/test/tools.test.js +0 -363
@@ -1,546 +0,0 @@
1
- /**
2
- * Design Entity Types (Nouns)
3
- *
4
- * Design tool entities for files, components, design systems,
5
- * and collaboration (Figma, Sketch, etc.).
6
- *
7
- * @packageDocumentation
8
- */
9
- // =============================================================================
10
- // DesignFile
11
- // =============================================================================
12
- /**
13
- * DesignFile entity
14
- *
15
- * Represents a design file (Figma, Sketch, etc.).
16
- */
17
- export const DesignFile = {
18
- singular: 'design-file',
19
- plural: 'design-files',
20
- description: 'A design file',
21
- properties: {
22
- // Identity
23
- name: {
24
- type: 'string',
25
- description: 'File name',
26
- },
27
- key: {
28
- type: 'string',
29
- optional: true,
30
- description: 'Unique file key',
31
- },
32
- thumbnailUrl: {
33
- type: 'url',
34
- optional: true,
35
- description: 'Thumbnail URL',
36
- },
37
- // Type
38
- type: {
39
- type: 'string',
40
- optional: true,
41
- description: 'File type',
42
- examples: ['figma', 'sketch', 'xd', 'psd', 'ai', 'svg'],
43
- },
44
- // Version
45
- version: {
46
- type: 'string',
47
- optional: true,
48
- description: 'Current version',
49
- },
50
- lastModified: {
51
- type: 'datetime',
52
- optional: true,
53
- description: 'Last modified date',
54
- },
55
- // Content
56
- pageCount: {
57
- type: 'number',
58
- optional: true,
59
- description: 'Number of pages',
60
- },
61
- componentCount: {
62
- type: 'number',
63
- optional: true,
64
- description: 'Number of components',
65
- },
66
- // URLs
67
- editorUrl: {
68
- type: 'url',
69
- optional: true,
70
- description: 'Editor URL',
71
- },
72
- embedUrl: {
73
- type: 'url',
74
- optional: true,
75
- description: 'Embed URL',
76
- },
77
- },
78
- relationships: {
79
- project: {
80
- type: 'Project',
81
- required: false,
82
- description: 'Parent project',
83
- },
84
- owner: {
85
- type: 'User',
86
- description: 'File owner',
87
- },
88
- collaborators: {
89
- type: 'User[]',
90
- description: 'Collaborators',
91
- },
92
- components: {
93
- type: 'Component[]',
94
- description: 'Components in file',
95
- },
96
- },
97
- actions: [
98
- 'create',
99
- 'update',
100
- 'rename',
101
- 'duplicate',
102
- 'delete',
103
- 'share',
104
- 'export',
105
- 'version',
106
- ],
107
- events: [
108
- 'created',
109
- 'updated',
110
- 'renamed',
111
- 'duplicated',
112
- 'deleted',
113
- 'shared',
114
- 'exported',
115
- 'versioned',
116
- ],
117
- };
118
- // =============================================================================
119
- // Component
120
- // =============================================================================
121
- /**
122
- * Component entity
123
- *
124
- * Represents a reusable design component.
125
- */
126
- export const Component = {
127
- singular: 'component',
128
- plural: 'components',
129
- description: 'A reusable design component',
130
- properties: {
131
- // Identity
132
- name: {
133
- type: 'string',
134
- description: 'Component name',
135
- },
136
- key: {
137
- type: 'string',
138
- optional: true,
139
- description: 'Unique component key',
140
- },
141
- description: {
142
- type: 'string',
143
- optional: true,
144
- description: 'Component description',
145
- },
146
- // Categorization
147
- category: {
148
- type: 'string',
149
- optional: true,
150
- description: 'Component category',
151
- },
152
- tags: {
153
- type: 'string',
154
- array: true,
155
- optional: true,
156
- description: 'Tags',
157
- },
158
- // Properties
159
- properties: {
160
- type: 'json',
161
- optional: true,
162
- description: 'Component properties/variants',
163
- },
164
- // Visual
165
- thumbnailUrl: {
166
- type: 'url',
167
- optional: true,
168
- description: 'Thumbnail URL',
169
- },
170
- // Status
171
- status: {
172
- type: 'string',
173
- optional: true,
174
- description: 'Component status',
175
- examples: ['draft', 'review', 'approved', 'deprecated'],
176
- },
177
- isPublished: {
178
- type: 'boolean',
179
- optional: true,
180
- description: 'Whether published to library',
181
- },
182
- },
183
- relationships: {
184
- file: {
185
- type: 'DesignFile',
186
- description: 'Source file',
187
- },
188
- designSystem: {
189
- type: 'DesignSystem',
190
- required: false,
191
- description: 'Parent design system',
192
- },
193
- variants: {
194
- type: 'Component[]',
195
- description: 'Component variants',
196
- },
197
- },
198
- actions: [
199
- 'create',
200
- 'update',
201
- 'publish',
202
- 'unpublish',
203
- 'deprecate',
204
- 'delete',
205
- ],
206
- events: [
207
- 'created',
208
- 'updated',
209
- 'published',
210
- 'unpublished',
211
- 'deprecated',
212
- 'deleted',
213
- ],
214
- };
215
- // =============================================================================
216
- // DesignSystem
217
- // =============================================================================
218
- /**
219
- * DesignSystem entity
220
- *
221
- * Represents a design system or component library.
222
- */
223
- export const DesignSystem = {
224
- singular: 'design-system',
225
- plural: 'design-systems',
226
- description: 'A design system or component library',
227
- properties: {
228
- // Identity
229
- name: {
230
- type: 'string',
231
- description: 'Design system name',
232
- },
233
- description: {
234
- type: 'string',
235
- optional: true,
236
- description: 'Description',
237
- },
238
- version: {
239
- type: 'string',
240
- optional: true,
241
- description: 'Current version',
242
- },
243
- // Content
244
- componentCount: {
245
- type: 'number',
246
- optional: true,
247
- description: 'Number of components',
248
- },
249
- styleCount: {
250
- type: 'number',
251
- optional: true,
252
- description: 'Number of styles',
253
- },
254
- // URLs
255
- documentationUrl: {
256
- type: 'url',
257
- optional: true,
258
- description: 'Documentation URL',
259
- },
260
- // Status
261
- status: {
262
- type: 'string',
263
- optional: true,
264
- description: 'System status',
265
- examples: ['development', 'beta', 'stable', 'deprecated'],
266
- },
267
- },
268
- relationships: {
269
- components: {
270
- type: 'Component[]',
271
- description: 'Components in system',
272
- },
273
- styles: {
274
- type: 'Style[]',
275
- description: 'Styles in system',
276
- },
277
- maintainers: {
278
- type: 'User[]',
279
- description: 'System maintainers',
280
- },
281
- },
282
- actions: [
283
- 'create',
284
- 'update',
285
- 'publish',
286
- 'deprecate',
287
- ],
288
- events: [
289
- 'created',
290
- 'updated',
291
- 'published',
292
- 'versionReleased',
293
- 'deprecated',
294
- ],
295
- };
296
- // =============================================================================
297
- // Style
298
- // =============================================================================
299
- /**
300
- * Style entity
301
- *
302
- * Represents a design style (color, typography, effect).
303
- */
304
- export const Style = {
305
- singular: 'style',
306
- plural: 'styles',
307
- description: 'A design style (color, typography, effect)',
308
- properties: {
309
- // Identity
310
- name: {
311
- type: 'string',
312
- description: 'Style name',
313
- },
314
- key: {
315
- type: 'string',
316
- optional: true,
317
- description: 'Unique style key',
318
- },
319
- description: {
320
- type: 'string',
321
- optional: true,
322
- description: 'Style description',
323
- },
324
- // Type
325
- type: {
326
- type: 'string',
327
- description: 'Style type',
328
- examples: ['color', 'typography', 'effect', 'grid'],
329
- },
330
- // Value
331
- value: {
332
- type: 'json',
333
- description: 'Style value/definition',
334
- },
335
- // Categorization
336
- category: {
337
- type: 'string',
338
- optional: true,
339
- description: 'Category (e.g., primary, semantic)',
340
- },
341
- },
342
- relationships: {
343
- designSystem: {
344
- type: 'DesignSystem',
345
- required: false,
346
- description: 'Parent design system',
347
- },
348
- file: {
349
- type: 'DesignFile',
350
- required: false,
351
- description: 'Source file',
352
- },
353
- },
354
- actions: [
355
- 'create',
356
- 'update',
357
- 'delete',
358
- 'publish',
359
- ],
360
- events: [
361
- 'created',
362
- 'updated',
363
- 'deleted',
364
- 'published',
365
- ],
366
- };
367
- // =============================================================================
368
- // Prototype
369
- // =============================================================================
370
- /**
371
- * Prototype entity
372
- *
373
- * Represents an interactive prototype.
374
- */
375
- export const Prototype = {
376
- singular: 'prototype',
377
- plural: 'prototypes',
378
- description: 'An interactive prototype',
379
- properties: {
380
- // Identity
381
- name: {
382
- type: 'string',
383
- description: 'Prototype name',
384
- },
385
- description: {
386
- type: 'string',
387
- optional: true,
388
- description: 'Prototype description',
389
- },
390
- // Configuration
391
- startingFrame: {
392
- type: 'string',
393
- optional: true,
394
- description: 'Starting frame/screen',
395
- },
396
- device: {
397
- type: 'string',
398
- optional: true,
399
- description: 'Target device',
400
- examples: ['desktop', 'tablet', 'mobile', 'watch'],
401
- },
402
- // URLs
403
- previewUrl: {
404
- type: 'url',
405
- optional: true,
406
- description: 'Preview URL',
407
- },
408
- embedUrl: {
409
- type: 'url',
410
- optional: true,
411
- description: 'Embed URL',
412
- },
413
- // Status
414
- status: {
415
- type: 'string',
416
- optional: true,
417
- description: 'Prototype status',
418
- examples: ['draft', 'review', 'approved'],
419
- },
420
- },
421
- relationships: {
422
- file: {
423
- type: 'DesignFile',
424
- description: 'Source file',
425
- },
426
- },
427
- actions: [
428
- 'create',
429
- 'update',
430
- 'share',
431
- 'present',
432
- ],
433
- events: [
434
- 'created',
435
- 'updated',
436
- 'shared',
437
- 'presented',
438
- 'viewed',
439
- ],
440
- };
441
- // =============================================================================
442
- // DesignComment
443
- // =============================================================================
444
- /**
445
- * DesignComment entity
446
- *
447
- * Represents a comment on a design.
448
- */
449
- export const DesignComment = {
450
- singular: 'design-comment',
451
- plural: 'design-comments',
452
- description: 'A comment on a design',
453
- properties: {
454
- // Content
455
- message: {
456
- type: 'string',
457
- description: 'Comment text',
458
- },
459
- // Position
460
- x: {
461
- type: 'number',
462
- optional: true,
463
- description: 'X coordinate',
464
- },
465
- y: {
466
- type: 'number',
467
- optional: true,
468
- description: 'Y coordinate',
469
- },
470
- frameId: {
471
- type: 'string',
472
- optional: true,
473
- description: 'Frame/artboard ID',
474
- },
475
- // Status
476
- status: {
477
- type: 'string',
478
- optional: true,
479
- description: 'Comment status',
480
- examples: ['open', 'resolved'],
481
- },
482
- resolvedAt: {
483
- type: 'datetime',
484
- optional: true,
485
- description: 'When resolved',
486
- },
487
- },
488
- relationships: {
489
- file: {
490
- type: 'DesignFile',
491
- description: 'Design file',
492
- },
493
- author: {
494
- type: 'User',
495
- description: 'Comment author',
496
- },
497
- parent: {
498
- type: 'DesignComment',
499
- required: false,
500
- description: 'Parent comment (for replies)',
501
- },
502
- replies: {
503
- type: 'DesignComment[]',
504
- description: 'Replies',
505
- },
506
- resolvedBy: {
507
- type: 'User',
508
- required: false,
509
- description: 'Who resolved',
510
- },
511
- },
512
- actions: [
513
- 'create',
514
- 'update',
515
- 'delete',
516
- 'resolve',
517
- 'reopen',
518
- 'reply',
519
- ],
520
- events: [
521
- 'created',
522
- 'updated',
523
- 'deleted',
524
- 'resolved',
525
- 'reopened',
526
- 'replied',
527
- ],
528
- };
529
- // =============================================================================
530
- // Exports
531
- // =============================================================================
532
- export const DesignEntities = {
533
- DesignFile,
534
- Component,
535
- DesignSystem,
536
- Style,
537
- Prototype,
538
- DesignComment,
539
- };
540
- export const DesignCategories = {
541
- files: ['DesignFile'],
542
- components: ['Component', 'DesignSystem'],
543
- styles: ['Style'],
544
- prototypes: ['Prototype'],
545
- collaboration: ['DesignComment'],
546
- };