@mintlify/cli 4.0.1425 → 4.0.1426

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.
@@ -179,6 +179,8 @@ import { Schema } from "prosemirror-model";
179
179
 
180
180
  // ../editor/dist/schemas/component-attrs.js
181
181
  var DEFAULT_MERMAID_PLACEMENT2 = "bottom-right";
182
+ var ICON_DESCRIPTION = "The icon to display. Options: Font Awesome icon name, Lucide icon name, Tabler icon name, URL to an externally hosted icon, path to an icon file in your project, or SVG code.";
183
+ var ICON_TYPE_DESCRIPTION = "The Font Awesome icon style. Only used with Font Awesome icons. Options: regular, solid, light, thin, sharp-solid, duotone, brands.";
182
184
  var BADGE_COLOR_OPTIONS = [
183
185
  "gray",
184
186
  "blue",
@@ -196,126 +198,320 @@ var BADGE_SHAPE_OPTIONS = ["rounded", "pill"];
196
198
  var BADGE_SIZE_OPTIONS = ["xs", "sm", "md", "lg"];
197
199
  var CARD_TYPE_OPTIONS = ["info", "warning", "note", "tip", "check", "danger"];
198
200
  var STEP_ATTRS = [
199
- { name: "icon", type: "expression" },
200
- { name: "iconType", type: "string" },
201
- { name: "stepNumber", type: "number" },
202
- { name: "titleSize", type: "string" },
201
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
202
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION },
203
+ { name: "stepNumber", type: "number", description: "The number of the step." },
204
+ {
205
+ name: "titleSize",
206
+ type: "string",
207
+ description: "The size of the step titles. One of p, h2, h3, and h4."
208
+ },
203
209
  { name: "isLast", type: "boolean" }
204
210
  ];
205
211
  var CARD_ATTRS = [
206
- { name: "type", type: "string", options: CARD_TYPE_OPTIONS },
207
- { name: "color", type: "string" },
208
- { name: "icon", type: "expression" },
209
- { name: "iconType", type: "string" },
210
- { name: "horizontal", type: "boolean" },
211
- { name: "href", type: "string" },
212
- { name: "img", type: "string" },
213
- { name: "cta", type: "string" }
212
+ {
213
+ name: "type",
214
+ type: "string",
215
+ options: CARD_TYPE_OPTIONS,
216
+ description: "Apply a callout-style theme to the card. Sets the card's background, border, and default icon to match the selected type."
217
+ },
218
+ {
219
+ name: "color",
220
+ type: "string",
221
+ description: "Icon color as a hex code (for example, #FF6B6B)."
222
+ },
223
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
224
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION },
225
+ {
226
+ name: "horizontal",
227
+ type: "boolean",
228
+ description: "Display the card in a compact horizontal layout."
229
+ },
230
+ { name: "href", type: "string", description: "URL to navigate to when the card is clicked." },
231
+ {
232
+ name: "img",
233
+ type: "string",
234
+ description: "URL or local path to an image displayed at the top of the card."
235
+ },
236
+ { name: "cta", type: "string", description: "Custom text for the action button." }
214
237
  ];
215
238
  var COLUMNS_ATTRS = [
216
- { name: "cols", type: "number" }
239
+ {
240
+ name: "cols",
241
+ type: "number",
242
+ description: "The number of columns per row. Accepts values from 1 to 4."
243
+ }
217
244
  ];
218
245
  var ACCORDION_ATTRS = [
219
- { name: "description", type: "string" },
220
- { name: "defaultOpen", type: "boolean" },
221
- { name: "icon", type: "expression" },
222
- { name: "iconType", type: "string" }
246
+ {
247
+ name: "description",
248
+ type: "string",
249
+ description: "Detail below the title in the Accordion preview."
250
+ },
251
+ {
252
+ name: "defaultOpen",
253
+ type: "boolean",
254
+ description: "Whether the Accordion is open by default."
255
+ },
256
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
257
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION }
223
258
  ];
224
259
  var CALLOUT_ATTRS = [
225
260
  { name: "type", type: "string" },
226
- { name: "icon", type: "expression" },
227
- { name: "iconType", type: "string" },
228
- { name: "color", type: "string" }
261
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
262
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION },
263
+ {
264
+ name: "color",
265
+ type: "string",
266
+ description: "Custom color as a hex code (for example, #FFC107). Sets the border, background tint, and text color of the callout."
267
+ }
229
268
  ];
230
269
  var TAB_ATTRS = [
231
- { name: "title", type: "string", required: true },
232
- { name: "icon", type: "expression" },
233
- { name: "iconType", type: "string" }
270
+ {
271
+ name: "title",
272
+ type: "string",
273
+ required: true,
274
+ description: "The title of the tab. Short titles are easier to navigate. Tabs with matching titles synchronize their selections."
275
+ },
276
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
277
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION }
234
278
  ];
235
279
  var TABS_ATTRS = [
236
- { name: "defaultTabIndex", type: "number" }
280
+ {
281
+ name: "defaultTabIndex",
282
+ type: "number",
283
+ description: "The index of the tab to display by default (zero-based). For example, set to 1 to show the second tab on page load."
284
+ }
237
285
  ];
238
286
  var BADGE_ATTRS = [
239
- { name: "color", type: "string", default: "gray", options: BADGE_COLOR_OPTIONS },
240
- { name: "size", type: "string", default: "md", options: BADGE_SIZE_OPTIONS },
241
- { name: "shape", type: "string", default: "rounded", options: BADGE_SHAPE_OPTIONS },
242
- { name: "stroke", type: "boolean", default: false },
243
- { name: "disabled", type: "boolean", default: false },
244
- { name: "icon", type: "expression" },
245
- { name: "iconType", type: "string" }
287
+ {
288
+ name: "color",
289
+ type: "string",
290
+ default: "gray",
291
+ options: BADGE_COLOR_OPTIONS,
292
+ description: "Badge color variant."
293
+ },
294
+ {
295
+ name: "size",
296
+ type: "string",
297
+ default: "md",
298
+ options: BADGE_SIZE_OPTIONS,
299
+ description: "Badge size."
300
+ },
301
+ {
302
+ name: "shape",
303
+ type: "string",
304
+ default: "rounded",
305
+ options: BADGE_SHAPE_OPTIONS,
306
+ description: "Badge shape."
307
+ },
308
+ {
309
+ name: "stroke",
310
+ type: "boolean",
311
+ default: false,
312
+ description: "Display badge with an outline instead of filled background."
313
+ },
314
+ {
315
+ name: "disabled",
316
+ type: "boolean",
317
+ default: false,
318
+ description: "Display badge in a disabled state with reduced opacity."
319
+ },
320
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
321
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION }
246
322
  ];
247
323
  var TOOLTIP_ATTRS = [
248
- { name: "tip", type: "string", default: "", required: true },
249
- { name: "headline", type: "string", default: "" },
250
- { name: "cta", type: "string", default: "" },
251
- { name: "href", type: "string", default: "" }
324
+ {
325
+ name: "tip",
326
+ type: "string",
327
+ default: "",
328
+ required: true,
329
+ description: "The text displayed in the tooltip."
330
+ },
331
+ {
332
+ name: "headline",
333
+ type: "string",
334
+ default: "",
335
+ description: "Text displayed before the tip text."
336
+ },
337
+ {
338
+ name: "cta",
339
+ type: "string",
340
+ default: "",
341
+ description: "The call-to-action text for a link within the tooltip."
342
+ },
343
+ {
344
+ name: "href",
345
+ type: "string",
346
+ default: "",
347
+ description: "URL for the call-to-action link. Required when using cta."
348
+ }
252
349
  ];
253
350
  var FRAME_ATTRS = [
254
- { name: "caption", type: "string" }
351
+ {
352
+ name: "caption",
353
+ type: "string",
354
+ description: "Text that appears as part of the frame, centered below the content. Supports markdown formatting including links and bold text."
355
+ }
255
356
  ];
256
357
  var EXPANDABLE_ATTRS = [
257
- { name: "title", type: "string", required: true },
258
- { name: "defaultOpen", type: "boolean" }
358
+ {
359
+ name: "title",
360
+ type: "string",
361
+ required: true,
362
+ description: "The name of the object you are showing."
363
+ },
364
+ {
365
+ name: "defaultOpen",
366
+ type: "boolean",
367
+ description: "Set to true for the expandable to open when the page loads."
368
+ }
259
369
  ];
260
370
  var VISIBILITY_AUDIENCE_OPTIONS = ["humans", "agents"];
261
371
  var VISIBILITY_ATTRS = [
262
- { name: "for", type: "string", required: true, options: VISIBILITY_AUDIENCE_OPTIONS }
372
+ {
373
+ name: "for",
374
+ type: "string",
375
+ required: true,
376
+ options: VISIBILITY_AUDIENCE_OPTIONS,
377
+ description: "The audience for the wrapped content: humans (visible on the web, excluded from Markdown output) or agents (hidden on the web, included in Markdown output)."
378
+ }
263
379
  ];
264
380
  var UPDATE_ATTRS = [
265
- { name: "label", type: "string", required: true },
266
- { name: "tags", type: "expression" },
267
- { name: "description", type: "string" },
268
- { name: "rss", type: "expression" }
381
+ {
382
+ name: "label",
383
+ type: "string",
384
+ required: true,
385
+ description: "Label for the update. Appears to the left of the update and creates an anchor link. Labels should be unique."
386
+ },
387
+ {
388
+ name: "tags",
389
+ type: "expression",
390
+ description: "Tags for the update. Shown as filters in the right side panel."
391
+ },
392
+ {
393
+ name: "description",
394
+ type: "string",
395
+ description: "Description of the update. Appears below the label and tag."
396
+ },
397
+ {
398
+ name: "rss",
399
+ type: "expression",
400
+ description: "Creates a single RSS feed entry with a custom title and description."
401
+ }
269
402
  ];
270
403
  var ICON_ATTRS = [
271
404
  { name: "name", type: "string" },
272
- { name: "icon", type: "expression" },
273
- { name: "iconType", type: "string" },
274
- { name: "color", type: "string" },
275
- { name: "size", type: "number" }
405
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
406
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION },
407
+ {
408
+ name: "color",
409
+ type: "string",
410
+ description: "The color of the icon as a hex code (for example, #FF5733)."
411
+ },
412
+ { name: "size", type: "number", description: "The size of the icon in pixels." }
276
413
  ];
277
414
  var CODE_BLOCK_ATTRS = [
278
- { name: "language", type: "string" },
279
- { name: "filename", type: "string" },
415
+ {
416
+ name: "language",
417
+ type: "string",
418
+ description: "The programming language for syntax highlighting."
419
+ },
420
+ {
421
+ name: "filename",
422
+ type: "string",
423
+ description: "The filename to display in the code block header."
424
+ },
280
425
  { name: "filenameSyntax", type: "string" },
281
- { name: "expandable", type: "boolean" },
282
- { name: "icon", type: "expression" },
426
+ { name: "expandable", type: "boolean", description: "Whether to expand the code block." },
427
+ {
428
+ name: "icon",
429
+ type: "expression",
430
+ description: "The icon to display in the code block header."
431
+ },
283
432
  { name: "lang", type: "string" },
284
- { name: "lines", type: "boolean" },
285
- { name: "wrap", type: "boolean" },
286
- { name: "highlight", type: "expression" },
287
- { name: "focus", type: "expression" },
433
+ { name: "lines", type: "boolean", description: "Whether to show line numbers." },
434
+ { name: "wrap", type: "boolean", description: "Whether to wrap the code block." },
435
+ {
436
+ name: "highlight",
437
+ type: "expression",
438
+ description: 'The lines to highlight. Provide a stringified array of numbers. Example: "[1,3,4,5]".'
439
+ },
440
+ {
441
+ name: "focus",
442
+ type: "expression",
443
+ description: 'The lines to focus on. Provide a stringified array of numbers. Example: "[1,3,4,5]".'
444
+ },
288
445
  { name: "add", type: "expression" },
289
446
  { name: "remove", type: "expression" },
290
- { name: "twoslash", type: "boolean" },
447
+ {
448
+ name: "twoslash",
449
+ type: "boolean",
450
+ description: "Enable interactive type information in JavaScript and TypeScript code blocks. Hover over variables, functions, and parameters to see types and errors like in an IDE."
451
+ },
291
452
  { name: "nocopy", type: "boolean" }
292
453
  ];
293
454
  var PROMPT_BLOCK_ATTRS = [
294
- { name: "icon", type: "expression" },
295
- { name: "iconType", type: "string" },
296
- { name: "actions", type: "expression", default: ["copy"] }
455
+ { name: "icon", type: "expression", description: ICON_DESCRIPTION },
456
+ { name: "iconType", type: "string", description: ICON_TYPE_DESCRIPTION },
457
+ {
458
+ name: "actions",
459
+ type: "expression",
460
+ default: ["copy"],
461
+ description: 'Array of available actions. Valid values are "copy" (copy to clipboard) and "cursor" (open in Cursor).'
462
+ }
297
463
  ];
298
464
  var MERMAID_BLOCK_ATTRS = [
299
- { name: "placement", type: "string", default: DEFAULT_MERMAID_PLACEMENT2 },
300
- { name: "actions", type: "boolean" }
465
+ {
466
+ name: "placement",
467
+ type: "string",
468
+ default: DEFAULT_MERMAID_PLACEMENT2,
469
+ description: "Position of the interactive controls. Options: top-left, top-right, bottom-left, bottom-right."
470
+ },
471
+ {
472
+ name: "actions",
473
+ type: "boolean",
474
+ description: "Show or hide the interactive controls. When set, this overrides the default behavior (controls shown when diagram height exceeds 120px)."
475
+ }
301
476
  ];
477
+ var PARAM_LOCATION_DESCRIPTION = "Whether the parameter is a query, path, body, or header. Followed by the parameter name.";
302
478
  var PARAM_FIELD_ATTRS = [
303
- { name: "query", type: "string" },
304
- { name: "path", type: "string" },
305
- { name: "body", type: "string" },
306
- { name: "header", type: "string" },
307
- { name: "default", type: "string" },
308
- { name: "type", type: "string" },
309
- { name: "required", type: "boolean" },
310
- { name: "deprecated", type: "boolean" },
311
- { name: "placeholder", type: "string" }
479
+ { name: "query", type: "string", description: PARAM_LOCATION_DESCRIPTION },
480
+ { name: "path", type: "string", description: PARAM_LOCATION_DESCRIPTION },
481
+ { name: "body", type: "string", description: PARAM_LOCATION_DESCRIPTION },
482
+ { name: "header", type: "string", description: PARAM_LOCATION_DESCRIPTION },
483
+ {
484
+ name: "default",
485
+ type: "string",
486
+ description: "Default value populated when the request value is empty."
487
+ },
488
+ {
489
+ name: "type",
490
+ type: "string",
491
+ description: "Expected type of the parameter's value. Supports number, string, boolean, object. Define arrays using the [] suffix. For example string[]."
492
+ },
493
+ { name: "required", type: "boolean", description: "Indicate whether you require the parameter." },
494
+ {
495
+ name: "deprecated",
496
+ type: "boolean",
497
+ description: "Indicate whether you have deprecated the parameter."
498
+ },
499
+ {
500
+ name: "placeholder",
501
+ type: "string",
502
+ description: "Placeholder text for the input in the playground."
503
+ }
312
504
  ];
313
505
  var RESPONSE_FIELD_ATTRS = [
314
- { name: "name", type: "string", required: true },
315
- { name: "type", type: "string" },
316
- { name: "default", type: "string" },
317
- { name: "required", type: "boolean" },
318
- { name: "deprecated", type: "boolean" }
506
+ { name: "name", type: "string", required: true, description: "The name of the response value." },
507
+ {
508
+ name: "type",
509
+ type: "string",
510
+ description: "Expected type of the response value. This can be any arbitrary string."
511
+ },
512
+ { name: "default", type: "string", description: "The default value." },
513
+ { name: "required", type: "boolean", description: "Indicate whether you require the response." },
514
+ { name: "deprecated", type: "boolean", description: "Whether you have deprecated a field." }
319
515
  ];
320
516
 
321
517
  // ../editor/dist/schemas/utils.js
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mintlify/cli",
3
- "version": "4.0.1425",
3
+ "version": "4.0.1426",
4
4
  "description": "The Mintlify CLI",
5
5
  "engines": {
6
6
  "node": ">=18.0.0"
@@ -82,7 +82,7 @@
82
82
  "keytar": "7.9.0"
83
83
  },
84
84
  "devDependencies": {
85
- "@mintlify/editor": "0.0.319",
85
+ "@mintlify/editor": "0.0.320",
86
86
  "@mintlify/ts-config": "2.0.2",
87
87
  "@tsconfig/recommended": "1.0.2",
88
88
  "@types/detect-port": "1.3.2",
@@ -101,5 +101,5 @@
101
101
  "vitest": "2.1.9",
102
102
  "vitest-mock-process": "1.0.4"
103
103
  },
104
- "gitHead": "fa20775643b3d5ea378e246611f0adb728d2b0c2"
104
+ "gitHead": "493248997c157b876149cda72cd1b58b8d2aabb9"
105
105
  }