@vielzeug/codex 26.10.10 → 26.10.12

package/data/refine.json

@@ -453,41 +453,6 @@
     ],
     "description": "Encapsulates the three-step focus lifecycle used by dialogs and drawers:\n1. Capture the element that triggered the open.\n2. Move focus inside the overlay (optionally to a specific element).\n3. Restore focus when the overlay closes."
   },
-  {
-    "kind": "function",
-    "name": "registerIcons",
-    "return": {
-      "type": {
-        "text": "void"
-      }
-    },
-    "parameters": [
-      {
-        "name": "icons",
-        "type": {
-          "text": "Record<string, IconNode>"
-        }
-      }
-    ],
-    "description": "Register icons (or override existing ones) by name. Keys may be kebab-case or\nPascalCase: both resolve."
-  },
-  {
-    "kind": "function",
-    "name": "resolveIcon",
-    "return": {
-      "type": {
-        "text": "IconNode | undefined"
-      }
-    },
-    "parameters": [
-      {
-        "name": "name",
-        "type": {
-          "text": "string"
-        }
-      }
-    ]
-  },
   {
     "kind": "function",
     "name": "dispatchKeyboardAction",
@@ -885,6 +850,282 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "mapIconifyIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconifyIcon>>"
+        }
+      }
+    ],
+    "description": "Keep app keys and the shared Iconify geometry, presentation, and validation contract."
+  },
+  {
+    "kind": "function",
+    "name": "heroiconsIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconifyIcon>>"
+        }
+      }
+    ],
+    "description": "Convert caller-named individual `@iconify-icons/heroicons` data, not `@heroicons/react` components.\nPreserves app keys and SVG presentation; requires DOMParser. No imports or registration of icon sets."
+  },
+  {
+    "kind": "function",
+    "name": "iconifyIcon",
+    "return": {
+      "type": {
+        "text": "IconDefinition"
+      }
+    },
+    "parameters": [
+      {
+        "name": "data",
+        "type": {
+          "text": "IconifyIcon"
+        }
+      }
+    ],
+    "description": "Convert trusted local Iconify data using the browser DOMParser, never HTML injection."
+  },
+  {
+    "kind": "variable",
+    "name": "children",
+    "type": {
+      "text": "readonly IconElement[]"
+    }
+  },
+  {
+    "kind": "function",
+    "name": "iconifyIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "collection",
+        "type": {
+          "text": "IconifyCollection"
+        }
+      },
+      {
+        "name": "names",
+        "optional": true,
+        "type": {
+          "text": "readonly string[]"
+        }
+      }
+    ],
+    "description": "Convert selected names (including aliases), or the entire explicitly imported collection."
+  },
+  {
+    "kind": "function",
+    "name": "lucideIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, LucideIconData>>"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "mdiIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconifyIcon>>"
+        }
+      }
+    ],
+    "description": "Convert caller-named individual `@iconify-icons/mdi` data, not framework components or raw path strings.\nPreserves app keys and SVG presentation; requires DOMParser. No imports or registration of icon sets."
+  },
+  {
+    "kind": "function",
+    "name": "registerIcons",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconDefinition>>"
+        }
+      }
+    ],
+    "description": "Register trusted, synchronous SVG data. Re-registration replaces an application icon."
+  },
+  {
+    "kind": "function",
+    "name": "registerDefaultIcons",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconDefinition>>"
+        }
+      }
+    ],
+    "description": "Internal defaults never replace application registrations, in either import order."
+  },
+  {
+    "kind": "function",
+    "name": "resolveIcon",
+    "return": {
+      "type": {
+        "text": "IconDefinition | undefined"
+      }
+    },
+    "parameters": [
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "variable",
+    "name": "SVG_NS",
+    "type": {
+      "text": "string"
+    },
+    "default": "'http://www.w3.org/2000/svg'"
+  },
+  {
+    "kind": "function",
+    "name": "validateAttributes",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "attrs",
+        "default": "{}",
+        "type": {
+          "text": "IconAttributes"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "validateElement",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "node",
+        "type": {
+          "text": "IconElement"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "validateIcon",
+    "return": {
+      "type": {
+        "text": "void"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icon",
+        "type": {
+          "text": "IconDefinition"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "createIconChildren",
+    "return": {
+      "type": {
+        "text": "SVGElement[]"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icon",
+        "type": {
+          "text": "IconDefinition"
+        }
+      },
+      {
+        "name": "prefix",
+        "type": {
+          "text": "string"
+        }
+      }
+    ],
+    "description": "Prefix local IDs and references per rendered instance, including nested gradients/masks."
+  },
+  {
+    "kind": "function",
+    "name": "tablerIcons",
+    "return": {
+      "type": {
+        "text": "Record<string, IconDefinition>"
+      }
+    },
+    "parameters": [
+      {
+        "name": "icons",
+        "type": {
+          "text": "Readonly<Record<string, IconifyIcon>>"
+        }
+      }
+    ],
+    "description": "Convert caller-named individual `@iconify-icons/tabler` data, not native Tabler framework components.\nPreserves app keys and SVG presentation; requires DOMParser. No imports or registration of icon sets."
+  },
   {
     "kind": "function",
     "name": "parseMaxWidthPx",
@@ -2435,14 +2676,14 @@
       "text": "'ore-icon'"
     },
     "default": "'ore-icon'",
-    "description": "Icon wrapper for consistent Lucide rendering across Block.\n\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icon-lucide` for the complete library."
+    "description": "Library-neutral SVG icon rendering with explicit local registration.\n\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icons/lucide/all` for the complete Lucide library."
   },
   {
     "kind": "class",
     "name": "OreIconElement",
     "tagName": "ore-icon",
     "customElement": true,
-    "description": "Icon wrapper for consistent Lucide rendering across Block.\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icon-lucide` for the complete library.",
+    "description": "Library-neutral SVG icon rendering with explicit local registration.\nNames resolve from a synchronous registry: refine's own component icons are\nalways registered; apps register their set with `registerIcons()` or import\n`@vielzeug/refine/icons/lucide/all` for the complete Lucide library.",
     "summary": "",
     "attributes": [
       {
@@ -2450,7 +2691,7 @@
         "type": {
           "text": "string"
         },
-        "description": "Lucide icon name, e.g. `search` or `chevron-right`, resolved from the registered set"
+        "description": "Registered icon name"
       },
       {
         "name": "size",
@@ -2465,8 +2706,7 @@
         "type": {
           "text": "number"
         },
-        "description": "SVG stroke width (default: 2)",
-        "default": "2"
+        "description": "Override the icon's stroke width"
       },
       {
         "name": "absolute-stroke-width",
@@ -5022,119 +5262,7 @@
   },
   {
     "kind": "variable",
-    "name": "ASYNC_TAG",
-    "type": {
-      "text": "'ore-async'"
-    },
-    "default": "'ore-async'",
-    "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks."
-  },
-  {
-    "kind": "class",
-    "name": "OreAsyncElement",
-    "tagName": "ore-async",
-    "customElement": true,
-    "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "status",
-        "type": {
-          "text": "'idle' | 'loading' | 'empty' | 'error' | 'success'"
-        },
-        "description": "current state: 'idle' | 'loading' | 'empty' | 'error' | 'success' (default: 'success')",
-        "default": "'success'"
-      },
-      {
-        "name": "retryable",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "show retry button in error state (default: false)",
-        "default": "false"
-      },
-      {
-        "name": "empty-label",
-        "type": {
-          "text": "string"
-        },
-        "description": "title for empty state (default: 'No content yet')",
-        "default": "'No content yet'"
-      },
-      {
-        "name": "empty-description",
-        "type": {
-          "text": "string"
-        },
-        "description": "optional text for empty state"
-      },
-      {
-        "name": "error-label",
-        "type": {
-          "text": "string"
-        },
-        "description": "title for error state (default: 'Something went wrong')",
-        "default": "'Something went wrong'"
-      },
-      {
-        "name": "error-description",
-        "type": {
-          "text": "string"
-        },
-        "description": "optional text for error state"
-      }
-    ],
-    "events": [
-      {
-        "name": "retry",
-        "description": "Emitted when the retry button is clicked (no detail payload)",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "default content shown in 'success' state"
-      },
-      {
-        "name": "loading",
-        "description": "custom loading UI (overrides default skeletons)"
-      },
-      {
-        "name": "empty",
-        "description": "custom empty UI (overrides default icon/label)"
-      },
-      {
-        "name": "error",
-        "description": "custom error UI (overrides default icon/label)"
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--async-color",
-        "description": "Text/icon color used by default async state content"
-      },
-      {
-        "name": "--async-gap",
-        "description": "Vertical spacing between icon, title, description, and actions"
-      },
-      {
-        "name": "--async-icon-size",
-        "description": "Icon size for built-in loading/empty/error visuals"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<!-- Success state: default slot is shown -->\n<ore-async status=\"success\">\n  <ul><li>Item one</li><li>Item two</li></ul>\n</ore-async>\n<!-- Loading state: shows skeleton placeholders -->\n<ore-async status=\"loading\"></ore-async>\n<!-- Empty state with custom message -->\n<ore-async status=\"empty\" empty-label=\"No results\" empty-description=\"Try adjusting your filters.\"></ore-async>\n<!-- Error state with retry button -->\n<ore-async status=\"error\" retryable error-label=\"Failed to load\" error-description=\"Check your connection.\"></ore-async>\n```"
-      }
-    ]
-  },
-  {
-    "kind": "variable",
-    "name": "ALERT_TAG",
+    "name": "ALERT_TAG",
     "type": {
       "text": "'ore-alert'"
     },
@@ -5319,6 +5447,118 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "ASYNC_TAG",
+    "type": {
+      "text": "'ore-async'"
+    },
+    "default": "'ore-async'",
+    "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks."
+  },
+  {
+    "kind": "class",
+    "name": "OreAsyncElement",
+    "tagName": "ore-async",
+    "customElement": true,
+    "description": "A container for handling asynchronous states (loading, empty, error, success).\nSimplifies data fetching UI by providing consistent fallbacks.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "status",
+        "type": {
+          "text": "'idle' | 'loading' | 'empty' | 'error' | 'success'"
+        },
+        "description": "current state: 'idle' | 'loading' | 'empty' | 'error' | 'success' (default: 'success')",
+        "default": "'success'"
+      },
+      {
+        "name": "retryable",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "show retry button in error state (default: false)",
+        "default": "false"
+      },
+      {
+        "name": "empty-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "title for empty state (default: 'No content yet')",
+        "default": "'No content yet'"
+      },
+      {
+        "name": "empty-description",
+        "type": {
+          "text": "string"
+        },
+        "description": "optional text for empty state"
+      },
+      {
+        "name": "error-label",
+        "type": {
+          "text": "string"
+        },
+        "description": "title for error state (default: 'Something went wrong')",
+        "default": "'Something went wrong'"
+      },
+      {
+        "name": "error-description",
+        "type": {
+          "text": "string"
+        },
+        "description": "optional text for error state"
+      }
+    ],
+    "events": [
+      {
+        "name": "retry",
+        "description": "Emitted when the retry button is clicked (no detail payload)",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "default content shown in 'success' state"
+      },
+      {
+        "name": "loading",
+        "description": "custom loading UI (overrides default skeletons)"
+      },
+      {
+        "name": "empty",
+        "description": "custom empty UI (overrides default icon/label)"
+      },
+      {
+        "name": "error",
+        "description": "custom error UI (overrides default icon/label)"
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--async-color",
+        "description": "Text/icon color used by default async state content"
+      },
+      {
+        "name": "--async-gap",
+        "description": "Vertical spacing between icon, title, description, and actions"
+      },
+      {
+        "name": "--async-icon-size",
+        "description": "Icon size for built-in loading/empty/error visuals"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<!-- Success state: default slot is shown -->\n<ore-async status=\"success\">\n  <ul><li>Item one</li><li>Item two</li></ul>\n</ore-async>\n<!-- Loading state: shows skeleton placeholders -->\n<ore-async status=\"loading\"></ore-async>\n<!-- Empty state with custom message -->\n<ore-async status=\"empty\" empty-label=\"No results\" empty-description=\"Try adjusting your filters.\"></ore-async>\n<!-- Error state with retry button -->\n<ore-async status=\"error\" retryable error-label=\"Failed to load\" error-description=\"Check your connection.\"></ore-async>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "BADGE_TAG",
@@ -8571,7 +8811,7 @@
         "type": {
           "text": "string"
         },
-        "description": "Lucide icon name for the default send button (default 'arrow-up')"
+        "description": "Registered icon name for the default send button (default 'arrow-up')"
       },
       {
         "name": "send-label",
@@ -9568,6 +9808,101 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "RADIO_GROUP_CTX"
+  },
+  {
+    "kind": "variable",
+    "name": "RADIO_GROUP_TAG",
+    "type": {
+      "text": "'ore-radio-group'"
+    },
+    "default": "'ore-radio-group'",
+    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management."
+  },
+  {
+    "kind": "class",
+    "name": "OreRadioGroupElement",
+    "tagName": "ore-radio-group",
+    "customElement": true,
+    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "value",
+        "type": {
+          "text": "string"
+        },
+        "description": "Selected value"
+      },
+      {
+        "name": "name",
+        "type": {
+          "text": "string"
+        },
+        "description": "Form field name"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "Group label"
+      },
+      {
+        "name": "orientation",
+        "type": {
+          "text": "'vertical' | 'horizontal'"
+        },
+        "description": "Layout: 'vertical' | 'horizontal'"
+      },
+      {
+        "name": "required",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Required field"
+      }
+    ],
+    "events": [
+      {
+        "name": "change",
+        "description": "Emitted when a radio is selected. detail: { values: string[], labels: string[], originalEvent?: Event }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "Place `ore-radio` elements here"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "items",
+        "description": "Items container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--radio-group-direction",
+        "description": "Flex direction of the items list ('row' | 'column')"
+      },
+      {
+        "name": "--radio-group-gap",
+        "description": "Gap between radio items"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-radio-group name=\"plan\" label=\"Choose a plan\" value=\"free\" required>\n  <ore-radio value=\"free\">Free</ore-radio>\n  <ore-radio value=\"pro\">Pro</ore-radio>\n  <ore-radio value=\"enterprise\">Enterprise</ore-radio>\n</ore-radio-group>\n<ore-radio-group name=\"direction\" orientation=\"horizontal\" color=\"primary\">\n  <ore-radio value=\"left\">Left</ore-radio>\n  <ore-radio value=\"right\">Right</ore-radio>\n</ore-radio-group>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "RATING_TAG",
@@ -9721,101 +10056,6 @@
       }
     ]
   },
-  {
-    "kind": "variable",
-    "name": "RADIO_GROUP_CTX"
-  },
-  {
-    "kind": "variable",
-    "name": "RADIO_GROUP_TAG",
-    "type": {
-      "text": "'ore-radio-group'"
-    },
-    "default": "'ore-radio-group'",
-    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management."
-  },
-  {
-    "kind": "class",
-    "name": "OreRadioGroupElement",
-    "tagName": "ore-radio-group",
-    "customElement": true,
-    "description": "A group of radio buttons that allows users to select a single option from a set.\nSupports keyboard navigation (arrows) and automatic value management.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "value",
-        "type": {
-          "text": "string"
-        },
-        "description": "Selected value"
-      },
-      {
-        "name": "name",
-        "type": {
-          "text": "string"
-        },
-        "description": "Form field name"
-      },
-      {
-        "name": "label",
-        "type": {
-          "text": "string"
-        },
-        "description": "Group label"
-      },
-      {
-        "name": "orientation",
-        "type": {
-          "text": "'vertical' | 'horizontal'"
-        },
-        "description": "Layout: 'vertical' | 'horizontal'"
-      },
-      {
-        "name": "required",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Required field"
-      }
-    ],
-    "events": [
-      {
-        "name": "change",
-        "description": "Emitted when a radio is selected. detail: { values: string[], labels: string[], originalEvent?: Event }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "Place `ore-radio` elements here"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "items",
-        "description": "Items container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--radio-group-direction",
-        "description": "Flex direction of the items list ('row' | 'column')"
-      },
-      {
-        "name": "--radio-group-gap",
-        "description": "Gap between radio items"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-radio-group name=\"plan\" label=\"Choose a plan\" value=\"free\" required>\n  <ore-radio value=\"free\">Free</ore-radio>\n  <ore-radio value=\"pro\">Pro</ore-radio>\n  <ore-radio value=\"enterprise\">Enterprise</ore-radio>\n</ore-radio-group>\n<ore-radio-group name=\"direction\" orientation=\"horizontal\" color=\"primary\">\n  <ore-radio value=\"left\">Left</ore-radio>\n  <ore-radio value=\"right\">Right</ore-radio>\n</ore-radio-group>\n```"
-      }
-    ]
-  },
   {
     "kind": "variable",
     "name": "SELECT_TAG",