@lism-css/mcp 0.24.0 → 0.27.0

package/dist/tools/convert-css.js

@@ -3,7 +3,6 @@ import { loadPropsMarkdown } from '../lib/load-markdown.js';
 import { parsePropRows } from '../lib/markdown-utils.js';
 import { MetaInfoSchema } from '../lib/schemas.js';
 import { success, error, READ_ONLY_ANNOTATIONS } from '../lib/response.js';
-/** 変換結果の1行 */
 const ConversionEntrySchema = z.object({
     css: z.string(),
     lismProp: z.string().nullable(),
@@ -12,7 +11,6 @@ const ConversionEntrySchema = z.object({
     confidence: z.enum(['exact', 'approximate', 'unmapped']),
     note: z.string(),
 });
-/** コンポーネント提案 */
 const ComponentSuggestionSchema = z.object({
     name: z.string(),
     reason: z.string(),
@@ -21,7 +19,6 @@ const ComponentSuggestionSchema = z.object({
 // ----------------------------------------------------------------
 // CSS パース
 // ----------------------------------------------------------------
-/** @ルール（@media 等）が含まれていないか検査する */
 function detectAtRules(cssText) {
     const atRuleMatch = cssText.match(/^@(\w[\w-]*)/m);
     if (atRuleMatch) {
@@ -29,16 +26,12 @@ function detectAtRules(cssText) {
     }
     return null;
 }
-/**
- * CSS テキストから宣言を抽出する。
- * `;` で分割する際に `url()` 等の括弧内の `;` を無視する。
- */
+/** CSSテキストから宣言を抽出する。url()などの括弧内にある`;`は区切りとみなさない。 */
 function parseCssDeclarations(cssText) {
-    // コメント除去
+    // コメントとセレクタの外枠を取り除く。
     let cleaned = cssText.replace(/\/\*[\s\S]*?\*\//g, '');
-    // セレクタ + ブレースを除去（裸の宣言リストも受け付ける）
     cleaned = cleaned.replace(/[^{}]*\{/g, '').replace(/\}/g, '');
-    // 括弧のネストを考慮して `;` で分割
+    // 括弧の深さを追いながら宣言単位に分ける。
     const segments = [];
     let current = '';
     let parenDepth = 0;
@@ -72,12 +65,10 @@ function parseCssDeclarations(cssText) {
     }
     return declarations;
 }
-/** プリセット値列から値を抽出する（例: "-fz:base, -fz:5xl" → ["base", "5xl"]） */
 function extractPresetValues(presetColumn, propName) {
     if (!presetColumn || presetColumn === '—' || presetColumn === '-')
         return [];
     const values = [];
-    // -{prop}:{value} パターンを全て抽出
     const escaped = propName.replace(/[-/\\^$*+?.()|[\]{}]/g, '\\$&');
     const regex = new RegExp(`-${escaped}:([^,\\s\`〜]+)`, 'g');
     let match;
@@ -98,7 +89,6 @@ function buildCssPropertyMap(mappings) {
     const map = new Map();
     for (const mapping of mappings) {
         const normalized = mapping.cssProperty.toLowerCase();
-        // CSS カスタムプロパティ形式はスキップ（"--hl" 等）
         if (!normalized.startsWith('(class:')) {
             map.set(normalized, mapping);
         }
@@ -108,7 +98,6 @@ function buildCssPropertyMap(mappings) {
 // ----------------------------------------------------------------
 // 値のマッピング
 // ----------------------------------------------------------------
-/** よくある CSS 値 → Lism トークン値の変換テーブル */
 const VALUE_ALIASES = {
     'space-between': 'between',
     currentcolor: 'current',
@@ -119,10 +108,8 @@ function suggestValue(mapping, cssValue) {
     const tokens = mapping.presetValues;
     if (tokens.length === 0)
         return null;
-    // 直接一致
     if (tokens.includes(cssValue))
         return cssValue;
-    // エイリアス変換後に一致
     const aliased = VALUE_ALIASES[cssValue.toLowerCase()];
     if (aliased && tokens.includes(aliased))
         return aliased;
@@ -131,12 +118,12 @@ function suggestValue(mapping, cssValue) {
 // ----------------------------------------------------------------
 // コンポーネント検出
 // ----------------------------------------------------------------
+/** display関連の宣言から利用できるLismレイアウトコンポーネントを提案する。 */
 function detectComponent(declarations) {
     const propMap = new Map(declarations.map((d) => [d.property, d.value.toLowerCase()]));
     const display = propMap.get('display');
     const flexDirection = propMap.get('flex-direction');
     const placeItems = propMap.get('place-items');
-    // Stack: flex + column
     if (display === 'flex' && (flexDirection === 'column' || flexDirection === 'column-reverse')) {
         return {
             name: 'Stack',
@@ -144,7 +131,6 @@ function detectComponent(declarations) {
             implicitCss: ['display: flex', 'flex-direction: column'],
         };
     }
-    // Center: grid + place-items: center
     if (display === 'grid' && placeItems === 'center') {
         return {
             name: 'Center',
@@ -152,7 +138,6 @@ function detectComponent(declarations) {
             implicitCss: ['display: grid', 'place-items: center'],
         };
     }
-    // Flex
     if (display === 'flex') {
         return {
             name: 'Flex',
@@ -160,7 +145,6 @@ function detectComponent(declarations) {
             implicitCss: ['display: flex'],
         };
     }
-    // Grid
     if (display === 'grid') {
         return {
             name: 'Grid',
@@ -177,6 +161,7 @@ function findCategory(mappings, propName) {
     const found = mappings.find((m) => m.prop === propName);
     return found?.sectionName ?? 'unknown';
 }
+/** 変換結果からJSX使用例を組み立てる。 */
 function buildExample(conversions, component) {
     const tagName = component?.name ?? 'Lism';
     const implicitCssSet = new Set(component?.implicitCss.map((c) => c.split(':')[0].trim()) ?? []);
@@ -188,7 +173,7 @@ function buildExample(conversions, component) {
             styles.push(conv.css);
             continue;
         }
-        // コンポーネントが暗黙的に付与する CSS はスキップ
+        // コンポーネントが暗黙に持つCSSは重複出力しない。
         if (implicitCssSet.has(cssProp))
             continue;
         if (conv.suggestedValue != null) {
@@ -232,7 +217,6 @@ export function registerConvertCss(server) {
         annotations: READ_ONLY_ANNOTATIONS,
     }, ({ css }) => {
         try {
-            // @ ルール検出
             const atRuleError = detectAtRules(css);
             if (atRuleError) {
                 return error(atRuleError);
@@ -244,7 +228,7 @@ export function registerConvertCss(server) {
             if (declarations.length === 0) {
                 return error('No CSS declarations found. Provide CSS in "property: value;" format.');
             }
-            // 各宣言を変換
+            // 各宣言をLism Propと候補値へ変換する。
             const conversions = declarations.map((decl) => {
                 const mapping = cssPropertyMap.get(decl.property);
                 if (!mapping) {
@@ -272,9 +256,8 @@ export function registerConvertCss(server) {
                             : `Use as a custom value (category: ${category})`,
                 };
             });
-            // コンポーネント検出
+            // 変換結果からコンポーネント候補と使用例を組み立てる。
             const suggestedComponent = detectComponent(declarations);
-            // 使用例
             const example = buildExample(conversions, suggestedComponent);
             return success({
                 conversions,

package/dist/tools/get-guide.js

@@ -22,14 +22,14 @@ const GUIDE_TOPICS = {
     'set-class': { files: ['set-class.md'], label: 'Set classes (set--plain, set--bxsh, set--hov, etc.)' },
     'primitive-class': {
         files: ['primitive-class.md'],
-        label: 'Primitive class prefixes (is--, l--, a--) and Component class (c--), with column-layout primitive selection guide',
+        label: 'Primitive class prefixes (l--, a--), with column-layout primitive selection guide',
     },
     'trait-class': {
         files: ['trait-class.md'],
         label: 'Trait classes (is--, has--): declarative role/feature classes in the lism-trait layer',
     },
     'utility-class': { files: ['utility-class.md'], label: 'Utility classes (u--trim, u--cbox, etc.)' },
-    'css-rules': { files: ['css-rules.md'], label: 'CSS methodology, layer structure, naming conventions' },
+    'css-rules': { files: ['css-rules.md'], label: 'CSS methodology, layer structure, Block Class (b--) / Custom Class (c--), naming conventions' },
     naming: {
         files: ['naming.md'],
         label: 'Naming conventions: CSS variable / class naming rules, {prop} and {value} abbreviation rules',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lism-css/mcp",
-  "version": "0.24.0",
+  "version": "0.27.0",
   "description": "MCP server for lism-css documentation and API reference.",
   "keywords": [
     "mcp",
@@ -24,13 +24,13 @@
     "bin"
   ],
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@types/node": "^25.0.0",
-    "typescript": "^5.8.3",
-    "vitest": "^4.1.0"
+    "@types/node": "^25.9.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.10"
   },
   "license": "MIT",
   "engines": {