@vielzeug/codex 26.10.17 → 26.10.19

package/data/refine.json

@@ -33,6 +33,43 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "MOTION_MODES",
+    "type": {
+      "text": "['full', 'reduced', 'system']"
+    },
+    "default": "['full', 'reduced', 'system']",
+    "description": "App-level motion mode, mirroring `@vielzeug/necromancer`'s `MotionMode`:\nthe operating-system preference is the default, and an application with its\nown \"reduce motion\" setting can force either direction.\n\nThe mode is one attribute on `<html>` (`data-motion`), which the Reduced\nMotion block in `theme.css` reads: `'reduced'` zeroes every duration and\ntransition token and switches the `--_motion-*` escape hatches to `none`,\n`'full'` opts back in despite an OS-level reduction, and `'system'` (the\ndefault) removes the attribute. Because the tokens drive every CSS\nanimation and transition in the library, one call restyles all motion."
+  },
+  {
+    "kind": "function",
+    "name": "getMotionMode",
+    "return": {
+      "type": {
+        "text": "MotionMode"
+      }
+    },
+    "description": "Reads the current motion mode from `<html>`; `'system'` when unset."
+  },
+  {
+    "kind": "function",
+    "name": "setMotionMode",
+    "return": {
+      "type": {
+        "text": "MotionMode"
+      }
+    },
+    "parameters": [
+      {
+        "name": "mode",
+        "type": {
+          "text": "MotionMode"
+        }
+      }
+    ],
+    "description": "Sets the app-level motion mode by writing (or removing, for `'system'`)\nthe `data-motion` attribute on `<html>`. Returns the applied mode so\ncallers can round-trip a value they don't control."
+  },
   {
     "kind": "variable",
     "name": "components",
@@ -850,6 +887,49 @@
       }
     ]
   },
+  {
+    "kind": "function",
+    "name": "applyTruncationReveal",
+    "return": {
+      "type": {
+        "text": "TruncationRevealHandle"
+      }
+    },
+    "parameters": [
+      {
+        "name": "el",
+        "type": {
+          "text": "HTMLElement"
+        }
+      },
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "{ bothAxes?: boolean; slot?: HTMLSlotElement | null }"
+        }
+      }
+    ]
+  },
+  {
+    "kind": "function",
+    "name": "truncationRevealRef",
+    "return": {
+      "type": {
+        "text": "((el: HTMLElement | null) => void)"
+      }
+    },
+    "parameters": [
+      {
+        "name": "options",
+        "default": "{}",
+        "type": {
+          "text": "{ bothAxes?: boolean }"
+        }
+      }
+    ],
+    "description": "An ore `ref` callback that applies applyTruncationReveal when the label\nmounts and detaches it when the label unmounts. Prefer this for a label inside\na conditionally rendered template: ore re-invokes the callback with the new\nelement (and `null` for the old one) whenever that branch re-renders, so the\nreveal can never be left pointing at a detached node. The handle is tracked\nlocally rather than via `onCleanup`, because a re-render can fire the callback\noutside the setup context where `onCleanup` is unavailable.\n\nThe label's own `<slot>` child is used automatically."
+  },
   {
     "kind": "function",
     "name": "mapIconifyIcons",
@@ -1180,6 +1260,38 @@
     ],
     "description": "The container width to test against a breakpoint, falling back to the element itself."
   },
+  {
+    "kind": "function",
+    "name": "createLayoutMotion",
+    "return": {
+      "type": {
+        "text": "LayoutMotion"
+      }
+    },
+    "parameters": [
+      {
+        "name": "host",
+        "type": {
+          "text": "HTMLElement"
+        },
+        "description": "The element whose computed style carries the timing tokens\n(usually the component host; its shadow root holds the tracked elements)."
+      },
+      {
+        "name": "signal",
+        "type": {
+          "text": "AbortSignal"
+        },
+        "description": "Lifecycle signal: disposing it cancels in-flight animations."
+      },
+      {
+        "name": "options",
+        "type": {
+          "text": "LayoutMotionOptions"
+        }
+      }
+    ],
+    "description": "Builds a reflow-motion helper for one host element."
+  },
   {
     "kind": "variable",
     "name": "themableBundle",
@@ -4893,6 +5005,27 @@
         },
         "description": "Clamp to N lines with ellipsis (multi-line truncation)"
       },
+      {
+        "name": "expandable",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Reveal clipped text on click/tap (pairs with `truncate` or `lines`)"
+      },
+      {
+        "name": "expanded",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Controlled expanded state for an `expandable` text"
+      },
+      {
+        "name": "default-expanded",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Initial uncontrolled expanded state"
+      },
       {
         "name": "italic",
         "type": {
@@ -4908,6 +5041,15 @@
         "description": "Semantic HTML element: 'span' | 'p' | 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6' | 'label' | 'code'"
       }
     ],
+    "events": [
+      {
+        "name": "expand-change",
+        "description": "Fired when an `expandable` text is toggled. detail: { expanded: boolean }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
     "slots": [
       {
         "name": "",
@@ -4939,7 +5081,7 @@
     "demos": [
       {
         "url": "",
-        "description": "```html\n<ore-text variant=\"heading\" size=\"2xl\" weight=\"bold\">Welcome</ore-text>\n<ore-text as=\"h2\" variant=\"heading\" size=\"xl\">Section title</ore-text>\n<ore-text color=\"primary\" weight=\"semibold\">Important notice</ore-text>\n<ore-text variant=\"code\">npm install</ore-text>\n<ore-text lines=\"2\">Long paragraph that clamps at two lines…</ore-text>\n```"
+        "description": "```html\n<ore-text variant=\"heading\" size=\"2xl\" weight=\"bold\">Welcome</ore-text>\n<ore-text as=\"h2\" variant=\"heading\" size=\"xl\">Section title</ore-text>\n<ore-text color=\"primary\" weight=\"semibold\">Important notice</ore-text>\n<ore-text variant=\"code\">npm install</ore-text>\n<ore-text lines=\"2\">Long paragraph that clamps at two lines…</ore-text>\n<!-- Clamp and let the reader expand -->\n<ore-text lines=\"2\" expandable>Long paragraph, tap to read the rest…</ore-text>\n```"
       }
     ]
   },
@@ -6679,6 +6821,15 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "TOAST_STATUSES",
+    "type": {
+      "text": "['neutral', 'info', 'success', 'warning', 'danger']"
+    },
+    "default": "['neutral', 'info', 'success', 'warning', 'danger']",
+    "description": "Notification severity. Drives the status icon, the accent color, and the\ndefault screen-reader urgency; it never fills the surface, which stays a\nneutral light/dark card so a stack of notifications stays calm and legible."
+  },
   {
     "kind": "variable",
     "name": "id"
@@ -6743,7 +6894,23 @@
       },
       {
         "name": "--toast-bg",
-        "description": "Opaque surface for flat/bordered notifications."
+        "description": "Neutral notification surface (default the elevated contrast surface)."
+      },
+      {
+        "name": "--toast-color",
+        "description": "Notification text color."
+      },
+      {
+        "name": "--toast-border-color",
+        "description": "Notification border."
+      },
+      {
+        "name": "--toast-icon-size",
+        "description": "Status icon size (default --size-5)."
+      },
+      {
+        "name": "--toast-avatar-size",
+        "description": "Leading avatar diameter (default --size-8)."
       },
       {
         "name": "--toast-shadow",
@@ -6883,6 +7050,15 @@
     "default": "['shine', 'rainbow']",
     "description": "Animated border effect for ore-button."
   },
+  {
+    "kind": "variable",
+    "name": "BUTTON_EMPHASIS",
+    "type": {
+      "text": "['normal', 'primary', 'cancel', 'destructive']"
+    },
+    "default": "['normal', 'primary', 'cancel', 'destructive']",
+    "description": "Semantic role of a button's action, following the four-role model Apple's\nHuman Interface Guidelines use for buttons: Normal, Primary, Cancel,\nDestructive. The role picks the treatment, so prominence stops being a\nstyling accident:\n\n- `primary` — the action most people will choose: accent fill (solid).\n- `cancel` — dismiss without changing anything: neutral ghost.\n- `destructive` — deletes or is otherwise hard to undo: error ink with no\n  filled background (HIG's destructive treatment is red text, not a red\n  slab; a filled error button can be mistaken for a primary action).\n- `normal` — the default treatment, unchanged from no emphasis at all.\n\nAn explicit `color`/`variant` attribute always wins over the mapping, so\n`emphasis` is a shortcut, not a lock-in."
+  },
   {
     "kind": "variable",
     "name": "BUTTON_TAG",
@@ -6956,6 +7132,13 @@
         },
         "description": "Animated border effect: 'shine' | 'rainbow'"
       },
+      {
+        "name": "emphasis",
+        "type": {
+          "text": "'normal' | 'primary' | 'cancel' | 'destructive'"
+        },
+        "description": "Semantic role: 'normal' | 'primary' | 'cancel' | 'destructive' (explicit color/variant wins)"
+      },
       {
         "name": "icon-only",
         "type": {
@@ -7048,6 +7231,10 @@
         "name": "--button-font-size",
         "description": "Font size override"
       },
+      {
+        "name": "--button-min-height",
+        "description": "Minimum height override (defaults to the 44px touch target)"
+      },
       {
         "name": "--button-frost-active-bg",
         "description": "Background when pressed (frost variant)"
@@ -8083,6 +8270,32 @@
     ],
     "description": "Feature-owned state and transform pipeline for `ore-datagrid`.\n\nRows flow through the active view, query, filters, sorting, and pagination in order. Selection\nand column visibility share the same model so every interactive grid concern\nhas one reactive owner. Source-backed grids retain their server-owned rows by\nsetting `clientSide` to false."
   },
+  {
+    "kind": "function",
+    "name": "createRowMotion",
+    "return": {
+      "type": {
+        "text": "LayoutMotion"
+      }
+    },
+    "parameters": [
+      {
+        "name": "host",
+        "type": {
+          "text": "HTMLElement"
+        },
+        "description": "The grid host element (its shadow root holds the rows)."
+      },
+      {
+        "name": "signal",
+        "type": {
+          "text": "AbortSignal"
+        },
+        "description": "Lifecycle signal: disposing it cancels in-flight animations."
+      }
+    ],
+    "description": "Builds the grid's row-motion helper."
+  },
   {
     "kind": "function",
     "name": "createGridNav",
@@ -11899,14 +12112,14 @@
       "text": "'ore-grid'"
     },
     "default": "'ore-grid'",
-    "description": "ore-grid: Flexible grid layout with responsive column control.\n\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set."
+    "description": "ore-grid: Flexible grid layout with responsive column control.\n\nThe grid is container-responsive: `cols-*` breakpoints compare against the\nelement's own width (measured with a ResizeObserver), not the viewport, so a\nnarrow grid in a sidebar gets its mobile layout even on a wide screen.\nBreakpoint thresholds come from the `--size-screen-*` tokens. Fixed counts\nresolve through the `--grid-1`–`--grid-12` tokens; the responsive floor uses\n`--grid-min-item-width`. CSS custom properties `--grid-cols`, `--grid-rows`,\n`--grid-gap`, `--grid-row-gap`, `--grid-col-gap` are honoured as fallbacks\nwhen no attribute is set."
   },
   {
     "kind": "class",
     "name": "OreGridElement",
     "tagName": "ore-grid",
     "customElement": true,
-    "description": "ore-grid: Flexible grid layout with responsive column control.\nColumns are computed in JS and applied as `--_cols` inline, so they respond\nto the element's own width via ResizeObserver. CSS custom properties\n`--grid-cols`, `--grid-rows`, `--grid-gap`, `--grid-row-gap`, `--grid-col-gap`\nare honoured as fallbacks when no attribute is set.",
+    "description": "ore-grid: Flexible grid layout with responsive column control.\nThe grid is container-responsive: `cols-*` breakpoints compare against the\nelement's own width (measured with a ResizeObserver), not the viewport, so a\nnarrow grid in a sidebar gets its mobile layout even on a wide screen.\nBreakpoint thresholds come from the `--size-screen-*` tokens. Fixed counts\nresolve through the `--grid-1`–`--grid-12` tokens; the responsive floor uses\n`--grid-min-item-width`. CSS custom properties `--grid-cols`, `--grid-rows`,\n`--grid-gap`, `--grid-row-gap`, `--grid-col-gap` are honoured as fallbacks\nwhen no attribute is set.",
     "summary": "",
     "attributes": [
       {
@@ -11998,8 +12211,8 @@
         "type": {
           "text": "string"
         },
-        "description": "Min column width for responsive mode (default: 250px)",
-        "default": "250px"
+        "description": "Min column width for responsive mode (default: var(--grid-min-item-width))",
+        "default": "var(--grid-min-item-width"
       },
       {
         "name": "fullwidth",
@@ -12062,6 +12275,10 @@
         "name": "--grid-cols",
         "description": "Fallback column template (used when no cols attr is set)"
       },
+      {
+        "name": "--grid-min-item-width",
+        "description": "Floor for auto-fit column width (default: 250px)"
+      },
       {
         "name": "--grid-rows",
         "description": "Fallback row template"
@@ -13893,6 +14110,114 @@
       }
     ]
   },
+  {
+    "kind": "variable",
+    "name": "POPOVER_TAG",
+    "type": {
+      "text": "'ore-popover'"
+    },
+    "default": "'ore-popover'",
+    "description": "A floating panel anchored to a trigger element."
+  },
+  {
+    "kind": "class",
+    "name": "OrePopoverElement",
+    "tagName": "ore-popover",
+    "customElement": true,
+    "description": "A floating panel anchored to a trigger element.",
+    "summary": "",
+    "attributes": [
+      {
+        "name": "placement",
+        "type": {
+          "text": "string"
+        },
+        "description": "Preferred placement (default: 'bottom')",
+        "default": "'bottom'"
+      },
+      {
+        "name": "trigger",
+        "type": {
+          "text": "'click' | 'hover' | 'focus'"
+        },
+        "description": "'click' | 'hover' | 'focus' (default: 'click')",
+        "default": "'click'"
+      },
+      {
+        "name": "open",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Controlled open state"
+      },
+      {
+        "name": "default-open",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Initial uncontrolled open state"
+      },
+      {
+        "name": "offset",
+        "type": {
+          "text": "number"
+        },
+        "description": "Gap in px (default: 8)",
+        "default": "8"
+      },
+      {
+        "name": "disabled",
+        "type": {
+          "text": "boolean"
+        },
+        "description": "Disables the popover"
+      },
+      {
+        "name": "label",
+        "type": {
+          "text": "string"
+        },
+        "description": "aria-label on the panel"
+      }
+    ],
+    "events": [
+      {
+        "name": "open-change",
+        "description": "When the panel state changes. detail: { open, reason }",
+        "type": {
+          "text": "CustomEvent"
+        }
+      }
+    ],
+    "slots": [
+      {
+        "name": "",
+        "description": "The trigger element"
+      },
+      {
+        "name": "content",
+        "description": "Panel content"
+      }
+    ],
+    "cssParts": [
+      {
+        "name": "panel",
+        "description": "Panel container."
+      }
+    ],
+    "cssProperties": [
+      {
+        "name": "--popover-overflow",
+        "description": "Panel overflow behavior (default: auto)"
+      }
+    ],
+    "demos": [
+      {
+        "url": "",
+        "description": "```html\n<ore-popover placement=\"bottom\" trigger=\"click\">\n  <ore-button>Open info</ore-button>\n  <div slot=\"content\">\n    <p>Popover body content goes here.</p>\n  </div>\n</ore-popover>\n```"
+      }
+    ]
+  },
   {
     "kind": "variable",
     "name": "NAVIGATION_MENU_ITEM_TAG",
@@ -14085,114 +14410,6 @@
     ],
     "demos": []
   },
-  {
-    "kind": "variable",
-    "name": "POPOVER_TAG",
-    "type": {
-      "text": "'ore-popover'"
-    },
-    "default": "'ore-popover'",
-    "description": "A floating panel anchored to a trigger element."
-  },
-  {
-    "kind": "class",
-    "name": "OrePopoverElement",
-    "tagName": "ore-popover",
-    "customElement": true,
-    "description": "A floating panel anchored to a trigger element.",
-    "summary": "",
-    "attributes": [
-      {
-        "name": "placement",
-        "type": {
-          "text": "string"
-        },
-        "description": "Preferred placement (default: 'bottom')",
-        "default": "'bottom'"
-      },
-      {
-        "name": "trigger",
-        "type": {
-          "text": "'click' | 'hover' | 'focus'"
-        },
-        "description": "'click' | 'hover' | 'focus' (default: 'click')",
-        "default": "'click'"
-      },
-      {
-        "name": "open",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Controlled open state"
-      },
-      {
-        "name": "default-open",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Initial uncontrolled open state"
-      },
-      {
-        "name": "offset",
-        "type": {
-          "text": "number"
-        },
-        "description": "Gap in px (default: 8)",
-        "default": "8"
-      },
-      {
-        "name": "disabled",
-        "type": {
-          "text": "boolean"
-        },
-        "description": "Disables the popover"
-      },
-      {
-        "name": "label",
-        "type": {
-          "text": "string"
-        },
-        "description": "aria-label on the panel"
-      }
-    ],
-    "events": [
-      {
-        "name": "open-change",
-        "description": "When the panel state changes. detail: { open, reason }",
-        "type": {
-          "text": "CustomEvent"
-        }
-      }
-    ],
-    "slots": [
-      {
-        "name": "",
-        "description": "The trigger element"
-      },
-      {
-        "name": "content",
-        "description": "Panel content"
-      }
-    ],
-    "cssParts": [
-      {
-        "name": "panel",
-        "description": "Panel container."
-      }
-    ],
-    "cssProperties": [
-      {
-        "name": "--popover-overflow",
-        "description": "Panel overflow behavior (default: auto)"
-      }
-    ],
-    "demos": [
-      {
-        "url": "",
-        "description": "```html\n<ore-popover placement=\"bottom\" trigger=\"click\">\n  <ore-button>Open info</ore-button>\n  <div slot=\"content\">\n    <p>Popover body content goes here.</p>\n  </div>\n</ore-popover>\n```"
-      }
-    ]
-  },
   {
     "kind": "function",
     "name": "awaitExit",
@@ -14413,8 +14630,16 @@
         "type": {
           "text": "number"
         },
-        "description": "Show delay in milliseconds (default: 0)",
-        "default": "0"
+        "description": "Show delay in milliseconds (default: 300 on hover, immediate on focus/click)",
+        "default": "300 on hover, immediate on focus/click"
+      },
+      {
+        "name": "close-delay",
+        "type": {
+          "text": "number"
+        },
+        "description": "Hide delay in milliseconds (default: 100 on pointer leave, immediate on focus out)",
+        "default": "100 on pointer leave, immediate on focus out"
       },
       {
         "name": "open",