@udixio/mcp 0.3.2 → 0.4.3

package/dist/bundled/doc-src/data/components/tooltip.overview.mdx

@@ -1,159 +0,0 @@
----
----
-
-
-
-
-
-
-
-import { CodePreview } from '@/components/CodePreview.js';
-
-## Usage
-
-Tooltip displays informative text when users hover, focus, or click a target.
-
-```bash
-import { Tooltip, Button } from "@udixio/ui-react"
-```
-
-<CodePreview client:load
-             code={`
-  <Tooltip text="Copy to clipboard">
-    <Button label="Hover me" />
-  </Tooltip>
-`}
-/>
-
-## Content
-
-Use `content` to render fully custom tooltip content (Markdown, rich text, or components). When `content` is provided, `title`, `text`, and `buttons` are ignored.
-
-```jsx
-<Tooltip
-  variant="rich"
-  content={
-    <div>
-      <strong>Shortcuts</strong>
-      <p>Press ⌘K to open the command palette.</p>
-    </div>
-  }
->
-  <Button label="Help" />
-</Tooltip>
-```
-
-## Variants
-
-Plain is a small text bubble. Rich is card-like with title, text, and actions.
-
-```jsx
-<div className="flex gap-6">
-  <Tooltip text="Plain tooltip">
-    <Button label="Plain" />
-  </Tooltip>
-  <Tooltip variant="rich" title="Saved" text="Item added to favorites" buttons={[{ label: 'Undo', variant: 'text' }] }>
-    <Button label="Rich" />
-  </Tooltip>
-</div>
-```
-
-## Triggers
-
-Control how the tooltip appears using `trigger`: "hover", "focus", "click" or an array of these.
-
-```jsx
-<Tooltip text="Opens on click" trigger="click">
-  <Button label="Click" />
-</Tooltip>
-```
-
-## Guidelines (M3 aligned)
-
-Use plain tooltips to label icon-only controls; rich tooltips are for longer explanations and optional actions.
-
-```jsx
-<div className="flex gap-6">
-  <Tooltip text="Present now">
-    <Button label="🎥" />
-  </Tooltip>
-  <Tooltip
-    variant="rich"
-    title="New setting"
-    text="Choose who can see your activity status."
-    buttons={[{ label: 'Learn more', variant: 'text' }]}
-  >
-    <Button label="Privacy" />
-  </Tooltip>
-</div>
-```
-
-Avoid hiding critical info inside a tooltip; use a dialog for destructive or required decisions.
-
-```jsx
-<Tooltip
-  variant="rich"
-  title="Delete project"
-  text="This action is permanent."
-  buttons={[{ label: 'Learn more', variant: 'text' }]}
->
-  <Button label="Delete" />
-</Tooltip>
-```
-
-## Delays
-
-Use `openDelay` and `closeDelay` (ms) to tune the hover/focus behavior. Defaults: `openDelay={400}`, `closeDelay={150}`.
-
-```jsx
-<Tooltip text="Slightly slower open" openDelay={600} closeDelay={100}>
-  <Button label="Hover" />
-</Tooltip>
-```
-
-## Controlled open state
-
-Use `isOpen` with `onOpenChange` to fully control the visibility. Use `defaultOpen` for uncontrolled initial state.
-
-```jsx
-function ControlledTooltip() {
-  const [open, setOpen] = React.useState(false);
-  return (
-    <Tooltip text="Controlled" isOpen={open} onOpenChange={setOpen}>
-      <Button label={open ? 'Hide' : 'Show'} onClick={() => setOpen(!open)} />
-    </Tooltip>
-  );
-}
-```
-
-## Position
-
-Provide an explicit `position` or let it auto-place based on target position.
-
-```jsx
-<Tooltip text="Top left" variant="rich" position="top-left">
-  <Button label="Positioned" />
-</Tooltip>
-```
-
-## Behavior
-
-On desktop, tooltips open on hover or focus. Use `trigger="click"` for persistent rich tooltips that stay open until another interaction.
-
-```jsx
-<Tooltip variant="rich" text="Persistent tooltip" trigger="click">
-  <Button label="Click to toggle" />
-</Tooltip>
-```
-
-## Keyboard
-
-| Keys | Actions |
-| --- | --- |
-| Tab | Focus lands on button, if available |
-| Space or Enter | Activates the focused element |
-
-## Accessibility
-
-- The tooltip uses `role="tooltip"` and links to its trigger via `aria-describedby` when open.
-- Press `Escape` to close an open tooltip.

package/dist/bundled/doc-src/data/pages/mcp.mdx

@@ -1,92 +0,0 @@
----
-title: MCP — Utiliser le package @udixio/mcp
-description: Guide pour installer, lancer et connecter le serveur MCP de la lib UI Udixio.
----
-
-
-# MCP — Utiliser le package `@udixio/mcp`
-
-Ce guide explique comment utiliser le serveur MCP pour exposer aux assistants IA (Claude Desktop, Cursor, MCP Inspector, etc.) les informations de la librairie UI :
-
-- Liste des composants du design system
-- Recherche dans la documentation (MD/MDX)
-- Tokens de thème (couleurs, espaces, etc.)
-- Accès à des fichiers de doc via une resource `doc://{path}`
-
-Le serveur MCP est publié sous le nom npm public `@udixio/mcp` et expose un binaire `udixio-mcp`.
-
-
-## Prérequis
-
-- Node.js ≥ 18
-
-Le package `@udixio/mcp` est auto‑contenu: il embarque un instantané (docs, thème, index des composants) et fonctionne sans aucune configuration.
-
-## Utilisation (zéro setup)
-
-```bash
-# Installer le binaire globalement
-npm i -g @udixio/mcp
-
-# Lancer le serveur MCP (utilise les données embarquées)
-udixio-mcp
-```
-
-Intégration côté client (ex. Claude Desktop):
-
-```json
-{
-  "mcpServers": {
-    "udixio-ui": { "command": "udixio-mcp" }
-  }
-}
-```
-
-
-## Outils MCP exposés (Tools)
-
-Le serveur enregistre plusieurs « tools » accessibles côté client MCP :
-
-- `listComponents` — retourne la liste des composants et leurs fichiers source relatifs (données embarquées).
-- `getComponentDoc` — prend `{ name: string }` et renvoie des chemins de doc/story correspondants (données embarquées).
-- `searchDocs` — prend `{ query: string, limit?: number }` et effectue une recherche plein texte dans la documentation embarquée.
-- `getThemeTokens` — renvoie l’objet de thème issu du snapshot embarqué.
-
-Exemple d’appel (depuis un client MCP) :
-
-```json
-{
-  "tool": "searchDocs",
-  "input": { "query": "Button", "limit": 5 }
-}
-```
-
-
-## Resources MCP
-
-Une resource est enregistrée pour lire directement des fichiers de doc par chemin relatif à `apps/doc/src` :
-
-- Template: `doc://{path}`
-- Exemple: `doc://components/button.mdx`
-
-
-## Intégration avec un client MCP (Claude Desktop)
-
-Ajoutez/éditez votre configuration utilisateur pour déclarer le serveur MCP. Exemple minimal :
-
-```json
-{
-  "mcpServers": {
-    "udixio-ui": {
-      "command": "udixio-mcp"
-    }
-  }
-}
-```
-
-Ensuite, dans le client, demandez par exemple :
-
-- « Appelle `listComponents` »
-- « Recherche dans la doc: `searchDocs` avec query=`colors` »
-- « Donne-moi les tokens de thème via `getThemeTokens` »
-- « Ouvre la resource `doc://path/vers/un/fichier.mdx` »

package/dist/bundled/doc-src/layouts/components.astro

@@ -1,87 +0,0 @@
----
-import '@/styles/global.css';
-import { getCollection, render } from 'astro:content';
-import { Button, Divider , Tabs, Tab} from '@udixio/ui-react';
-import { sentenceCase, kebabCase } from 'change-case';
-import { ComponentSidebar } from '@/components/ComponentSidebar';
-import { ComponentNavigation } from '@/components/ComponentNavigation';
-import { Navigation } from '@/components/Navigation';
-import { ClientRouter } from 'astro:transitions';
-import { DocSidebar } from '@/components/DocSidebar';
-import Layout from '@/layouts/layout.astro';
-import {Card, Icon}from "@udixio/ui-react";
-import { renderMarkdown } from '@/lib/markdown';
-import { faExclamation, faInfo, faInfoCircle,  } from '@fortawesome/free-solid-svg-icons';
-
-const apis = await getCollection('api');
-const overviews = await getCollection('overviews');
-
-const pathName = Astro.url.pathname;
-
-const { component } = Astro.params;
-
-const componentApi = apis.find(api => api.id === component);
-
-if (!componentApi) {
-  return Astro.redirect('/404', 404);
-}
-
-const limitation = componentApi.data.tags.limitations
-
-// Build robust, sanitized HTML from Markdown and style elements via classes
-const limitationHtml = typeof limitation === 'string' && limitation.trim().length > 0
-  ? renderMarkdown(limitation, {
-      classes: {
-        // ul: 'list-disc pl-6',
-        li: '!text-on-secondary-container',
-        // p: 'mb-2',
-      },
-    })
-  : '';
-
-const overviewIds = new Set(
-  overviews.map((overview) => overview.id.replaceAll('overview', '')),
-);
-
-const components =apis .filter((api) => !api.data.tags?.parent)  .filter((api) => overviewIds.has(api.id)).map(({ id }) => ({
-  slug: id
-})).sort((a, b) => a.slug.localeCompare(b.slug))
----
-<Layout docSidebar>
-  <Fragment slot="sidebar"> <!-- pass table header -->
-    <ComponentSidebar  client:load  transition:name="component-sidebar" transition:persist
-                       current={pathName.startsWith('/components') ? pathName.split('/').filter(Boolean)[1] : null}
-                       components={components}
-    />
-  </Fragment>
-  <div class="max-w-screen-xl mx-auto">
-    <Card variant="filled" className="mt-8 bg-surface-container">
-      <div class="p-8">
-        <slot name="header" />
-      </div>
-      <ComponentNavigation  client:load  transition:name="component-navigation"  transition:persist  componentApi={componentApi}/>
-    </Card>
-    {limitation && (
-      <Card
-        className="my-12 theme-warning prose-markdown"
-        role="note"
-        aria-labelledby="limitations-title"
-      >
-        <div class="flex items-start gap-4 p-6 md:p-7">
-          <div class="p-2 rounded-full bg-primary-container">
-            <Icon icon={faExclamation} className="size-5 md:size-6 text-on-primary-container" />
-          </div>
-          <div>
-            <h3 id="limitations-title" class="text-base md:text-lg font-medium mb-2 text-on-secondary-container ml-2 !mt-0">
-              Known Limitations (Beta)
-            </h3>
-            <div class="text-sm leading-6 md:text-base md:leading-7 [&_ul]:list-disc [&_ul]:pl-5" set:html={limitationHtml}></div>
-          </div>
-        </div>
-      </Card>
-    )}
-
-    <slot/>
-  </div>
-
-</Layout>

package/dist/bundled/doc-src/layouts/layout.astro

@@ -1,55 +0,0 @@
----
-import '@/styles/global.css';
-import { getCollection, render } from 'astro:content';
-import { Button, Divider, SmoothScroll } from '@udixio/ui-react';
-import { sentenceCase, kebabCase } from 'change-case';
-import { ComponentSidebar } from '@/components/ComponentSidebar';
-import { Navigation } from '@/components/Navigation';
-import { ClientRouter } from 'astro:transitions';
-import { DocSidebar } from '@/components/DocSidebar';
-import { ThemeProvider } from '@/components/theme/ThemeProvider';
-
-const apis = await getCollection('api');
-
-const pathName = Astro.url.pathname;
-
-
-const {docSidebar} = Astro.props
----
-
-<html lang="en">
-<head>
-  <meta charset="utf-8" />
-  <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
-  <meta name="viewport" content="width=device-width" />
-  <title>Astro</title>
-  <ClientRouter />
-</head>
-<body class="dark dynamic bg-surface text-on-surface" data-udx-color-keys="surface surface-dim surface-bright surface-container-lowest surface-container-low surface-container surface-container-high surface-container-highest on-surface on-surface-variant outline outline-variant inverse-surface inverse-on-surface primary primary-dim on-primary primary-container on-primary-container primary-fixed primary-fixed-dim on-primary-fixed on-primary-fixed-variant inverse-primary secondary secondary-dim on-secondary secondary-container on-secondary-container secondary-fixed secondary-fixed-dim on-secondary-fixed on-secondary-fixed-variant tertiary tertiary-dim on-tertiary tertiary-container on-tertiary-container tertiary-fixed tertiary-fixed-dim on-tertiary-fixed on-tertiary-fixed-variant error error-dim on-error error-container on-error-container surface-variant surface-tint background on-background success success-dim on-success success-container on-success-container success-fixed success-fixed-dim on-success-fixed on-success-fixed-variant">
-<SmoothScroll client:idle />
-<main class="mx-auto flex justify-between">
-  <div class="flex sticky top-0 h-screen">
-    <Navigation  client:load  transition:name="navigation" transition:persist/>
-    <Divider orientation="vertical" />
-    <slot name="sidebar" />
-  </div>
-  <div class=" flex flex-1 gap-8">
-
-    <div class="flex-1">
-
-      <slot />
-
-    </div>
-
-  </div>
-  <div>
-    {docSidebar &&   <DocSidebar client:load />}
-  </div>
-</main>
-<script >
-  import { initAnimateOnScroll as animateOnScroll } from '@udixio/ui-react';
-  animateOnScroll({ once: false });
-</script>
-<ThemeProvider client:idle transition:name="theme-provider" transition:persist />
-</body>
-</html>

package/dist/bundled/doc-src/pages/404.astro

@@ -1,18 +0,0 @@
----
-import Layout from '@/layouts/layout.astro';
-import { Button } from '@udixio/ui-react';
----
-<Layout>
-  <div class="flex items-center justify-center min-h-[70vh] px-8">
-    <div class="text-center space-y-6">
-      <h1 class="text-4xl font-extrabold tracking-tight">404 — Page introuvable</h1>
-      <p class="text-base text-muted-foreground max-w-prose mx-auto">
-        La page que vous recherchez n'existe pas ou a été déplacée.
-      </p>
-      <div class="flex items-center justify-center gap-3">
-        <Button href="/">Retour à l’accueil</Button>
-        <Button variant="outlined" href="/search">Rechercher dans la documentation</Button>
-      </div>
-    </div>
-  </div>
-</Layout>

package/dist/bundled/doc-src/pages/[...url].astro

@@ -1,34 +0,0 @@
----
-import Layout from '@/layouts/layout.astro';
-import { getCollection, render } from 'astro:content';
-import Code from '@/components/Code.astro';
-
-export async function getStaticPaths() {
-  const pages = await getCollection('pages');
-
-  return pages.map((page )=>{
-    let url = page.filePath!.replace(/\.(md|mdx)$/, '');
-    url = url.replace(/\/index$/, '');
-    url = url.replace('src/data/pages/', '/');
-
-    return{
-      params: { url: url },
-      props: { page }
-    }
-  });
-}
-
-const { page } = Astro.props;
-
-const { Content, headings } = await render(page);
-
----
-<Layout>
-  {/* Render the matched MD/MDX content component. Given getStaticPaths(), this should always be defined. */}
-  <section class="px-8 py-10 max-w-screen-lg mx-auto">
-    <div class="prose-markdown">
-      <Content components={{ pre: Code }} />
-    </div>
-  </section>
-
-</Layout>