@aglyn/plugins-mui 1.0.0-beta.143

package/src/lib/components/list.js

@@ -0,0 +1,108 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+/**
+ * @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 { mdiFormatListBulletedSquare } from "@aglyn/shared-data-mdi";
+import MuiList from "@mui/material/List";
+import ListSubheader from "@mui/material/ListSubheader";
+import { createElement, forwardRef } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+import { presets as listItemPresets, schema as listItemSchema } from "./list-item.js";
+// Component ids are persisted in screen documents; keep the legacy ids.
+export const ID = 'muiList';
+/**
+ * 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.
+ */ const List = forwardRef((props, ref)=>{
+    const { subheader } = props, rest = _object_without_properties_loose(props, [
+        "subheader"
+    ]);
+    return createElement(MuiList, _extends({
+        ref,
+        // ListSubheader defaults to `li`, which is what belongs inside the
+        // `ul` List renders.
+        subheader: subheader ? createElement(ListSubheader, null, subheader) : undefined
+    }, rest));
+});
+List.displayName = 'AglynList';
+export const schema = {
+    $id: ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'List',
+    description: 'Vertical list of items, optionally under a sticky heading.',
+    category: Aglyn.ComponentCategory.DATA_DISPLAY,
+    icon: {
+        path: mdiFormatListBulletedSquare.path
+    },
+    restrictChildren: [
+        Aglyn.LinealDirectiveFlag.LIMIT_TO,
+        {
+            components: [
+                listItemSchema.$id
+            ]
+        }
+    ],
+    // The list had NO attributes at all: density and padding were only
+    // reachable by hand-writing sx, which is not where authors look.
+    attributes: [
+        {
+            name: 'subheader',
+            label: 'Heading',
+            description: 'Sticky heading rendered above the items. Leave blank for none.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'dense',
+            label: 'Dense?',
+            description: 'If true, items are compacted vertically. Applies to every item ' + 'in the list.',
+            component: Aglyn.FieldComponentType.SWITCH
+        },
+        {
+            name: 'disablePadding',
+            label: 'Disable padding?',
+            description: 'If true, the padding above and below the list is removed.',
+            component: Aglyn.FieldComponentType.SWITCH
+        }
+    ]
+};
+export const presets = [
+    {
+        $id: generatePresetId(ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'List',
+        icon: {
+            path: mdiFormatListBulletedSquare.path
+        },
+        category: Aglyn.ComponentCategory.DATA_DISPLAY,
+        data: {
+            $id: null,
+            componentId: ID,
+            pluginId: BUNDLE_ID,
+            nodes: [
+                _extends({}, listItemPresets[0].data),
+                _extends({}, listItemPresets[0].data)
+            ]
+        }
+    }
+];
+export default List;
+
+//# sourceMappingURL=list.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/list.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  mdiFormatListBulletedSquare,\n} from '@aglyn/shared-data-mdi'\nimport MuiList, { type ListProps } from '@mui/material/List'\nimport ListSubheader from '@mui/material/ListSubheader'\nimport { createElement, forwardRef } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\nimport {\n  presets as listItemPresets,\n  schema as listItemSchema,\n} from './list-item'\n\n// Component ids are persisted in screen documents; keep the legacy ids.\nexport const ID: Aglyn.ComponentId = 'muiList'\n\nexport interface ListElementProps extends Omit<ListProps, 'subheader'> {\n  /** Sticky heading above the items; omitted entirely when blank. */\n  subheader?: string\n}\n\n/**\n * List (https://mui.com/material-ui/react-list/).\n *\n * Wraps MUI's List only to turn the authored `subheader` string into a\n * real `ListSubheader`: MUI types the prop as a node, so a bare string\n * renders as unstyled text outside the list's own heading treatment.\n */\nconst List = forwardRef<HTMLUListElement, ListElementProps>((props, ref) => {\n  const { subheader, ...rest } = props\n  return createElement(MuiList, {\n    ref,\n    // ListSubheader defaults to `li`, which is what belongs inside the\n    // `ul` List renders.\n    subheader: subheader\n      ? createElement(ListSubheader, null, subheader)\n      : undefined,\n    ...rest,\n  })\n})\nList.displayName = 'AglynList'\n\nexport const schema: Aglyn.ComponentSchema<ListElementProps> = {\n  $id: ID,\n  pluginId: BUNDLE_ID,\n  displayName: 'List',\n  description: 'Vertical list of items, optionally under a sticky heading.',\n  category: Aglyn.ComponentCategory.DATA_DISPLAY,\n  icon: { path: mdiFormatListBulletedSquare.path },\n  restrictChildren: [\n    Aglyn.LinealDirectiveFlag.LIMIT_TO,\n    {\n      components: [listItemSchema.$id],\n    },\n  ],\n  // The list had NO attributes at all: density and padding were only\n  // reachable by hand-writing sx, which is not where authors look.\n  attributes: [\n    {\n      name: 'subheader',\n      label: 'Heading',\n      description:\n        'Sticky heading rendered above the items. Leave blank for none.',\n      component: Aglyn.FieldComponentType.TEXT_FIELD,\n    },\n    {\n      name: 'dense',\n      label: 'Dense?',\n      description:\n        'If true, items are compacted vertically. Applies to every item ' +\n        'in the list.',\n      component: Aglyn.FieldComponentType.SWITCH,\n    },\n    {\n      name: 'disablePadding',\n      label: 'Disable padding?',\n      description: 'If true, the padding above and below the list 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',\n    icon: { path: mdiFormatListBulletedSquare.path },\n    category: Aglyn.ComponentCategory.DATA_DISPLAY,\n    data: {\n      $id: null,\n      componentId: ID,\n      pluginId: BUNDLE_ID,\n      nodes: [\n        {\n          ...listItemPresets[0].data,\n        },\n        {\n          ...listItemPresets[0].data,\n        },\n      ],\n    },\n  },\n]\n\nexport default List\n"],"names":["Aglyn","mdiFormatListBulletedSquare","MuiList","ListSubheader","createElement","forwardRef","BUNDLE_ID","generatePresetId","presets","listItemPresets","schema","listItemSchema","ID","List","props","ref","subheader","rest","undefined","displayName","$id","pluginId","description","category","ComponentCategory","DATA_DISPLAY","icon","path","restrictChildren","LinealDirectiveFlag","LIMIT_TO","components","attributes","name","label","component","FieldComponentType","TEXT_FIELD","SWITCH","type","NodeType","PRESET","data","componentId","nodes"],"mappings":";;AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SACEC,2BAA2B,QACtB,yBAAwB;AAC/B,OAAOC,aAAiC,qBAAoB;AAC5D,OAAOC,mBAAmB,8BAA6B;AACvD,SAASC,aAAa,EAAEC,UAAU,QAAQ,QAAO;AACjD,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SAASC,gBAAgB,QAAQ,iCAA6B;AAC9D,SACEC,WAAWC,eAAe,EAC1BC,UAAUC,cAAc,QACnB,iBAAa;AAEpB,wEAAwE;AACxE,OAAO,MAAMC,KAAwB,UAAS;AAO9C;;;;;;CAMC,GACD,MAAMC,OAAOR,WAA+C,CAACS,OAAOC;IAClE,MAAM,EAAEC,SAAS,EAAW,GAAGF,OAATG,wCAASH;;;IAC/B,OAAOV,cAAcF,SAAS;QAC5Ba;QACA,mEAAmE;QACnE,qBAAqB;QACrBC,WAAWA,YACPZ,cAAcD,eAAe,MAAMa,aACnCE;OACDD;AAEP;AACAJ,KAAKM,WAAW,GAAG;AAEnB,OAAO,MAAMT,SAAkD;IAC7DU,KAAKR;IACLS,UAAUf;IACVa,aAAa;IACbG,aAAa;IACbC,UAAUvB,MAAMwB,iBAAiB,CAACC,YAAY;IAC9CC,MAAM;QAAEC,MAAM1B,4BAA4B0B,IAAI;IAAC;IAC/CC,kBAAkB;QAChB5B,MAAM6B,mBAAmB,CAACC,QAAQ;QAClC;YACEC,YAAY;gBAACpB,eAAeS,GAAG;aAAC;QAClC;KACD;IACD,mEAAmE;IACnE,iEAAiE;IACjEY,YAAY;QACV;YACEC,MAAM;YACNC,OAAO;YACPZ,aACE;YACFa,WAAWnC,MAAMoC,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEJ,MAAM;YACNC,OAAO;YACPZ,aACE,oEACA;YACFa,WAAWnC,MAAMoC,kBAAkB,CAACE,MAAM;QAC5C;QACA;YACEL,MAAM;YACNC,OAAO;YACPZ,aAAa;YACba,WAAWnC,MAAMoC,kBAAkB,CAACE,MAAM;QAC5C;KACD;AACH,EAAC;AAED,OAAO,MAAM9B,UAAgC;IAC3C;QACEY,KAAKb,iBAAiBK;QACtB2B,MAAMvC,MAAMwC,QAAQ,CAACC,MAAM;QAC3BtB,aAAa;QACbO,MAAM;YAAEC,MAAM1B,4BAA4B0B,IAAI;QAAC;QAC/CJ,UAAUvB,MAAMwB,iBAAiB,CAACC,YAAY;QAC9CiB,MAAM;YACJtB,KAAK;YACLuB,aAAa/B;YACbS,UAAUf;YACVsC,OAAO;gBACL,aACKnC,eAAe,CAAC,EAAE,CAACiC,IAAI;gBAE5B,aACKjC,eAAe,CAAC,EAAE,CAACiC,IAAI;aAE7B;QACH;IACF;CACD,CAAA;AAED,eAAe7B,KAAI"}

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

@@ -0,0 +1,129 @@
+/**
+ * @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 BoxProps } from '@mui/material/Box';
+export declare const MARKDOWN_ID: Aglyn.ComponentId;
+export declare const TABLE_OF_CONTENTS_ID: Aglyn.ComponentId;
+export interface MarkdownProps extends BoxProps {
+    /** The document, as markdown-lite source. */
+    content?: string;
+    /**
+     * The pixel pair of each library image this document names, keyed by the
+     * target as the document writes it, stamped by the composition from the
+     * assets' DAM records (AGL-3149) — never set by hand.
+     *
+     * An image with no entry here renders exactly as it did before this prop
+     * existed: see `mediaBodyImageAttributes` for why a partial answer is worse
+     * than none.
+     */
+    intrinsicSizes?: Record<string, {
+        width: number;
+        height: number;
+    }>;
+}
+/**
+ * A whole document authored as markdown (AGL-1162).
+ *
+ * The elements that made a legal or policy page before this were hundreds of
+ * Typography nodes, one per paragraph — which meant the page could not be
+ * pasted from, or back into, the markdown file in Drive that is its actual
+ * source. Here the source IS the element's content, so updating the page is
+ * one paste.
+ *
+ * Rendered through the shared markdown-lite parser, which emits plain data
+ * blocks and never an HTML string — so there is no `dangerouslySetInnerHTML`
+ * anywhere on this path and nothing to sanitize. Parsing is pure, so the full
+ * document server-renders and the text is in the crawled HTML.
+ *
+ * Child NODES are never rendered, in either branch (AGL-1388). The document
+ * is the `content` prop; there is no position in a parsed block list that a
+ * dropped element could occupy, so the schema turns dropping off and
+ * `nodeAcceptsChildren` now honors that — a drop lands as a sibling instead.
+ * `children` is destructured away rather than left in `rest` because the
+ * empty-content branch spreads `rest` onto a childless Box: without this, a
+ * Markdown element rendered exactly the child nodes it had swallowed a
+ * moment earlier as soon as its content was cleared.
+ */
+declare const Markdown: import("react").ForwardRefExoticComponent<Omit<MarkdownProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export interface TableOfContentsProps extends BoxProps {
+    /**
+     * The Markdown element this lists the headings of. Empty means "the first
+     * Markdown element on the screen", which is the answer on every page that
+     * has exactly one — see {@link resolveMarkdownSource}.
+     */
+    forNodeId?: string;
+    /** Aside heading; an empty string renders no heading at all. */
+    heading?: string;
+    /** Deepest heading level listed: `'2'` for top level only. */
+    depth?: '2' | '3';
+}
+/**
+ * Which Markdown element a table of contents speaks for (AGL-1162).
+ *
+ * Resolved through the NODE TREE, never the DOM: the besigner canvas renders
+ * inside a closed shadow root, so a `document.querySelector` from a component
+ * finds nothing there and the aside would be empty in the one place it is
+ * being authored.
+ *
+ * The tree is walked from the root in document order, so "the first Markdown
+ * element" means the first one a reader meets — not the first key of a node
+ * map, whose order is storage detail.
+ *
+ * An explicit `forNodeId` wins, compared with `leafIdsMatch` because the
+ * stored id is the raw canvas id while a composed tree namespaces layout and
+ * reusable-component grafts (AGL-573/1229). A pick that no longer resolves —
+ * the element was deleted and re-added, which is exactly what re-pasting a
+ * document looks like — falls back to the first Markdown element rather than
+ * leaving a published page with an empty aside.
+ */
+export declare function resolveMarkdownSource(root: Aglyn.NodeSchema | undefined, forNodeId?: string): string;
+/**
+ * Scrolls to a heading in the cases the browser cannot reach, and ONLY those
+ * (AGL-1162). Returns whether it handled the click.
+ *
+ * In `document` it deliberately does nothing and lets the plain `#slug`
+ * anchor work: native fragment navigation updates the address bar, adds a
+ * history entry the back button understands, and honours the site's CSS
+ * `scroll-behavior` — none of which a hand-rolled `scrollIntoView` gives
+ * back. It is also the only version that works with JavaScript off.
+ *
+ * (`behavior: 'smooth'` was the first attempt at the whole job, and it is
+ * exactly the wrong shape: a browser that declines to animate — a background
+ * tab, reduced-motion — leaves the click prevented and the page unmoved, so
+ * a working link reads as a broken one.)
+ *
+ * The besigner canvas renders inside a CLOSED shadow root, where the heading
+ * is not in `document` at all and a fragment navigation finds nothing. There
+ * the link's own `getRootNode()` is the shadow root holding both ends, and
+ * `ShadowRoot.getElementById` finds the heading.
+ */
+export declare function scrollToHeading(anchor: Element, slug: string): boolean;
+/**
+ * "On this page" (AGL-1162) — the headings of a Markdown element on the same
+ * screen, as working anchor links.
+ *
+ * A mobx `observer` because it reads ANOTHER node's props: the renderer's
+ * Leaf re-renders on changes to the node it is rendering, and nothing else,
+ * so without this the aside in the besigner would keep listing the headings
+ * of the document as it was when the aside mounted.
+ */
+declare const TableOfContents: import("react").FunctionComponent<Omit<TableOfContentsProps, "ref"> & import("react").RefAttributes<HTMLElement>>;
+export declare const markdownSchema: Aglyn.ComponentSchema<MarkdownProps>;
+export declare const tableOfContentsSchema: Aglyn.ComponentSchema<TableOfContentsProps>;
+export declare const markdownPresets: Aglyn.PresetSchema[];
+export { Markdown, TableOfContents };
+export default Markdown;