digital-tools 2.1.3 → 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 (294) hide show
  1. package/CHANGELOG.md +9 -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 +21 -11
  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 +31 -14
  132. package/src/client.ts +136 -0
  133. package/src/define.ts +30 -24
  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 -4
  199. package/LICENSE +0 -21
  200. package/dist/providers/voice/vapi.d.ts +0 -27
  201. package/dist/providers/voice/vapi.d.ts.map +0 -1
  202. package/dist/providers/voice/vapi.js +0 -440
  203. package/dist/providers/voice/vapi.js.map +0 -1
  204. package/src/define.js +0 -259
  205. package/src/entities/advertising.js +0 -999
  206. package/src/entities/ai.js +0 -756
  207. package/src/entities/analytics.js +0 -1588
  208. package/src/entities/automation.js +0 -601
  209. package/src/entities/communication.js +0 -1150
  210. package/src/entities/crm.js +0 -1386
  211. package/src/entities/design.js +0 -546
  212. package/src/entities/development.js +0 -2212
  213. package/src/entities/document.js +0 -874
  214. package/src/entities/ecommerce.js +0 -1429
  215. package/src/entities/experiment.js +0 -1039
  216. package/src/entities/finance.js +0 -3478
  217. package/src/entities/forms.js +0 -1892
  218. package/src/entities/hr.js +0 -661
  219. package/src/entities/identity.js +0 -997
  220. package/src/entities/index.js +0 -282
  221. package/src/entities/infrastructure.js +0 -1153
  222. package/src/entities/knowledge.js +0 -1438
  223. package/src/entities/marketing.js +0 -1610
  224. package/src/entities/media.js +0 -1634
  225. package/src/entities/notification.js +0 -1199
  226. package/src/entities/presentation.js +0 -1274
  227. package/src/entities/productivity.js +0 -1317
  228. package/src/entities/project-management.js +0 -1136
  229. package/src/entities/recruiting.js +0 -736
  230. package/src/entities/shipping.js +0 -509
  231. package/src/entities/signature.js +0 -1102
  232. package/src/entities/site.js +0 -222
  233. package/src/entities/spreadsheet.js +0 -1341
  234. package/src/entities/storage.js +0 -1198
  235. package/src/entities/support.js +0 -1166
  236. package/src/entities/video-conferencing.js +0 -1750
  237. package/src/entities/video.js +0 -950
  238. package/src/entities.js +0 -1663
  239. package/src/index.js +0 -74
  240. package/src/providers/analytics/index.js +0 -17
  241. package/src/providers/analytics/mixpanel.js +0 -255
  242. package/src/providers/calendar/cal-com.js +0 -303
  243. package/src/providers/calendar/google-calendar.js +0 -335
  244. package/src/providers/calendar/index.js +0 -20
  245. package/src/providers/crm/hubspot.js +0 -566
  246. package/src/providers/crm/index.js +0 -17
  247. package/src/providers/development/github.js +0 -472
  248. package/src/providers/development/index.js +0 -17
  249. package/src/providers/ecommerce/index.js +0 -17
  250. package/src/providers/ecommerce/shopify.js +0 -378
  251. package/src/providers/email/index.js +0 -20
  252. package/src/providers/email/resend.js +0 -258
  253. package/src/providers/email/sendgrid.js +0 -161
  254. package/src/providers/finance/index.js +0 -17
  255. package/src/providers/finance/stripe.js +0 -549
  256. package/src/providers/forms/index.js +0 -17
  257. package/src/providers/forms/typeform.js +0 -500
  258. package/src/providers/index.js +0 -123
  259. package/src/providers/knowledge/index.js +0 -17
  260. package/src/providers/knowledge/notion.js +0 -389
  261. package/src/providers/marketing/index.js +0 -17
  262. package/src/providers/marketing/mailchimp.js +0 -443
  263. package/src/providers/media/cloudinary.js +0 -318
  264. package/src/providers/media/index.js +0 -17
  265. package/src/providers/messaging/index.js +0 -20
  266. package/src/providers/messaging/slack.js +0 -393
  267. package/src/providers/messaging/twilio-sms.js +0 -249
  268. package/src/providers/project-management/index.js +0 -17
  269. package/src/providers/project-management/linear.js +0 -575
  270. package/src/providers/registry.js +0 -86
  271. package/src/providers/spreadsheet/google-sheets.js +0 -375
  272. package/src/providers/spreadsheet/index.js +0 -20
  273. package/src/providers/spreadsheet/xlsx.js +0 -423
  274. package/src/providers/storage/index.js +0 -24
  275. package/src/providers/storage/s3.js +0 -419
  276. package/src/providers/support/index.js +0 -17
  277. package/src/providers/support/zendesk.js +0 -373
  278. package/src/providers/tasks/index.js +0 -17
  279. package/src/providers/tasks/todoist.js +0 -286
  280. package/src/providers/types.js +0 -9
  281. package/src/providers/video-conferencing/google-meet.js +0 -286
  282. package/src/providers/video-conferencing/index.js +0 -31
  283. package/src/providers/video-conferencing/jitsi.js +0 -254
  284. package/src/providers/video-conferencing/teams.js +0 -270
  285. package/src/providers/video-conferencing/zoom.js +0 -332
  286. package/src/registry.js +0 -128
  287. package/src/tools/communication.js +0 -184
  288. package/src/tools/data.js +0 -205
  289. package/src/tools/index.js +0 -11
  290. package/src/tools/web.js +0 -137
  291. package/src/types.js +0 -10
  292. package/test/define.test.js +0 -306
  293. package/test/registry.test.js +0 -357
  294. 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
- };