@ikas/code-components-mcp 1.4.0-beta.61 → 1.4.0-beta.62

package/data/storefront-api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-16T07:27:28.550Z",
+  "generatedAt": "2026-06-16T09:24:46.528Z",
   "functions": [
     {
       "name": "apiListProductBrand",
@@ -15141,7 +15141,7 @@
     {
       "name": "getThemeSetting",
       "signature": "function getThemeSetting(name: string): ThemeSetting | undefined",
-      "description": "A single global variable by its stable key (`variableName`, e.g. `_6Q0KV7VGGM`).\nDiscover keys via  (each item carries a human `displayName`).\nThe returned `value` is the live blueprint value when available, else the default.",
+      "description": "A single global variable by its stable key (`variableName`, e.g. `_6Q0KV7VGGM`).\nDiscover keys via  (each item carries a human `displayName`).\nThe returned `value` is the live blueprint value when available, else the default.\nIts shape is discriminated by `type` (see ); note an\nIMAGE setting's value is an image REFERENCE (no `.url`) — resolve with\n`getDefaultSrc`/`getSrc`.",
       "params": [],
       "returnType": "ThemeSetting | undefined",
       "categories": [],
@@ -15207,7 +15207,7 @@
     {
       "name": "getThemeColorSchemes",
       "signature": "function getThemeColorSchemes(): { schemes: { id: string; name: string }[]; values: ColorSchemeToken[] }",
-      "description": "Theme color schemes — the available schemes plus per-scheme color values.",
+      "description": "Theme color schemes (palettes). Returns two PARALLEL lists with different jobs:\n- `schemes`: the color SLOTS as `{ id, name }` LABELS only — no colors live here.\n  Use it to resolve a slot's display name from its id.\n- `values`: the actual palettes. A palette's colors live in its `colorsByScheme`\n  map, keyed by slot id → `{ resolved, cssVar }`.\n\nTo render swatches, iterate `values[].colorsByScheme` (the source of truth for\ncolors), NOT the top-level `schemes` array — `schemes` carries labels only, so\niterating it renders empty. Look up each swatch's label from `schemes` by its\nslot-id key:\n\n  const { schemes, values } = getThemeColorSchemes();\n  const slotName = (id: string) => schemes.find(s => s.id === id)?.name ?? id;\n  values.forEach(palette =>\n    Object.entries(palette.colorsByScheme).forEach(([slotId, { resolved, cssVar }]) => {\n      // slotName(slotId) → label, cssVar → live var() ref (prefer this), resolved → hex snapshot\n    })\n  );",
       "params": [],
       "returnType": "{ schemes: { id: string; name: string }[]; values: ColorSchemeToken[] }",
       "categories": [],

package/data/storefront-types.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-06-16T07:27:28.572Z",
+  "generatedAt": "2026-06-16T09:24:46.549Z",
   "types": [
     {
       "name": "IkasProductAttributeDetail",
@@ -11771,6 +11771,511 @@
         }
       ],
       "filePath": "video/index.ts"
+    },
+    {
+      "name": "ThemeSetting",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "displayName",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "type",
+          "type": "GlobalVariableType",
+          "optional": false
+        },
+        {
+          "name": "value",
+          "type": "any",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "DesignToken",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "resolved",
+          "type": "string | null",
+          "optional": false
+        },
+        {
+          "name": "cssVar",
+          "type": "string",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "TypographyToken",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "resolved",
+          "type": "Record<string, string>",
+          "optional": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "BreakpointToken",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "KeyframeToken",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "type",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "ref",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "points",
+          "type": "{ point: string }[]",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ColorSchemeToken",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "isDefault",
+          "type": "boolean",
+          "optional": false
+        },
+        {
+          "name": "className",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "colorsByScheme",
+          "type": "Record<string, { resolved: string | null; cssVar: string }>",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ThemeGlobals",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "settings",
+          "type": "Record<string, ThemeSetting>",
+          "optional": false
+        },
+        {
+          "name": "colors",
+          "type": "DesignToken[]",
+          "optional": false
+        },
+        {
+          "name": "typography",
+          "type": "TypographyToken[]",
+          "optional": false
+        },
+        {
+          "name": "breakpoints",
+          "type": "BreakpointToken[]",
+          "optional": false
+        },
+        {
+          "name": "keyframes",
+          "type": "KeyframeToken[]",
+          "optional": false
+        },
+        {
+          "name": "colorSchemes",
+          "type": "{ schemes: { id: string; name: string }[]; values: ColorSchemeToken[] }",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "StyleValueLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "value",
+          "type": "any",
+          "optional": true
+        },
+        {
+          "name": "patternValueId",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "keyframeValueId",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "colorSchemeId",
+          "type": "string",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "StyleConditionLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "value",
+          "type": "StyleValueLike",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ElementStyleLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "property",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "value",
+          "type": "StyleValueLike | StyleConditionLike[]",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "PatternValueLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "style",
+          "type": "ElementStyleLike",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "PatternElementLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "styles",
+          "type": "ElementStyleLike[]",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ColorSchemeLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ColorSchemeValueColorLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "colorSchemeId",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "style",
+          "type": "StyleValueLike",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "ColorSchemeValueLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "isDefault",
+          "type": "boolean",
+          "optional": true
+        },
+        {
+          "name": "designAssetId",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "colors",
+          "type": "ColorSchemeValueColorLike[]",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "BreakpointLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "width",
+          "type": "number",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "KeyframePointLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "point",
+          "type": "string",
+          "optional": false
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "KeyframeLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": false
+        },
+        {
+          "name": "name",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "type",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "points",
+          "type": "KeyframePointLike[]",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "VariableLike",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "id",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "variableName",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "displayName",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "variableType",
+          "type": "string",
+          "optional": true
+        },
+        {
+          "name": "defaultValue",
+          "type": "any",
+          "optional": true
+        },
+        {
+          "name": "isGlobal",
+          "type": "boolean",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
+    },
+    {
+      "name": "SerializableProject",
+      "kind": "type",
+      "domain": "theme",
+      "properties": [
+        {
+          "name": "globalsBlueprint",
+          "type": "{ module?: { variables?: VariableLike[] } }",
+          "optional": true
+        },
+        {
+          "name": "theme",
+          "type": "{\n    breakpoints?: BreakpointLike[];\n    keyframes?: KeyframeLike[];\n    pattern?: {\n      values?: PatternValueLike[];\n      elements?: PatternElementLike[];\n      colorSchemes?: ColorSchemeLike[];\n      colorSchemeValues?: ColorSchemeValueLike[];\n    };\n  }",
+          "optional": true
+        }
+      ],
+      "filePath": "theme-globals.ts"
     }
   ]
 }

package/dist/index.js

@@ -2227,7 +2227,7 @@ server.tool("get_framework_guide", "Get a framework guide on a specific topic (e
     };
 });
 // Tool: get_type_definition
-server.tool("get_type_definition", "Get the full definition of a storefront type or enum by name (e.g. 'IkasProduct', 'IkasOrderStatus'). Shows all properties with types, extends, or enum values.", {
+server.tool("get_type_definition", "Get the full definition of a storefront type or enum by name. Shows all properties with types, extends, or enum values. Covers both runtime models (e.g. 'IkasProduct', 'IkasOrderStatus') and theme-globals tokens returned by the getters (e.g. 'ThemeSetting', 'DesignToken', 'TypographyToken', 'ColorSchemeToken', 'BreakpointToken', 'KeyframeToken'). If a type reports as not found, it may not be indexed yet — fall back to reading the package's `.d.ts` (e.g. `@ikas/bp-storefront-config`) rather than typing the value as `any`.", {
     name: z
         .string()
         .describe("Type or enum name (e.g. 'IkasProduct', 'IkasOrderStatus')"),
@@ -4050,7 +4050,7 @@ server.tool("get_editor_workflow", "Read this FIRST when the user wants to place
     return { content: [{ type: "text", text: EDITOR_WORKFLOW_GUIDE }] };
 });
 // Tool: list_theme_globals
-server.tool("list_theme_globals", "List the theme's global settings from the connected editor: global variables (Theme Settings) and design tokens (colors, typography, breakpoints, keyframes, color schemes). Call this BEFORE generating sections/components so you reuse the theme's existing variables and tokens (read them in component code via `getThemeSetting`/`getThemeColors`/... from `@ikas/bp-storefront`). Includes items created manually in the editor UI. Requires `ikas-component dev` running with the editor connected.", {
+server.tool("list_theme_globals", "List the theme's global settings from the connected editor: global variables (Theme Settings) and design tokens (colors, typography, breakpoints, keyframes, color schemes). Call this BEFORE generating sections/components so you reuse the theme's existing variables and tokens (read them in component code via `getThemeSetting`/`getThemeColors`/... from `@ikas/bp-storefront`). Includes items created manually in the editor UI. Requires `ikas-component dev` running with the editor connected. Two shape gotchas when consuming the result at runtime: (1) color schemes — `colorSchemes.schemes` holds only `{id,name}` slot LABELS; the actual colors live in `colorSchemes.values[].colorsByScheme` keyed by slot id, so iterate `values[].colorsByScheme` (iterating `schemes` renders empty). (2) An IMAGE setting's `value` is an image REFERENCE like `{id:'theme-images/<uuid>'}` with no `.url` — resolve it via `getDefaultSrc`/`getSrc`.", {
     project_root: z.string().describe("Absolute path to the code-component project (where `node_modules/.bin/ikas-component` lives)."),
     port: z.number().optional().describe("Dev server WebSocket port (default 5201)."),
 }, async ({ project_root, port }) => {