@aglyn/plugins-mui 1.0.0-beta.143

package/src/lib/components/link-box.js

@@ -0,0 +1,212 @@
+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 { mdiLinkBoxOutline } from "@aglyn/shared-data-mdi";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import MuiBox from "@mui/material/Box";
+import { forwardRef } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+import { linkContainerA11yProps, linkContainerLabelFieldProps, REDUNDANT_ATTRIBUTE } from "./link-box-accessible-name.js";
+// Component ids are persisted in screen documents; never rename.
+export const ID = 'muiLinkBox';
+/**
+ * A container that IS the link — icon, heading and description inside one
+ * anchor, instead of a tile whose only clickable part is its title.
+ *
+ * Every other linking element in the plugin is a leaf: Screen Link and
+ * Button both render their `children` as inline text, so `nodeAcceptsChildren`
+ * reports false and the canvas will not let anything be dropped inside them.
+ * That left no way to author a card, a mega-menu tile, or a linked logo —
+ * the shapes where the whole box is meant to be one target (AGL-1231).
+ *
+ * Nothing interactive may be nested inside: an `<a>` inside an `<a>` is
+ * invalid HTML and browsers unnest it, which silently moves half the tile
+ * back out of the link. Convert an inner Screen Link to plain Text when you
+ * wrap it in one of these.
+ *
+ * The link is named by the text inside it, so a box holding only an icon
+ * needs `ariaLabel` — or `redundant`, when a link beside it already goes to
+ * the same place (AGL-2886). Both land on the anchor in every branch below,
+ * so the canvas carries the same attributes the published page does.
+ */ const LinkBox = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { screenId, href: externalHref, newTab, ariaLabel, redundant, children, sx } = props, rest = _object_without_properties_loose(props, [
+        "screenId",
+        "href",
+        "newTab",
+        "ariaLabel",
+        "redundant",
+        "children",
+        "sx"
+    ]);
+    const a11y = linkContainerA11yProps(ariaLabel, redundant);
+    // Node styles ride the renderer-merged sx; recompose (stack.ts pattern).
+    // Spreading `rest` with `sx` still inside it would REPLACE the baseline
+    // below rather than merge with it, so every styled tile would quietly lose
+    // `textDecoration: none` and get the browser's underlined-blue anchor.
+    const nodeSx = Array.isArray(sx) ? sx : sx ? [
+        sx
+    ] : [];
+    // Shared resolution (AGL-1335): screen id first, `javascript:`/`data:`
+    // hrefs refused, `screen:`-prefixed prop values understood in either slot.
+    // "External" means it leaves the site, not merely "typed by hand": a
+    // site-relative `/pricing` in the href field must stay in the tab, or the
+    // visitor loses their history for nothing.
+    const { href, suppressNavigation, leavesSite: external } = Aglyn.useLinkTarget(screenId, externalHref);
+    // The unresolved and suppressed cases keep the same ELEMENT, not just the
+    // same box (AGL-1268): this used to render a `<div>` here and an `<a>` when
+    // the screen resolved, so the node's element type depended on the screens
+    // map — a screen published or unpublished between renders changed the DOM
+    // shape. An `<a>` without `href` is HTML's placeholder link: identical
+    // element, non-interactive, and the canvas stays inert exactly as before.
+    // The style floor matches the active branch so the two render identically.
+    if (!href || suppressNavigation) {
+        return /*#__PURE__*/ _jsx(MuiBox, _extends({
+            ref: ref,
+            component: "a"
+        }, rest, a11y, {
+            sx: [
+                {
+                    display: 'block',
+                    color: 'inherit',
+                    textDecoration: 'none'
+                },
+                ...nodeSx
+            ],
+            children: children
+        }));
+    }
+    return /*#__PURE__*/ _jsx(AppLink, _extends({
+        ref: ref,
+        // NOT `componentVariant="naked"`: that branch renders a bare NextLink,
+        // which does not process `sx` — it lands on the DOM as a literal `sx=""`
+        // attribute and every style is silently dropped. The default branch is
+        // MUI's Link, which does. The anchor chrome it brings is neutralised by
+        // the baseline below.
+        href: href
+    }, newTab && external ? {
+        target: '_blank',
+        rel: 'noopener noreferrer'
+    } : {}, rest, a11y, {
+        // `display: block` so the anchor takes the tile's box, and no anchor
+        // chrome — authors then style it exactly as they would a Box. This is
+        // only the floor: node styles come after it and win.
+        sx: [
+            {
+                display: 'block',
+                color: 'inherit',
+                textDecoration: 'none'
+            },
+            ...nodeSx
+        ],
+        children: children
+    }));
+});
+LinkBox.displayName = 'AglynLinkBox';
+/** A label is announced by nothing once the link is hidden as a duplicate. */ const NOT_REDUNDANT = {
+    when: REDUNDANT_ATTRIBUTE,
+    is: true,
+    notMatch: true
+};
+export const schema = {
+    $id: ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Link Container',
+    description: 'Container that is itself a link — put an icon, a heading and a ' + 'description inside and the whole box becomes one target.',
+    category: Aglyn.ComponentCategory.NAVIGATION,
+    icon: {
+        path: mdiLinkBoxOutline.path,
+        sx: {
+            color: '#2196f3'
+        }
+    },
+    attributes: [
+        {
+            name: 'screenId',
+            description: 'Screen this box navigates to. The address is generated from the ' + 'published path at render time, so it keeps working when the ' + "screen's slug or parent changes.",
+            component: Aglyn.FieldComponentType.SCREEN_SELECT,
+            label: 'Screen'
+        },
+        {
+            name: 'href',
+            description: 'Where the whole container goes when it points off this site. ' + 'Ignored while Screen names one. Everything inside the box becomes ' + 'part of this one link, so it should hold no other link.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            label: 'External URL',
+            // A bare `#fragment` saves and goes nowhere (AGL-2867).
+            resolveProps: Aglyn.bareFragmentLinkFieldProps
+        },
+        {
+            name: 'newTab',
+            description: 'Open in a new tab. Applies to external URLs only — a link to one ' + 'of your own screens stays in the tab so the visitor keeps their ' + 'history.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            label: 'Open in a new tab'
+        },
+        {
+            name: 'ariaLabel',
+            label: 'Accessible label',
+            description: 'Names this link for screen readers. Needed when the box holds only ' + 'an icon, or an image with no alt text, which is otherwise announced ' + 'as just "link". Leave it empty when there is text inside: that text ' + 'already names the link.',
+            // A text field, so the Attributes panel takes a binding here as it
+            // does in every other text attribute.
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            condition: NOT_REDUNDANT,
+            // Warns while nothing names the link (AGL-2886).
+            resolveProps: linkContainerLabelFieldProps
+        },
+        {
+            name: REDUNDANT_ATTRIBUTE,
+            label: 'Duplicate of another link',
+            description: 'Turn on when another link beside this box goes to the same place, ' + 'such as the arrow on a card whose title is already a link. Screen ' + 'readers and the Tab key then skip this box, so those visitors meet ' + 'the destination once, and a click or tap still follows it. Leave it ' + 'off when this is the only link to where it goes.',
+            component: Aglyn.FieldComponentType.SWITCH
+        }
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Link Container',
+        pluginId: BUNDLE_ID,
+        description: 'A whole box that links somewhere',
+        category: Aglyn.ComponentCategory.NAVIGATION,
+        icon: schema.icon,
+        data: {
+            $id: null,
+            componentId: ID,
+            pluginId: BUNDLE_ID,
+            // Ships with padding and a hover tint: an empty, zero-height anchor
+            // dropped on the canvas looks like nothing happened.
+            props: {},
+            // Node-level sx (AGL-1346) — the record the Styles panel edits.
+            sx: {
+                display: 'block',
+                paddingTop: 2,
+                paddingRight: 2,
+                paddingBottom: 2,
+                paddingLeft: 2,
+                borderRadius: 1,
+                '&:hover': {
+                    backgroundColor: 'action.hover'
+                }
+            }
+        }
+    }
+];
+export default LinkBox;
+
+//# sourceMappingURL=link-box.js.map

package/src/lib/components/link-box.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/link-box.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 { mdiLinkBoxOutline } from '@aglyn/shared-data-mdi'\nimport { AppLink } from '@aglyn/shared-ui-jsx'\nimport MuiBox from '@mui/material/Box'\nimport type { SxProps } from '@mui/material/styles'\nimport { forwardRef, type ReactNode } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\nimport {\n  linkContainerA11yProps,\n  linkContainerLabelFieldProps,\n  REDUNDANT_ATTRIBUTE,\n} from './link-box-accessible-name'\n\n// Component ids are persisted in screen documents; never rename.\nexport const ID: Aglyn.ComponentId = 'muiLinkBox'\n\nexport interface LinkBoxProps {\n  /** Target screen id, resolved from the host routing map at render time. */\n  screenId?: string\n  /** External URL escape hatch, used only when no `screenId` is set. */\n  href?: string\n  /** Opens in a new tab. External destinations only. */\n  newTab?: boolean\n  /** The link's name for assistive tech, when its content supplies none. */\n  ariaLabel?: string\n  /**\n   * The box repeats a link beside it to the same destination, so it is\n   * hidden from assistive tech and left out of the tab order.\n   */\n  redundant?: boolean\n  /**\n   * Authored node styles, handed over by the renderer rather than typed into\n   * an attribute. Declared because the merge below reads it: undeclared, no\n   * typed caller could style a tile (AGL-1323).\n   */\n  sx?: SxProps\n  children?: ReactNode\n}\n\n/**\n * A container that IS the link — icon, heading and description inside one\n * anchor, instead of a tile whose only clickable part is its title.\n *\n * Every other linking element in the plugin is a leaf: Screen Link and\n * Button both render their `children` as inline text, so `nodeAcceptsChildren`\n * reports false and the canvas will not let anything be dropped inside them.\n * That left no way to author a card, a mega-menu tile, or a linked logo —\n * the shapes where the whole box is meant to be one target (AGL-1231).\n *\n * Nothing interactive may be nested inside: an `<a>` inside an `<a>` is\n * invalid HTML and browsers unnest it, which silently moves half the tile\n * back out of the link. Convert an inner Screen Link to plain Text when you\n * wrap it in one of these.\n *\n * The link is named by the text inside it, so a box holding only an icon\n * needs `ariaLabel` — or `redundant`, when a link beside it already goes to\n * the same place (AGL-2886). Both land on the anchor in every branch below,\n * so the canvas carries the same attributes the published page does.\n */\nconst LinkBox = forwardRef<HTMLElement, LinkBoxProps>((props, ref) => {\n  const {\n    screenId,\n    href: externalHref,\n    newTab,\n    ariaLabel,\n    redundant,\n    children,\n    sx,\n    ...rest\n  } = props\n  const a11y = linkContainerA11yProps(ariaLabel, redundant)\n  // Node styles ride the renderer-merged sx; recompose (stack.ts pattern).\n  // Spreading `rest` with `sx` still inside it would REPLACE the baseline\n  // below rather than merge with it, so every styled tile would quietly lose\n  // `textDecoration: none` and get the browser's underlined-blue anchor.\n  const nodeSx = Array.isArray(sx) ? sx : sx ? [sx] : []\n  // Shared resolution (AGL-1335): screen id first, `javascript:`/`data:`\n  // hrefs refused, `screen:`-prefixed prop values understood in either slot.\n  // \"External\" means it leaves the site, not merely \"typed by hand\": a\n  // site-relative `/pricing` in the href field must stay in the tab, or the\n  // visitor loses their history for nothing.\n  const {\n    href,\n    suppressNavigation,\n    leavesSite: external,\n  } = Aglyn.useLinkTarget(screenId, externalHref)\n\n  // The unresolved and suppressed cases keep the same ELEMENT, not just the\n  // same box (AGL-1268): this used to render a `<div>` here and an `<a>` when\n  // the screen resolved, so the node's element type depended on the screens\n  // map — a screen published or unpublished between renders changed the DOM\n  // shape. An `<a>` without `href` is HTML's placeholder link: identical\n  // element, non-interactive, and the canvas stays inert exactly as before.\n  // The style floor matches the active branch so the two render identically.\n  if (!href || suppressNavigation) {\n    return (\n      <MuiBox\n        ref={ref}\n        component=\"a\"\n        {...rest}\n        {...a11y}\n        sx={[\n          { display: 'block', color: 'inherit', textDecoration: 'none' },\n          ...nodeSx,\n        ]}\n      >\n        {children}\n      </MuiBox>\n    )\n  }\n  return (\n    <AppLink\n      ref={ref}\n      // NOT `componentVariant=\"naked\"`: that branch renders a bare NextLink,\n      // which does not process `sx` — it lands on the DOM as a literal `sx=\"\"`\n      // attribute and every style is silently dropped. The default branch is\n      // MUI's Link, which does. The anchor chrome it brings is neutralised by\n      // the baseline below.\n      href={href}\n      {...(newTab && external\n        ? { target: '_blank', rel: 'noopener noreferrer' }\n        : {})}\n      {...rest}\n      {...a11y}\n      // `display: block` so the anchor takes the tile's box, and no anchor\n      // chrome — authors then style it exactly as they would a Box. This is\n      // only the floor: node styles come after it and win.\n      sx={[\n        { display: 'block', color: 'inherit', textDecoration: 'none' },\n        ...nodeSx,\n      ]}\n    >\n      {children}\n    </AppLink>\n  )\n})\nLinkBox.displayName = 'AglynLinkBox'\n\n/** A label is announced by nothing once the link is hidden as a duplicate. */\nconst NOT_REDUNDANT = { when: REDUNDANT_ATTRIBUTE, is: true, notMatch: true }\n\nexport const schema: Aglyn.ComponentSchema<LinkBoxProps> = {\n  $id: ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'Link Container',\n  description:\n    'Container that is itself a link — put an icon, a heading and a ' +\n    'description inside and the whole box becomes one target.',\n  category: Aglyn.ComponentCategory.NAVIGATION,\n  icon: { path: mdiLinkBoxOutline.path, sx: { color: '#2196f3' } },\n  attributes: [\n    {\n      name: 'screenId',\n      description:\n        'Screen this box navigates to. The address is generated from the ' +\n        'published path at render time, so it keeps working when the ' +\n        \"screen's slug or parent changes.\",\n      component: Aglyn.FieldComponentType.SCREEN_SELECT,\n      label: 'Screen',\n    },\n    {\n      name: 'href',\n      description:\n        'Where the whole container goes when it points off this site. ' +\n        'Ignored while Screen names one. Everything inside the box becomes ' +\n        'part of this one link, so it should hold no other link.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      label: 'External URL',\n      // A bare `#fragment` saves and goes nowhere (AGL-2867).\n      resolveProps: Aglyn.bareFragmentLinkFieldProps,\n    },\n    {\n      name: 'newTab',\n      description:\n        'Open in a new tab. Applies to external URLs only — a link to one ' +\n        'of your own screens stays in the tab so the visitor keeps their ' +\n        'history.',\n      component: Aglyn.FieldComponentType.SWITCH,\n      label: 'Open in a new tab',\n    },\n    {\n      name: 'ariaLabel',\n      label: 'Accessible label',\n      description:\n        'Names this link for screen readers. Needed when the box holds only ' +\n        'an icon, or an image with no alt text, which is otherwise announced ' +\n        'as just \"link\". Leave it empty when there is text inside: that text ' +\n        'already names the link.',\n      // A text field, so the Attributes panel takes a binding here as it\n      // does in every other text attribute.\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n      condition: NOT_REDUNDANT,\n      // Warns while nothing names the link (AGL-2886).\n      resolveProps: linkContainerLabelFieldProps,\n    },\n    {\n      name: REDUNDANT_ATTRIBUTE,\n      label: 'Duplicate of another link',\n      description:\n        'Turn on when another link beside this box goes to the same place, ' +\n        'such as the arrow on a card whose title is already a link. Screen ' +\n        'readers and the Tab key then skip this box, so those visitors meet ' +\n        'the destination once, and a click or tap still follows it. Leave it ' +\n        'off when this is the only link to where it goes.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n  ],\n}\n\nexport const presets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Link Container',\n    pluginId: BUNDLE_ID,\n    description: 'A whole box that links somewhere',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: schema.icon,\n    data: {\n      $id: null,\n      componentId: ID,\n      pluginId: BUNDLE_ID,\n      // Ships with padding and a hover tint: an empty, zero-height anchor\n      // dropped on the canvas looks like nothing happened.\n      props: {},\n      // Node-level sx (AGL-1346) — the record the Styles panel edits.\n      sx: {\n        display: 'block',\n        paddingTop: 2,\n        paddingRight: 2,\n        paddingBottom: 2,\n        paddingLeft: 2,\n        borderRadius: 1,\n        '&:hover': { backgroundColor: 'action.hover' },\n      },\n    },\n  },\n]\n\nexport default LinkBox\n"],"names":["Aglyn","mdiLinkBoxOutline","AppLink","MuiBox","forwardRef","BUNDLE_ID","generatePresetId","linkContainerA11yProps","linkContainerLabelFieldProps","REDUNDANT_ATTRIBUTE","ID","LinkBox","props","ref","screenId","href","externalHref","newTab","ariaLabel","redundant","children","sx","rest","a11y","nodeSx","Array","isArray","suppressNavigation","leavesSite","external","useLinkTarget","component","display","color","textDecoration","target","rel","displayName","NOT_REDUNDANT","when","is","notMatch","schema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","path","attributes","name","FieldComponentType","SCREEN_SELECT","label","TEXT_FIELD","resolveProps","bareFragmentLinkFieldProps","SWITCH","condition","presets","type","NodeType","PRESET","data","componentId","paddingTop","paddingRight","paddingBottom","paddingLeft","borderRadius","backgroundColor"],"mappings":"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"}

package/src/lib/components/list-item-text.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 ListItemText, { type ListItemTextProps } from '@mui/material/ListItemText';
+export declare const ID: Aglyn.ComponentId;
+export declare const schema: Aglyn.ComponentSchema<ListItemTextProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default ListItemText;

package/src/lib/components/list-item-text.js

@@ -0,0 +1,86 @@
+/**
+ * @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 { mdiFormatListChecks } from "@aglyn/shared-data-mdi";
+import ListItemText from "@mui/material/ListItemText";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+// Component ids are persisted in screen documents; keep the legacy ids.
+export const ID = 'muiListItemText';
+export const schema = {
+    $id: ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'List Item Text',
+    description: 'The primary and secondary text pair inside a list row.',
+    category: Aglyn.ComponentCategory.DATA_DISPLAY,
+    icon: {
+        path: mdiFormatListChecks.path
+    },
+    // Text lives in `primary`/`secondary` (not `children`), so this component
+    // exposes its own text fields instead of FIELD_TEXT_CONTENT.
+    flags: {
+        // …and MUI reads `children` ONLY as a fallback for a missing `primary`
+        // (`primary = primaryProp != null ? primaryProp : children`), so with a
+        // primary set — which every preset and every authored row has — a node
+        // dropped in here is discarded at render with no warning. Same shape as
+        // the Markdown block that swallowed three /press screenshots
+        // (AGL-1388): the row's text is its attributes, not its child list.
+        dropping: Aglyn.FEATURE_FLAG.DISABLED
+    },
+    attributes: [
+        {
+            name: 'primary',
+            description: 'The main content text.',
+            component: Aglyn.FieldComponentType.TEXTAREA,
+            label: 'Primary text'
+        },
+        {
+            name: 'secondary',
+            description: 'The secondary content text.',
+            component: Aglyn.FieldComponentType.TEXTAREA,
+            label: 'Secondary text'
+        },
+        {
+            name: 'inset',
+            description: 'Indents the text to line up with rows that have an icon or ' + 'avatar, so a mixed list keeps one text column.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            label: 'Inset?'
+        }
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'List Item Text',
+        icon: {
+            path: mdiFormatListChecks.path
+        },
+        category: Aglyn.ComponentCategory.DATA_DISPLAY,
+        data: {
+            $id: null,
+            componentId: ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                primary: 'Item Primary',
+                secondary: 'This is the secondary'
+            }
+        }
+    }
+];
+export default ListItemText;
+
+//# sourceMappingURL=list-item-text.js.map

package/src/lib/components/list-item-text.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/list-item-text.ts"],"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 {\n  mdiFormatListChecks,\n} from '@aglyn/shared-data-mdi'\nimport ListItemText, {\n  type ListItemTextProps,\n} from '@mui/material/ListItemText'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\n\n// Component ids are persisted in screen documents; keep the legacy ids.\nexport const ID: Aglyn.ComponentId = 'muiListItemText'\n\nexport const schema: Aglyn.ComponentSchema<ListItemTextProps> = {\n  $id: ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'List Item Text',\n  description: 'The primary and secondary text pair inside a list row.',\n  category: Aglyn.ComponentCategory.DATA_DISPLAY,\n  icon: { path: mdiFormatListChecks.path },\n  // Text lives in `primary`/`secondary` (not `children`), so this component\n  // exposes its own text fields instead of FIELD_TEXT_CONTENT.\n  flags: {\n    // …and MUI reads `children` ONLY as a fallback for a missing `primary`\n    // (`primary = primaryProp != null ? primaryProp : children`), so with a\n    // primary set — which every preset and every authored row has — a node\n    // dropped in here is discarded at render with no warning. Same shape as\n    // the Markdown block that swallowed three /press screenshots\n    // (AGL-1388): the row's text is its attributes, not its child list.\n    dropping: Aglyn.FEATURE_FLAG.DISABLED,\n  },\n  attributes: [\n    {\n      name: 'primary',\n      description: 'The main content text.',\n      component: Aglyn.FieldComponentType.TEXTAREA,\n      label: 'Primary text',\n    },\n    {\n      name: 'secondary',\n      description: 'The secondary content text.',\n      component: Aglyn.FieldComponentType.TEXTAREA,\n      label: 'Secondary text',\n    },\n    {\n      name: 'inset',\n      description:\n        'Indents the text to line up with rows that have an icon or ' +\n        'avatar, so a mixed list keeps one text column.',\n      component: Aglyn.FieldComponentType.SWITCH,\n      label: 'Inset?',\n    },\n  ],\n}\n\nexport const presets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'List Item Text',\n    icon: { path: mdiFormatListChecks.path },\n    category: Aglyn.ComponentCategory.DATA_DISPLAY,\n    data: {\n      $id: null,\n      componentId: ID,\n      pluginId: BUNDLE_ID,\n      props: {\n        primary: 'Item Primary',\n        secondary: 'This is the secondary',\n      },\n    },\n  },\n]\n\nexport default ListItemText\n"],"names":["Aglyn","mdiFormatListChecks","ListItemText","BUNDLE_ID","generatePresetId","ID","schema","$id","pluginId","displayName","description","category","ComponentCategory","DATA_DISPLAY","icon","path","flags","dropping","FEATURE_FLAG","DISABLED","attributes","name","component","FieldComponentType","TEXTAREA","label","SWITCH","presets","type","NodeType","PRESET","data","componentId","props","primary","secondary"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SACEC,mBAAmB,QACd,yBAAwB;AAC/B,OAAOC,kBAEA,6BAA4B;AACnC,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SAASC,gBAAgB,QAAQ,iCAA6B;AAE9D,wEAAwE;AACxE,OAAO,MAAMC,KAAwB,kBAAiB;AAEtD,OAAO,MAAMC,SAAmD;IAC9DC,KAAKF;IACLG,UAAUL;IACVM,aAAa;IACbC,aAAa;IACbC,UAAUX,MAAMY,iBAAiB,CAACC,YAAY;IAC9CC,MAAM;QAAEC,MAAMd,oBAAoBc,IAAI;IAAC;IACvC,0EAA0E;IAC1E,6DAA6D;IAC7DC,OAAO;QACL,uEAAuE;QACvE,wEAAwE;QACxE,uEAAuE;QACvE,wEAAwE;QACxE,6DAA6D;QAC7D,oEAAoE;QACpEC,UAAUjB,MAAMkB,YAAY,CAACC,QAAQ;IACvC;IACAC,YAAY;QACV;YACEC,MAAM;YACNX,aAAa;YACbY,WAAWtB,MAAMuB,kBAAkB,CAACC,QAAQ;YAC5CC,OAAO;QACT;QACA;YACEJ,MAAM;YACNX,aAAa;YACbY,WAAWtB,MAAMuB,kBAAkB,CAACC,QAAQ;YAC5CC,OAAO;QACT;QACA;YACEJ,MAAM;YACNX,aACE,gEACA;YACFY,WAAWtB,MAAMuB,kBAAkB,CAACG,MAAM;YAC1CD,OAAO;QACT;KACD;AACH,EAAC;AAED,OAAO,MAAME,UAAgC;IAC3C;QACEpB,KAAKH,iBAAiBC;QACtBuB,MAAM5B,MAAM6B,QAAQ,CAACC,MAAM;QAC3BrB,aAAa;QACbK,MAAM;YAAEC,MAAMd,oBAAoBc,IAAI;QAAC;QACvCJ,UAAUX,MAAMY,iBAAiB,CAACC,YAAY;QAC9CkB,MAAM;YACJxB,KAAK;YACLyB,aAAa3B;YACbG,UAAUL;YACV8B,OAAO;gBACLC,SAAS;gBACTC,WAAW;YACb;QACF;IACF;CACD,CAAA;AAED,eAAejC,aAAY"}

package/src/lib/components/list-item.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @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 ListItemProps } from '@mui/material/ListItem';
+/**
+ * MUI's ListItem behind the cleared-prop guard (AGL-1451).
+ *
+ * Exported raw, so every one of its five authorable attributes reached MUI
+ * as authored — including `alignItems`, whose `''` option is not `undefined`
+ * (so the `alignItems = 'center'` destructuring default never fires) and is
+ * falsy (so the `alignItems === 'flex-start'` branch is skipped), leaving a
+ * row that carries neither utility class.
+ */
+declare const ListItem: import("react").ForwardRefExoticComponent<Omit<ListItemProps, "ref"> & import("react").RefAttributes<HTMLLIElement>>;
+export declare const ID: Aglyn.ComponentId;
+export declare const schema: Aglyn.ComponentSchema<ListItemProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default ListItem;

package/src/lib/components/list-item.js

@@ -0,0 +1,127 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { mdiFormatListText } from "@aglyn/shared-data-mdi";
+import MuiListItem from "@mui/material/ListItem";
+import { createElement, forwardRef } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { dropClearedProps } from "../utils/drop-cleared-props.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+import { presets as listItemTextPresets, schema as listItemTextSchema } from "./list-item-text.js";
+/**
+ * MUI's ListItem behind the cleared-prop guard (AGL-1451).
+ *
+ * Exported raw, so every one of its five authorable attributes reached MUI
+ * as authored — including `alignItems`, whose `''` option is not `undefined`
+ * (so the `alignItems = 'center'` destructuring default never fires) and is
+ * falsy (so the `alignItems === 'flex-start'` branch is skipped), leaving a
+ * row that carries neither utility class.
+ */ const ListItem = forwardRef((props, ref)=>createElement(MuiListItem, _extends({}, dropClearedProps(props), {
+        ref
+    })));
+ListItem.displayName = 'AglynListItem';
+// Component ids are persisted in screen documents; keep the legacy ids.
+export const ID = 'muiListItem';
+export const schema = {
+    $id: ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'List Item',
+    description: 'One row of a list.',
+    category: Aglyn.ComponentCategory.DATA_DISPLAY,
+    icon: {
+        path: mdiFormatListText.path
+    },
+    restrictChildren: [
+        Aglyn.LinealDirectiveFlag.LIMIT_TO,
+        {
+            components: [
+                listItemTextSchema.$id
+            ]
+        }
+    ],
+    // Like List, this had NO attributes: dividers, density and gutters are
+    // the first things anyone reaches for on a list row, and none of them
+    // were reachable from the inspector.
+    attributes: [
+        {
+            name: 'divider',
+            label: 'Divider?',
+            description: 'If true, a 1px line is drawn under the item.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'alignItems',
+            label: 'Align items',
+            description: 'Vertical alignment of the row content. Use flex-start when the ' + 'secondary text wraps to several lines.',
+            component: Aglyn.FieldComponentType.SELECT,
+            // `center` is MUI's own value and the one an author needs to move a
+            // row BACK off Top, so it stays in the list as a real sentinel
+            // rather than being deleted (AGL-1451). As `''` that move could not
+            // persist (AGL-1191).
+            options: [
+                {
+                    value: 'center',
+                    label: 'Center (default)'
+                },
+                {
+                    value: 'flex-start',
+                    label: 'Top'
+                }
+            ]
+        },
+        {
+            name: 'dense',
+            label: 'Dense?',
+            description: 'If true, this row is compacted vertically. The parent list’s ' + 'Dense setting already applies to every row.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'disableGutters',
+            label: 'Disable gutters?',
+            description: 'Removes this row’s side padding, so its text lines up with content ' + 'outside the list instead of being indented from it.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'disablePadding',
+            label: 'Disable padding?',
+            description: 'If true, all padding is removed.',
+            component: Aglyn.FieldComponentType.SWITCH
+        }
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'List Item',
+        icon: {
+            path: mdiFormatListText.path
+        },
+        category: Aglyn.ComponentCategory.DATA_DISPLAY,
+        data: {
+            $id: null,
+            componentId: ID,
+            pluginId: BUNDLE_ID,
+            nodes: [
+                _extends({}, listItemTextPresets[0].data)
+            ]
+        }
+    }
+];
+export default ListItem;
+
+//# sourceMappingURL=list-item.js.map

package/src/lib/components/list-item.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/list-item.ts"],"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 {\n  mdiFormatListText,\n} from '@aglyn/shared-data-mdi'\nimport MuiListItem, { type ListItemProps } from '@mui/material/ListItem'\nimport { createElement, forwardRef } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { dropClearedProps } from '../utils/drop-cleared-props'\nimport { generatePresetId } from '../utils/generate-preset-id'\nimport {\n  presets as listItemTextPresets,\n  schema as listItemTextSchema,\n} from './list-item-text'\n\n/**\n * MUI's ListItem behind the cleared-prop guard (AGL-1451).\n *\n * Exported raw, so every one of its five authorable attributes reached MUI\n * as authored — including `alignItems`, whose `''` option is not `undefined`\n * (so the `alignItems = 'center'` destructuring default never fires) and is\n * falsy (so the `alignItems === 'flex-start'` branch is skipped), leaving a\n * row that carries neither utility class.\n */\nconst ListItem = forwardRef<HTMLLIElement, ListItemProps>((props, ref) =>\n  createElement(MuiListItem, { ...dropClearedProps(props), ref }),\n)\nListItem.displayName = 'AglynListItem'\n\n// Component ids are persisted in screen documents; keep the legacy ids.\nexport const ID: Aglyn.ComponentId = 'muiListItem'\n\nexport const schema: Aglyn.ComponentSchema<ListItemProps> = {\n  $id: ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'List Item',\n  description: 'One row of a list.',\n  category: Aglyn.ComponentCategory.DATA_DISPLAY,\n  icon: { path: mdiFormatListText.path },\n  restrictChildren: [\n    Aglyn.LinealDirectiveFlag.LIMIT_TO,\n    {\n      components: [listItemTextSchema.$id],\n    },\n  ],\n  // Like List, this had NO attributes: dividers, density and gutters are\n  // the first things anyone reaches for on a list row, and none of them\n  // were reachable from the inspector.\n  attributes: [\n    {\n      name: 'divider',\n      label: 'Divider?',\n      description: 'If true, a 1px line is drawn under the item.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'alignItems',\n      label: 'Align items',\n      description:\n        'Vertical alignment of the row content. Use flex-start when the ' +\n        'secondary text wraps to several lines.',\n      component: Aglyn.FieldComponentType.SELECT,\n      // `center` is MUI's own value and the one an author needs to move a\n      // row BACK off Top, so it stays in the list as a real sentinel\n      // rather than being deleted (AGL-1451). As `''` that move could not\n      // persist (AGL-1191).\n      options: [\n        { value: 'center', label: 'Center (default)' },\n        { value: 'flex-start', label: 'Top' },\n      ],\n    },\n    {\n      name: 'dense',\n      label: 'Dense?',\n      description:\n        'If true, this row is compacted vertically. The parent list’s ' +\n        'Dense setting already applies to every row.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'disableGutters',\n      label: 'Disable gutters?',\n      description:\n        'Removes this row’s side padding, so its text lines up with content ' +\n        'outside the list instead of being indented from it.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'disablePadding',\n      label: 'Disable padding?',\n      description: 'If true, all padding is removed.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n  ],\n}\n\nexport const presets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'List Item',\n    icon: { path: mdiFormatListText.path },\n    category: Aglyn.ComponentCategory.DATA_DISPLAY,\n    data: {\n      $id: null,\n      componentId: ID,\n      pluginId: BUNDLE_ID,\n      nodes: [\n        {\n          ...listItemTextPresets[0].data,\n        },\n      ],\n    },\n  },\n]\n\nexport default ListItem\n"],"names":["Aglyn","mdiFormatListText","MuiListItem","createElement","forwardRef","BUNDLE_ID","dropClearedProps","generatePresetId","presets","listItemTextPresets","schema","listItemTextSchema","ListItem","props","ref","displayName","ID","$id","pluginId","description","category","ComponentCategory","DATA_DISPLAY","icon","path","restrictChildren","LinealDirectiveFlag","LIMIT_TO","components","attributes","name","label","component","FieldComponentType","SWITCH","SELECT","options","value","type","NodeType","PRESET","data","componentId","nodes"],"mappings":";AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SACEC,iBAAiB,QACZ,yBAAwB;AAC/B,OAAOC,iBAAyC,yBAAwB;AACxE,SAASC,aAAa,EAAEC,UAAU,QAAQ,QAAO;AACjD,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SAASC,gBAAgB,QAAQ,iCAA6B;AAC9D,SAASC,gBAAgB,QAAQ,iCAA6B;AAC9D,SACEC,WAAWC,mBAAmB,EAC9BC,UAAUC,kBAAkB,QACvB,sBAAkB;AAEzB;;;;;;;;CAQC,GACD,MAAMC,WAAWR,WAAyC,CAACS,OAAOC,MAChEX,cAAcD,aAAa,aAAKI,iBAAiBO;QAAQC;;AAE3DF,SAASG,WAAW,GAAG;AAEvB,wEAAwE;AACxE,OAAO,MAAMC,KAAwB,cAAa;AAElD,OAAO,MAAMN,SAA+C;IAC1DO,KAAKD;IACLE,UAAUb;IACVU,aAAa;IACbI,aAAa;IACbC,UAAUpB,MAAMqB,iBAAiB,CAACC,YAAY;IAC9CC,MAAM;QAAEC,MAAMvB,kBAAkBuB,IAAI;IAAC;IACrCC,kBAAkB;QAChBzB,MAAM0B,mBAAmB,CAACC,QAAQ;QAClC;YACEC,YAAY;gBAACjB,mBAAmBM,GAAG;aAAC;QACtC;KACD;IACD,uEAAuE;IACvE,sEAAsE;IACtE,qCAAqC;IACrCY,YAAY;QACV;YACEC,MAAM;YACNC,OAAO;YACPZ,aAAa;YACba,WAAWhC,MAAMiC,kBAAkB,CAACC,MAAM;QAC5C;QACA;YACEJ,MAAM;YACNC,OAAO;YACPZ,aACE,oEACA;YACFa,WAAWhC,MAAMiC,kBAAkB,CAACE,MAAM;YAC1C,oEAAoE;YACpE,+DAA+D;YAC/D,oEAAoE;YACpE,sBAAsB;YACtBC,SAAS;gBACP;oBAAEC,OAAO;oBAAUN,OAAO;gBAAmB;gBAC7C;oBAAEM,OAAO;oBAAcN,OAAO;gBAAM;aACrC;QACH;QACA;YACED,MAAM;YACNC,OAAO;YACPZ,aACE,kEACA;YACFa,WAAWhC,MAAMiC,kBAAkB,CAACC,MAAM;QAC5C;QACA;YACEJ,MAAM;YACNC,OAAO;YACPZ,aACE,wEACA;YACFa,WAAWhC,MAAMiC,kBAAkB,CAACC,MAAM;QAC5C;QACA;YACEJ,MAAM;YACNC,OAAO;YACPZ,aAAa;YACba,WAAWhC,MAAMiC,kBAAkB,CAACC,MAAM;QAC5C;KACD;AACH,EAAC;AAED,OAAO,MAAM1B,UAAgC;IAC3C;QACES,KAAKV,iBAAiBS;QACtBsB,MAAMtC,MAAMuC,QAAQ,CAACC,MAAM;QAC3BzB,aAAa;QACbQ,MAAM;YAAEC,MAAMvB,kBAAkBuB,IAAI;QAAC;QACrCJ,UAAUpB,MAAMqB,iBAAiB,CAACC,YAAY;QAC9CmB,MAAM;YACJxB,KAAK;YACLyB,aAAa1B;YACbE,UAAUb;YACVsC,OAAO;gBACL,aACKlC,mBAAmB,CAAC,EAAE,CAACgC,IAAI;aAEjC;QACH;IACF;CACD,CAAA;AAED,eAAe7B,SAAQ"}

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

@@ -0,0 +1,34 @@
+/**
+ * @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 ListProps } from '@mui/material/List';
+export declare const ID: Aglyn.ComponentId;
+export interface ListElementProps extends Omit<ListProps, 'subheader'> {
+    /** Sticky heading above the items; omitted entirely when blank. */
+    subheader?: string;
+}
+/**
+ * List (https://mui.com/material-ui/react-list/).
+ *
+ * Wraps MUI's List only to turn the authored `subheader` string into a
+ * real `ListSubheader`: MUI types the prop as a node, so a bare string
+ * renders as unstyled text outside the list's own heading treatment.
+ */
+declare const List: import("react").ForwardRefExoticComponent<Omit<ListElementProps, "ref"> & import("react").RefAttributes<HTMLUListElement>>;
+export declare const schema: Aglyn.ComponentSchema<ListElementProps>;
+export declare const presets: Aglyn.PresetSchema[];
+export default List;