@mostra/protocol 0.13.0 → 0.15.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 (125) hide show
  1. package/dist/artifact-path.d.ts +22 -0
  2. package/dist/artifact-path.d.ts.map +1 -0
  3. package/dist/artifact-path.js +39 -0
  4. package/dist/artifact-path.js.map +1 -0
  5. package/dist/diagnostics/codes/index.d.ts +5 -2
  6. package/dist/diagnostics/codes/index.d.ts.map +1 -1
  7. package/dist/diagnostics/codes/index.js +7 -1
  8. package/dist/diagnostics/codes/index.js.map +1 -1
  9. package/dist/diagnostics/codes/license.d.ts +8 -0
  10. package/dist/diagnostics/codes/license.d.ts.map +1 -0
  11. package/dist/diagnostics/codes/license.js +55 -0
  12. package/dist/diagnostics/codes/license.js.map +1 -0
  13. package/dist/diagnostics/codes/pack.d.ts +8 -0
  14. package/dist/diagnostics/codes/pack.d.ts.map +1 -0
  15. package/dist/diagnostics/codes/pack.js +110 -0
  16. package/dist/diagnostics/codes/pack.js.map +1 -0
  17. package/dist/diagnostics/codes/plugin.d.ts +8 -0
  18. package/dist/diagnostics/codes/plugin.d.ts.map +1 -0
  19. package/dist/diagnostics/codes/plugin.js +154 -0
  20. package/dist/diagnostics/codes/plugin.js.map +1 -0
  21. package/dist/diagnostics/diagnostic.d.ts +1 -1
  22. package/dist/diagnostics/diagnostic.d.ts.map +1 -1
  23. package/dist/diagnostics/diagnostic.js +4 -1
  24. package/dist/diagnostics/diagnostic.js.map +1 -1
  25. package/dist/index.d.ts +13 -1
  26. package/dist/index.js +13 -1
  27. package/dist/methods/deps/add.d.ts +6 -0
  28. package/dist/methods/deps/add.d.ts.map +1 -1
  29. package/dist/methods/deps/add.js +1 -0
  30. package/dist/methods/deps/add.js.map +1 -1
  31. package/dist/methods/index.d.ts.map +1 -1
  32. package/dist/methods/index.js +15 -1
  33. package/dist/methods/index.js.map +1 -1
  34. package/dist/methods/mostra/initialize.d.ts +7 -0
  35. package/dist/methods/mostra/initialize.d.ts.map +1 -1
  36. package/dist/methods/mostra/initialize.js +4 -2
  37. package/dist/methods/mostra/initialize.js.map +1 -1
  38. package/dist/methods/pack/add.d.ts +80 -0
  39. package/dist/methods/pack/add.d.ts.map +1 -0
  40. package/dist/methods/pack/add.js +59 -0
  41. package/dist/methods/pack/add.js.map +1 -0
  42. package/dist/methods/plugin/add.d.ts +43 -0
  43. package/dist/methods/plugin/add.d.ts.map +1 -0
  44. package/dist/methods/plugin/add.js +39 -0
  45. package/dist/methods/plugin/add.js.map +1 -0
  46. package/dist/methods/plugin/commands.d.ts +38 -0
  47. package/dist/methods/plugin/commands.d.ts.map +1 -0
  48. package/dist/methods/plugin/commands.js +33 -0
  49. package/dist/methods/plugin/commands.js.map +1 -0
  50. package/dist/methods/plugin/export.d.ts +58 -0
  51. package/dist/methods/plugin/export.d.ts.map +1 -0
  52. package/dist/methods/plugin/export.js +57 -0
  53. package/dist/methods/plugin/export.js.map +1 -0
  54. package/dist/methods/plugin/list.d.ts +26 -0
  55. package/dist/methods/plugin/list.d.ts.map +1 -0
  56. package/dist/methods/plugin/list.js +30 -0
  57. package/dist/methods/plugin/list.js.map +1 -0
  58. package/dist/methods/plugin/remove.d.ts +32 -0
  59. package/dist/methods/plugin/remove.d.ts.map +1 -0
  60. package/dist/methods/plugin/remove.js +33 -0
  61. package/dist/methods/plugin/remove.js.map +1 -0
  62. package/dist/methods/plugin/validate.d.ts +35 -0
  63. package/dist/methods/plugin/validate.d.ts.map +1 -0
  64. package/dist/methods/plugin/validate.js +33 -0
  65. package/dist/methods/plugin/validate.js.map +1 -0
  66. package/dist/plugin/contract-versions.generated.js +14 -0
  67. package/dist/plugin/contract-versions.generated.js.map +1 -0
  68. package/dist/plugin/contracts.d.ts +51 -0
  69. package/dist/plugin/contracts.d.ts.map +1 -0
  70. package/dist/plugin/contracts.js +129 -0
  71. package/dist/plugin/contracts.js.map +1 -0
  72. package/dist/plugin/license.d.ts +87 -0
  73. package/dist/plugin/license.d.ts.map +1 -0
  74. package/dist/plugin/license.js +243 -0
  75. package/dist/plugin/license.js.map +1 -0
  76. package/dist/plugin/manifest.d.ts +141 -0
  77. package/dist/plugin/manifest.d.ts.map +1 -0
  78. package/dist/plugin/manifest.js +281 -0
  79. package/dist/plugin/manifest.js.map +1 -0
  80. package/dist/plugin/registry-item.d.ts +171 -0
  81. package/dist/plugin/registry-item.d.ts.map +1 -0
  82. package/dist/plugin/registry-item.js +162 -0
  83. package/dist/plugin/registry-item.js.map +1 -0
  84. package/dist/plugin/spdx.generated.d.ts +9 -0
  85. package/dist/plugin/spdx.generated.d.ts.map +1 -0
  86. package/dist/plugin/spdx.generated.js +846 -0
  87. package/dist/plugin/spdx.generated.js.map +1 -0
  88. package/dist/plugin.d.ts +7 -0
  89. package/dist/plugin.js +6 -0
  90. package/dist/plugins.d.ts +118 -0
  91. package/dist/plugins.d.ts.map +1 -0
  92. package/dist/plugins.js +109 -0
  93. package/dist/plugins.js.map +1 -0
  94. package/package.json +19 -4
  95. package/schemas/plugin-manifest.draft-07.json +611 -0
  96. package/schemas/plugin-manifest.schema.json +607 -0
  97. package/schemas/protocol.draft-07.json +899 -1
  98. package/schemas/protocol.schema.json +875 -1
  99. package/src/artifact-path.ts +46 -0
  100. package/src/diagnostics/codes/index.ts +14 -2
  101. package/src/diagnostics/codes/license.ts +65 -0
  102. package/src/diagnostics/codes/pack.ts +125 -0
  103. package/src/diagnostics/codes/plugin.ts +173 -0
  104. package/src/diagnostics/diagnostic.ts +7 -1
  105. package/src/index.ts +57 -0
  106. package/src/methods/deps/add.ts +7 -0
  107. package/src/methods/index.ts +14 -0
  108. package/src/methods/mostra/initialize.ts +9 -1
  109. package/src/methods/pack/add.ts +133 -0
  110. package/src/methods/plugin/add.ts +70 -0
  111. package/src/methods/plugin/commands.ts +67 -0
  112. package/src/methods/plugin/export.ts +100 -0
  113. package/src/methods/plugin/list.ts +45 -0
  114. package/src/methods/plugin/remove.ts +58 -0
  115. package/src/methods/plugin/validate.ts +60 -0
  116. package/src/plugin/contract-versions.generated.ts +15 -0
  117. package/src/plugin/contracts.ts +171 -0
  118. package/src/plugin/license.ts +320 -0
  119. package/src/plugin/manifest.ts +546 -0
  120. package/src/plugin/registry-item.ts +330 -0
  121. package/src/plugin/spdx-tables.ts +74 -0
  122. package/src/plugin/spdx.generated.ts +844 -0
  123. package/src/plugin.ts +77 -0
  124. package/src/plugins.ts +239 -0
  125. package/LICENSE +0 -202
@@ -0,0 +1,607 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "title": "Mostra plugin manifest (the \"mostra\" key of package.json) and source pack items (D30)",
4
+ "x-mostra-revisions": {
5
+ "plugin-manifest": "2026-11-14"
6
+ },
7
+ "$defs": {
8
+ "BundledLicense": {
9
+ "type": "object",
10
+ "properties": {
11
+ "package": {
12
+ "type": "string",
13
+ "minLength": 1,
14
+ "maxLength": 214
15
+ },
16
+ "license": {
17
+ "type": "string",
18
+ "minLength": 1,
19
+ "maxLength": 512
20
+ },
21
+ "class": {
22
+ "type": "string",
23
+ "enum": [
24
+ "osi-permissive",
25
+ "osi-copyleft",
26
+ "public-domain",
27
+ "free",
28
+ "source-available",
29
+ "proprietary",
30
+ "unknown"
31
+ ]
32
+ },
33
+ "summary": {
34
+ "type": "string",
35
+ "maxLength": 400
36
+ },
37
+ "url": {
38
+ "type": "string",
39
+ "format": "uri"
40
+ }
41
+ },
42
+ "required": [
43
+ "package",
44
+ "license"
45
+ ],
46
+ "additionalProperties": {}
47
+ },
48
+ "PackMostraBlock": {
49
+ "type": "object",
50
+ "properties": {
51
+ "base": {
52
+ "type": "string",
53
+ "enum": [
54
+ "base",
55
+ "radix"
56
+ ]
57
+ },
58
+ "variants": {
59
+ "type": "object",
60
+ "propertyNames": {
61
+ "type": "string",
62
+ "enum": [
63
+ "base",
64
+ "radix"
65
+ ]
66
+ },
67
+ "additionalProperties": {
68
+ "type": "string",
69
+ "minLength": 1
70
+ }
71
+ },
72
+ "fields": {
73
+ "readOnly": true,
74
+ "type": "array",
75
+ "items": {
76
+ "type": "string",
77
+ "minLength": 1
78
+ }
79
+ },
80
+ "baselines": {
81
+ "type": "string",
82
+ "minLength": 1
83
+ },
84
+ "license": {
85
+ "type": "string",
86
+ "minLength": 1,
87
+ "maxLength": 512
88
+ },
89
+ "licenseClass": {
90
+ "type": "string",
91
+ "enum": [
92
+ "osi-permissive",
93
+ "osi-copyleft",
94
+ "public-domain",
95
+ "free",
96
+ "source-available",
97
+ "proprietary",
98
+ "unknown"
99
+ ]
100
+ }
101
+ },
102
+ "additionalProperties": {},
103
+ "description": "What a Mostra pack adds to a shadcn registry item: its base, variants, fields, baselines and license."
104
+ },
105
+ "PluginCommandEntry": {
106
+ "type": "object",
107
+ "properties": {
108
+ "command": {
109
+ "type": "string",
110
+ "pattern": "^[a-z][a-z0-9-]{0,31}(?: [a-z][a-z0-9-]{0,31}){0,3}$"
111
+ },
112
+ "entry": {
113
+ "type": "string",
114
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
115
+ },
116
+ "export": {
117
+ "type": "string",
118
+ "pattern": "^[A-Za-z_$][\\w$]*$"
119
+ }
120
+ },
121
+ "required": [
122
+ "command",
123
+ "entry"
124
+ ],
125
+ "additionalProperties": {}
126
+ },
127
+ "PluginContributes": {
128
+ "type": "object",
129
+ "properties": {
130
+ "embedEngines": {
131
+ "readOnly": true,
132
+ "type": "array",
133
+ "items": {
134
+ "$ref": "#/$defs/PluginEntry"
135
+ }
136
+ },
137
+ "exporters": {
138
+ "readOnly": true,
139
+ "type": "array",
140
+ "items": {
141
+ "$ref": "#/$defs/PluginEntry"
142
+ }
143
+ },
144
+ "verifyChecks": {
145
+ "readOnly": true,
146
+ "type": "array",
147
+ "items": {
148
+ "$ref": "#/$defs/PluginEntry"
149
+ }
150
+ },
151
+ "anchorProviders": {
152
+ "readOnly": true,
153
+ "type": "array",
154
+ "items": {
155
+ "$ref": "#/$defs/PluginEntry"
156
+ }
157
+ },
158
+ "connectors": {
159
+ "readOnly": true,
160
+ "type": "array",
161
+ "items": {
162
+ "$ref": "#/$defs/PluginEntry"
163
+ }
164
+ },
165
+ "cliCommands": {
166
+ "readOnly": true,
167
+ "type": "array",
168
+ "items": {
169
+ "$ref": "#/$defs/PluginCommandEntry"
170
+ }
171
+ },
172
+ "packs": {
173
+ "readOnly": true,
174
+ "type": "array",
175
+ "items": {
176
+ "$ref": "#/$defs/PluginPackEntry"
177
+ }
178
+ }
179
+ },
180
+ "additionalProperties": {}
181
+ },
182
+ "PluginEntry": {
183
+ "type": "object",
184
+ "properties": {
185
+ "id": {
186
+ "type": "string",
187
+ "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
188
+ },
189
+ "entry": {
190
+ "type": "string",
191
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
192
+ },
193
+ "export": {
194
+ "type": "string",
195
+ "pattern": "^[A-Za-z_$][\\w$]*$"
196
+ }
197
+ },
198
+ "required": [
199
+ "id",
200
+ "entry"
201
+ ],
202
+ "additionalProperties": {}
203
+ },
204
+ "PluginExample": {
205
+ "type": "object",
206
+ "properties": {
207
+ "id": {
208
+ "type": "string",
209
+ "pattern": "^[a-z0-9][a-z0-9._-]{0,63}$"
210
+ },
211
+ "path": {
212
+ "type": "string",
213
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
214
+ },
215
+ "baselines": {
216
+ "type": "string",
217
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
218
+ }
219
+ },
220
+ "required": [
221
+ "id",
222
+ "path"
223
+ ],
224
+ "additionalProperties": {}
225
+ },
226
+ "PluginManifest": {
227
+ "type": "object",
228
+ "properties": {
229
+ "name": {
230
+ "type": "string",
231
+ "pattern": "^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+\\/[a-z0-9][a-z0-9._-]{0,63}$"
232
+ },
233
+ "title": {
234
+ "type": "string",
235
+ "minLength": 1,
236
+ "maxLength": 80
237
+ },
238
+ "description": {
239
+ "type": "string",
240
+ "maxLength": 400
241
+ },
242
+ "contracts": {
243
+ "type": "object",
244
+ "propertyNames": {
245
+ "type": "string",
246
+ "enum": [
247
+ "embed-engine",
248
+ "exporter",
249
+ "verify-check",
250
+ "anchor-provider",
251
+ "connector",
252
+ "cli-command"
253
+ ]
254
+ },
255
+ "additionalProperties": {
256
+ "type": "string",
257
+ "minLength": 1,
258
+ "maxLength": 128
259
+ }
260
+ },
261
+ "contributes": {
262
+ "$ref": "#/$defs/PluginContributes"
263
+ },
264
+ "effects": {
265
+ "readOnly": true,
266
+ "type": "array",
267
+ "items": {
268
+ "type": "string"
269
+ }
270
+ },
271
+ "license": {
272
+ "type": "string",
273
+ "minLength": 1,
274
+ "maxLength": 512
275
+ },
276
+ "bundledLicenses": {
277
+ "readOnly": true,
278
+ "type": "array",
279
+ "items": {
280
+ "$ref": "#/$defs/BundledLicense"
281
+ }
282
+ },
283
+ "skills": {
284
+ "readOnly": true,
285
+ "type": "array",
286
+ "items": {
287
+ "type": "string",
288
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
289
+ }
290
+ },
291
+ "examples": {
292
+ "readOnly": true,
293
+ "type": "array",
294
+ "items": {
295
+ "$ref": "#/$defs/PluginExample"
296
+ }
297
+ },
298
+ "platforms": {
299
+ "readOnly": true,
300
+ "type": "array",
301
+ "items": {
302
+ "type": "string"
303
+ }
304
+ }
305
+ },
306
+ "required": [
307
+ "name",
308
+ "contracts",
309
+ "contributes",
310
+ "license"
311
+ ],
312
+ "additionalProperties": {},
313
+ "description": "The \"mostra\" key of a Mostra plugin's package.json (D30): its name, contract ranges, contributions, declared effects and licenses."
314
+ },
315
+ "PluginPackEntry": {
316
+ "type": "object",
317
+ "properties": {
318
+ "item": {
319
+ "type": "string",
320
+ "pattern": "^\\.\\/(?!.*(?:^|\\/)\\.\\.?(?:\\/|$))[^\\\\:*?\"<>|\\0]+$"
321
+ }
322
+ },
323
+ "required": [
324
+ "item"
325
+ ],
326
+ "additionalProperties": {}
327
+ },
328
+ "Registry": {
329
+ "type": "object",
330
+ "properties": {
331
+ "name": {
332
+ "type": "string"
333
+ },
334
+ "homepage": {
335
+ "type": "string"
336
+ },
337
+ "include": {
338
+ "readOnly": true,
339
+ "type": "array",
340
+ "items": {
341
+ "type": "string",
342
+ "minLength": 1
343
+ }
344
+ },
345
+ "items": {
346
+ "readOnly": true,
347
+ "type": "array",
348
+ "items": {
349
+ "$ref": "#/$defs/RegistryItem"
350
+ }
351
+ }
352
+ },
353
+ "additionalProperties": {}
354
+ },
355
+ "RegistryFile": {
356
+ "type": "object",
357
+ "properties": {
358
+ "path": {
359
+ "type": "string",
360
+ "minLength": 1
361
+ },
362
+ "content": {
363
+ "type": "string"
364
+ },
365
+ "type": {
366
+ "type": "string",
367
+ "minLength": 1
368
+ },
369
+ "target": {
370
+ "type": "string"
371
+ }
372
+ },
373
+ "required": [
374
+ "path",
375
+ "type"
376
+ ],
377
+ "additionalProperties": {}
378
+ },
379
+ "RegistryItem": {
380
+ "type": "object",
381
+ "properties": {
382
+ "$schema": {
383
+ "type": "string"
384
+ },
385
+ "name": {
386
+ "type": "string",
387
+ "minLength": 1
388
+ },
389
+ "type": {
390
+ "type": "string",
391
+ "minLength": 1
392
+ },
393
+ "title": {
394
+ "type": "string"
395
+ },
396
+ "description": {
397
+ "type": "string"
398
+ },
399
+ "author": {
400
+ "type": "string"
401
+ },
402
+ "dependencies": {
403
+ "readOnly": true,
404
+ "type": "array",
405
+ "items": {
406
+ "type": "string",
407
+ "minLength": 1
408
+ }
409
+ },
410
+ "devDependencies": {
411
+ "readOnly": true,
412
+ "type": "array",
413
+ "items": {
414
+ "type": "string",
415
+ "minLength": 1
416
+ }
417
+ },
418
+ "registryDependencies": {
419
+ "readOnly": true,
420
+ "type": "array",
421
+ "items": {
422
+ "type": "string",
423
+ "minLength": 1
424
+ }
425
+ },
426
+ "files": {
427
+ "readOnly": true,
428
+ "type": "array",
429
+ "items": {
430
+ "$ref": "#/$defs/RegistryFile"
431
+ }
432
+ },
433
+ "tailwind": {
434
+ "type": "object",
435
+ "propertyNames": {
436
+ "type": "string"
437
+ },
438
+ "additionalProperties": {}
439
+ },
440
+ "cssVars": {
441
+ "type": "object",
442
+ "properties": {
443
+ "theme": {
444
+ "type": "object",
445
+ "propertyNames": {
446
+ "type": "string"
447
+ },
448
+ "additionalProperties": {
449
+ "type": "string"
450
+ }
451
+ },
452
+ "light": {
453
+ "type": "object",
454
+ "propertyNames": {
455
+ "type": "string"
456
+ },
457
+ "additionalProperties": {
458
+ "type": "string"
459
+ }
460
+ },
461
+ "dark": {
462
+ "type": "object",
463
+ "propertyNames": {
464
+ "type": "string"
465
+ },
466
+ "additionalProperties": {
467
+ "type": "string"
468
+ }
469
+ }
470
+ },
471
+ "additionalProperties": {}
472
+ },
473
+ "css": {
474
+ "type": "object",
475
+ "propertyNames": {
476
+ "type": "string"
477
+ },
478
+ "additionalProperties": {
479
+ "$ref": "#/$defs/__shared#/$defs/schema0"
480
+ }
481
+ },
482
+ "envVars": {
483
+ "type": "object",
484
+ "propertyNames": {
485
+ "type": "string"
486
+ },
487
+ "additionalProperties": {
488
+ "type": "string"
489
+ }
490
+ },
491
+ "meta": {
492
+ "type": "object",
493
+ "propertyNames": {
494
+ "type": "string"
495
+ },
496
+ "additionalProperties": {}
497
+ },
498
+ "docs": {
499
+ "type": "string"
500
+ },
501
+ "categories": {
502
+ "readOnly": true,
503
+ "type": "array",
504
+ "items": {
505
+ "type": "string"
506
+ }
507
+ },
508
+ "extends": {
509
+ "type": "string"
510
+ },
511
+ "font": {
512
+ "type": "object",
513
+ "properties": {
514
+ "family": {
515
+ "type": "string"
516
+ },
517
+ "provider": {
518
+ "type": "string"
519
+ },
520
+ "import": {
521
+ "type": "string"
522
+ },
523
+ "variable": {
524
+ "type": "string"
525
+ },
526
+ "weight": {
527
+ "readOnly": true,
528
+ "type": "array",
529
+ "items": {
530
+ "type": "string"
531
+ }
532
+ },
533
+ "subsets": {
534
+ "readOnly": true,
535
+ "type": "array",
536
+ "items": {
537
+ "type": "string"
538
+ }
539
+ },
540
+ "selector": {
541
+ "type": "string"
542
+ },
543
+ "dependency": {
544
+ "type": "string"
545
+ }
546
+ },
547
+ "required": [
548
+ "family",
549
+ "provider",
550
+ "import",
551
+ "variable"
552
+ ],
553
+ "additionalProperties": {}
554
+ },
555
+ "mostra": {
556
+ "$ref": "#/$defs/PackMostraBlock"
557
+ }
558
+ },
559
+ "required": [
560
+ "name",
561
+ "type"
562
+ ],
563
+ "additionalProperties": {},
564
+ "description": "A source pack item (D30): shadcn's registry-item.json, which installs unchanged, plus an optional mostra block."
565
+ },
566
+ "__shared": {
567
+ "$defs": {
568
+ "schema0": {
569
+ "anyOf": [
570
+ {
571
+ "type": "string"
572
+ },
573
+ {
574
+ "readOnly": true,
575
+ "type": "array",
576
+ "items": {
577
+ "anyOf": [
578
+ {
579
+ "type": "string"
580
+ },
581
+ {
582
+ "type": "object",
583
+ "propertyNames": {
584
+ "type": "string"
585
+ },
586
+ "additionalProperties": {
587
+ "type": "string"
588
+ }
589
+ }
590
+ ]
591
+ }
592
+ },
593
+ {
594
+ "type": "object",
595
+ "propertyNames": {
596
+ "type": "string"
597
+ },
598
+ "additionalProperties": {
599
+ "$ref": "#/$defs/__shared#/$defs/schema0"
600
+ }
601
+ }
602
+ ]
603
+ }
604
+ }
605
+ }
606
+ }
607
+ }