@aglyn/plugins-mui 1.0.0-beta.143

package/src/lib/components/nav-menu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/nav-menu.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as Aglyn from '@aglyn/aglyn'\nimport { mdiChevronDown, mdiFormDropdown, mdiViewGridOutline } from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport Box, { type BoxProps } from '@mui/material/Box'\nimport Button from '@mui/material/Button'\nimport ClickAwayListener from '@mui/material/ClickAwayListener'\nimport Paper from '@mui/material/Paper'\nimport Stack from '@mui/material/Stack'\nimport Typography from '@mui/material/Typography'\nimport {\n  forwardRef,\n  type KeyboardEvent,\n  type ReactNode,\n  useCallback,\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n} from 'react'\nimport type { SxProps } from '@mui/material/styles'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\nimport { isLeafSelectedWithin, parseLeafNodeId } from './drawer'\n\n// Component ids are persisted in screen documents; never rename.\nexport const NAV_MENU_ID: Aglyn.ComponentId = 'muiNavMenu'\nexport const MEGA_MENU_ID: Aglyn.ComponentId = 'muiMegaMenu'\n\nexport type MegaMenuPanelWidth = 'auto' | 'wide' | 'full'\n\n/** Hover close grace period so the pointer can cross into the panel. */\nconst HOVER_CLOSE_DELAY_MS = 150\n\nexport interface NavMenuProps {\n  /** Visible trigger text of the nav item. */\n  label?: string\n  /**\n   * Authored node styles, handed over by the renderer rather than typed into\n   * an attribute. It lands on the element root and the trigger inherits, which\n   * is what lets an author override the default text transform (AGL-1198) —\n   * so it has to be expressible by a typed caller too (AGL-1323).\n   */\n  sx?: SxProps\n  children?: ReactNode\n}\n\nexport interface MegaMenuProps {\n  label?: string\n  /** Panel width preset: content-sized, wide (720px), or full-bleed. */\n  panelWidth?: MegaMenuPanelWidth\n  /** Authored node styles — see `NavMenuProps.sx`. */\n  sx?: SxProps\n  children?: ReactNode\n}\n\n/**\n * Mounted menus in mount order (AGL-568). Broadcast commands (no target\n * node id) are answered by the FIRST registered menu only, mirroring the\n * drawer bus, so a page with one menu needs no wiring at all.\n */\nconst mountedMenus: string[] = []\n\n/**\n * The panel sx per mega-menu width preset. Wide/full center under the\n * trigger with the 50%/translate trick, so no measuring is needed and\n * SSR markup is stable.\n */\nexport function megaMenuPanelSx(panelWidth: MegaMenuPanelWidth): SxProps {\n  switch (panelWidth) {\n    case 'full':\n      return {\n        width: '100vw',\n        maxWidth: '100vw',\n        left: '50%',\n        transform: 'translateX(-50%)',\n        borderRadius: 0,\n      }\n    case 'wide':\n      return {\n        width: 'min(90vw, 720px)',\n        left: '50%',\n        transform: 'translateX(-50%)',\n      }\n    default:\n      return { minWidth: 280, left: 0 }\n  }\n}\n\n/**\n * Shared dropdown shell (AGL-562, interactions-driven since AGL-568): a\n * trigger button plus an absolutely positioned panel inside a relative\n * wrapper. Keeping the panel inside the wrapper's DOM (no portal) makes\n * pointer leave of trigger + panel a single mouseleave and keeps SSR\n * hydration trivial — the panel simply isn't rendered until opened, so\n * the server ships a closed menu.\n *\n * Open/close behavior: clicking the trigger toggles the menu (the\n * zero-config default), and the interactions system drives it over the\n * menu command bus (`dispatchMenuCommand`) keyed by node id — e.g. \"On\n * hover → Open menu (this element)\". Hover-opened menus close on their\n * own when the pointer leaves the trigger + panel surface (with a short\n * grace period); click/command opens stay put until click-away, Escape,\n * or an explicit close.\n *\n * On the static besigner canvas (flagged by ScreenLinkContext.editorInert)\n * the menu mirrors the live site's collapsed state: just the trigger, no\n * panel (AGL-571). Only while the menu or one of its descendants is selected\n * (the renderer stamps `data-aglyn-selected-within` on the leaf) does the\n * panel expand inline, like form fields do, so its contents stay selectable\n * and editable without fighting a popup — and it collapses again the moment\n * selection leaves the subtree. The Preview surface is NOT inert (AGL-830):\n * it suppresses link navigation but runs interactions for real, so the menu\n * takes the live branch and opens on hover exactly like the tenant site.\n */\ninterface MenuShellProps extends BoxProps {\n  label: string\n  editorHint: string\n  panelSx: SxProps\n}\n\n/**\n * Trigger typography (AGL-1198). A menu label sits in a nav beside plain\n * links, so it reads as navigation, not as a call to action — MUI's\n * uppercase Button transform shouts \"PRODUCT\" next to \"Pricing\". The\n * default lives on the WRAPPER and the Button inherits it, so an author\n * who does want uppercase can set it in STYLES → Typography on the\n * element and have it win; before this there was no way to change it at\n * all, because the Button is internal to the element.\n */\nconst TRIGGER_SHELL_SX = {\n  position: 'relative',\n  display: 'inline-flex',\n  textTransform: 'none',\n} as const\n/**\n * The rest of the same argument, generalized (AGL-2542).\n *\n * `textTransform` was one symptom of a whole button's worth of them. The\n * trigger still arrived as a `Button`: 0.875rem where the links beside it\n * were 15px, `min-width: 64px` padding \"Docs\" out to a width its own text\n * never asked for, and `6px 8px` of padding widening the visual gap on two\n * items out of five. In a nav laid out on a flat gap, that is a rhythm one\n * element breaks and no author can fix — the Button is internal, so a font\n * size set in STYLES lands on the wrapper and MUI's own class outranks it.\n *\n * So every typographic property is handed back to the wrapper the same way\n * `textTransform` was, and the button chrome that has no meaning on a nav\n * item is dropped. The element now renders as what it is — a label in a nav\n * — and STYLES → Typography on it reaches the label, which is the control an\n * author was reaching for when they found there wasn't one.\n *\n * `endIcon`'s negative right margin goes with the padding it was tucking\n * into; left at -4px against zero padding, the chevron would hang outside\n * the element and break the gap it just stopped breaking.\n *\n * ⚠️ Padding is where the hover target came from, and a hover-opened menu is\n * only as reachable as its trigger. It belongs on the WRAPPER now — which is\n * both what an author can actually edit and what `onMouseLeave` measures, so\n * padding added there enlarges the target instead of merely looking like it.\n */\nconst TRIGGER_SX = {\n  fontFamily: 'inherit',\n  fontSize: 'inherit',\n  fontWeight: 'inherit',\n  lineHeight: 'inherit',\n  letterSpacing: 'inherit',\n  textTransform: 'inherit',\n  color: 'inherit',\n  minWidth: 0,\n  padding: 0,\n  '& .MuiButton-endIcon': { marginRight: 0 },\n} as const\n\nconst MenuShell = forwardRef<HTMLDivElement, MenuShellProps>((props, ref) => {\n  const { label, editorHint, panelSx, sx, children, ...rest } = props\n  // Node styles ride the sx prop the renderer merges; keep them by\n  // composing with the shell's own layout sx (stack.ts pattern).\n  const nodeSx = Array.isArray(sx) ? sx : sx ? [sx] : []\n  const { editorInert } = Aglyn.useScreenLink(undefined)\n  const [open, setOpen] = useState(false)\n  // True while the menu is open BECAUSE a hover interaction opened it —\n  // only then does pointer leave close the menu.\n  const hoverOpenRef = useRef(false)\n  const closeTimer = useRef<ReturnType<typeof setTimeout> | null>(null)\n  // The renderer stamps the node id on every leaf; commands target it.\n  const nodeId = useMemo(\n    () => parseLeafNodeId((rest as Record<string, unknown>)['data-aglyn']),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [(rest as Record<string, unknown>)['data-aglyn']],\n  )\n\n  const cancelClose = useCallback(() => {\n    if (closeTimer.current) {\n      clearTimeout(closeTimer.current)\n      closeTimer.current = null\n    }\n  }, [])\n  const closeNow = useCallback(() => {\n    cancelClose()\n    hoverOpenRef.current = false\n    setOpen(false)\n  }, [cancelClose])\n  const scheduleClose = useCallback(() => {\n    cancelClose()\n    closeTimer.current = setTimeout(closeNow, HOVER_CLOSE_DELAY_MS)\n  }, [cancelClose, closeNow])\n\n  // Menu command bus enrollment (AGL-568): mirrors the drawer exactly —\n  // live surfaces only, keyed by node id, broadcasts answered by the\n  // first mounted menu.\n  useEffect(() => {\n    if (editorInert || !nodeId) return undefined\n    mountedMenus.push(nodeId)\n    const unsubscribe = Aglyn.subscribeMenuCommands((detail) => {\n      // Match on the un-namespaced suffix (AGL-573): a command authored on\n      // a layout-scoped menu carries the raw canvas id while this menu's\n      // live id is `layout__`-namespaced (or vice versa) — leafIdsMatch\n      // compares them equal without re-authoring the persisted action.\n      const targeted = detail.nodeId\n        ? Aglyn.leafIdsMatch(detail.nodeId, nodeId)\n        : mountedMenus[0] === nodeId\n      if (!targeted) return\n      cancelClose()\n      if (detail.command === 'close') {\n        hoverOpenRef.current = false\n        setOpen(false)\n        return\n      }\n      // open/toggle: remember hover provenance so pointer leave closes\n      // hover-opened menus (and never click/command-opened ones).\n      hoverOpenRef.current = Boolean(detail.hover)\n      if (detail.command === 'open') setOpen(true)\n      else setOpen((value) => !value)\n    })\n    return () => {\n      unsubscribe()\n      cancelClose()\n      const index = mountedMenus.indexOf(nodeId)\n      if (index >= 0) mountedMenus.splice(index, 1)\n    }\n  }, [editorInert, nodeId, cancelClose])\n\n  if (editorInert) {\n    // Editor affordance (AGL-571): collapsed trigger by default — exactly\n    // what the live site shows — expanding to the editable panel only while\n    // the menu subtree holds the selection.\n    const authoring = isLeafSelectedWithin(rest as Record<string, unknown>)\n    return (\n      <Box\n        ref={ref}\n        {...rest}\n        // Relative so the authoring panel drops UNDER the trigger as an\n        // overlay (AGL-830). The old inline-block expanded the panel in the\n        // toolbar's flow, shoving and overlapping the other nav items in a\n        // horizontal app bar; positioning it like the live popup keeps the\n        // bar intact while the panel stays selectable and editable in place.\n        sx={[TRIGGER_SHELL_SX, ...nodeSx]}\n      >\n        <Button\n          color=\"inherit\"\n          aria-expanded={authoring || undefined}\n          endIcon={<MdiIcon path={mdiChevronDown.path} />}\n          sx={TRIGGER_SX}\n        >\n          {label}\n        </Button>\n        {authoring ? (\n          <Paper\n            elevation={4}\n            aria-label={label}\n            sx={[\n              {\n                position: 'absolute',\n                top: '100%',\n                mt: 0.5,\n                zIndex: (theme) => theme.zIndex.modal,\n                p: 1,\n                border: '1px dashed',\n                borderColor: 'divider',\n              },\n              panelSx as never,\n            ]}\n          >\n            <Typography\n              variant=\"caption\"\n              color=\"text.secondary\"\n              sx={{ display: 'block', mb: 0.5, px: 1 }}\n            >\n              {editorHint}\n            </Typography>\n            {children}\n          </Paper>\n        ) : null}\n      </Box>\n    )\n  }\n\n  return (\n    <ClickAwayListener onClickAway={() => open && closeNow()}>\n      <Box\n        ref={ref}\n        {...rest}\n        // Hover-close choreography (AGL-568): the panel renders inside\n        // this wrapper (no portal), so trigger + panel share one\n        // enter/leave pair. Only hover-opened menus follow the pointer\n        // out; enter always cancels a pending close so the pointer can\n        // travel between trigger and panel.\n        onMouseEnter={cancelClose}\n        onMouseLeave={() => {\n          if (hoverOpenRef.current) scheduleClose()\n        }}\n        onKeyDown={(event: KeyboardEvent) => {\n          if (event.key === 'Escape') closeNow()\n        }}\n        sx={[TRIGGER_SHELL_SX, ...nodeSx]}\n      >\n        <Button\n          color=\"inherit\"\n          aria-haspopup=\"true\"\n          aria-expanded={open || undefined}\n          endIcon={<MdiIcon path={mdiChevronDown.path} />}\n          sx={TRIGGER_SX}\n          onClick={() => {\n            // Zero-config default: the trigger click-toggles its menu;\n            // a click also \"pins\" a hover-opened menu.\n            cancelClose()\n            hoverOpenRef.current = false\n            setOpen((value) => !value)\n          }}\n        >\n          {label}\n        </Button>\n        {open ? (\n          <Paper\n            elevation={4}\n            aria-label={label}\n            sx={[\n              {\n                position: 'absolute',\n                top: '100%',\n                zIndex: (theme) => theme.zIndex.modal,\n                p: 1,\n              },\n              panelSx as never,\n            ]}\n          >\n            {children}\n          </Paper>\n        ) : null}\n      </Box>\n    </ClickAwayListener>\n  )\n})\nMenuShell.displayName = 'AglynMenuShell'\n\n/**\n * Strips the pre-AGL-568 \"Open on\" attribute persisted docs may still\n * carry. Behavior configuration rides the interactions system now; the\n * stored value is ignored silently — no migrations, no warnings — and\n * must never leak onto the DOM.\n */\nfunction stripLegacyTrigger(rest: Record<string, unknown>): void {\n  delete rest['trigger']\n}\n\n/**\n * Dropdown nav item (AGL-562): a labeled nav button whose children —\n * screen links, buttons, anything — open in a dropdown panel. Clicking\n * the trigger toggles it; interactions drive it over the menu command\n * bus (AGL-568). SSR ships the menu closed; no window access happens at\n * render.\n */\nconst NavMenu = forwardRef<HTMLDivElement, NavMenuProps>((props, ref) => {\n  const { label, children, ...rest } = props\n  stripLegacyTrigger(rest as Record<string, unknown>)\n  return (\n    <MenuShell\n      ref={ref}\n      label={label || 'Menu'}\n      editorHint=\"Dropdown items — shown in a menu on the live site\"\n      panelSx={{ minWidth: 220, left: 0 }}\n      {...rest}\n    >\n      <Stack spacing={0.5} sx={{ alignItems: 'stretch' }}>\n        {children}\n      </Stack>\n    </MenuShell>\n  )\n})\nNavMenu.displayName = 'AglynNavMenu'\n\n/**\n * Mega menu (AGL-562): a SaaS-style wide panel anchored under a nav\n * item with a free-form canvas slot — columns of links, promos,\n * whatever the author drops in. Click-toggles like the dropdown; the\n * SaaS hover-open convention is one interaction away (\"On hover → Open\n * menu\", AGL-568) and then closes itself on pointer leave.\n */\nexport const MegaMenu = forwardRef<HTMLDivElement, MegaMenuProps>(\n  (props, ref) => {\n    const { label, panelWidth, children, ...rest } = props\n    stripLegacyTrigger(rest as Record<string, unknown>)\n    return (\n      <MenuShell\n        ref={ref}\n        label={label || 'Menu'}\n        editorHint=\"Mega menu panel — opens under the nav item on the live site\"\n        panelSx={{ p: 3, ...megaMenuPanelSx(panelWidth || 'auto') } as never}\n        {...rest}\n      >\n        {children}\n      </MenuShell>\n    )\n  },\n)\nMegaMenu.displayName = 'AglynMegaMenu'\n\nexport const navMenuSchema: Aglyn.ComponentSchema<NavMenuProps> = {\n  $id: NAV_MENU_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Dropdown Menu',\n  description: 'A nav item that opens a dropdown of links beneath it.',\n  category: Aglyn.ComponentCategory.NAVIGATION,\n  icon: { path: mdiFormDropdown.path, sx: { color: '#2196f3' } },\n  // Open/close behavior deliberately has NO attribute (AGL-568): click\n  // toggles by default and everything else is authored as an\n  // interaction (e.g. \"On hover → Open menu\").\n  attributes: [\n    {\n      name: 'label',\n      description: 'Text on the nav item that opens the dropdown.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Label',\n    },\n  ],\n}\n\nexport const megaMenuSchema: Aglyn.ComponentSchema<MegaMenuProps> = {\n  $id: MEGA_MENU_ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Mega Menu',\n  description:\n    'A nav item that opens a wide panel — columns of links, promos, whatever you build.',\n  category: Aglyn.ComponentCategory.NAVIGATION,\n  icon: { path: mdiViewGridOutline.path, sx: { color: '#2196f3' } },\n  // Open/close behavior deliberately has NO attribute (AGL-568) — see\n  // navMenuSchema.\n  attributes: [\n    {\n      name: 'label',\n      description: 'Text on the nav item that opens the panel.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'Label',\n    },\n    {\n      name: 'panelWidth',\n      description: 'How wide the opened panel is.',\n      component: Aglyn.FieldComponentType.SELECT,\n      label: 'Panel width',\n      // `auto` is the `MegaMenuPanelWidth` member `megaMenuPanelSx` already\n      // switches on, so the sentinel names the case that existed in code\n      // but not in the option list (AGL-1451); `''` could not persist\n      // (AGL-1191), so a wide panel could not be narrowed again.\n      options: [\n        { value: 'auto', label: 'Fit content' },\n        { value: 'wide', label: 'Wide (720px)' },\n        { value: 'full', label: 'Full width' },\n      ],\n    },\n  ],\n}\n\nconst navLink = (label: string) => ({\n  $id: null,\n  componentId: 'muiScreenLink',\n  pluginId: BUNDLE_ID,\n  props: { children: label, color: 'inherit' },\n})\n\nconst megaColumn = (title: string, links: string[]) => ({\n  $id: null,\n  componentId: 'muiStack',\n  pluginId: BUNDLE_ID,\n  props: { spacing: 0.5 },\n  // Styling goes on the node's own sx, never in props (AGL-1346) — that is\n  // the record the Styles panel edits.\n  sx: { minWidth: 180, alignItems: 'flex-start' },\n  nodes: [\n    {\n      $id: null,\n      componentId: 'muiTypography',\n      pluginId: BUNDLE_ID,\n      props: { variant: 'overline', color: 'text.secondary', children: title },\n    },\n    ...links.map(navLink),\n  ],\n})\n\nexport const navMenuPresets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(NAV_MENU_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Dropdown Menu',\n    pluginId: BUNDLE_ID,\n    description: 'Nav item that opens a dropdown of links',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: navMenuSchema.icon,\n    data: {\n      $id: null,\n      componentId: NAV_MENU_ID,\n      pluginId: BUNDLE_ID,\n      props: { label: 'More' },\n      nodes: [navLink('About'), navLink('Blog'), navLink('Contact')],\n    },\n  },\n  // Primitive dropdown scaffold (AGL-589): the same result as the menu\n  // elements but built from a Stack + Button + hidden panel, with the\n  // hover choreography (grace delay, Esc/outside-click dismissal)\n  // pre-wired as real interactions the user can edit or remove. The\n  // panel carries `aglyn-hidden` so it starts closed on the live site;\n  // the canvas shows it for editing (the hidden style only injects at\n  // runtime).\n  {\n    $id: generatePresetId('muiStack', 'dropdown-panel'),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Dropdown Panel',\n    pluginId: BUNDLE_ID,\n    description:\n      'Trigger + hover panel built from primitives — opens on hover, ' +\n      'closes on leave with a grace delay, dismisses on Esc or outside ' +\n      'click; the wiring arrives as editable interactions',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiFormDropdown.path, sx: { color: '#2196f3' } },\n    data: {\n      $id: null,\n      presetRef: 'wrapper',\n      componentId: 'muiStack',\n      pluginId: BUNDLE_ID,\n      props: {},\n      sx: { position: 'relative', display: 'inline-flex' },\n      nodes: [\n        {\n          $id: null,\n          presetRef: 'trigger',\n          componentId: 'muiButton',\n          pluginId: BUNDLE_ID,\n          props: { children: 'Explore', color: 'inherit' },\n        },\n        {\n          $id: null,\n          presetRef: 'panel',\n          componentId: 'muiStack',\n          pluginId: BUNDLE_ID,\n          props: {\n            className: 'aglyn-hidden',\n            direction: 'row',\n            spacing: 4,\n          },\n          // The panel's whole positioning. It lived in `props.sx` on the\n          // documents this preset seeded, where the Styles panel could\n          // neither show nor clear it (AGL-1339/AGL-1346); a fresh insert\n          // now puts it where a click can reach it. Same keys, same order,\n          // and `node.sx` composes last — the panel renders identically.\n          sx: {\n            position: 'absolute',\n            top: '100%',\n            left: 0,\n            zIndex: 1300,\n            paddingTop: 3,\n            paddingRight: 3,\n            paddingBottom: 3,\n            paddingLeft: 3,\n            minWidth: 560,\n            flexWrap: 'wrap',\n            backgroundColor: 'background.paper',\n            color: 'text.primary',\n            boxShadow: 8,\n            borderRadius: 1,\n          },\n          nodes: [\n            megaColumn('Shop', ['New arrivals', 'Best sellers', 'Sale']),\n            megaColumn('Company', ['About', 'Careers', 'Press']),\n            megaColumn('Support', ['Help center', 'Contact']),\n          ],\n        },\n      ],\n    },\n    interactionTemplates: [\n      {\n        name: 'Dropdown panel — open on hover',\n        event: 'elementHoverEnter',\n        triggerRef: 'wrapper',\n        steps: [\n          {\n            type: 'showElement',\n            targetRef: 'panel',\n            dismissOn: ['escape', 'outsideClick'],\n          },\n        ],\n      },\n      {\n        name: 'Dropdown panel — close on hover leave',\n        event: 'elementHoverLeave',\n        triggerRef: 'wrapper',\n        steps: [{ type: 'hideElement', targetRef: 'panel', delayMs: 250 }],\n      },\n    ],\n  },\n  {\n    $id: generatePresetId(MEGA_MENU_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Mega Menu',\n    pluginId: BUNDLE_ID,\n    description:\n      'Wide panel with columns of links; add a hover interaction to ' +\n      'open it on hover',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: megaMenuSchema.icon,\n    data: {\n      $id: null,\n      componentId: MEGA_MENU_ID,\n      pluginId: BUNDLE_ID,\n      props: { label: 'Products', panelWidth: 'wide' },\n      nodes: [\n        {\n          $id: null,\n          componentId: 'muiStack',\n          pluginId: BUNDLE_ID,\n          props: { direction: 'row', spacing: 4 },\n          sx: { flexWrap: 'wrap' },\n          nodes: [\n            megaColumn('Shop', ['New arrivals', 'Best sellers', 'Sale']),\n            megaColumn('Company', ['About', 'Careers', 'Press']),\n            megaColumn('Support', ['Help center', 'Contact']),\n          ],\n        },\n      ],\n    },\n  },\n]\n\nexport default NavMenu\n"],"names":["Aglyn","mdiChevronDown","mdiFormDropdown","mdiViewGridOutline","MdiIcon","Box","Button","ClickAwayListener","Paper","Stack","Typography","forwardRef","useCallback","useEffect","useMemo","useRef","useState","BUNDLE_ID","generatePresetId","isLeafSelectedWithin","parseLeafNodeId","NAV_MENU_ID","MEGA_MENU_ID","HOVER_CLOSE_DELAY_MS","mountedMenus","megaMenuPanelSx","panelWidth","width","maxWidth","left","transform","borderRadius","minWidth","TRIGGER_SHELL_SX","position","display","textTransform","TRIGGER_SX","fontFamily","fontSize","fontWeight","lineHeight","letterSpacing","color","padding","marginRight","MenuShell","props","ref","label","editorHint","panelSx","sx","children","rest","nodeSx","Array","isArray","editorInert","useScreenLink","undefined","open","setOpen","hoverOpenRef","closeTimer","nodeId","cancelClose","current","clearTimeout","closeNow","scheduleClose","setTimeout","push","unsubscribe","subscribeMenuCommands","detail","targeted","leafIdsMatch","command","Boolean","hover","value","index","indexOf","splice","authoring","aria-expanded","endIcon","path","elevation","aria-label","top","mt","zIndex","theme","modal","p","border","borderColor","variant","mb","px","onClickAway","onMouseEnter","onMouseLeave","onKeyDown","event","key","aria-haspopup","onClick","displayName","stripLegacyTrigger","NavMenu","spacing","alignItems","MegaMenu","navMenuSchema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","attributes","name","component","FieldComponentType","TEXT_FIELD","megaMenuSchema","SELECT","options","navLink","componentId","megaColumn","title","links","nodes","map","navMenuPresets","type","NodeType","PRESET","data","presetRef","className","direction","paddingTop","paddingRight","paddingBottom","paddingLeft","flexWrap","backgroundColor","boxShadow","interactionTemplates","triggerRef","steps","targetRef","dismissOn","delayMs"],"mappings":"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"}

package/src/lib/components/pagination.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as Aglyn from '@aglyn/aglyn';
+import { type ReactNode } from 'react';
+export declare const ID: Aglyn.ComponentId;
+export interface PaginationElementProps {
+    count?: number | string;
+    defaultPage?: number | string;
+    color?: 'primary' | 'secondary' | 'standard';
+    shape?: 'circular' | 'rounded';
+    size?: 'small' | 'medium' | 'large';
+    variant?: 'text' | 'outlined';
+    siblingCount?: number | string;
+    boundaryCount?: number | string;
+    showFirstButton?: boolean;
+    showLastButton?: boolean;
+    hidePrevButton?: boolean;
+    hideNextButton?: boolean;
+    disabled?: boolean;
+    /**
+     * Accepted and dropped. The element is self-closing (see `flags`), so the
+     * editor never authors children — but the renderer builds elements from
+     * persisted props, and a stray child from an older document would reach
+     * MUI's Pagination and render beside the page list. Declared because the
+     * implementation deliberately discards it (AGL-1323).
+     */
+    children?: ReactNode;
+}
+/**
+ * Pagination control (https://mui.com/material-ui/react-pagination/).
+ *
+ * Uncontrolled: it tracks and highlights the page a visitor picks, but
+ * it does not by itself fetch or filter anything — pair it with an
+ * interaction, or with a repeat that reads the page. That is stated in
+ * the element's own description too, because a page-picker that looks
+ * wired and isn't is worse than one that says what it is.
+ *
+ * The `size` here is MUI's own three-value scale; the shared FIELD_SIZE
+ * preset also offers `inherit`, which Pagination does not accept, so the
+ * shared field is narrowed rather than re-declared.
+ */
+declare const PaginationElement: import("react").ForwardRefExoticComponent<PaginationElementProps & import("react").RefAttributes<HTMLElement>>;
+export declare const schema: Aglyn.ComponentSchema<PaginationElementProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default PaginationElement;

package/src/lib/components/pagination.js

@@ -0,0 +1,243 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Aglyn from "@aglyn/aglyn";
+import { mdiFormatListNumbered } from "@aglyn/shared-data-mdi";
+import MuiPagination from "@mui/material/Pagination";
+import { forwardRef } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { FIELD_DISABLED, FIELD_SIZE } from "../constants/field-presets.js";
+import { dropClearedProps } from "../utils/drop-cleared-props.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+// Component ids are persisted in screen documents; never rename.
+export const ID = 'muiPagination';
+/** Number-typed attribute fields round-trip as strings. */ function toCount(value, fallback) {
+    if (value == null || value === '') return fallback;
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0) return fallback;
+    return Math.round(parsed);
+}
+/**
+ * Pagination control (https://mui.com/material-ui/react-pagination/).
+ *
+ * Uncontrolled: it tracks and highlights the page a visitor picks, but
+ * it does not by itself fetch or filter anything — pair it with an
+ * interaction, or with a repeat that reads the page. That is stated in
+ * the element's own description too, because a page-picker that looks
+ * wired and isn't is worse than one that says what it is.
+ *
+ * The `size` here is MUI's own three-value scale; the shared FIELD_SIZE
+ * preset also offers `inherit`, which Pagination does not accept, so the
+ * shared field is narrowed rather than re-declared.
+ */ const PaginationElement = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { count, defaultPage, siblingCount, boundaryCount, children: _children } = props, spread = _object_without_properties_loose(props, [
+        "count",
+        "defaultPage",
+        "siblingCount",
+        "boundaryCount",
+        "children"
+    ]);
+    // A cleared `color`/`size` persists as null; MUI capitalizes both and
+    // throws during SSR, 500ing the page (AGL-1226).
+    const rest = dropClearedProps(spread);
+    const total = toCount(count, 10);
+    return /*#__PURE__*/ _jsx(MuiPagination, _extends({
+        ref: ref,
+        count: total,
+        // Out-of-range defaults make MUI drop the selection entirely.
+        defaultPage: Math.min(Math.max(toCount(defaultPage, 1), 1), total),
+        siblingCount: toCount(siblingCount, 1),
+        boundaryCount: toCount(boundaryCount, 1)
+    }, rest));
+});
+PaginationElement.displayName = 'AglynPagination';
+export const schema = {
+    $id: ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Pagination',
+    description: 'Page picker. It highlights the chosen page; wire an interaction to ' + 'make it change what the page shows.',
+    category: Aglyn.ComponentCategory.NAVIGATION,
+    icon: {
+        path: mdiFormatListNumbered.path,
+        sx: {
+            color: '#2196f3'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'count',
+            label: 'Pages',
+            description: 'Total number of pages. Default 10.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            type: 'number'
+        },
+        {
+            name: 'defaultPage',
+            label: 'Starting page',
+            description: 'The page selected when a visitor arrives. Default 1.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            type: 'number'
+        },
+        {
+            name: 'variant',
+            label: 'Variant',
+            description: 'Outlined draws a border around each page item.',
+            component: Aglyn.FieldComponentType.SELECT,
+            // REAL SENTINELS here, not deletions (AGL-1453) — the opposite call
+            // from Button's and Typography's "Default" options, for a reason that
+            // is visible in the lists themselves: those name MUI's default among
+            // their choices, so `''` was a duplicate. These four offered ONLY the
+            // non-default alternative, so `''` was the sole route back — and it
+            // could not persist (AGL-1191). Picking Outlined, Rounded, Primary or
+            // Small was a one-way door: the "(default)" option reverted on save and
+            // the field snapped back to what it was.
+            //
+            // Each sentinel is MUI Pagination's own literal default for that prop
+            // (`Pagination.js`: `variant = 'text'`, `shape = 'circular'`,
+            // `color = 'standard'`, `size = 'medium'`), so the labels stop lying
+            // and a stored value renders exactly what an unset one did.
+            options: [
+                {
+                    value: 'text',
+                    label: 'Text (default)'
+                },
+                {
+                    value: 'outlined',
+                    label: 'Outlined'
+                }
+            ]
+        },
+        {
+            name: 'shape',
+            label: 'Shape',
+            description: 'Rounded squares instead of circles.',
+            component: Aglyn.FieldComponentType.SELECT,
+            options: [
+                {
+                    value: 'circular',
+                    label: 'Circular (default)'
+                },
+                {
+                    value: 'rounded',
+                    label: 'Rounded'
+                }
+            ]
+        },
+        {
+            name: 'color',
+            label: 'Theme color',
+            description: 'Color of the selected page item.',
+            component: Aglyn.FieldComponentType.SELECT,
+            options: [
+                {
+                    value: 'standard',
+                    label: 'Standard (default)'
+                },
+                {
+                    value: 'primary',
+                    label: 'Primary'
+                },
+                {
+                    value: 'secondary',
+                    label: 'Secondary'
+                }
+            ]
+        },
+        _extends({}, FIELD_SIZE, {
+            options: [
+                {
+                    value: 'medium',
+                    label: 'Medium (default)'
+                },
+                {
+                    value: 'small',
+                    label: 'Small'
+                },
+                {
+                    value: 'large',
+                    label: 'Large'
+                }
+            ]
+        }),
+        {
+            name: 'siblingCount',
+            label: 'Sibling pages',
+            description: 'How many page numbers to show either side of the current one.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            type: 'number'
+        },
+        {
+            name: 'boundaryCount',
+            label: 'Boundary pages',
+            description: 'How many page numbers to always show at the start and end.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            type: 'number'
+        },
+        {
+            name: 'showFirstButton',
+            label: 'Show first-page button?',
+            description: 'Adds a jump-to-first control.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'showLastButton',
+            label: 'Show last-page button?',
+            description: 'Adds a jump-to-last control.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'hidePrevButton',
+            label: 'Hide previous button?',
+            description: 'Removes the previous-page arrow.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'hideNextButton',
+            label: 'Hide next button?',
+            description: 'Removes the next-page arrow.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        FIELD_DISABLED
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Pagination',
+        pluginId: BUNDLE_ID,
+        description: 'Page picker with previous/next arrows',
+        category: Aglyn.ComponentCategory.NAVIGATION,
+        icon: schema.icon,
+        data: {
+            $id: null,
+            componentId: ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                count: 10,
+                color: 'primary'
+            }
+        }
+    }
+];
+export default PaginationElement;
+
+//# sourceMappingURL=pagination.js.map

package/src/lib/components/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/pagination.tsx"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport * as Aglyn from '@aglyn/aglyn'\nimport { mdiFormatListNumbered } from '@aglyn/shared-data-mdi'\nimport MuiPagination from '@mui/material/Pagination'\nimport { forwardRef, type ReactNode } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { FIELD_DISABLED, FIELD_SIZE } from '../constants/field-presets'\nimport { dropClearedProps } from '../utils/drop-cleared-props'\nimport { generatePresetId } from '../utils/generate-preset-id'\n\n// Component ids are persisted in screen documents; never rename.\nexport const ID: Aglyn.ComponentId = 'muiPagination'\n\nexport interface PaginationElementProps {\n  count?: number | string\n  defaultPage?: number | string\n  color?: 'primary' | 'secondary' | 'standard'\n  shape?: 'circular' | 'rounded'\n  size?: 'small' | 'medium' | 'large'\n  variant?: 'text' | 'outlined'\n  siblingCount?: number | string\n  boundaryCount?: number | string\n  showFirstButton?: boolean\n  showLastButton?: boolean\n  hidePrevButton?: boolean\n  hideNextButton?: boolean\n  disabled?: boolean\n  /**\n   * Accepted and dropped. The element is self-closing (see `flags`), so the\n   * editor never authors children — but the renderer builds elements from\n   * persisted props, and a stray child from an older document would reach\n   * MUI's Pagination and render beside the page list. Declared because the\n   * implementation deliberately discards it (AGL-1323).\n   */\n  children?: ReactNode\n}\n\n/** Number-typed attribute fields round-trip as strings. */\nfunction toCount(value: unknown, fallback: number): number {\n  if (value == null || value === '') return fallback\n  const parsed = Number(value)\n  if (!Number.isFinite(parsed) || parsed < 0) return fallback\n  return Math.round(parsed)\n}\n\n/**\n * Pagination control (https://mui.com/material-ui/react-pagination/).\n *\n * Uncontrolled: it tracks and highlights the page a visitor picks, but\n * it does not by itself fetch or filter anything — pair it with an\n * interaction, or with a repeat that reads the page. That is stated in\n * the element's own description too, because a page-picker that looks\n * wired and isn't is worse than one that says what it is.\n *\n * The `size` here is MUI's own three-value scale; the shared FIELD_SIZE\n * preset also offers `inherit`, which Pagination does not accept, so the\n * shared field is narrowed rather than re-declared.\n */\nconst PaginationElement = forwardRef<HTMLElement, PaginationElementProps>(\n  (props, ref) => {\n    const {\n      count,\n      defaultPage,\n      siblingCount,\n      boundaryCount,\n      children: _children,\n      ...spread\n    } = props\n    // A cleared `color`/`size` persists as null; MUI capitalizes both and\n    // throws during SSR, 500ing the page (AGL-1226).\n    const rest = dropClearedProps(spread)\n    const total = toCount(count, 10)\n    return (\n      <MuiPagination\n        ref={ref}\n        count={total}\n        // Out-of-range defaults make MUI drop the selection entirely.\n        defaultPage={Math.min(Math.max(toCount(defaultPage, 1), 1), total)}\n        siblingCount={toCount(siblingCount, 1)}\n        boundaryCount={toCount(boundaryCount, 1)}\n        {...rest}\n      />\n    )\n  },\n)\nPaginationElement.displayName = 'AglynPagination'\n\nexport const schema: Aglyn.ComponentSchema<PaginationElementProps> = {\n  $id: ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Pagination',\n  description:\n    'Page picker. It highlights the chosen page; wire an interaction to ' +\n    'make it change what the page shows.',\n  category: Aglyn.ComponentCategory.NAVIGATION,\n  icon: { path: mdiFormatListNumbered.path, sx: { color: '#2196f3' } },\n  flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n  attributes: [\n    {\n      name: 'count',\n      label: 'Pages',\n      description: 'Total number of pages. Default 10.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      type: 'number',\n    },\n    {\n      name: 'defaultPage',\n      label: 'Starting page',\n      description: 'The page selected when a visitor arrives. Default 1.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      type: 'number',\n    },\n    {\n      name: 'variant',\n      label: 'Variant',\n      description: 'Outlined draws a border around each page item.',\n      component: Aglyn.FieldComponentType.SELECT,\n      // REAL SENTINELS here, not deletions (AGL-1453) — the opposite call\n      // from Button's and Typography's \"Default\" options, for a reason that\n      // is visible in the lists themselves: those name MUI's default among\n      // their choices, so `''` was a duplicate. These four offered ONLY the\n      // non-default alternative, so `''` was the sole route back — and it\n      // could not persist (AGL-1191). Picking Outlined, Rounded, Primary or\n      // Small was a one-way door: the \"(default)\" option reverted on save and\n      // the field snapped back to what it was.\n      //\n      // Each sentinel is MUI Pagination's own literal default for that prop\n      // (`Pagination.js`: `variant = 'text'`, `shape = 'circular'`,\n      // `color = 'standard'`, `size = 'medium'`), so the labels stop lying\n      // and a stored value renders exactly what an unset one did.\n      options: [\n        { value: 'text', label: 'Text (default)' },\n        { value: 'outlined', label: 'Outlined' },\n      ],\n    },\n    {\n      name: 'shape',\n      label: 'Shape',\n      description: 'Rounded squares instead of circles.',\n      component: Aglyn.FieldComponentType.SELECT,\n      options: [\n        { value: 'circular', label: 'Circular (default)' },\n        { value: 'rounded', label: 'Rounded' },\n      ],\n    },\n    {\n      name: 'color',\n      label: 'Theme color',\n      description: 'Color of the selected page item.',\n      component: Aglyn.FieldComponentType.SELECT,\n      options: [\n        { value: 'standard', label: 'Standard (default)' },\n        { value: 'primary', label: 'Primary' },\n        { value: 'secondary', label: 'Secondary' },\n      ],\n    },\n    {\n      // Narrowed from the shared preset: Pagination has no `inherit`\n      // size, and offering it would render nothing different.\n      ...FIELD_SIZE,\n      options: [\n        { value: 'medium', label: 'Medium (default)' },\n        { value: 'small', label: 'Small' },\n        { value: 'large', label: 'Large' },\n      ],\n    },\n    {\n      name: 'siblingCount',\n      label: 'Sibling pages',\n      description:\n        'How many page numbers to show either side of the current one.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      type: 'number',\n    },\n    {\n      name: 'boundaryCount',\n      label: 'Boundary pages',\n      description:\n        'How many page numbers to always show at the start and end.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      type: 'number',\n    },\n    {\n      name: 'showFirstButton',\n      label: 'Show first-page button?',\n      description: 'Adds a jump-to-first control.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'showLastButton',\n      label: 'Show last-page button?',\n      description: 'Adds a jump-to-last control.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'hidePrevButton',\n      label: 'Hide previous button?',\n      description: 'Removes the previous-page arrow.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'hideNextButton',\n      label: 'Hide next button?',\n      description: 'Removes the next-page arrow.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    FIELD_DISABLED,\n  ],\n}\n\nexport const presets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Pagination',\n    pluginId: BUNDLE_ID,\n    description: 'Page picker with previous/next arrows',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: schema.icon,\n    data: {\n      $id: null,\n      componentId: ID,\n      pluginId: BUNDLE_ID,\n      props: { count: 10, color: 'primary' },\n    },\n  },\n]\n\nexport default PaginationElement\n"],"names":["Aglyn","mdiFormatListNumbered","MuiPagination","forwardRef","BUNDLE_ID","FIELD_DISABLED","FIELD_SIZE","dropClearedProps","generatePresetId","ID","toCount","value","fallback","parsed","Number","isFinite","Math","round","PaginationElement","props","ref","count","defaultPage","siblingCount","boundaryCount","children","_children","spread","rest","total","min","max","displayName","schema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","path","sx","color","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","label","component","FieldComponentType","TEXT_FIELD","type","SELECT","options","SWITCH","presets","NodeType","PRESET","data","componentId"],"mappings":"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"}

package/src/lib/components/paper.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as Aglyn from '@aglyn/aglyn';
+import { type ReactNode } from 'react';
+export declare const ID: Aglyn.ComponentId;
+export interface PaperElementProps {
+    /** Shadow depth, 0–24. Ignored by MUI when `variant` is `outlined`. */
+    elevation?: number | string;
+    variant?: 'elevation' | 'outlined';
+    /** If true, corners are not rounded. */
+    square?: boolean;
+    children?: ReactNode;
+}
+/** MUI's shadow scale tops out at 24; anything above renders unshadowed. */
+export declare const MAX_ELEVATION = 24;
+/**
+ * Coerces a persisted elevation to the number MUI's shadow lookup needs.
+ *
+ * Number-typed attribute fields round-trip through the document as
+ * strings often enough that this can't be assumed away: `elevation="3"`
+ * indexes MUI's shadow array with a string and yields `undefined`, i.e. a
+ * paper the author gave a shadow renders completely flat.
+ */
+export declare function toElevation(value: unknown): number | undefined;
+/**
+ * Surface primitive (https://mui.com/material-ui/react-paper/): the
+ * themed background + shadow that Card, Accordion and Drawer are all
+ * built on, exposed on its own for panels and callouts.
+ */
+declare const PaperElement: import("react").ForwardRefExoticComponent<PaperElementProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const schema: Aglyn.ComponentSchema<PaperElementProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default PaperElement;