@santi020k/lumen-mcp 0.2.0 → 0.3.0

package/bin/lumen-mcp-local.mjs

@@ -1,6 +1,4 @@
-
 import { spawnSync } from 'node:child_process'
-import * as fs from 'node:fs/promises'
 import { dirname, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
@@ -9,6 +7,7 @@ const repoRoot = resolve(packageRoot, '../..')
 const distEntry = join(packageRoot, 'dist/index.js')
 
 const filesIn = async (directory) => {
+  const fs = await import('node:fs/promises')
   const entries = await fs.readdir(directory, { withFileTypes: true })
 
   const nested = await Promise.all(entries.map((entry) => {
@@ -21,6 +20,8 @@ const filesIn = async (directory) => {
 }
 
 const needsBuild = async () => {
+  const fs = await import('node:fs/promises')
+
   try {
     await fs.access(distEntry)
   } catch {

package/data/lumen-data.json

@@ -23,6 +23,7 @@
       "Checkbox": "d971d97482ba924a07d4891cc782dd14c87b9f8bdb7b4070181b2189748b8be1",
       "Collapsible": "7652876be7a40fc2451168ea8220c49a5ef0fcfddc04d6d5ff424e6d2d26a04a",
       "Code": "e2f5eea415e1d2212dcb782487b417806f7ba6a7b1469f1b74a082fe35523275",
+      "CodeTabs": "2fc520388101b91ed507df0bc2d26cd97cb45cdf7510017d81c6fb4c85e7d51a",
       "Combobox": "93821fbc97e296cf426a53f52eda225b0361fba9c22a2f612436008be8efe4e2",
       "Command": "41c6175a15f7267bbf42fd00b74127571875e80a79d3f6700fad0abc3ccde09a",
       "ContextMenu": "93130a486b3e5c33c3ba05c510069bb51ab7be4a37ab0f1d45c50064527e8512",
@@ -30,7 +31,7 @@
       "DataTable": "98b6681fe1324a2367d47cac7a406b9ad85fc2c04746ff1c5b0fe7bc7c9fea68",
       "DatePicker": "6a70845a80a56e740a6a9dd8958d20255812e4dde78ace4beb86338a08f9bcae",
       "DateRangePicker": "e4d2f62fac35eda4d7662a745b0121bfa1aa995658cd51f8203836298a4028a8",
-      "Dialog": "cff17667f14a718462381776a9ad9ca8216c9dc865ea439f83fc0d45859f78e6",
+      "Dialog": "35302b79415111b97316bf2590e1b50d25f4ab606705e4a51feb768b5c79e8c5",
       "Direction": "ceba5f37b9f7a2e8f0b0d70175b1dc161bfe0674db962adc837838f2f20de51c",
       "Drawer": "8ef5a38b8fbcce6a27b10523b57cfd30728ec2f902515ada9566a2f21b2ec302",
       "DropdownMenu": "104ffe49547e89a91d312d9bdfcbab4ec76188decbad8140ef920bfe91804d7c",
@@ -4281,6 +4282,309 @@
       "recipes": [],
       "runtimeEvents": []
     },
+    {
+      "apiReference": [
+        {
+          "attribute": "items",
+          "defaultValue": "required",
+          "description": "Defines the labelled code examples and their stable selection values.",
+          "values": "Array<{ code, label, language?, value }>"
+        },
+        {
+          "attribute": "ariaLabel",
+          "defaultValue": "\"Code examples\"",
+          "description": "Names the tab list for assistive technology.",
+          "values": "string"
+        },
+        {
+          "attribute": "initialValue",
+          "defaultValue": "first item value",
+          "description": "Selects the matching code example before interaction.",
+          "values": "string"
+        },
+        {
+          "attribute": "storageKey",
+          "defaultValue": "-",
+          "description": "Persists selection and synchronizes CodeTabs instances that share this key.",
+          "values": "string"
+        },
+        {
+          "attribute": "copy",
+          "defaultValue": "true",
+          "description": "Shows a copy button for each code example.",
+          "values": "boolean"
+        },
+        {
+          "attribute": "theme",
+          "defaultValue": "\"auto\"",
+          "description": "Selects the code palette family.",
+          "values": "\"auto\" | \"lumen\" | \"santi020k\""
+        },
+        {
+          "attribute": "wrap",
+          "defaultValue": "true",
+          "description": "Wraps long code lines instead of requiring horizontal scrolling.",
+          "values": "boolean"
+        },
+        {
+          "attribute": "class, className",
+          "defaultValue": "\"\"",
+          "description": "Merges custom classes with the generated ui-* root classes.",
+          "values": "string"
+        },
+        {
+          "attribute": "...native attributes",
+          "defaultValue": "-",
+          "description": "Forwards standard attributes to the root element unless the component consumes them.",
+          "values": "HTML attributes"
+        }
+      ],
+      "astroSource": "---\nimport { resolveLumenAstroProps } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\nimport Code from './Code.astro'\nimport Tabs from './Tabs.astro'\n\ntype CodeTheme = 'auto' | 'lumen' | 'santi020k'\n\nexport interface CodeTabItem {\n  code: string\n  label: string\n  language?: string\n  value: string\n}\n\ninterface Props extends HTMLAttributes<'div'> {\n  ariaLabel?: string\n  class?: string | null\n  className?: string\n  copy?: boolean\n  initialValue?: string\n  items: readonly CodeTabItem[]\n  storageKey?: string\n  theme?: CodeTheme\n  wrap?: boolean\n}\n\nconst {\n  ariaLabel = 'Code examples',\n  class: classProp = '',\n  className = '',\n  copy = true,\n  initialValue,\n  items,\n  storageKey,\n  theme = 'auto',\n  wrap = true,\n  ...rest\n} = Astro.props\n\nconst selectedValue = initialValue ?? items[0]?.value\nconst tabsStateProps = {\n  ...(selectedValue === undefined ? {} : { initialValue: selectedValue }),\n  ...(storageKey === undefined ? {} : { storageKey })\n}\nconst { classList, passthrough } = resolveLumenAstroProps(\n  rest,\n  ['ui-code-tabs'],\n  classProp ?? '',\n  className\n)\n---\n\n<Tabs\n  class:list={classList}\n  {...tabsStateProps}\n  {...passthrough}\n>\n  <div class=\"ui-code-tabs__list\" role=\"tablist\" aria-label={ariaLabel}>\n    {items.map(item => (\n      <button\n        aria-selected={item.value === selectedValue ? 'true' : 'false'}\n        class=\"ui-code-tabs__tab\"\n        data-value={item.value}\n        role=\"tab\"\n        type=\"button\"\n      >\n        {item.label}\n      </button>\n    ))}\n  </div>\n\n  {items.map(item => (\n    <div\n      class=\"ui-code-tabs__panel\"\n      data-value={item.value}\n      hidden={item.value !== selectedValue}\n      role=\"tabpanel\"\n    >\n      <Code\n        code={item.code}\n        copy={copy}\n        {...(item.language === undefined ? {} : { language: item.language })}\n        theme={theme}\n        variant=\"block\"\n        wrap={wrap}\n      />\n    </div>\n  ))}\n</Tabs>\n",
+      "category": "Data display",
+      "collections": [],
+      "dependencies": [
+        "Code",
+        "Tabs",
+        "styles",
+        "runtime"
+      ],
+      "description": "Groups related code examples into accessible, persistent tabs.",
+      "files": [
+        "packages/astro/components/CodeTabs.astro",
+        "packages/astro/components/Code.astro",
+        "packages/astro/components/Tabs.astro",
+        "packages/astro/styles/lumen.css",
+        "packages/astro/runtime/UIPrimitives.astro"
+      ],
+      "frameworkDetails": {
+        "astro": {
+          "available": true,
+          "behavior": {
+            "mode": "runtime",
+            "setup": "Mount UIPrimitives once in the application's root layout; do not mount it beside each component."
+          },
+          "example": "<CodeTabs ariaLabel=\"Package manager\" items={[{ value: \"pnpm\", label: \"pnpm\", code: \"pnpm add @santi020k/lumen-astro\", language: \"bash\" }, { value: \"npm\", label: \"npm\", code: \"npm install @santi020k/lumen-astro\", language: \"bash\" }]} storageKey=\"preferred-package-manager\" />",
+          "importStatement": "import { CodeTabs } from '@santi020k/lumen-astro'",
+          "language": "astro",
+          "packageName": "@santi020k/lumen-astro",
+          "props": [
+            {
+              "name": "ariaLabel",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "class",
+              "optional": true,
+              "type": "string | null"
+            },
+            {
+              "name": "className",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "copy",
+              "optional": true,
+              "type": "boolean"
+            },
+            {
+              "name": "initialValue",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "items",
+              "optional": false,
+              "type": "readonly CodeTabItem[]"
+            },
+            {
+              "name": "storageKey",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "theme",
+              "optional": true,
+              "type": "CodeTheme"
+            },
+            {
+              "name": "wrap",
+              "optional": true,
+              "type": "boolean"
+            }
+          ],
+          "propsExtends": "HTMLAttributes<'div'>",
+          "source": "---\nimport { resolveLumenAstroProps } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\nimport Code from './Code.astro'\nimport Tabs from './Tabs.astro'\n\ntype CodeTheme = 'auto' | 'lumen' | 'santi020k'\n\nexport interface CodeTabItem {\n  code: string\n  label: string\n  language?: string\n  value: string\n}\n\ninterface Props extends HTMLAttributes<'div'> {\n  ariaLabel?: string\n  class?: string | null\n  className?: string\n  copy?: boolean\n  initialValue?: string\n  items: readonly CodeTabItem[]\n  storageKey?: string\n  theme?: CodeTheme\n  wrap?: boolean\n}\n\nconst {\n  ariaLabel = 'Code examples',\n  class: classProp = '',\n  className = '',\n  copy = true,\n  initialValue,\n  items,\n  storageKey,\n  theme = 'auto',\n  wrap = true,\n  ...rest\n} = Astro.props\n\nconst selectedValue = initialValue ?? items[0]?.value\nconst tabsStateProps = {\n  ...(selectedValue === undefined ? {} : { initialValue: selectedValue }),\n  ...(storageKey === undefined ? {} : { storageKey })\n}\nconst { classList, passthrough } = resolveLumenAstroProps(\n  rest,\n  ['ui-code-tabs'],\n  classProp ?? '',\n  className\n)\n---\n\n<Tabs\n  class:list={classList}\n  {...tabsStateProps}\n  {...passthrough}\n>\n  <div class=\"ui-code-tabs__list\" role=\"tablist\" aria-label={ariaLabel}>\n    {items.map(item => (\n      <button\n        aria-selected={item.value === selectedValue ? 'true' : 'false'}\n        class=\"ui-code-tabs__tab\"\n        data-value={item.value}\n        role=\"tab\"\n        type=\"button\"\n      >\n        {item.label}\n      </button>\n    ))}\n  </div>\n\n  {items.map(item => (\n    <div\n      class=\"ui-code-tabs__panel\"\n      data-value={item.value}\n      hidden={item.value !== selectedValue}\n      role=\"tabpanel\"\n    >\n      <Code\n        code={item.code}\n        copy={copy}\n        {...(item.language === undefined ? {} : { language: item.language })}\n        theme={theme}\n        variant=\"block\"\n        wrap={wrap}\n      />\n    </div>\n  ))}\n</Tabs>\n",
+          "styleImport": "import '@santi020k/lumen-astro/styles.css'"
+        },
+        "elements": {
+          "attributes": [
+            "data-ui-tabs",
+            "items",
+            "ariaLabel",
+            "initialValue",
+            "storageKey",
+            "copy",
+            "theme",
+            "wrap",
+            "class, className",
+            "...native attributes"
+          ],
+          "available": true,
+          "behavior": {
+            "mode": "registration",
+            "setup": "Call defineLumenElements() once before rendering Lumen custom elements. Registration includes this component’s interactive behavior."
+          },
+          "example": "<lumen-code-tabs></lumen-code-tabs>",
+          "importStatement": "import { defineLumenElements } from '@santi020k/lumen-elements/define'",
+          "language": "html",
+          "packageName": "@santi020k/lumen-elements",
+          "props": [],
+          "propsExtends": "HTMLElement attributes",
+          "registration": "defineLumenElements()",
+          "source": "CodeTabs: {\n    baseClassName: 'ui-code-tabs',\n    defaults: { 'data-ui-tabs': '' },\n    tagName: 'lumen-code-tabs'\n  }",
+          "styleImport": "import '@santi020k/lumen-elements/styles.css'",
+          "tagName": "lumen-code-tabs"
+        },
+        "react": {
+          "available": true,
+          "behavior": {
+            "mode": "built-in",
+            "setup": "Interactive behavior is implemented by the React component; do not mount Astro UIPrimitives."
+          },
+          "example": "<CodeTabs ariaLabel=\"Package manager\" items={[{ value: \"pnpm\", label: \"pnpm\", code: \"pnpm add @santi020k/lumen-astro\", language: \"bash\" }, { value: \"npm\", label: \"npm\", code: \"npm install @santi020k/lumen-astro\", language: \"bash\" }]} storageKey=\"preferred-package-manager\" />",
+          "importStatement": "import { CodeTabs } from '@santi020k/lumen-react'",
+          "language": "tsx",
+          "packageName": "@santi020k/lumen-react",
+          "props": [
+            {
+              "name": "ariaLabel",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "copy",
+              "optional": true,
+              "type": "boolean"
+            },
+            {
+              "name": "initialValue",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "items",
+              "optional": true,
+              "type": "readonly CodeTabItem[]"
+            },
+            {
+              "name": "storageKey",
+              "optional": true,
+              "type": "string"
+            },
+            {
+              "name": "theme",
+              "optional": true,
+              "type": "CodeTheme"
+            },
+            {
+              "name": "wrap",
+              "optional": true,
+              "type": "boolean"
+            }
+          ],
+          "propsExtends": "Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'defaultValue'>",
+          "source": "export interface CodeTabsProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children' | 'defaultValue'> {\n  ariaLabel?: string\n  copy?: boolean\n  initialValue?: string\n  items?: readonly CodeTabItem[]\n  storageKey?: string\n  theme?: CodeTheme\n  wrap?: boolean\n}\n\nexport const CodeTabs = ({\n  ariaLabel = 'Code examples',\n  className,\n  copy = true,\n  initialValue,\n  items = emptyCodeTabItems,\n  storageKey,\n  theme = 'auto',\n  wrap = true,\n  ...props\n}: CodeTabsProps) => {\n  const selectedValue = initialValue ?? items[0]?.value\n\n  const [value, setValue] = useState(() => {\n    let storedValue: string | null = null\n\n    if (storageKey && typeof localStorage !== 'undefined') {\n      try {\n        storedValue = localStorage.getItem(storageKey)\n      } catch {\n        // Storage can be unavailable in privacy modes; tab selection should still work.\n      }\n    }\n\n    return storedValue && items.some(item => item.value === storedValue)\n      ? storedValue\n      : (selectedValue ?? '')\n  })\n\n  useEffect(() => {\n    const synchronize = (event: Event) => {\n      const detail = (event as CustomEvent<{ storageKey?: string; value?: string }>).detail\n\n      if (\n        storageKey &&\n        detail.storageKey === storageKey &&\n        detail.value &&\n        items.some(item => item.value === detail.value)\n      ) {\n        setValue(detail.value)\n      }\n    }\n\n    document.addEventListener('ui:tabs-change', synchronize)\n\n    return () => {\n      document.removeEventListener('ui:tabs-change', synchronize)\n    }\n  }, [items, storageKey])\n\n  const selectValue = (nextValue: string) => {\n    setValue(nextValue)\n\n    if (storageKey) {\n      try {\n        localStorage.setItem(storageKey, nextValue)\n      } catch {\n        // Storage can be unavailable in privacy modes; tab selection should still work.\n      }\n    }\n\n    document.dispatchEvent(new CustomEvent('ui:tabs-change', {\n      detail: { storageKey, value: nextValue }\n    }))\n  }\n\n  return (\n    <Tabs\n      className={composeClassName('ui-code-tabs', className)}\n      data-storage-key={storageKey}\n      onValueChange={selectValue}\n      value={value}\n      {...props}\n    >\n      <TabsList aria-label={ariaLabel} className=\"ui-code-tabs__list\">\n        {items.map(item => (\n          <TabsTrigger className=\"ui-code-tabs__tab\" key={item.value} value={item.value}>\n            {item.label}\n          </TabsTrigger>\n        ))}\n      </TabsList>\n      {items.map(item => (\n        <TabsPanel className=\"ui-code-tabs__panel\" key={item.value} value={item.value}>\n          <Code\n            code={item.code}\n            copy={copy}\n            {...(item.language === undefined ? {} : { language: item.language })}\n            theme={theme}\n            variant=\"block\"\n            wrap={wrap}\n          />\n        </TabsPanel>\n      ))}\n    </Tabs>\n  )\n}",
+          "styleImport": "import '@santi020k/lumen-react/styles.css'"
+        }
+      },
+      "frameworks": {
+        "astro": true,
+        "elements": true,
+        "react": true
+      },
+      "guidance": null,
+      "kebab": "code-tabs",
+      "keyboardInteractions": [
+        {
+          "action": "Activate and focus the next code example, wrapping at the end.",
+          "key": "ArrowRight"
+        },
+        {
+          "action": "Activate and focus the previous code example, wrapping at the start.",
+          "key": "ArrowLeft"
+        },
+        {
+          "action": "Activate and focus the first or last code example.",
+          "key": "Home, End"
+        }
+      ],
+      "keywords": [
+        "accessible",
+        "code",
+        "codetabs",
+        "data",
+        "display",
+        "examples",
+        "groups",
+        "into",
+        "persistent",
+        "related",
+        "tabs"
+      ],
+      "name": "CodeTabs",
+      "props": [
+        {
+          "name": "ariaLabel",
+          "optional": true,
+          "type": "string"
+        },
+        {
+          "name": "class",
+          "optional": true,
+          "type": "string | null"
+        },
+        {
+          "name": "className",
+          "optional": true,
+          "type": "string"
+        },
+        {
+          "name": "copy",
+          "optional": true,
+          "type": "boolean"
+        },
+        {
+          "name": "initialValue",
+          "optional": true,
+          "type": "string"
+        },
+        {
+          "name": "items",
+          "optional": false,
+          "type": "readonly CodeTabItem[]"
+        },
+        {
+          "name": "storageKey",
+          "optional": true,
+          "type": "string"
+        },
+        {
+          "name": "theme",
+          "optional": true,
+          "type": "CodeTheme"
+        },
+        {
+          "name": "wrap",
+          "optional": true,
+          "type": "boolean"
+        }
+      ],
+      "propsExtends": "HTMLAttributes<'div'>",
+      "recipes": [],
+      "runtimeEvents": []
+    },
     {
       "apiReference": [
         {
@@ -5877,6 +6181,12 @@
           "description": "Deprecated alias for glass; surface=\"glass\" maps to glass={true}.",
           "values": "\"default\" | \"glass\""
         },
+        {
+          "attribute": "layout",
+          "defaultValue": "\"centered\"",
+          "description": "Uses the standard centered panel or a viewport-filling native dialog shell.",
+          "values": "\"centered\" | \"fullscreen\""
+        },
         {
           "attribute": "id",
           "defaultValue": "-",
@@ -5908,7 +6218,7 @@
           "values": "HTML attributes"
         }
       ],
-      "astroSource": "---\nimport { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\ninterface Props extends HTMLAttributes<'dialog'> {\n  class?: string | null\n  className?: string\n  glass?: boolean | 'subtle' | 'strong'\n  /**\n   * @deprecated Use `glass` instead. `surface=\"glass\"` maps to `glass={true}`.\n   */\n  surface?: 'default' | 'glass'\n}\n\nconst {\n  class: classProp = '',\n  className = '',\n  glass = false,\n  surface = 'default',\n  ...rest\n} = Astro.props\n\nconst resolvedGlass = resolveLumenGlass(glass, surface)\nconst { classList, passthrough } = resolveLumenAstroProps(rest, [\n    'ui-dialog',\n    resolvedGlass && 'ui-dialog--glass',\n    glass === 'subtle' && 'ui-glass-subtle',\n    glass === 'strong' && 'ui-glass-strong'\n], classProp, className)\n---\n\n<dialog\n  data-surface={resolvedGlass ? 'glass' : 'default'}\n  data-ui-dialog\n  class:list={classList}\n  {...passthrough}\n>\n  <slot />\n</dialog>\n",
+      "astroSource": "---\nimport { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\ninterface Props extends HTMLAttributes<'dialog'> {\n  class?: string | null\n  className?: string\n  glass?: boolean | 'subtle' | 'strong'\n  layout?: 'centered' | 'fullscreen'\n  /**\n   * @deprecated Use `glass` instead. `surface=\"glass\"` maps to `glass={true}`.\n   */\n  surface?: 'default' | 'glass'\n}\n\nconst {\n  class: classProp = '',\n  className = '',\n  glass = false,\n  layout = 'centered',\n  surface = 'default',\n  ...rest\n} = Astro.props\n\nconst resolvedGlass = resolveLumenGlass(glass, surface)\nconst { classList, passthrough } = resolveLumenAstroProps(rest, [\n    'ui-dialog',\n    layout === 'fullscreen' && 'ui-dialog--fullscreen',\n    resolvedGlass && 'ui-dialog--glass',\n    glass === 'subtle' && 'ui-glass-subtle',\n    glass === 'strong' && 'ui-glass-strong'\n], classProp, className)\n---\n\n<dialog\n  data-surface={resolvedGlass ? 'glass' : 'default'}\n  data-layout={layout}\n  data-ui-dialog\n  class:list={classList}\n  {...passthrough}\n>\n  <slot />\n</dialog>\n",
       "category": "Overlays",
       "collections": [
         "Dialogs and contextual layers"
@@ -5952,6 +6262,11 @@
               "optional": true,
               "type": "boolean | 'subtle' | 'strong'"
             },
+            {
+              "name": "layout",
+              "optional": true,
+              "type": "'centered' | 'fullscreen'"
+            },
             {
               "name": "surface",
               "optional": true,
@@ -5959,13 +6274,14 @@
             }
           ],
           "propsExtends": "HTMLAttributes<'dialog'>",
-          "source": "---\nimport { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\ninterface Props extends HTMLAttributes<'dialog'> {\n  class?: string | null\n  className?: string\n  glass?: boolean | 'subtle' | 'strong'\n  /**\n   * @deprecated Use `glass` instead. `surface=\"glass\"` maps to `glass={true}`.\n   */\n  surface?: 'default' | 'glass'\n}\n\nconst {\n  class: classProp = '',\n  className = '',\n  glass = false,\n  surface = 'default',\n  ...rest\n} = Astro.props\n\nconst resolvedGlass = resolveLumenGlass(glass, surface)\nconst { classList, passthrough } = resolveLumenAstroProps(rest, [\n    'ui-dialog',\n    resolvedGlass && 'ui-dialog--glass',\n    glass === 'subtle' && 'ui-glass-subtle',\n    glass === 'strong' && 'ui-glass-strong'\n], classProp, className)\n---\n\n<dialog\n  data-surface={resolvedGlass ? 'glass' : 'default'}\n  data-ui-dialog\n  class:list={classList}\n  {...passthrough}\n>\n  <slot />\n</dialog>\n",
+          "source": "---\nimport { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core'\n\nimport type { HTMLAttributes } from 'astro/types'\n\ninterface Props extends HTMLAttributes<'dialog'> {\n  class?: string | null\n  className?: string\n  glass?: boolean | 'subtle' | 'strong'\n  layout?: 'centered' | 'fullscreen'\n  /**\n   * @deprecated Use `glass` instead. `surface=\"glass\"` maps to `glass={true}`.\n   */\n  surface?: 'default' | 'glass'\n}\n\nconst {\n  class: classProp = '',\n  className = '',\n  glass = false,\n  layout = 'centered',\n  surface = 'default',\n  ...rest\n} = Astro.props\n\nconst resolvedGlass = resolveLumenGlass(glass, surface)\nconst { classList, passthrough } = resolveLumenAstroProps(rest, [\n    'ui-dialog',\n    layout === 'fullscreen' && 'ui-dialog--fullscreen',\n    resolvedGlass && 'ui-dialog--glass',\n    glass === 'subtle' && 'ui-glass-subtle',\n    glass === 'strong' && 'ui-glass-strong'\n], classProp, className)\n---\n\n<dialog\n  data-surface={resolvedGlass ? 'glass' : 'default'}\n  data-layout={layout}\n  data-ui-dialog\n  class:list={classList}\n  {...passthrough}\n>\n  <slot />\n</dialog>\n",
           "styleImport": "import '@santi020k/lumen-astro/styles.css'"
         },
         "elements": {
           "attributes": [
             "data-ui-dialog",
             "glass",
+            "layout",
             "surface",
             "id",
             "data-ui-dialog-trigger",
@@ -5985,7 +6301,7 @@
           "props": [],
           "propsExtends": "HTMLElement attributes",
           "registration": "defineLumenElements()",
-          "source": "Dialog: {\n    attributeClasses: {\n      glass: { strong: 'ui-dialog--glass ui-glass-strong', subtle: 'ui-dialog--glass ui-glass-subtle', true: 'ui-dialog--glass' },\n      surface: { glass: 'ui-dialog--glass' }\n    },\n    baseClassName: 'ui-dialog',\n    defaults: { 'data-ui-dialog': '', surface: 'default' },\n    tagName: 'lumen-dialog'\n  }",
+          "source": "Dialog: {\n    attributeClasses: {\n      glass: { strong: 'ui-dialog--glass ui-glass-strong', subtle: 'ui-dialog--glass ui-glass-subtle', true: 'ui-dialog--glass' },\n      layout: { fullscreen: 'ui-dialog--fullscreen' },\n      surface: { glass: 'ui-dialog--glass' }\n    },\n    baseClassName: 'ui-dialog',\n    defaults: { 'data-ui-dialog': '', layout: 'centered', surface: 'default' },\n    tagName: 'lumen-dialog'\n  }",
           "styleImport": "import '@santi020k/lumen-elements/styles.css'",
           "tagName": "lumen-dialog"
         },
@@ -6083,9 +6399,15 @@
           "importStatement": "import { Button, Dialog, Card } from '@santi020k/lumen-react'\nimport { useDialog } from '@santi020k/lumen-react'",
           "language": "tsx",
           "packageName": "@santi020k/lumen-react",
-          "props": [],
+          "props": [
+            {
+              "name": "layout",
+              "optional": true,
+              "type": "'centered' | 'fullscreen'"
+            }
+          ],
           "propsExtends": "Omit<ComponentPropsWithoutRef<'dialog'>, 'open'> & SurfaceProps & Omit<DialogOptions, 'id'>",
-          "source": "export type DialogProps = Omit<ComponentPropsWithoutRef<'dialog'>, 'open'> & SurfaceProps & Omit<DialogOptions, 'id'>\n\nexport const Dialog = ({\n  className,\n  defaultOpen,\n  glass = false,\n  onClick,\n  onClose,\n  onOpenChange,\n  open,\n  surface = 'default',\n  ...props\n}: DialogProps) => {\n  const dialog = useDialog({ defaultOpen, onOpenChange, open })\n\n  return (\n    <dialog\n      {...dialog.dialogProps}\n      {...props}\n      className={composeClassName('ui-dialog', glassSurfaceClass('ui-dialog', surface, glass), className)}\n      data-surface={resolveSurface(surface, glass)}\n      onClick={composeHandlers(onClick, dialog.dialogProps.onClick)}\n      onClose={composeHandlers(onClose, dialog.dialogProps.onClose)}\n    />\n  )\n}",
+          "source": "export type DialogProps = Omit<ComponentPropsWithoutRef<'dialog'>, 'open'> & SurfaceProps & Omit<DialogOptions, 'id'> & {\n  layout?: 'centered' | 'fullscreen'\n}\n\nexport const Dialog = ({\n  className,\n  defaultOpen,\n  glass = false,\n  layout = 'centered',\n  onClick,\n  onClose,\n  onOpenChange,\n  open,\n  surface = 'default',\n  ...props\n}: DialogProps) => {\n  const dialog = useDialog({ defaultOpen, onOpenChange, open })\n\n  return (\n    <dialog\n      {...dialog.dialogProps}\n      {...props}\n      className={composeClassName(\n        'ui-dialog',\n        layout === 'fullscreen' && 'ui-dialog--fullscreen',\n        glassSurfaceClass('ui-dialog', surface, glass),\n        className\n      )}\n      data-layout={layout}\n      data-surface={resolveSurface(surface, glass)}\n      onClick={composeHandlers(onClick, dialog.dialogProps.onClick)}\n      onClose={composeHandlers(onClose, dialog.dialogProps.onClose)}\n    />\n  )\n}",
           "styleImport": "import '@santi020k/lumen-react/styles.css'"
         }
       },
@@ -6156,6 +6478,11 @@
           "optional": true,
           "type": "boolean | 'subtle' | 'strong'"
         },
+        {
+          "name": "layout",
+          "optional": true,
+          "type": "'centered' | 'fullscreen'"
+        },
         {
           "name": "surface",
           "optional": true,
@@ -24564,11 +24891,11 @@
   ],
   "docs": {
     "aiUsage": "# AI Usage Guide\n\nUse this guide when an AI agent is building an app with Lumen or updating examples that teach\nanother agent how to use the library.\n\n## Install the Lumen Agent Skill\n\nLumen ships a portable Agent Skill for AI coding tools that support the open `SKILL.md` format:\n\n```bash\nnpx skills add santi020k/lumen --skill lumen-ui\n```\n\nThe source lives in [`skills/lumen-ui`](../skills/lumen-ui). The skill provides the durable\nframework-selection, component-composition, theming, accessibility, and verification workflow.\nUse it by naming `$lumen-ui` in a prompt, or let a compatible agent trigger it from Lumen-specific\nrequests.\n\nThe skill and MCP server complement each other: the skill explains how to work, while\n`@santi020k/lumen-mcp` supplies structured catalog search, framework-specific contracts, recipes,\nsource, tokens, resources, and rules.\n\n## Pick the Right Package\n\nUse the framework requested by the user. Every adapter shares the same Lumen foundation.\n\n| App Target | Install | Import Components From | Load Styles From |\n| --- | --- | --- | --- |\n| Astro | `@santi020k/lumen-astro` | `@santi020k/lumen-astro` | `@santi020k/lumen-astro/styles.css` |\n| React | `@santi020k/lumen-react` | `@santi020k/lumen-react` | `@santi020k/lumen-react/styles.css` |\n| Web Components | `@santi020k/lumen-elements` | `@santi020k/lumen-elements/define` | `@santi020k/lumen-elements/styles.css` |\n| Package metadata | `@santi020k/lumen-core` | `@santi020k/lumen-core` | Not applicable |\n\nEach framework package includes the shared foundation. Install `@santi020k/lumen` separately only\nwhen you need its framework-neutral CLI or registry metadata.\n\n## MCP-Assisted Workflow\n\nConnect `@santi020k/lumen-mcp` when the agent supports Model Context Protocol. The server returns\nvalidated structured content as well as readable text, so agents can select components without\nscraping documentation.\n\n```bash\ncodex mcp add lumen -- npx -y @santi020k/lumen-mcp\n```\n\nFor Codex project configuration:\n\n```toml\n[mcp_servers.lumen]\nenabled = true\ncommand = \"npx\"\nargs = [\"-y\", \"@santi020k/lumen-mcp\"]\n```\n\nUse this sequence:\n\n1. Read `lumen://meta` and `lumen://diagnostics` to identify and verify the snapshot.\n2. Read `lumen://rules`.\n3. Search for the use case with `lumen_search`, passing the target `framework` when known.\n4. Inspect the selected framework with `lumen_get_component` and `detail: \"usage\"`.\n5. Follow its framework behavior setup and hook/controller contract.\n6. Read related multi-component guidance with `lumen_get_recipe`.\n7. Request `detail: \"source\"` only when the usage contract is insufficient.\n8. Read `lumen://tokens` before introducing custom styling.\n9. Retain `lumen://catalog-manifest` and use `lumen_diff_catalog` after upgrades to identify contracts that need refreshing.\n\nExample framework-aware component request:\n\n```json\n{\n  \"name\": \"lumen_get_component\",\n  \"arguments\": {\n    \"name\": \"DateRangePicker\",\n    \"framework\": \"react\",\n    \"detail\": \"usage\"\n  }\n}\n```\n\nStable resources are available at `lumen://rules`, `lumen://tokens`, `lumen://components`,\n`lumen://meta`, `lumen://catalog-manifest`, `lumen://diagnostics`,\n`lumen://components/{name}`, and `lumen://recipes/{name}`. See\n[`packages/mcp/README.md`](../packages/mcp/README.md) for Claude Desktop, Cursor, generic stdio,\nlocal repository, and programmatic examples.\n\n## Minimal Setup\n\nImport the stylesheet once in the app's global CSS, root layout, or app entry.\n\n```css\n@import \"@santi020k/lumen-react/styles.css\";\n```\n\nIf Tailwind is present, keep both imports in the same shared CSS entry.\n\n```css\n@import \"@santi020k/lumen-react/layers.css\";\n@import \"tailwindcss\";\n@import \"@santi020k/lumen-react/styles.css\";\n```\n\nKeep the layer prelude first. It places Tailwind base styles below Lumen components and Tailwind\nutilities above them, so consumer spacing, display, radius, width, and responsive visibility\nclasses override Lumen defaults predictably.\n\nAstro apps should mount `UIPrimitives` once in the root layout when using interactive primitives\nsuch as dialogs, menus, popovers, tabs, carousels, command lists, toggles, validated forms, or\ntoasts. Do not place `UIPrimitives` in each component example or next to each primitive instance;\none root include enhances all matching `data-ui-*` markup on the page.\n\n```astro\n---\nimport { UIPrimitives } from '@santi020k/lumen-astro'\n---\n\n<UIPrimitives />\n```\n\n## Astro\n\nUse direct named imports from `@santi020k/lumen-astro`.\n\n```astro\n---\nimport { Button, Card, Input, Label } from '@santi020k/lumen-astro'\n---\n\n<Card>\n  <Label for=\"email\">Email</Label>\n  <Input id=\"email\" type=\"email\" placeholder=\"you@example.com\" />\n  <Button type=\"submit\">Subscribe</Button>\n</Card>\n```\n\n## React\n\nReact components share the same visual classes and data attributes as Astro components. For\nbehavior-heavy primitives, use the React behavior hooks from `@santi020k/lumen-react` (`useDialog`,\n`usePopover`, `useDropdownMenu`, `useTabs`, `useSelect`, `useToast`, and `useTooltip`), which track\nthe Astro runtime's ARIA, keyboard, Escape, dismissal, and toast controller semantics.\n\nThe React package entry is a client boundary. In Next.js, it can be imported by a Server Component\nwithout evaluating Lumen's contexts and hooks in the React server runtime; the rendered Lumen\nsubtree becomes a Client Component boundary. Vite and other client-rendered React applications use\nthe same entry without additional setup.\n`Button`, `Link`, `ButtonLink`, and `Input` accept React 19 DOM refs directly as props.\n`Button asChild` composes the button contract onto one child element, while `Input visualSize` controls\npresentation without shadowing the native numeric `size` attribute.\n\n```tsx\nimport '@santi020k/lumen-react/styles.css'\nimport { Button, Card, Input, Label } from '@santi020k/lumen-react'\n\nexport function SubscribeForm() {\n  return (\n    <Card>\n      <Label htmlFor=\"email\">Email</Label>\n      <Input id=\"email\" type=\"email\" placeholder=\"you@example.com\" />\n      <Button type=\"submit\">Subscribe</Button>\n    </Card>\n  )\n}\n```\n\n## Web Components\n\nRegister custom elements once, then use `lumen-*` tags in HTML. The elements adapter includes\ninteractive behavior parity for DataTable, Dialog, Popover, DropdownMenu, ContextMenu, Tabs,\nSelect, ThemeBuilder, Toast, Tooltip, forms, RichTextEditor, Schedule, and VirtualList: selection,\nvalidation, rich text command, context menu, schedule drag/drop, theme, and range events, ARIA\nstate, roving/listbox keyboard paths, Escape/outside dismissal, focus return/trapping, native\nselect form participation, and the same toast controller events as the Astro runtime.\n\n```html\n<script type=\"module\">\n  import { defineLumenElements } from '@santi020k/lumen-elements/define'\n\n  defineLumenElements()\n</script>\n\n<lumen-card>\n  <label for=\"email\">Email</label>\n  <lumen-input id=\"email\" type=\"email\" placeholder=\"you@example.com\"></lumen-input>\n  <lumen-button type=\"submit\">Subscribe</lumen-button>\n</lumen-card>\n```\n\n## Component Selection\n\nThe shared catalog includes:\n\n`Accordion`, `Alert`, `AlertDialog`, `Agenda`, `AspectRatio`, `Attachment`, `Autocomplete`,\n`Avatar`, `Badge`, `Breadcrumb`, `Bubble`, `Button`, `ButtonGroup`, `Calendar`, `Card`,\n`Carousel`, `Chart`, `Checkbox`, `Collapsible`, `Code`, `Combobox`, `Command`, `ColorPicker`,\n`ContextMenu`, `DataTable`, `DatePicker`, `DateRangePicker`, `Dialog`, `Direction`, `Drawer`,\n`DropdownMenu`, `Empty`, `Field`, `HoverCard`, `Icon`, `Input`, `InputGroup`, `InputOTP`, `Item`, `Kbd`,\n`Label`, `Marker`, `Menubar`, `Message`, `MessageScroller`, `NativeSelect`, `NavigationMenu`,\n`NumberField`, `Pagination`, `Popover`, `Progress`, `RadioGroup`, `Resizable`, `RichTextEditor`,\n`ScrollArea`, `Schedule`, `SearchField`, `Select`, `Separator`, `Sheet`, `Sidebar`, `Skeleton`,\n`Slider`, `Spinner`, `Switch`, `Table`, `Tabs`, `TagGroup`, `Textarea`, `ThemeBuilder`,\n`TimeField`, `Toast`, `Toggle`, `ToggleGroup`, `Tooltip`, `Tree`, `TreeGrid`, `Typography`, and\n`VirtualList`.\n\n## Product Recipes\n\n- Use `Icon name=\"search\"` or any Lucide icon name for standard interface pictograms. Kebab-case\n  names and Lucide aliases work. Pair decorative icons with `decorative`, and pass `label` only\n  when the icon carries meaning on its own. Lucide does not include brand marks such as GitHub;\n  render a project-owned SVG through the default `Icon` slot for brand and custom icons. Astro\n  reports unknown named icons during development instead of failing silently.\n- Use `Schedule` with `Agenda`, `Calendar`, and `DatePicker` for booking, CRM, content calendar, and\n  event planning screens. Mark slots with `data-ui-schedule-slot` and events with\n  `data-ui-schedule-event`; the runtime emits `ui:schedule-change` when a draggable event is moved.\n  `Calendar` renders a hidden input plus selectable date grid; Astro `UIPrimitives` and registered\n  Web Components wire month navigation and roving keyboard focus directly, while React apps can use\n  the `Calendar` component or `useCalendar` for the same date selection contract.\n  Astro `UIPrimitives` and registered Web Components bind schedule drag/drop directly; React apps\n  can use `useSchedule` for `rootProps`, `getEventProps`, `getSlotProps`, and `ui:schedule-change`\n  parity. Use `createScheduleSlots`, `moveScheduleEvent`, and `expandRecurringScheduleEvent` from\n  `@santi020k/lumen-core` for reusable schedule state; use `getScheduleConflicts` and\n  `canPlaceScheduleEvent` before committing drag/drop changes. Persist local schedule edits with\n  `createScheduleStorageKey`, `saveScheduleEvents`, and `loadScheduleEvents` against any\n  `localStorage`-compatible adapter. Use `resizeScheduleEvent` and `resizeScheduleEvents` for\n  snap-to-grid resize handles.\n- Use `DataTable`, `Tree`, `TreeGrid`, `VirtualList`, `Pagination`, and `Command` for dense data\n  collection workflows. Astro and Elements wire selectable/sortable `DataTable` behavior and\n  `VirtualList` range events; React emits the same data attributes for app-level adapters. `Tree`\n  and `TreeGrid` use roving keyboard focus, and `VirtualList` emits `ui:virtual-list-range` as the\n  rendered range changes. Use `createDataViewState`,\n  `serializeDataViewState`, `parseDataViewState`, `applyDataViewState`, and `getVirtualRange` for\n  saved views, filtering, sorting, pagination, and virtualization math. Use\n  `createDataViewStorageKey`, `saveDataViewState`, and `loadDataViewState` when saved views should\n  survive navigation or reloads. Use `pinDataViewColumn`, `unpinDataViewColumn`,\n  `toggleDataViewSelection`, `createDataViewSearchParams`, and `createDataViewServerRequest` when\n  connecting dense views to router state or server-backed data.\n- Use `Resizable` for split-pane editors, dashboards, inspectors, and side-by-side review layouts.\n  Astro `UIPrimitives` and registered Web Components generate separator handles and pane sizing\n  directly; React apps can use the `Resizable` component or `useResizable` for pointer, keyboard,\n  min/max, and double-click reset parity.\n- Use `ThemeBuilder`, `ColorPicker`, `Card`, `Button`, and `Input` to build token preview and export\n  tools. Add `data-ui-theme-brand-hue`, `data-ui-theme-accent-hue`, `data-ui-theme-scheme`,\n  `data-ui-theme-mode`, manual color inputs such as `data-ui-theme-primary-hex`, and\n  `data-ui-theme-target` for scoped live previews. Add `data-ui-theme-export-format`,\n  `data-ui-theme-export`, and `data-ui-theme-output` to copy CSS, Figma variable JSON, or design\n  token JSON. Astro `UIPrimitives` and registered Web Components wire those controls directly;\n  React apps can use `useThemeBuilder` for the same tokens, exports, and control props. Use\n  `createThemePalette`, `createThemeBuilderTokens`, `exportThemeBuilderValue`, `exportThemeCss`,\n  `parseThemeCss`, and `scoreThemeContrast`\n  for theme import/export and accessibility checks. Use `suggestReadableInk`, `mergeThemeTokens`,\n  and `tuneThemeContrast` when generated palettes need readable foreground repair.\n- Use `RichTextEditor` with `ButtonGroup`, `ToggleGroup`, and `Textarea` for editor compositions.\n  Controls with `data-ui-editor-command` dispatch browser editing commands and emit\n  `ui:editor-command`; use `data-ui-editor-value` for headings, links, and other value-bearing\n  commands. Editable surfaces support common formatting shortcuts, synchronize toggle\n  `aria-pressed` state, and emit `ui:editor-change` with HTML and plain text. Astro `UIPrimitives`\n  and registered Web Components bind those controls directly; React apps can use\n  `useRichTextEditor` for `rootProps`, `getCommandProps`, `getEditableProps`, and `executeCommand`.\n  For Tiptap, ProseMirror, Lexical, or Markdown engines, keep the external editor\n  package in the app and bridge toolbar buttons through the emitted command event instead of adding\n  the editor engine to Lumen.\n- Use `Autocomplete`, `SearchField`, `NumberField`, `TimeField`, `DateRangePicker`, `ColorPicker`,\n  and `TagGroup` when forms need more than plain text inputs. Add `data-ui-form` to forms that\n  should reflect native Constraint Validation API state into `Field` error slots on blur and submit.\n  For `InputOTP`, Astro `UIPrimitives` and registered Web Components render/sync a real native input\n  with visual OTP segments; React apps can use the `InputOTP` component or `useInputOTP` for the\n  same sanitization, paste handling, and caret navigation.\n  For `DateRangePicker`, Astro `UIPrimitives` and registered Web Components sync the paired native\n  date input `min`/`max` constraints directly; React apps can use `useDateRangePicker` for the same\n  start/end syncing props.\n  Use native attributes such as `required`, `pattern`, `min`, `max`, and `type`; add\n  `data-error-required`, `data-error-pattern`, `data-error-min`, `data-error-max`, or\n  `data-error-custom` when a control needs custom copy. Listen for `ui:validate` to call\n  `control.setCustomValidity(message)` before the runtime reads validity, and listen for\n  `ui:invalid` or `ui:valid` on the form for submission state. Astro `UIPrimitives` and registered\n  Web Components bind `data-ui-form` directly; React apps can use `useFormValidation` with `Field`\n  to get the same control props, CustomEvents, and error slot updates.\n- Use `Toast` for transient feedback. Static `<Toast>` markup works without\n  JavaScript. With Astro `UIPrimitives` or registered Web Components, create toasts with\n  `window.LumenToast.create(detail)`, `LumenToast.create(detail)` from `@santi020k/lumen-elements`,\n  or `document.dispatchEvent(new CustomEvent('ui:toast', { detail }))`; update them with\n  `.update(id, detail)` or `ui:toast-update`; and dismiss them with `.dismiss(id?)` or\n  `ui:toast-dismiss`. `detail` supports `title`, `description`, `variant`, `duration`, `placement`,\n  `max`, and `action: { label, value }`. Destructive toasts use `role=\"alert\"`; other variants use\n  `role=\"status\"`. Runtime toasts pause their timeout on hover or focus, and Escape dismisses the\n  focused toast.\n\n## Runtime CustomEvents\n\nWhen `UIPrimitives` is mounted, or when Web Components are registered for matching behavior, Lumen\nuses these CustomEvents:\n\n| Event | Target | Detail | Fires When |\n| --- | --- | --- | --- |\n| `ui:data-table-selection-change` | `DataTable` root `[data-ui-datatable]` | `{ values: string[] }` | Selectable row checkboxes, the select-all checkbox, or form reset changes selected row values. |\n| `ui:schedule-change` | `Schedule` root `[data-ui-schedule]` | `{ eventId?: string, slot?: string }` | A draggable schedule event is dropped on a `[data-ui-schedule-slot]`. |\n| `ui:virtual-list-range` | `VirtualList` root `[data-ui-virtual-list]` | `{ startIndex: number, endIndex: number }` | The virtual list calculates its visible range on init or scroll. |\n| `ui:tag-remove` | `TagGroup` root `.ui-tag-group` or `[data-ui-tag-group]` | `{ value?: string }` | A `[data-ui-tag-remove]` control removes its closest tag or list item. |\n| `ui:editor-command` | `RichTextEditor` root `[data-ui-rich-text-editor]` | `{ command: string, executed: boolean, value?: string }` | A toolbar control or keyboard shortcut runs an editor command. |\n| `ui:editor-change` | `RichTextEditor` root `[data-ui-rich-text-editor]` | `{ html: string, text: string }` | Editable content changes or an editor command runs. |\n| `ui:theme-change` | `ThemeBuilder` root `[data-ui-theme-builder]` | `{ hue: number, accentHue: number, mode: 'generated' \\| 'manual', scheme: 'dark' \\| 'light', tokens: Record<string, string> }` | Hue, manual color, mode, or scheme controls update generated tokens. |\n| `ui:theme-export` | `ThemeBuilder` root `[data-ui-theme-builder]` | `{ css?: string, format: 'css' \\| 'figma' \\| 'tokens', tokens: Record<string, string> \\| null, value: string }` | A `[data-ui-theme-export]` control writes the selected export to the output and clipboard when available. |\n| `ui:validate` | Form `[data-ui-form]` | `{ control, form, value }` | Before validation state is read, so custom code can call `control.setCustomValidity(message)`. |\n| `ui:invalid` | Form `[data-ui-form]` | `{ control?, controls?, form }` | Blur or submit validation finds invalid controls. Failed submits focus the first invalid control. |\n| `ui:valid` | Form `[data-ui-form]` | `{ control?, controls?, form }` | Blur or submit validation finds the checked control or form valid. |\n| `ui:toast` | `document` | `{ id?, title?, description?, variant?, duration?, placement?, action? }` | Creates a runtime toast in the matching notification viewport. |\n| `ui:toast-update` | `document` | `{ id, title?, description?, variant?, duration? }` | Updates a runtime toast. |\n| `ui:toast-dismiss` | `document` | `{ id? }` | Dismisses one runtime toast, or all runtime toasts when `id` is omitted. |\n| `ui:toast-action` | Toast `[data-ui-toast]` | `{ id, value? }` | A runtime toast action button is pressed, unless the action specifies a custom event name. |\n\n## Registry Helper\n\n`@santi020k/lumen` exports typed component, recipe, and documentation metadata from\n`@santi020k/lumen/registry`. The package also ships a small `lumen` binary. Individual components\nare addressable by name, including kebab-case aliases such as `data-table`:\n\n```bash\nlumen list\nlumen show Button\nlumen show data-table\nlumen add Button\nlumen add Button --target react\nlumen add Button --target elements\nlumen add data-table\nlumen show scheduler\nlumen add scheduler\nlumen add scheduler --target react\nlumen add scheduler --target elements\nlumen add scheduler --dry-run\nlumen add scheduler --fail-on-conflict\nlumen add scheduler --force\nlumen add scheduler --merge\nlumen list --registry ./registry/lumen.registry.json\nlumen add custom-recipe --registry ./registry/custom.registry.json\nlumen add private-recipe --registry https://example.com/lumen.registry.json --registry-token \"$TOKEN\"\nlumen install\n```\n\n`lumen add <component>` defaults to an Astro wrapper. Use `--target react` for a local React wrapper\nor `--target elements` for a custom-elements starter. Bundled recipes also accept `--target astro`,\n`--target react`, and `--target elements`; external registry inline files keep their authored paths\nand sources.\n\nBefore inventing a wrapper or custom class pattern, check the component source in\n`packages/astro/components`. Astro is the reference implementation for props, class names, data\nattributes, and accessible markup.\n\n## Styling Rules for Generated Code\n\n- Do not require consumers to configure Tailwind for Lumen components.\n- Prefer component props and composition before adding custom CSS.\n- Use the shared token names for custom surfaces: `canvas`, `surface`, `surface-muted`,\n  `surface-strong`, `line`, `ink`, `ink-soft`, `ink-muted`, `brand`, `brand-solid`, `brand-soft`,\n  `accent`, `success`, `warning`, and `danger`.\n- Use `glass` as a boolean prop or attribute for glass surfaces when supported.\n- Do not generate `surface=\"glass\"` for overlays; it is a deprecated alias that maps to `glass`.\n- Preserve semantic labels, keyboard paths, focus states, and native form attributes.\n\n## Figma Handoff\n\nUse `exportThemeFigmaVariables` from `@santi020k/lumen-core/figma` when a design workflow needs\nFigma variable-friendly color values, and `exportThemeDesignTokens` when exporting standard design\ntoken JSON for token importers. See [docs/figma.md](figma.md) for the recommended Figma workflow.\n\n## When Editing This Repo\n\n- Shared contracts belong in `packages/core`.\n- Astro implementation and standalone CSS belong in `packages/astro`.\n- React-specific primitives belong in `packages/react`.\n- Web Component-specific primitives belong in `packages/elements`.\n- Update the relevant package README when public usage changes.\n- Add tests beside package code as `*.test.ts` when behavior, exported metadata, or component\n  contracts change.\n",
-    "readme": "# Lumen\n\nLumen is a multi-framework primitive UI system from Santiago Molina. Install the package for your\nframework; it includes the shared Lumen foundation and standalone stylesheet. Consumers do not\nneed Tailwind configuration for Lumen components to render.\n\nThe monorepo layers framework adapters around a shared core:\n\n- `@santi020k/lumen` - shared stylesheet, CLI, registry metadata, and package map\n- `@santi020k/lumen-core` - tokens, component metadata, class composition, and shared behavior helpers\n- `@santi020k/lumen-astro` - Astro components and progressive-enhancement runtime\n- `@santi020k/lumen-react` - React components\n- `@santi020k/lumen-elements` - standards-based Web Components\n- `@santi020k/lumen-mcp` - Model Context Protocol server for AI agents\n- `apps/docs` - Astro documentation and demo site\n\n## Quick Start\n\nChoose one package for your framework:\n\n```bash\n# Astro\npnpm add @santi020k/lumen-astro\n\n# React\npnpm add @santi020k/lumen-react\n\n# Web Components\npnpm add @santi020k/lumen-elements\n```\n\nImport the stylesheet from the same framework package once in your global CSS file, root layout,\nor app entry. For example:\n\n```css\n@import \"@santi020k/lumen-react/styles.css\";\n```\n\nWith Tailwind, keep it in the same shared CSS entry:\n\n```css\n@import \"@santi020k/lumen-react/layers.css\";\n@import \"tailwindcss\";\n@import \"@santi020k/lumen-react/styles.css\";\n```\n\nThe layer-order prelude lets Tailwind base styles run before Lumen components and keeps Tailwind\nutilities—including responsive `hidden` and display utilities—above Lumen component defaults.\n\nFor interactive Astro primitives, mount `UIPrimitives` once in your root layout:\n\n```astro\n---\nimport { Button, Card, Input } from '@santi020k/lumen-astro'\n---\n\n<Card>\n  <label for=\"email\">Email</label>\n  <Input id=\"email\" type=\"email\" placeholder=\"you@example.com\" />\n  <Button>Subscribe</Button>\n</Card>\n```\n\n## Development\n\n```bash\npnpm install\npnpm run dev\npnpm run validate\n```\n\n## Package Strategy\n\nThe `@santi020k/` scope keeps the project aligned with the existing package family while the API stabilizes. If Lumen grows beyond personal projects, the package graph can later move to a dedicated `@lumen-ui/*` scope without changing the internal architecture.\n\n## Migration\n\nIf you are replacing an older internal design system or duplicated UI primitives, refer to the [Migration Guide](docs/migrating-to-lumen.md) for instructions on adopting Lumen incrementally and mapping existing tokens.\n\n## Agent and Registry Surfaces\n\nInstall the portable Lumen Agent Skill in Codex, Claude Code, Cursor, Windsurf, and other compatible\nAI coding tools:\n\n```bash\nnpx skills add santi020k/lumen --skill lumen-ui\n```\n\nThe canonical skill lives in [skills/lumen-ui](skills/lumen-ui). It teaches agents how to select,\ncompose, theme, and verify Lumen primitives while preserving the app's framework and architecture.\nPair it with [`@santi020k/lumen-mcp`](packages/mcp/README.md) when the agent should search the live\ncatalog and retrieve current component source, props, tokens, and rules.\n\nLumen also includes [llms.txt](llms.txt), [docs/ai-usage.md](docs/ai-usage.md), and\n[registry/lumen.registry.json](registry/lumen.registry.json) so app generators can discover the\ncomponent catalog, setup rules, recipes, and installable file groups. The current roadmap lives in\n[docs/feature-roadmap.md](docs/feature-roadmap.md).\n\nFigma handoff guidance lives in [docs/figma.md](docs/figma.md), including theme token exports for\nFigma variables and the Code Connect path for the\n[published Lumen UI Library](https://www.figma.com/community/file/1662337342676541513).\n[Image performance guidance](docs/image-performance.md) explains how to retain Astro, Next.js,\nother framework, CMS, and CDN optimizers while applying Lumen presentation.\n\nThe umbrella package also exposes `@santi020k/lumen/registry` and a small `lumen` command for\nlisting recipes, showing recipe contents, printing install commands, loading alternate registry\nmanifests, and adding starter recipe files with conflict-safe defaults. Use `--merge` to merge\nincoming recipe files with existing files, `--fail-on-conflict` for CI, or `--registry-token` /\n`LUMEN_REGISTRY_TOKEN` for private remote registries.\n"
+    "readme": "<p align=\"center\">\n  <a href=\"https://lumen.santi020k.com\">\n    <img src=\"./apps/docs/public/logo.svg\" alt=\"Lumen UI\" width=\"239\" height=\"60\">\n  </a>\n</p>\n\n<h1 align=\"center\">Lumen UI</h1>\n\n<p align=\"center\">\n  A multi-framework UI system with 123 accessible primitives for Astro, React, and Web Components.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://lumen.santi020k.com\">Documentation</a>\n  ·\n  <a href=\"https://lumen.santi020k.com/docs/components\">Components</a>\n  ·\n  <a href=\"https://www.figma.com/community/file/1662337342676541513\">Figma library</a>\n  ·\n  <a href=\"https://github.com/santi020k/lumen/issues\">Issues</a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/santi020k/lumen/actions\"><img alt=\"GitHub Actions\" src=\"https://img.shields.io/github/actions/workflow/status/santi020k/lumen/ci.yml?branch=main&style=flat-square\"></a>\n  <a href=\"https://www.npmjs.com/package/@santi020k/lumen-astro\"><img alt=\"npm version\" src=\"https://img.shields.io/npm/v/@santi020k/lumen-astro?style=flat-square&label=npm\"></a>\n  <a href=\"./LICENSE\"><img alt=\"MIT license\" src=\"https://img.shields.io/badge/license-MIT-111827?style=flat-square\"></a>\n</p>\n\nLumen gives applications a consistent visual language without tying them to one rendering model.\nIts packages share tokens, component contracts, styles, and interaction patterns while keeping each\nframework's native authoring experience.\n\n- **Framework native:** Astro components, React primitives, and standards-based custom elements.\n- **Accessible by default:** semantic markup, keyboard paths, focus management, and reduced-motion\n  support are built into the primitives.\n- **Standalone CSS:** no Tailwind configuration is required. Tailwind users get an explicit layer\n  integration.\n- **Progressively enhanced:** Astro interactions use a small client runtime instead of requiring an\n  application framework.\n- **Ready for design and AI workflows:** published Figma resources, a portable agent skill, an MCP\n  server, `llms.txt`, and a machine-readable registry ship alongside the component system.\n\n## Quick start\n\nInstall the package for your framework:\n\n```bash\n# Astro\npnpm add @santi020k/lumen-astro\n\n# React\npnpm add @santi020k/lumen-react\n\n# Web Components\npnpm add @santi020k/lumen-elements\n```\n\n### Astro\n\nImport the stylesheet and mount `UIPrimitives` once in your root layout. The runtime enhances all\ninteractive Lumen markup on the page.\n\n```astro\n---\nimport '@santi020k/lumen-astro/styles.css'\nimport { UIPrimitives } from '@santi020k/lumen-astro'\n---\n\n<html lang=\"en\">\n  <body>\n    <slot />\n    <UIPrimitives />\n  </body>\n</html>\n```\n\n```astro\n---\nimport { Button, Card, Input } from '@santi020k/lumen-astro'\n---\n\n<Card>\n  <label for=\"email\">Email</label>\n  <Input id=\"email\" name=\"email\" type=\"email\" placeholder=\"you@example.com\" />\n  <Button>Subscribe</Button>\n</Card>\n```\n\n### React\n\nLoad the stylesheet once from your app entry or global CSS:\n\n```tsx\nimport '@santi020k/lumen-react/styles.css'\nimport { Button, Card, Input } from '@santi020k/lumen-react'\n\nexport function SubscribeForm() {\n  return (\n    <Card>\n      <label htmlFor=\"email\">Email</label>\n      <Input id=\"email\" name=\"email\" type=\"email\" placeholder=\"you@example.com\" />\n      <Button>Subscribe</Button>\n    </Card>\n  )\n}\n```\n\n### Web Components\n\nImport the styles and register the elements once:\n\n```html\n<style>\n  @import \"@santi020k/lumen-elements/styles.css\";\n</style>\n\n<script type=\"module\">\n  import { defineLumenElements } from '@santi020k/lumen-elements/define'\n\n  defineLumenElements()\n</script>\n\n<lumen-card>\n  <label for=\"email\">Email</label>\n  <lumen-input id=\"email\" name=\"email\" type=\"email\" placeholder=\"you@example.com\"></lumen-input>\n  <lumen-button>Subscribe</lumen-button>\n</lumen-card>\n```\n\nSee the [documentation](https://lumen.santi020k.com/docs) for installation, theming, component\nexamples, and API details.\n\n## Tailwind CSS\n\nKeep the layer prelude, Tailwind import, and Lumen stylesheet in the same shared CSS entry. Replace\n`lumen-astro` with the package for your framework.\n\n```css\n@import \"@santi020k/lumen-astro/layers.css\";\n@import \"tailwindcss\";\n@import \"@santi020k/lumen-astro/styles.css\";\n```\n\nThis order places Tailwind base styles before Lumen components and Tailwind utilities above Lumen\ncomponent defaults.\n\n## Packages\n\n| Package | Purpose |\n| --- | --- |\n| [`@santi020k/lumen-astro`](./packages/astro) | Reference implementation, Astro components, and progressive-enhancement runtime |\n| [`@santi020k/lumen-react`](./packages/react) | React components and behavior hooks |\n| [`@santi020k/lumen-elements`](./packages/elements) | Standards-based Web Components |\n| [`@santi020k/lumen-core`](./packages/core) | Shared tokens, metadata, class helpers, and behavior contracts |\n| [`@santi020k/lumen`](./packages/lumen) | Umbrella package, CLI, registry metadata, and public package map |\n| [`@santi020k/lumen-mcp`](./packages/mcp) | MCP server for component discovery and source retrieval |\n\n## AI and design workflows\n\nInstall the portable Lumen skill in Codex, Claude Code, Cursor, Windsurf, and other compatible\ncoding agents:\n\n```bash\nnpx skills add santi020k/lumen --skill lumen-ui\n```\n\nThe skill teaches agents how to select, compose, theme, and verify Lumen primitives. Pair it with\n[`@santi020k/lumen-mcp`](./packages/mcp) when an agent needs to search the live catalog or retrieve\ncurrent source, props, tokens, and usage rules.\n\nAdditional machine-readable surfaces include:\n\n- [`llms.txt`](./llms.txt) for a concise project map.\n- [`docs/ai-usage.md`](./docs/ai-usage.md) for downstream generation examples.\n- [`registry/lumen.registry.json`](./registry/lumen.registry.json) for recipes and installable file\n  groups.\n- [`docs/figma.md`](./docs/figma.md) for Figma variables and Code Connect workflows.\n\n## Contributing\n\nLumen is a pnpm workspace. Astro is the reference implementation; shared contracts belong in\n`packages/core`, while framework-specific behavior stays in its adapter package.\n\n```bash\npnpm install\npnpm run dev\npnpm run validate\n```\n\nRead [`CONTRIBUTING.md`](./CONTRIBUTING.md) before opening a pull request. User-visible package\nchanges require a changeset.\n\n## License\n\nLumen is available under the [MIT License](./LICENSE).\n"
   },
   "meta": {
-    "catalogHash": "420181fedc7718c1ac636ea8e84b4caf7959ad1dbb846eaebcbf6cfd166fc2d1",
-    "componentCount": 123,
+    "catalogHash": "fe40e1272c32ff21e23f31007bf371c3f667aec69779a3af0f34b397a151cc4f",
+    "componentCount": 124,
     "packages": [
       "@santi020k/lumen-astro",
       "@santi020k/lumen-react",
@@ -24576,16 +24903,16 @@
       "@santi020k/lumen-core"
     ],
     "packageVersions": {
-      "@santi020k/lumen-astro": "0.2.0",
-      "@santi020k/lumen-core": "0.2.0",
-      "@santi020k/lumen-elements": "0.2.0",
-      "@santi020k/lumen-mcp": "0.2.0",
-      "@santi020k/lumen-react": "0.2.0"
+      "@santi020k/lumen-astro": "0.3.0",
+      "@santi020k/lumen-core": "0.3.0",
+      "@santi020k/lumen-elements": "0.3.0",
+      "@santi020k/lumen-mcp": "0.3.0",
+      "@santi020k/lumen-react": "0.3.0"
     },
     "registryName": "lumen",
     "registryVersion": 1,
     "schemaVersion": 3,
-    "serverVersion": "0.2.0"
+    "serverVersion": "0.3.0"
   },
   "recipes": [
     {

package/dist/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../src/data.ts"],"names":[],"mappings":"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"}

package/dist/data.js

@@ -1,10 +1,11 @@
-import { readFileSync as readFsFile } from 'node:fs';
+import * as fs from 'node:fs';
 import { fileURLToPath } from 'node:url';
 const dataUrl = new URL('../data/lumen-data.json', import.meta.url);
 let cached;
 export const loadLumenData = () => {
     if (cached)
         return cached;
+    const readFsFile = Reflect.get(fs, 'readFileSync');
     const raw = readFsFile(fileURLToPath(dataUrl), 'utf8');
     cached = JSON.parse(raw);
     return cached;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AAYrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,cAAc,YAAY,CAAA;AAE1B,4EAA4E;AAC5E,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,IAAI,CAKlD,CAAA;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,UAAU,EAAE,UAAU,CAAA;IACtB,GAAG,EAAE,GAAG,CAAA;CACT;AAED,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAC5B,UAAS,mBAAwB,KAChC,OAAO,CAAC,kBAAkB,CA2I5B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,WAAW,CAAA;AAYrD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACzC,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC/C,cAAc,YAAY,CAAA;AAE1B,4EAA4E;AAC5E,eAAO,MAAM,aAAa,QAAa,OAAO,CAAC,IAAI,CAKlD,CAAA;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC1B,UAAU,EAAE,UAAU,CAAA;IACtB,GAAG,EAAE,GAAG,CAAA;CACT;AAoDD,wFAAwF;AACxF,eAAO,MAAM,iBAAiB,GAC5B,UAAS,mBAAwB,KAChC,OAAO,CAAC,kBAAkB,CA+F5B,CAAA"}

package/dist/index.js

@@ -11,6 +11,43 @@ export const startLumenMcp = async () => {
     const transport = new StdioServerTransport();
     await server.connect(transport);
 };
+const toWebRequest = (request, host, options) => {
+    const headers = new Headers();
+    for (const [name, value] of Object.entries(request.headers)) {
+        for (const item of Array.isArray(value) ? value : [value]) {
+            if (item !== undefined)
+                headers.append(name, item);
+        }
+    }
+    const hostHeader = request.headers.host ?? `${host}:${options.port ?? 3000}`;
+    const method = request.method;
+    return new Request(`http://${hostHeader}${request.url}`, {
+        headers,
+        method,
+        ...(['GET', 'HEAD'].includes(method) ? {} : { body: JSON.stringify(request.body) })
+    });
+};
+const streamResponse = async (webResponse, response) => {
+    response.statusCode = webResponse.status;
+    for (const [name, value] of webResponse.headers.entries())
+        response.setHeader(name, value);
+    if (!webResponse.body) {
+        response.end();
+        return;
+    }
+    const reader = webResponse.body.getReader();
+    response.once('close', () => {
+        reader.cancel().catch(() => { });
+    });
+    while (!response.destroyed) {
+        const chunk = await reader.read();
+        if (chunk.done)
+            break;
+        response.write(Buffer.from(chunk.value));
+    }
+    if (!response.writableEnded)
+        response.end();
+};
 /** Start a self-hostable Streamable HTTP transport. Defaults to loopback for safety. */
 export const startLumenMcpHttp = async (options = {}) => {
     const host = options.host ?? '127.0.0.1';
@@ -28,44 +65,11 @@ export const startLumenMcpHttp = async (options = {}) => {
         activeServers.add(mcpServer);
         try {
             await mcpServer.connect(transport);
-            const headers = new Headers();
-            for (const [name, value] of Object.entries(request.headers)) {
-                for (const item of Array.isArray(value) ? value : [value]) {
-                    if (item !== undefined)
-                        headers.append(name, item);
-                }
-            }
-            const hostHeader = request.headers.host ?? `${host}:${options.port ?? 3000}`;
-            const method = request.method;
-            const webRequest = new Request(`http://${hostHeader}${request.url}`, {
-                headers,
-                method,
-                ...(['GET', 'HEAD'].includes(method)
-                    ? {}
-                    : { body: JSON.stringify(request.body) })
-            });
+            const webRequest = toWebRequest(request, host, options);
             const webResponse = await transport.handleRequest(webRequest, {
                 parsedBody: request.body
             });
-            response.statusCode = webResponse.status;
-            for (const [name, value] of webResponse.headers.entries())
-                response.setHeader(name, value);
-            if (!webResponse.body) {
-                response.end();
-                return;
-            }
-            const reader = webResponse.body.getReader();
-            response.once('close', () => {
-                reader.cancel().catch(() => { });
-            });
-            while (!response.destroyed) {
-                const chunk = await reader.read();
-                if (chunk.done)
-                    break;
-                response.write(Buffer.from(chunk.value));
-            }
-            if (!response.writableEnded)
-                response.end();
+            await streamResponse(webResponse, response);
         }
         catch (error) {
             if (response.headersSent)

package/dist/tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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"}

package/dist/tools.js

@@ -40,21 +40,25 @@ export const resolveRecipe = (name, data = loadLumenData()) => {
     const target = normalize(name);
     return data.recipes.find((recipe) => normalize(recipe.name) === target);
 };
-const frameworkSearchText = (component, framework) => (framework
-    ? [component.frameworkDetails[framework]]
-    : Object.values(component.frameworkDetails))
-    .flatMap((framework) => [
+const frameworkBehaviorSearchText = (behavior) => [
+    behavior?.description ?? '',
+    behavior?.hook ?? '',
+    behavior?.mode ?? '',
+    behavior?.setup ?? ''
+];
+const frameworkDetailsSearchText = (framework) => [
     framework.packageName,
-    framework.behavior?.description ?? '',
-    framework.behavior?.hook ?? '',
-    framework.behavior?.mode ?? '',
-    framework.behavior?.setup ?? '',
+    ...frameworkBehaviorSearchText(framework.behavior),
     framework.example,
     framework.propsExtends ?? '',
     framework.props.map((prop) => `${prop.name} ${prop.type}`).join(' '),
     framework.attributes?.join(' ') ?? '',
     framework.tagName ?? ''
-])
+];
+const frameworkSearchText = (component, framework) => (framework
+    ? [Reflect.get(component.frameworkDetails, framework)]
+    : Object.values(component.frameworkDetails))
+    .flatMap(frameworkDetailsSearchText)
     .join(' ');
 const componentSearchText = (component, framework) => [
     component.name,
@@ -74,13 +78,13 @@ const componentSearchText = (component, framework) => [
 ].join(' ');
 const scoreCandidate = (query, terms, searchableText, primaryName = '') => {
     const normalizedText = normalize(searchableText);
-    const matchedTerms = terms.filter((term) => (searchTermAliases[term] ?? [term]).some((candidate) => normalizedText.includes(candidate)));
+    const matchedTerms = terms.filter((term) => (Reflect.get(searchTermAliases, term) ?? [term]).some((candidate) => normalizedText.includes(candidate)));
     if (matchedTerms.length === 0)
         return { matchedTerms, score: 0 };
     const normalizedQuery = terms.join('-');
     const normalizedName = normalize(primaryName);
     const coverage = matchedTerms.length / terms.length;
-    let score = matchedTerms.reduce((total, term) => total + ((searchTermAliases[term] ?? [term]).some((candidate) => normalizedName.includes(candidate))
+    let score = matchedTerms.reduce((total, term) => total + ((Reflect.get(searchTermAliases, term) ?? [term]).some((candidate) => normalizedName.includes(candidate))
         ? 20
         : 5), 0);
     score += Math.round(coverage * 80);
@@ -101,7 +105,7 @@ const appendSearchResult = (results, candidate, query, terms, searchableText) =>
 const collectSearchResults = (query, terms, data, framework) => {
     const results = [];
     for (const component of data.components) {
-        if (framework && !component.frameworks[framework])
+        if (framework && !Reflect.get(component.frameworks, framework))
             continue;
         appendSearchResult(results, {
             category: component.category,
@@ -231,38 +235,35 @@ const formatProps = (framework) => {
         : 'Props:';
     return `${header}\n${lines.join('\n')}`;
 };
-const formatComponentUsage = (component, frameworkName, detail) => {
-    const framework = getFrameworkDetail(component.frameworkDetails, frameworkName);
-    const sections = [
-        `# ${component.name}`,
-        component.description,
-        `Category: ${component.category}`,
-        `Framework: ${frameworkName}`,
-        `Package: ${framework.packageName}`,
-        `Import: ${framework.importStatement}`,
-        `Styles: ${framework.styleImport}`,
-        framework.tagName ? `Custom element: <${framework.tagName}>` : '',
-        component.recipes.length > 0
-            ? `Recipes: ${component.recipes.map((recipe) => recipe.name).join(', ')}`
-            : 'Recipes: none'
-    ].filter(Boolean);
-    if (detail === 'summary')
-        return sections.join('\n');
-    sections.push('', formatProps(framework), '', '## Example', `\`\`\`${framework.language}`);
-    sections.push(framework.example, '```');
-    if (framework.behavior) {
-        sections.push('', '## Framework behavior', framework.behavior.setup);
-        if (framework.behavior.hook)
-            sections.push(`Hook: ${framework.behavior.hook}`);
-        if (framework.behavior.description)
-            sections.push(framework.behavior.description);
-        if (framework.behavior.options && framework.behavior.options.length > 0) {
-            sections.push('', 'Hook options:', ...framework.behavior.options.map((option) => `- ${option.name}: ${option.type} — ${option.description}`));
-        }
-        if (framework.behavior.controller && framework.behavior.controller.length > 0) {
-            sections.push('', 'Controller values:', ...framework.behavior.controller.map((value) => `- ${value.name}: ${value.type} — ${value.description}`));
-        }
+const buildSummarySections = (component, frameworkName, framework) => [
+    `# ${component.name}`,
+    component.description,
+    `Category: ${component.category}`,
+    `Framework: ${frameworkName}`,
+    `Package: ${framework.packageName}`,
+    `Import: ${framework.importStatement}`,
+    `Styles: ${framework.styleImport}`,
+    framework.tagName ? `Custom element: <${framework.tagName}>` : '',
+    component.recipes.length > 0
+        ? `Recipes: ${component.recipes.map((recipe) => recipe.name).join(', ')}`
+        : 'Recipes: none'
+].filter(Boolean);
+const appendBehaviorSections = (sections, behavior) => {
+    if (!behavior)
+        return;
+    sections.push('', '## Framework behavior', behavior.setup);
+    if (behavior.hook)
+        sections.push(`Hook: ${behavior.hook}`);
+    if (behavior.description)
+        sections.push(behavior.description);
+    if (behavior.options && behavior.options.length > 0) {
+        sections.push('', 'Hook options:', ...behavior.options.map((option) => `- ${option.name}: ${option.type} — ${option.description}`));
+    }
+    if (behavior.controller && behavior.controller.length > 0) {
+        sections.push('', 'Controller values:', ...behavior.controller.map((value) => `- ${value.name}: ${value.type} — ${value.description}`));
     }
+};
+const appendGuidanceSections = (sections, component) => {
     if (component.guidance) {
         sections.push('', '## Guidance', component.guidance.when);
         if (component.guidance.distinction)
@@ -270,15 +271,27 @@ const formatComponentUsage = (component, frameworkName, detail) => {
     }
     if (component.keyboardInteractions.length > 0) {
         sections.push('', '## Keyboard interactions');
-        sections.push(...component.keyboardInteractions.map((row) => `- ${row.key}: ${row.action}`));
+        sections.push(...component.keyboardInteractions.map((interaction) => `- ${interaction.key}: ${interaction.action}`));
+    }
+    if (component.apiReference.length > 0) {
+        sections.push('', '## API reference');
+        sections.push(...component.apiReference.map((row) => `- \`${row.attribute}\` ${row.values} — ${row.description}`));
     }
     if (component.runtimeEvents.length > 0) {
         sections.push('', '## Runtime events');
         sections.push(...component.runtimeEvents.map((event) => `- ${event.name}: ${event.when}`));
     }
+};
+const formatComponentUsage = (component, frameworkName, detail) => {
+    const framework = getFrameworkDetail(component.frameworkDetails, frameworkName);
+    const sections = buildSummarySections(component, frameworkName, framework);
+    if (detail === 'summary')
+        return sections.join('\n');
+    sections.push('', formatProps(framework), '', '## Example', `\`\`\`${framework.language}`, framework.example, '```');
+    appendBehaviorSections(sections, framework.behavior);
+    appendGuidanceSections(sections, component);
     if (detail === 'source') {
-        sections.push('', `## ${frameworkName} reference source`);
-        sections.push(`\`\`\`${framework.language}`, framework.source.trimEnd(), '```');
+        sections.push('', `## ${frameworkName} reference source`, `\`\`\`${framework.language}`, framework.source.trimEnd(), '```');
     }
     return sections.join('\n');
 };
@@ -389,12 +402,12 @@ const diffManifestSection = (current, baseline) => {
     const currentNames = Object.keys(current);
     const baselineNames = Object.keys(baseline);
     return {
-        added: currentNames.filter((name) => baseline[name] === undefined).sort(),
+        added: currentNames.filter((name) => Reflect.get(baseline, name) === undefined).sort(),
         changed: currentNames
-            .filter((name) => baseline[name] !== undefined && baseline[name] !== current[name])
+            .filter((name) => Reflect.get(baseline, name) !== undefined && Reflect.get(baseline, name) !== Reflect.get(current, name))
             .sort(),
-        removed: baselineNames.filter((name) => current[name] === undefined).sort(),
-        unchanged: currentNames.filter((name) => baseline[name] === current[name]).sort()
+        removed: baselineNames.filter((name) => Reflect.get(current, name) === undefined).sort(),
+        unchanged: currentNames.filter((name) => Reflect.get(baseline, name) === Reflect.get(current, name)).sort()
     };
 };
 export const getCatalogManifest = (data = loadLumenData()) => ({
@@ -465,14 +478,17 @@ export const diagnose = (data = loadLumenData()) => {
         {
             message: 'Every component has a manifest fingerprint.',
             name: 'component-manifest',
-            status: componentNames.every((name) => data.catalogManifest.components[name]) ? 'pass' : 'fail'
+            status: componentNames.every((name) => Reflect.get(data.catalogManifest.components, name)) ? 'pass' : 'fail'
         },
         {
             message: 'Every available framework contract has an example and import statement.',
             name: 'framework-contracts',
-            status: data.components.every((component) => Object.entries(component.frameworks).every(([framework, available]) => !available ||
-                Boolean(component.frameworkDetails[framework].example.trim()) &&
-                    Boolean(component.frameworkDetails[framework].importStatement.trim()))) ? 'pass' : 'fail'
+            status: data.components.every((component) => Object.entries(component.frameworks).every(([framework, available]) => {
+                if (!available)
+                    return true;
+                const details = Reflect.get(component.frameworkDetails, framework);
+                return Boolean(details?.example.trim()) && Boolean(details?.importStatement.trim());
+            })) ? 'pass' : 'fail'
         }
     ];
     const status = checks.every((check) => check.status === 'pass') ? 'healthy' : 'issues';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@santi020k/lumen-mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "publishConfig": {
     "access": "public"
   },