@exhaustive-ui/mcp 22.4.0 → 22.5.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 (115) hide show
  1. package/README.md +13 -1
  2. package/data/cards/accordion.md +88 -0
  3. package/data/cards/animateonscroll.md +152 -0
  4. package/data/cards/autocomplete.md +104 -0
  5. package/data/cards/autofocus.md +34 -0
  6. package/data/cards/avatar.md +43 -0
  7. package/data/cards/badge.md +43 -0
  8. package/data/cards/blockui.md +51 -0
  9. package/data/cards/breadcrumb.md +54 -0
  10. package/data/cards/button.md +77 -0
  11. package/data/cards/card.md +48 -0
  12. package/data/cards/carousel.md +99 -0
  13. package/data/cards/cascadeselect.md +81 -0
  14. package/data/cards/chart.md +103 -0
  15. package/data/cards/checkbox.md +58 -0
  16. package/data/cards/chip.md +49 -0
  17. package/data/cards/classnames.md +73 -0
  18. package/data/cards/colorpicker.md +51 -0
  19. package/data/cards/confirmdialog.md +89 -0
  20. package/data/cards/confirmpopup.md +74 -0
  21. package/data/cards/contextmenu.md +66 -0
  22. package/data/cards/dataview.md +115 -0
  23. package/data/cards/datepicker.md +102 -0
  24. package/data/cards/dialog.md +89 -0
  25. package/data/cards/divider.md +54 -0
  26. package/data/cards/dock.md +85 -0
  27. package/data/cards/dragdrop.md +102 -0
  28. package/data/cards/drawer.md +62 -0
  29. package/data/cards/dynamicdialog.md +76 -0
  30. package/data/cards/editor.md +55 -0
  31. package/data/cards/fieldset.md +53 -0
  32. package/data/cards/fileinput.md +72 -0
  33. package/data/cards/fileupload.md +89 -0
  34. package/data/cards/floatlabel.md +41 -0
  35. package/data/cards/fluid.md +47 -0
  36. package/data/cards/focustrap.md +60 -0
  37. package/data/cards/galleria.md +101 -0
  38. package/data/cards/iconfield.md +44 -0
  39. package/data/cards/iftalabel.md +38 -0
  40. package/data/cards/image.md +56 -0
  41. package/data/cards/imagecompare.md +44 -0
  42. package/data/cards/inplace.md +55 -0
  43. package/data/cards/inputgroup.md +66 -0
  44. package/data/cards/inputmask.md +71 -0
  45. package/data/cards/inputnumber.md +77 -0
  46. package/data/cards/inputotp.md +60 -0
  47. package/data/cards/inputtext.md +41 -0
  48. package/data/cards/keyfilter.md +48 -0
  49. package/data/cards/knob.md +54 -0
  50. package/data/cards/listbox.md +103 -0
  51. package/data/cards/megamenu.md +97 -0
  52. package/data/cards/menu.md +68 -0
  53. package/data/cards/menubar.md +106 -0
  54. package/data/cards/message.md +50 -0
  55. package/data/cards/metergroup.md +57 -0
  56. package/data/cards/multiselect.md +119 -0
  57. package/data/cards/orderlist.md +94 -0
  58. package/data/cards/organizationchart.md +57 -0
  59. package/data/cards/overlay.md +62 -0
  60. package/data/cards/paginator.md +61 -0
  61. package/data/cards/panel.md +56 -0
  62. package/data/cards/panelmenu.md +103 -0
  63. package/data/cards/password.md +78 -0
  64. package/data/cards/picklist.md +102 -0
  65. package/data/cards/popover.md +52 -0
  66. package/data/cards/progressbar.md +41 -0
  67. package/data/cards/progressspinner.md +37 -0
  68. package/data/cards/radiobutton.md +51 -0
  69. package/data/cards/rating.md +56 -0
  70. package/data/cards/ripple.md +36 -0
  71. package/data/cards/scroller.md +32 -0
  72. package/data/cards/scrollpanel.md +49 -0
  73. package/data/cards/scrolltop.md +46 -0
  74. package/data/cards/select.md +107 -0
  75. package/data/cards/selectbutton.md +60 -0
  76. package/data/cards/skeleton.md +53 -0
  77. package/data/cards/slider.md +51 -0
  78. package/data/cards/speeddial.md +99 -0
  79. package/data/cards/splitbutton.md +93 -0
  80. package/data/cards/splitter.md +51 -0
  81. package/data/cards/stepper.md +120 -0
  82. package/data/cards/styleclass.md +44 -0
  83. package/data/cards/table.md +270 -0
  84. package/data/cards/tabs.md +96 -0
  85. package/data/cards/tag.md +40 -0
  86. package/data/cards/terminal.md +67 -0
  87. package/data/cards/textarea.md +44 -0
  88. package/data/cards/tieredmenu.md +126 -0
  89. package/data/cards/timeline.md +58 -0
  90. package/data/cards/toast.md +59 -0
  91. package/data/cards/togglebutton.md +59 -0
  92. package/data/cards/toggleswitch.md +51 -0
  93. package/data/cards/toolbar.md +74 -0
  94. package/data/cards/tooltip.md +42 -0
  95. package/data/cards/tree.md +96 -0
  96. package/data/cards/treeselect.md +99 -0
  97. package/data/cards/treetable.md +210 -0
  98. package/data/components/checkbox.md +0 -24
  99. package/data/components/dock.md +2 -2
  100. package/data/components/galleria.md +7 -7
  101. package/data/components/inputnumber.md +2 -2
  102. package/data/components/llms.md +4 -0
  103. package/data/components/password.md +3 -3
  104. package/data/components/picklist.md +1 -1
  105. package/data/components/table.md +1 -1
  106. package/data/components.json +26 -22
  107. package/data/llms-full.txt +49 -42
  108. package/data/llms.txt +100 -96
  109. package/data/manifest.json +30 -1
  110. package/data/pages/llms.md +29 -0
  111. package/data/snapshot.json +2 -2
  112. package/dist/index.d.mts +35 -2
  113. package/dist/index.mjs +1393 -1077
  114. package/dist/index.mjs.map +1 -1
  115. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -23,7 +23,7 @@ declare function resolveConfig(env?: Env, overrides?: Partial<ServerConfig>): Se
23
23
  //#region src/source.d.ts
24
24
  /**
25
25
  * Where the machine-readable docs come from. Paths are relative to the `/llms/` directory of the docs site:
26
- * `components.json`, `manifest.json`, `llms.txt`, `llms-full.txt`, `components/<name>.md`, `pages/<name>.md`.
26
+ * `components.json`, `manifest.json`, `llms.txt`, `llms-full.txt`, `components/<name>.md`, `cards/<name>.md`, `pages/<name>.md`.
27
27
  */
28
28
  interface DocsSource {
29
29
  readonly kind: string;
@@ -315,6 +315,9 @@ interface ComponentEntry {
315
315
  publicUrl: string;
316
316
  markdownUrl: string;
317
317
  docPath: string;
318
+ /** Compact card: import, tag, key inputs, templates with their context, one example. */
319
+ cardPath: string;
320
+ cardUrl: string;
318
321
  resourceUri: string;
319
322
  apiResourceUri: string;
320
323
  import?: string;
@@ -351,6 +354,11 @@ interface Catalog {
351
354
  generatedAt: string;
352
355
  site: string;
353
356
  components: ComponentEntry[];
357
+ /**
358
+ * Entry points with selectors but no docs page of their own (InputIcon, OverlayBadge, Bind...): not listed or
359
+ * searchable as components, but known to the usage validators so their tags and inputs are recognized.
360
+ */
361
+ parts: ComponentEntry[];
354
362
  guides: GuideEntry[];
355
363
  directives: DirectiveEntry[];
356
364
  }
@@ -402,6 +410,31 @@ interface UsageIssue {
402
410
  /** Validate a template or component source against the generated API of one component. */
403
411
  declare function validateComponentUsage(catalog: Catalog, component: ComponentEntry, code: string): UsageIssue[];
404
412
  //#endregion
413
+ //#region src/check.d.ts
414
+ /**
415
+ * `exhaustive-ui-mcp check`: validate every template of a project against the ExhaustiveUI API, the way an agent calls
416
+ * validate_usage, but for all the components of all the files at once, with file and line. Meant to run after an agent
417
+ * (or a person) writes templates: PrimeNG tags and imports, unknown inputs and outputs, removed v22 inputs, misspelled
418
+ * template names.
419
+ */
420
+ interface CheckIssue extends UsageIssue {
421
+ file: string;
422
+ line: number;
423
+ component?: string;
424
+ }
425
+ /** Validate one file. */
426
+ declare function checkSource(catalog: Catalog, file: string, code: string): CheckIssue[];
427
+ /** Validate every .html and .ts file under the given paths. */
428
+ declare function checkProject(catalog: Catalog, targets: string[]): Promise<{
429
+ files: number;
430
+ issues: CheckIssue[];
431
+ }>;
432
+ /** Human readable report, one issue per line, like a compiler. */
433
+ declare function formatCheckReport(result: {
434
+ files: number;
435
+ issues: CheckIssue[];
436
+ }, cwd?: string): string;
437
+ //#endregion
405
438
  //#region src/tools.d.ts
406
439
  interface ToolResult {
407
440
  [key: string]: unknown;
@@ -444,5 +477,5 @@ declare function createExhaustiveUiMcpServer(options?: CreateServerOptions): Pro
444
477
  declare function runExhaustiveUiMcpServer(options?: CreateServerOptions): Promise<void>;
445
478
  declare function componentApi(component: ComponentEntry): Record<string, unknown>;
446
479
  //#endregion
447
- export { CachedSource, type Catalog, CatalogLoader, type ComponentEntry, type CreateServerOptions, DEFAULT_CACHE_TTL_SECONDS, DEFAULT_DOCS_URL, DEFAULT_FETCH_TIMEOUT_MS, type DirectiveEntry, type DocsSource, FallbackSource, type FetchLike, type GuideEntry, MemorySource, PROMPT_NAMES, RESOURCE_BASE_URI, RESOURCE_TEMPLATE_NAMES, RemoteSource, SERVER_NAME, STATIC_RESOURCE_URIS, type SectionEntry, type ServerConfig, SnapshotSource, type SourceStatus, TOOL_NAMES, type ToolContext, type ToolResult, type UsageIssue, buildCatalog, componentApi, createDocsSource, createExhaustiveUiMcpServer, createToolContext, findComponent, findGuide, findSection, readPackageVersion, resolveConfig, runExhaustiveUiMcpServer, searchCatalog, validateComponentUsage };
480
+ export { CachedSource, type Catalog, CatalogLoader, type CheckIssue, type ComponentEntry, type CreateServerOptions, DEFAULT_CACHE_TTL_SECONDS, DEFAULT_DOCS_URL, DEFAULT_FETCH_TIMEOUT_MS, type DirectiveEntry, type DocsSource, FallbackSource, type FetchLike, type GuideEntry, MemorySource, PROMPT_NAMES, RESOURCE_BASE_URI, RESOURCE_TEMPLATE_NAMES, RemoteSource, SERVER_NAME, STATIC_RESOURCE_URIS, type SectionEntry, type ServerConfig, SnapshotSource, type SourceStatus, TOOL_NAMES, type ToolContext, type ToolResult, type UsageIssue, buildCatalog, checkProject, checkSource, componentApi, createDocsSource, createExhaustiveUiMcpServer, createToolContext, findComponent, findGuide, findSection, formatCheckReport, readPackageVersion, resolveConfig, runExhaustiveUiMcpServer, searchCatalog, validateComponentUsage };
448
481
  //# sourceMappingURL=index.d.mts.map