@amedia/brick-mcp 0.0.1-LLM-DOCS → 0.0.1-NEW-PATH-1

package/package.json

@@ -2,7 +2,7 @@
   "name": "@amedia/brick-mcp",
   "homepage": "https://github.com/amedia/brick.git",
   "author": "Amedia",
-  "version": "0.0.1-LLM-DOCS",
+  "version": "0.0.1-NEW-PATH-1",
   "description": "This is a MCP server for Brick",
   "license": "MIT",
   "type": "module",
@@ -13,12 +13,10 @@
   },
   "files": [
     "dist",
-    "scripts",
-    "data"
+    "scripts"
   ],
   "scripts": {
     "build": "node build.js",
-    "generate-data": "node scripts/generate-data.js",
     "lint": "kragl lint",
     "lint:fix": "kragl lint --fix",
     "test:typescript": "tsc --noEmit",
@@ -36,8 +34,7 @@
     "@fastify/cors": "11.1.0",
     "@modelcontextprotocol/sdk": "1.21.0",
     "fastify": "5.6.1",
-    "zod": "3.25.76",
-    "zod-to-json-schema": "3.24.6"
+    "zod": "3.25.76"
   },
   "devDependencies": {
     "@amedia/kragl": "5.1.1",

package/scripts/generate-data.js

@@ -11,7 +11,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 
 const BRICK_ROOT = join(__dirname, '..', '..', '..');
-const DATA_DIR = join(__dirname, '..', 'data');
+const DATA_DIR = join(__dirname, '..', 'src', 'data');
 
 /**
  * Extract component selector from package name
@@ -77,6 +77,10 @@ async function generateComponentMetadata() {
   const entries = await readdir(packagesDir, { withFileTypes: true });
 
   const metadataList = [];
+  const componentsDir = join(DATA_DIR, 'components');
+
+  // Create components directory
+  await mkdir(componentsDir, { recursive: true });
 
   for (const entry of entries) {
     if (entry.isDirectory() && entry.name.startsWith('brick-')) {
@@ -96,6 +100,25 @@ async function generateComponentMetadata() {
         const category = categorizeComponent(componentName);
         const tags = extractTags(componentName, category);
 
+        // Read llm.txt if it exists
+        let llmContent;
+        try {
+          llmContent = await readFile(join(packagePath, 'llm.txt'), 'utf-8');
+        } catch {
+          llmContent = undefined;
+        }
+
+        // Read MDX documentation if it exists
+        let mdxContent;
+        try {
+          mdxContent = await readFile(
+            join(packagePath, 'stories', `${componentName}.mdx`),
+            'utf-8'
+          );
+        } catch {
+          mdxContent = undefined;
+        }
+
         // Lightweight metadata (for list operations)
         const metadata = {
           name: componentName,
@@ -106,6 +129,19 @@ async function generateComponentMetadata() {
           tags: tags.length > 0 ? tags : undefined,
         };
 
+        // Full component data (for get operations)
+        const fullComponent = {
+          ...metadata,
+          llm: llmContent,
+          mdx: mdxContent,
+        };
+
+        // Write individual component file
+        await writeFile(
+          join(componentsDir, `${componentName}.json`),
+          JSON.stringify(fullComponent, null, 2)
+        );
+
         metadataList.push(metadata);
       } catch (error) {
         console.error(`Error processing ${entry.name}:`, error.message);
@@ -151,44 +187,6 @@ function extractTokens(obj, prefix = '', category, theme, tokens = []) {
   return tokens;
 }
 
-/**
- * Generate design tokens documentation
- */
-async function generateTokensDocumentation() {
-  console.log('Generating tokens documentation...');
-
-  const storiesPath = join(BRICK_ROOT, 'stories');
-  const documentationFiles = [
-    'brickTokensAnOverview.mdx',
-    'brickTokensFormats.mdx',
-    'brickTokensNaming.mdx',
-    'brickTokensThemes.mdx',
-    'brickTokensUsage.mdx',
-  ];
-
-  const documentation = {};
-
-  for (const file of documentationFiles) {
-    const filePath = join(storiesPath, file);
-    try {
-      const content = await readFile(filePath, 'utf-8');
-      const docKey = file.replace('brickTokens', '').replace('.mdx', '');
-      const key = docKey.charAt(0).toLowerCase() + docKey.slice(1);
-      documentation[key] = content;
-    } catch (error) {
-      console.error(`Error reading documentation ${file}:`, error.message);
-    }
-  }
-
-  await mkdir(DATA_DIR, { recursive: true });
-  await writeFile(
-    join(DATA_DIR, 'tokens-documentation.json'),
-    JSON.stringify(documentation, null, 2)
-  );
-
-  console.log(`✅ Generated tokens documentation`);
-}
-
 /**
  * Generate design tokens
  */
@@ -237,7 +235,6 @@ async function main() {
   try {
     await generateComponentMetadata();
     await generateDesignTokens();
-    await generateTokensDocumentation();
     console.log('✅ Data generation complete');
   } catch (error) {
     console.error('Error generating data:', error);

package/data/components/brick-actions.md

@@ -1,59 +0,0 @@
----
-name: brick-actions
-version: 0.1.5
-category: Tooling
-tags: [github-actions, automation, eik, publishing, ci-cd]
-use_cases: [ci-cd, automated-publishing, eik-deployment]
-related: []
----
-
-# Brick Actions
-
-Custom JavaScript GitHub Actions used to automate packaging and publishing to Eik when packages are published to NPM.
-
-## Key Capabilities
-
-- Automatically publishes packages to Eik CDN after NPM publication
-- Filters packages based on Eik configuration in package.json
-- Integrates with Changesets workflow for version management
-- Validates required secrets/tokens before execution
-
-## Technical Details
-
-- **Type**: GitHub Action (JavaScript)
-- **Main**: dist/index.js
-- **Build Tool**: @vercel/ncc
-- **Dependencies**: @actions/core, @actions/exec, @actions/github, @eik/cli, @manypkg/get-packages
-
-## How It Works
-
-1. Triggered when Changesets publishes packages to NPM
-2. Receives `publishedPackages` as input
-3. Filters packages that have `eik` configuration in package.json
-4. Runs `eik package` command with proper credentials
-5. Publishes to Eik CDN at https://assets.acdn.no
-
-## Development
-
-### Building
-
-```bash
-npm run build-index
-```
-
-This uses @vercel/ncc to compile code and modules into a single distribution file.
-
-### Testing
-
-Can be tested locally using [Act](https://github.com/nektos/act) with environment variables via dotenv.
-
-## Important Notes
-
-- Not a Brick web component - this is tooling for CI/CD
-- Changesets handles versioning and CHANGELOG updates
-- Does not commit `.eik/integrity.json` files
-- Requires proper Eik credentials in GitHub secrets
-
-## Version
-
-Current version: 0.1.5

package/data/components/brick-alt-teaser.md

@@ -1,253 +0,0 @@
----
-name: brick-alt-teaser
-version: 8.0.65
-selector: brick-alt-teaser-v8
-category: Media
-tags: [teaser, article, news, card, content-preview, media, alt-theme]
-use_cases: [news-listing, content-cards, article-preview, editorial-content, opinion-pieces, video-teasers, photo-galleries, reviews, featured-content]
-related: [brick-image, brick-player, brick-pill, brick-icon]
----
-
-# Brick Alt Teaser
-
-A flexible article teaser component designed for the Alt theme, supporting multiple content types including standard articles, features, opinions, videos, galleries, and reviews.
-
-## Key Capabilities
-
-- Multiple layout variants: standard article, feature, opinion, video, gallery, and review
-- Responsive image handling with srcset and custom aspect ratios
-- Video playback integration via brick-player
-- Photo gallery support with image count indicator
-- Review ratings displayed as dice icons
-- Opinion pieces with author bylines and profile images
-- Countdown timer support for time-sensitive content
-- Analytics integration with ADP (Amedia Data Platform)
-- Customizable background colors for visual categorization
-- Accessibility features including ARIA labels and screen reader support
-
-## Props/Attributes
-
-| Attribute | Type | Default | Required | Description |
-|-----------|------|---------|----------|-------------|
-| `title` | string | '' | yes | Main headline of the article |
-| `link` | string | '' | yes | URL to the full article |
-| `publication` | string | '' | no | Publication domain (e.g., "www.tb.no") |
-| `name` | string | '' | no | Publication name (e.g., "Tønsbergs Blad") |
-| `articleId` | string | '' | no | Unique article identifier for tracking |
-| `published` | string | '' | no | Publication date/time (supports ISO 8601 or human-readable format) |
-| `readEstimate` | string | '' | no | Estimated reading time (e.g., "Lesetid 4 min") |
-| `image` | string | '' | no | Primary image URL |
-| `srcset` | string | '' | no | Responsive image srcset for different screen sizes |
-| `imagesizes` | string | '' | no | Image sizes attribute for responsive images |
-| `imageRatio` | string | '' | no | Custom aspect ratio (e.g., "16/9", "4/3", "1.33") |
-| `aoi` | number | - | no | Area of interest width for image cropping |
-| `altText` | string | '' | no | Alternative text for images |
-| `tags` | string | '' | no | Comma-separated content tags |
-| `pretitle` | string | '' | no | Text displayed above the main title (for features) |
-| `feature` | boolean | false | no | Enables feature layout variant |
-| `opinion` | boolean | false | no | Enables opinion layout variant |
-| `review` | number | - | no | Review rating (1-6, displayed as dice icons) |
-| `gallery` | string | '' | no | Comma-separated list of gallery image URLs |
-| `isVideo` | boolean | false | no | Enables video teaser mode |
-| `videoId` | string | '' | no | Video identifier for brick-player |
-| `playerId` | string | '' | no | Flowplayer player ID |
-| `authorName` | string | '' | no | Author name(s) for opinion pieces (comma-separated for multiple) |
-| `authorRole` | string | '' | no | Author role/title for opinion pieces |
-| `authorImage` | string | '' | no | Author profile image URL |
-| `backgroundColor` | string | '#d3d9de' | no | Background color for the teaser card |
-| `countdown` | string | '' | no | ISO 8601 date for countdown timer |
-| `menuOnClickEventName` | string | '' | no | Custom event name dispatched when menu is clicked |
-| `publicationOnHoverEventName` | string | '' | no | Custom event name dispatched on publication logo hover |
-| `siteId` | string | '' | no | Site identifier for analytics |
-| `small` | boolean | false | no | Enables compact layout variant |
-
-## Examples
-
-### Basic Article Teaser
-
-```html
-<brick-alt-teaser-v8
-  title="Harvard: Fem av de beste treningsøvelsene du noensinne kan gjøre"
-  link="https://example.com/article/123"
-  publication="www.tb.no"
-  name="Tønsbergs Blad"
-  published="i dag 13:37"
-  readEstimate="Lesetid 4 min"
-  image="https://g.acdn.no/api/reflex/v1/image/resize/480/example.jpg"
-  srcset="https://g.acdn.no/api/reflex/v1/image/resize/480/example.jpg 880w, https://g.acdn.no/api/reflex/v1/image/resize/1280/example.jpg 1280w"
-  articleId="5-95-91371"
-  tags="Utvikling"
-  backgroundColor="#D3D9DE"
->
-</brick-alt-teaser-v8>
-```
-
-### Feature Teaser
-
-```html
-<brick-alt-teaser-v8
-  feature="true"
-  pretitle="Stikktittel for feature"
-  title="Tittel for feature teaser"
-  publication="www.akersposten.no"
-  name="Akersposten"
-  image="https://g.acdn.no/api/reflex/v1/image/resize/480/example.jpg"
-  altText="Beskrivende alt-tekst"
-  link="https://example.com/feature/456"
-  backgroundColor="#DEDCD3"
->
-</brick-alt-teaser-v8>
-```
-
-### Video Teaser
-
-```html
-<brick-alt-teaser-v8
-  title="Tittel for video teaser"
-  isVideo="true"
-  videoId="ea507f6b-ca59-4ae6-a5fa-942fd02b458a"
-  playerId="3689c16b-4cb9-4a36-baf4-2c3aa7fcc811"
-  publication="www.tb.no"
-  name="Tønsbergs Blad"
-  published="i dag 13:37"
-  readEstimate="Spilletid 13:37 min"
-  link="https://example.com/video/789"
-  backgroundColor="#D3DED6"
->
-</brick-alt-teaser-v8>
-```
-
-### Opinion Teaser
-
-```html
-<brick-alt-teaser-v8
-  opinion="true"
-  title="Mening om viktig samfunnsspørsmål"
-  authorName="Hege Breen Bakken"
-  authorRole="Politisk redaktør i Drammens Tidende"
-  authorImage="https://image.journalisten.no/357695.jpg"
-  publication="www.dt.no"
-  name="Drammens Tidende"
-  published="i dag 13:37"
-  image="https://g.acdn.no/api/reflex/v1/image/resize/480/example.jpg"
-  link="https://example.com/opinion/101"
->
-</brick-alt-teaser-v8>
-```
-
-### Gallery Teaser
-
-```html
-<brick-alt-teaser-v8
-  title="Bildegalleri fra årets arrangement"
-  gallery="https://example.com/img1.jpg, https://example.com/img2.jpg, https://example.com/img3.jpg"
-  image="https://example.com/img1.jpg"
-  readEstimate="3 bilder"
-  publication="www.tb.no"
-  name="Tønsbergs Blad"
-  published="i dag 13:37"
-  link="https://example.com/gallery/202"
-  altText="Bilder fra arrangementet"
->
-</brick-alt-teaser-v8>
-```
-
-### Review Teaser
-
-```html
-<brick-alt-teaser-v8
-  title="Anmeldelse: Årets beste film"
-  review="5"
-  image="https://g.acdn.no/api/reflex/v1/image/resize/480/example.jpg"
-  publication="www.tb.no"
-  name="Tønsbergs Blad"
-  published="i dag 13:37"
-  readEstimate="Lesetid 6 min"
-  link="https://example.com/review/303"
-  altText="Filmplakat"
->
-</brick-alt-teaser-v8>
-```
-
-## Programmatic Usage
-
-```javascript
-import { BrickAltTeaser } from '@amedia/brick-alt-teaser';
-
-// The component auto-registers as brick-alt-teaser-v8
-// You can also manually define it:
-if (!customElements.get('brick-alt-teaser-v8')) {
-  customElements.define('brick-alt-teaser-v8', BrickAltTeaser);
-}
-
-// Create and append programmatically
-const teaser = document.createElement('brick-alt-teaser-v8');
-teaser.setAttribute('title', 'My Article Title');
-teaser.setAttribute('link', 'https://example.com/article');
-teaser.setAttribute('image', 'https://example.com/image.jpg');
-document.querySelector('#container').appendChild(teaser);
-
-// Listen to custom events
-teaser.addEventListener('my-menu-event', (event) => {
-  console.log('Menu clicked');
-});
-```
-
-## Accessibility
-
-- **ARIA Labels**: Each teaser includes a comprehensive screen reader label combining title, publication, and date
-- **Keyboard Navigation**: Single tab stop per teaser (title link only) to avoid redundant navigation
-- **Focus Indicators**: Clear 2px outline on all focusable elements
-- **Semantic HTML**: Uses `<article>` with Schema.org NewsArticle markup
-- **Alt Text Support**: Images can include descriptive alternative text via `altText` attribute
-- **Skip Decorative Images**: Image links are `aria-hidden` to prevent duplicate announcements
-- **Menu Button**: Options menu includes proper `aria-expanded` state management
-
-## Analytics Integration
-
-The component includes built-in ADP (Amedia Data Platform) tracking:
-
-- **Teaser Clicks**: Automatically tagged with `data-adp-clickLabel="teaser"` and `data-adp-clickValue="read-article"`
-- **Menu Interactions**: Menu button tagged with `data-adp-clickvalue="open-menu"`
-- **Publication Tracking**: Publication logo includes hover tracking
-- **Custom Events**: Dispatches custom events via `menuOnClickEventName` and `publicationOnHoverEventName`
-- **Article Metadata**: Includes Schema.org itemprops for structured data tracking
-
-## Layout Variants
-
-The component automatically selects layout based on attributes:
-
-- **Opinion Layout**: Triggered by `opinion="true"` - Image above title with author byline
-- **Video/Gallery Layout**: Triggered by `isVideo="true"` or `gallery` attribute - Media at top
-- **Feature Layout**: Triggered by `feature="true"` - Enhanced styling with optional pretitle
-- **Standard Layout**: Default layout with image below title
-- **Small Layout**: Triggered by `small="true"` - Compact horizontal layout
-
-## Technical Details
-
-- **Custom Element**: `brick-alt-teaser-v8`
-- **Base Class**: HTMLElement (vanilla web component)
-- **Dependencies**:
-  - `@amedia/brick-tokens` - Design tokens and styling
-  - `@amedia/brick-image` - Image rendering
-  - `@amedia/brick-player` - Video playback
-  - `@amedia/brick-pill` - Tag/pill components
-  - `@amedia/brick-icon` - Icon rendering
-- **Renders as**: `<article>` with nested semantic HTML
-- **Styling**: CSS-in-JS via Stitches with design tokens
-- **Schema.org**: Implements NewsArticle microdata
-
-## Important Notes
-
-- **Alt Team Component**: Built and maintained by the Alt theme team. Consult with them before using in other contexts.
-- **Image Srcset**: As of v8.0.0, image srcset must be provided externally with correct sizes and encoding - it is no longer auto-generated
-- **Date Formats**: The `published` attribute accepts both human-readable strings ("i dag 13:37") and ISO 8601 timestamps
-- **Multiple Authors**: Opinion pieces support multiple comma-separated authors, which will display with ellipsis overflow
-- **Background Colors**: Common background colors follow design token patterns for subject categorization (default, nature, sport, health, culture, economy)
-- **Review Ratings**: Review attribute accepts values 1-6, displayed as dice icons
-- **Video Player**: Requires valid Flowplayer player ID and video ID for video teasers
-- **Countdown**: Countdown attribute expects ISO 8601 date format for time-sensitive content
-
-## Version
-
-Current version: 8.0.65