@aglyn/plugins-mui 1.0.0-beta.214 → 1.0.0-beta.216

package/src/lib/components/collection-entry-body.js

@@ -0,0 +1,328 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx, jsxs as _jsxs } 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 { mdiTextLong } from "@aglyn/shared-data-mdi";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import Box from "@mui/material/Box";
+import MuiLink from "@mui/material/Link";
+import Typography from "@mui/material/Typography";
+import { forwardRef, useContext, useMemo } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { UNRESOLVED_TOKEN } from "./collection-common.js";
+// Persisted component id (AGL-551/582); the compose pipeline references it
+// through the @aglyn/aglyn constant. Never rename.
+export const ENTRY_BODY_ID = Aglyn.COLLECTION_ENTRY_BODY_COMPONENT_ID;
+const renderInlines = (inlines, links)=>inlines.map((item, index)=>{
+        if (item.type === 'bold') return /*#__PURE__*/ _jsx("strong", {
+            children: item.text
+        }, index);
+        if (item.type === 'italic') return /*#__PURE__*/ _jsx("em", {
+            children: item.text
+        }, index);
+        if (item.type !== 'link') return /*#__PURE__*/ _jsx("span", {
+            children: item.text
+        }, index);
+        // Internal paths route through AppLink for client-side navigation
+        // (AGL-582); external links stay plain anchors. Editing surfaces render
+        // the link look without an href so clicks never navigate. A target named
+        // by REFERENCE resolves against the routing map first (AGL-3118), and one
+        // whose entry, listing or screen is gone renders as the words alone —
+        // never as an anchor holding the stored value.
+        const link = Aglyn.resolveMarkdownLink(item.href, links);
+        if (link.kind === 'text') return /*#__PURE__*/ _jsx("span", {
+            children: item.text
+        }, index);
+        if (link.kind === 'inert') {
+            return /*#__PURE__*/ _jsx(MuiLink, {
+                component: "span",
+                sx: {
+                    cursor: 'default'
+                },
+                children: item.text
+            }, index);
+        }
+        return link.kind === 'internal' ? /*#__PURE__*/ _jsx(AppLink, {
+            href: link.href,
+            children: item.text
+        }, index) : /*#__PURE__*/ _jsx(MuiLink, {
+            href: link.href,
+            children: item.text
+        }, index);
+    });
+/**
+ * Renders a content entry's markdown-lite body as themed MUI elements
+ * (AGL-551): headings, paragraphs, lists, and images pick up the site
+ * theme's typography instead of the old unthemed article HTML. Parsing is
+ * pure, so the full body server-renders (SEO keeps the article text).
+ */ const CollectionEntryBody = /*#__PURE__*/ forwardRef((props, ref)=>{
+    // `intrinsicSizes` is destructured out rather than left in `rest`: `rest` is
+    // spread onto a Box, and a composition-stamped object would reach the DOM as
+    // an attribute React has no idea what to do with.
+    const { markdown, intrinsicSizes } = props, rest = _object_without_properties_loose(props, [
+        "markdown",
+        "intrinsicSizes"
+    ]);
+    // Node styles ride the renderer-merged sx; recompose (stack.ts pattern).
+    const nodeSx = Array.isArray(props['sx']) ? props['sx'] : [
+        props['sx']
+    ];
+    // The routing map travels with the suppression flag: both decide what a
+    // link in this body renders as (AGL-3118).
+    const { suppressNavigation, screens } = useContext(Aglyn.ScreenLinkContext);
+    const links = useMemo(()=>({
+            suppressNavigation,
+            screens
+        }), [
+        suppressNavigation,
+        screens
+    ]);
+    // The site being rendered, for image blocks (AGL-1686) — read once here
+    // because hooks cannot run inside the block map below.
+    const { hostId } = Aglyn.useSite();
+    const source = (markdown != null ? markdown : '').trim();
+    const unresolved = !source || UNRESOLVED_TOKEN.test(source);
+    const blocks = useMemo(()=>unresolved ? [] : Aglyn.parseMarkdownLite(source), [
+        source,
+        unresolved
+    ]);
+    // Heading anchors, on the same terms as the Markdown element (AGL-1162).
+    // Without them a blog article could not carry an "On this page" aside at
+    // all: the Table of Contents element emits `#slug` links, and there was
+    // nothing on this page for them to land on.
+    const slugs = useMemo(()=>Aglyn.markdownHeadingSlugs(blocks), [
+        blocks
+    ]);
+    if (unresolved) {
+        // Editing surfaces get an affordance; the published site renders
+        // nothing rather than a literal token.
+        if (!suppressNavigation) return /*#__PURE__*/ _jsx(Box, _extends({
+            ref: ref
+        }, rest));
+        return /*#__PURE__*/ _jsx(Box, _extends({
+            ref: ref
+        }, rest, {
+            sx: [
+                {
+                    p: 2,
+                    border: '1px dashed',
+                    borderColor: 'divider',
+                    color: 'text.secondary',
+                    fontSize: 12,
+                    fontFamily: 'system-ui, sans-serif'
+                },
+                ...nodeSx
+            ],
+            children: 'Entry body — the {{entry.body}} markdown renders here'
+        }));
+    }
+    return /*#__PURE__*/ _jsx(Box, _extends({
+        ref: ref
+    }, rest, {
+        children: blocks.map((block, index)=>{
+            if (block.type === 'heading') {
+                return /*#__PURE__*/ _jsx(Typography, {
+                    id: slugs[index],
+                    variant: block.level === 2 ? 'h4' : 'h5',
+                    component: block.level === 2 ? 'h2' : 'h3',
+                    gutterBottom: true,
+                    sx: {
+                        scrollMarginTop: `${Aglyn.HEADING_ANCHOR_SCROLL_MARGIN}px`
+                    },
+                    children: renderInlines(block.inlines, links)
+                }, index);
+            }
+            if (block.type === 'image') {
+                return /*#__PURE__*/ _jsx(Box, _extends({
+                    component: "img"
+                }, Aglyn.mediaBodyImageAttributes({
+                    src: block.src,
+                    hostId,
+                    size: intrinsicSizes == null ? void 0 : intrinsicSizes[block.src]
+                }), {
+                    alt: block.alt,
+                    // Paired with the `width`/`height` above — see the Markdown
+                    // element's copy of this: without it the height hint outlives
+                    // the `maxWidth` cap and squashes the picture.
+                    sx: {
+                        maxWidth: '100%',
+                        height: 'auto',
+                        borderRadius: 1,
+                        my: 1
+                    }
+                }, Aglyn.DEFERRED_IMAGE_ATTRIBUTES), index);
+            }
+            if (block.type === 'list') {
+                return /*#__PURE__*/ _jsx(Box, {
+                    component: "ul",
+                    sx: {
+                        lineHeight: 1.7,
+                        pl: 3
+                    },
+                    children: block.items.map((item, itemIndex)=>/*#__PURE__*/ _jsx("li", {
+                            children: renderInlines(item, links)
+                        }, itemIndex))
+                }, index);
+            }
+            // A numbered list (AGL-1320) — a real `<ol>`, so the markers are the
+            // browser's and `start` survives: a notice that resumes at 7 has to
+            // read as 7 for the enumeration to mean anything.
+            if (block.type === 'orderedList') {
+                return /*#__PURE__*/ _jsx(Box, {
+                    component: "ol",
+                    start: block.start,
+                    sx: {
+                        lineHeight: 1.7,
+                        pl: 3
+                    },
+                    children: block.items.map((item, itemIndex)=>/*#__PURE__*/ _jsx("li", {
+                            children: renderInlines(item, links)
+                        }, itemIndex))
+                }, index);
+            }
+            // Code blocks and tables (AGL-974). Both scroll rather than wrap:
+            // a wrapped code line or a squeezed table column loses the very
+            // structure that made the block worth writing.
+            if (block.type === 'code') {
+                return /*#__PURE__*/ _jsx(Box, {
+                    component: "pre",
+                    sx: {
+                        my: 2,
+                        p: 2,
+                        overflowX: 'auto',
+                        borderRadius: 1,
+                        bgcolor: 'action.hover',
+                        fontFamily: 'monospace',
+                        fontSize: 14
+                    },
+                    children: /*#__PURE__*/ _jsx("code", {
+                        children: block.text
+                    })
+                }, index);
+            }
+            if (block.type === 'table') {
+                return /*#__PURE__*/ _jsx(Box, {
+                    sx: {
+                        my: 2,
+                        overflowX: 'auto'
+                    },
+                    children: /*#__PURE__*/ _jsxs(Box, {
+                        component: "table",
+                        sx: {
+                            borderCollapse: 'collapse',
+                            width: '100%',
+                            '& th, & td': {
+                                border: '1px solid',
+                                borderColor: 'divider',
+                                px: 1.5,
+                                py: 1
+                            },
+                            '& th': {
+                                bgcolor: 'action.hover'
+                            }
+                        },
+                        children: [
+                            /*#__PURE__*/ _jsx("thead", {
+                                children: /*#__PURE__*/ _jsx("tr", {
+                                    children: block.header.map((cell, cellIndex)=>{
+                                        var _block_align_cellIndex;
+                                        return /*#__PURE__*/ _jsx("th", {
+                                            style: {
+                                                textAlign: (_block_align_cellIndex = block.align[cellIndex]) != null ? _block_align_cellIndex : 'left'
+                                            },
+                                            children: renderInlines(cell, links)
+                                        }, cellIndex);
+                                    })
+                                })
+                            }),
+                            /*#__PURE__*/ _jsx("tbody", {
+                                children: block.rows.map((row, rowIndex)=>/*#__PURE__*/ _jsx("tr", {
+                                        children: row.map((cell, cellIndex)=>{
+                                            var _block_align_cellIndex;
+                                            return /*#__PURE__*/ _jsx("td", {
+                                                style: {
+                                                    textAlign: (_block_align_cellIndex = block.align[cellIndex]) != null ? _block_align_cellIndex : 'left'
+                                                },
+                                                children: renderInlines(cell, links)
+                                            }, cellIndex);
+                                        })
+                                    }, rowIndex))
+                            })
+                        ]
+                    })
+                }, index);
+            }
+            // The article template's pull-quote (AGL-1315, Figma 170:225):
+            // larger italic prose behind a left accent. Palette tokens only, so
+            // it follows the site theme in both modes.
+            if (block.type === 'quote') {
+                return /*#__PURE__*/ _jsx(Typography, {
+                    component: "blockquote",
+                    sx: {
+                        my: 3,
+                        mx: 0,
+                        pl: 2.5,
+                        borderLeft: '3px solid',
+                        borderColor: 'primary.main',
+                        fontStyle: 'italic',
+                        fontSize: '1.25em',
+                        lineHeight: 1.6,
+                        color: 'text.primary'
+                    },
+                    children: renderInlines(block.inlines, links)
+                }, index);
+            }
+            return /*#__PURE__*/ _jsx(Typography, {
+                variant: "body1",
+                sx: {
+                    lineHeight: 1.7
+                },
+                gutterBottom: true,
+                children: renderInlines(block.inlines, links)
+            }, index);
+        })
+    }));
+});
+CollectionEntryBody.displayName = 'AglynCollectionEntryBody';
+export const collectionEntryBodySchema = {
+    $id: ENTRY_BODY_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Entry Body',
+    description: "The current entry's markdown body, on an entry template.",
+    category: Aglyn.ComponentCategory.TEXT,
+    icon: {
+        path: mdiTextLong.path,
+        sx: {
+            color: 'secondary.main'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'markdown',
+            label: 'Markdown',
+            description: 'Markdown-lite content. Keep {{entry.body}} on entry-template ' + "screens so each entry's body renders here.",
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        }
+    ]
+};
+export { CollectionEntryBody };
+
+//# sourceMappingURL=collection-entry-body.js.map

package/src/lib/components/collection-entry-body.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-entry-body.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 { mdiTextLong } from '@aglyn/shared-data-mdi'\nimport { AppLink } from '@aglyn/shared-ui-jsx'\nimport Box from '@mui/material/Box'\nimport MuiLink from '@mui/material/Link'\nimport Typography from '@mui/material/Typography'\nimport type { ReactNode } from 'react'\nimport { forwardRef, useContext, useMemo } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { UNRESOLVED_TOKEN } from './collection-common'\n\n// Persisted component id (AGL-551/582); the compose pipeline references it\n// through the @aglyn/aglyn constant. Never rename.\nexport const ENTRY_BODY_ID: Aglyn.ComponentId =\n  Aglyn.COLLECTION_ENTRY_BODY_COMPONENT_ID\n\nexport interface CollectionEntryBodyProps {\n  /**\n   * Markdown-lite source. On entry-template screens `{{entry.body}}`\n   * resolves to the rendered entry's body at compose time.\n   */\n  markdown?: string\n  /**\n   * The pixel pair of each library image this body names, keyed by the target\n   * as the body writes it, stamped by the composition from the assets' DAM\n   * records (AGL-3149) — never set by hand, and never on the template, where\n   * `markdown` is still the `{{entry.body}}` token and names no asset.\n   */\n  intrinsicSizes?: Record<string, { width: number; height: number }>\n}\n\nconst renderInlines = (\n  inlines: Aglyn.MarkdownInline[],\n  links: { suppressNavigation?: boolean; screens?: Aglyn.ScreenRouteMap },\n): ReactNode[] =>\n  inlines.map((item, index) => {\n    if (item.type === 'bold') return <strong key={index}>{item.text}</strong>\n    if (item.type === 'italic') return <em key={index}>{item.text}</em>\n    if (item.type !== 'link') return <span key={index}>{item.text}</span>\n    // Internal paths route through AppLink for client-side navigation\n    // (AGL-582); external links stay plain anchors. Editing surfaces render\n    // the link look without an href so clicks never navigate. A target named\n    // by REFERENCE resolves against the routing map first (AGL-3118), and one\n    // whose entry, listing or screen is gone renders as the words alone —\n    // never as an anchor holding the stored value.\n    const link = Aglyn.resolveMarkdownLink(item.href, links)\n    if (link.kind === 'text') return <span key={index}>{item.text}</span>\n    if (link.kind === 'inert') {\n      return (\n        <MuiLink key={index} component=\"span\" sx={{ cursor: 'default' }}>\n          {item.text}\n        </MuiLink>\n      )\n    }\n    return link.kind === 'internal' ? (\n      <AppLink key={index} href={link.href}>\n        {item.text}\n      </AppLink>\n    ) : (\n      <MuiLink key={index} href={link.href}>\n        {item.text}\n      </MuiLink>\n    )\n  })\n\n/**\n * Renders a content entry's markdown-lite body as themed MUI elements\n * (AGL-551): headings, paragraphs, lists, and images pick up the site\n * theme's typography instead of the old unthemed article HTML. Parsing is\n * pure, so the full body server-renders (SEO keeps the article text).\n */\nconst CollectionEntryBody = forwardRef<\n  HTMLDivElement,\n  CollectionEntryBodyProps\n>((props, ref) => {\n  // `intrinsicSizes` is destructured out rather than left in `rest`: `rest` is\n  // spread onto a Box, and a composition-stamped object would reach the DOM as\n  // an attribute React has no idea what to do with.\n  const { markdown, intrinsicSizes, ...rest } = props\n  // Node styles ride the renderer-merged sx; recompose (stack.ts pattern).\n  const nodeSx = Array.isArray(props['sx']) ? props['sx'] : [props['sx']]\n  // The routing map travels with the suppression flag: both decide what a\n  // link in this body renders as (AGL-3118).\n  const { suppressNavigation, screens } = useContext(Aglyn.ScreenLinkContext)\n  const links = useMemo(\n    () => ({ suppressNavigation, screens }),\n    [suppressNavigation, screens],\n  )\n  // The site being rendered, for image blocks (AGL-1686) — read once here\n  // because hooks cannot run inside the block map below.\n  const { hostId } = Aglyn.useSite()\n  const source = (markdown ?? '').trim()\n  const unresolved = !source || UNRESOLVED_TOKEN.test(source)\n  const blocks = useMemo(\n    () => (unresolved ? [] : Aglyn.parseMarkdownLite(source)),\n    [source, unresolved],\n  )\n  // Heading anchors, on the same terms as the Markdown element (AGL-1162).\n  // Without them a blog article could not carry an \"On this page\" aside at\n  // all: the Table of Contents element emits `#slug` links, and there was\n  // nothing on this page for them to land on.\n  const slugs = useMemo(() => Aglyn.markdownHeadingSlugs(blocks), [blocks])\n  if (unresolved) {\n    // Editing surfaces get an affordance; the published site renders\n    // nothing rather than a literal token.\n    if (!suppressNavigation) return <Box ref={ref} {...rest} />\n    return (\n      <Box\n        ref={ref}\n        {...rest}\n        sx={[\n          {\n            p: 2,\n            border: '1px dashed',\n            borderColor: 'divider',\n            color: 'text.secondary',\n            fontSize: 12,\n            fontFamily: 'system-ui, sans-serif',\n          },\n          ...nodeSx,\n        ]}\n      >\n        {'Entry body — the {{entry.body}} markdown renders here'}\n      </Box>\n    )\n  }\n  return (\n    <Box ref={ref} {...rest}>\n      {blocks.map((block, index) => {\n        if (block.type === 'heading') {\n          return (\n            <Typography\n              key={index}\n              id={slugs[index]}\n              variant={block.level === 2 ? 'h4' : 'h5'}\n              component={block.level === 2 ? 'h2' : 'h3'}\n              gutterBottom\n              sx={{\n                scrollMarginTop: `${Aglyn.HEADING_ANCHOR_SCROLL_MARGIN}px`,\n              }}\n            >\n              {renderInlines(block.inlines, links)}\n            </Typography>\n          )\n        }\n        if (block.type === 'image') {\n          return (\n            <Box\n              key={index}\n              component=\"img\"\n              // Resolved like the related cover image in collection-related.tsx\n              // (AGL-1686): a body image is the same kind of asset and\n              // has no reason to be stored in a more fragile form.\n              //\n              // And sized like one too, as of AGL-3149: the same call gives\n              // the Markdown element's body images their candidate list and\n              // intrinsic pair, so the two bodies cannot disagree about how a\n              // picture in prose is delivered.\n              {...Aglyn.mediaBodyImageAttributes({\n                src: block.src,\n                hostId,\n                size: intrinsicSizes?.[block.src],\n              })}\n              alt={block.alt}\n              // Paired with the `width`/`height` above — see the Markdown\n              // element's copy of this: without it the height hint outlives\n              // the `maxWidth` cap and squashes the picture.\n              sx={{ maxWidth: '100%', height: 'auto', borderRadius: 1, my: 1 }}\n              // An image inside an entry body is below the fold by\n              // construction — the title, byline and opening paragraphs are\n              // above it. This one carried no loading hint at all, so it was\n              // fetched EAGERLY, at default priority, competing with the\n              // entry's own cover (AGL-2486).\n              {...Aglyn.DEFERRED_IMAGE_ATTRIBUTES}\n            />\n          )\n        }\n        if (block.type === 'list') {\n          return (\n            <Box key={index} component=\"ul\" sx={{ lineHeight: 1.7, pl: 3 }}>\n              {block.items.map((item, itemIndex) => (\n                <li key={itemIndex}>\n                  {renderInlines(item, links)}\n                </li>\n              ))}\n            </Box>\n          )\n        }\n        // A numbered list (AGL-1320) — a real `<ol>`, so the markers are the\n        // browser's and `start` survives: a notice that resumes at 7 has to\n        // read as 7 for the enumeration to mean anything.\n        if (block.type === 'orderedList') {\n          return (\n            <Box\n              key={index}\n              component=\"ol\"\n              start={block.start}\n              sx={{ lineHeight: 1.7, pl: 3 }}\n            >\n              {block.items.map((item, itemIndex) => (\n                <li key={itemIndex}>\n                  {renderInlines(item, links)}\n                </li>\n              ))}\n            </Box>\n          )\n        }\n        // Code blocks and tables (AGL-974). Both scroll rather than wrap:\n        // a wrapped code line or a squeezed table column loses the very\n        // structure that made the block worth writing.\n        if (block.type === 'code') {\n          return (\n            <Box\n              key={index}\n              component=\"pre\"\n              sx={{\n                my: 2,\n                p: 2,\n                overflowX: 'auto',\n                borderRadius: 1,\n                bgcolor: 'action.hover',\n                fontFamily: 'monospace',\n                fontSize: 14,\n              }}\n            >\n              <code>{block.text}</code>\n            </Box>\n          )\n        }\n        if (block.type === 'table') {\n          return (\n            <Box key={index} sx={{ my: 2, overflowX: 'auto' }}>\n              <Box\n                component=\"table\"\n                sx={{\n                  borderCollapse: 'collapse',\n                  width: '100%',\n                  '& th, & td': {\n                    border: '1px solid',\n                    borderColor: 'divider',\n                    px: 1.5,\n                    py: 1,\n                  },\n                  '& th': { bgcolor: 'action.hover' },\n                }}\n              >\n                <thead>\n                  <tr>\n                    {block.header.map((cell, cellIndex) => (\n                      <th\n                        key={cellIndex}\n                        style={{ textAlign: block.align[cellIndex] ?? 'left' }}\n                      >\n                        {renderInlines(cell, links)}\n                      </th>\n                    ))}\n                  </tr>\n                </thead>\n                <tbody>\n                  {block.rows.map((row, rowIndex) => (\n                    <tr key={rowIndex}>\n                      {row.map((cell, cellIndex) => (\n                        <td\n                          key={cellIndex}\n                          style={{\n                            textAlign: block.align[cellIndex] ?? 'left',\n                          }}\n                        >\n                          {renderInlines(cell, links)}\n                        </td>\n                      ))}\n                    </tr>\n                  ))}\n                </tbody>\n              </Box>\n            </Box>\n          )\n        }\n        // The article template's pull-quote (AGL-1315, Figma 170:225):\n        // larger italic prose behind a left accent. Palette tokens only, so\n        // it follows the site theme in both modes.\n        if (block.type === 'quote') {\n          return (\n            <Typography\n              key={index}\n              component=\"blockquote\"\n              sx={{\n                my: 3,\n                mx: 0,\n                pl: 2.5,\n                borderLeft: '3px solid',\n                borderColor: 'primary.main',\n                fontStyle: 'italic',\n                fontSize: '1.25em',\n                lineHeight: 1.6,\n                color: 'text.primary',\n              }}\n            >\n              {renderInlines(block.inlines, links)}\n            </Typography>\n          )\n        }\n        return (\n          <Typography\n            key={index}\n            variant=\"body1\"\n            sx={{ lineHeight: 1.7 }}\n            gutterBottom\n          >\n            {renderInlines(block.inlines, links)}\n          </Typography>\n        )\n      })}\n    </Box>\n  )\n})\nCollectionEntryBody.displayName = 'AglynCollectionEntryBody'\n\nexport const collectionEntryBodySchema: Aglyn.ComponentSchema<CollectionEntryBodyProps> =\n  {\n    $id: ENTRY_BODY_ID,\n    pluginId: BUNDLE_ID,\n    displayName: 'Entry Body',\n    description: \"The current entry's markdown body, on an entry template.\",\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: { path: mdiTextLong.path, sx: { color: 'secondary.main' } },\n    flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n    attributes: [\n      {\n        name: 'markdown',\n        label: 'Markdown',\n        description:\n          'Markdown-lite content. Keep {{entry.body}} on entry-template ' +\n          \"screens so each entry's body renders here.\",\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n    ],\n  }\n\nexport { CollectionEntryBody }\n"],"names":["Aglyn","mdiTextLong","AppLink","Box","MuiLink","Typography","forwardRef","useContext","useMemo","BUNDLE_ID","UNRESOLVED_TOKEN","ENTRY_BODY_ID","COLLECTION_ENTRY_BODY_COMPONENT_ID","renderInlines","inlines","links","map","item","index","type","strong","text","em","span","link","resolveMarkdownLink","href","kind","component","sx","cursor","CollectionEntryBody","props","ref","markdown","intrinsicSizes","rest","nodeSx","Array","isArray","suppressNavigation","screens","ScreenLinkContext","hostId","useSite","source","trim","unresolved","test","blocks","parseMarkdownLite","slugs","markdownHeadingSlugs","p","border","borderColor","color","fontSize","fontFamily","block","id","variant","level","gutterBottom","scrollMarginTop","HEADING_ANCHOR_SCROLL_MARGIN","mediaBodyImageAttributes","src","size","alt","maxWidth","height","borderRadius","my","DEFERRED_IMAGE_ATTRIBUTES","lineHeight","pl","items","itemIndex","li","start","overflowX","bgcolor","code","borderCollapse","width","px","py","thead","tr","header","cell","cellIndex","th","style","textAlign","align","tbody","rows","row","rowIndex","td","mx","borderLeft","fontStyle","displayName","collectionEntryBodySchema","$id","pluginId","description","category","ComponentCategory","TEXT","icon","path","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","label","FieldComponentType","TEXT_FIELD"],"mappings":"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"}

package/src/lib/components/collection-entry-meta.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @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 StackProps } from '@mui/material/Stack';
+export declare const ENTRY_META_ID: Aglyn.ComponentId;
+export interface CollectionEntryMetaProps extends StackProps {
+    /**
+     * Published date. Server-filled from the routed entry on entry templates
+     * (`expandCollectionEntryMeta`, AGL-1385); set it — or bind
+     * `{{entry.date}}` — only to override.
+     */
+    date?: string;
+    /**
+     * How {@link date} reads when the server fills it in (AGL-1459) — a
+     * COMPOSE-TIME prop, like Related Posts' `limit`: it is answered where the
+     * timestamp still exists (`expandCollectionEntryMeta`) and never reaches the
+     * DOM. Blank, or `default`, is the locale date the block has always emitted.
+     */
+    dateFormat?: Aglyn.CollectionEntryDateFormat;
+    /**
+     * Byline (AGL-1459). Server-filled from the entry's own author on entry
+     * templates, exactly like {@link date}; set it — or bind `{{entry.author}}`
+     * — only to override.
+     */
+    author?: string;
+    /** Category; server-filled, or bind `{{entry.category}}` to override. */
+    category?: string;
+    /** Comma-joined tags; server-filled, or bind `{{entry.tags}}`. */
+    tags?: string;
+    /**
+     * Round avatar shown before the byline (AGL-1459) — a media-picker target,
+     * so it holds a media reference (AGL-1215) as well as any URL form.
+     *
+     * A block-level pick, deliberately, and NOT a per-author image: entries
+     * carry an author NAME (`authorName`) and no portrait field, so a per-author
+     * avatar would need a schema decision on the entry model plus an editor
+     * field to fill it. Until then this is the site's brand mark, chosen once on
+     * the template — which is what the article frame actually asks for. Left
+     * unset it renders nothing at all, never a broken image.
+     */
+    avatarImage?: string;
+    showDate?: boolean;
+    showAuthor?: boolean;
+    /**
+     * Where the byline's NAME links — the author's page on this site
+     * (AGL-2519). Server-filled from the routed entry's author, like the
+     * avatar beside it; blank renders the name as plain text.
+     *
+     * Distinct from the author's own `url`, which the Entry Author card offers
+     * as a link row: this is "everything they wrote here", that is "their
+     * site", and a byline that conflated them would send a reader off-site from
+     * every article.
+     */
+    authorPageUrl?: string;
+    /** Off leaves the byline as plain text even when the author has a page. */
+    linkAuthor?: boolean;
+    showCategory?: boolean;
+    showTags?: boolean;
+    showAvatar?: boolean;
+}
+/**
+ * "{{entry.date}} · {{entry.category}}" meta line plus tag chips
+ * (AGL-582). Values arrive through entry tokens on entry renders; on other
+ * surfaces unresolved tokens collapse to nothing instead of leaking.
+ *
+ * On an entry template the tenant now also FILLS the three values from the
+ * routed entry when nothing is bound (`expandCollectionEntryMeta`, AGL-1385).
+ * Before that, a block dragged from the palette rather than dropped as the
+ * preset had no values at all — three "Show" switches gating nothing — and
+ * rendered as the empty `<Box>` below, at height 0.
+ */
+declare const CollectionEntryMeta: import("react").ForwardRefExoticComponent<Omit<CollectionEntryMetaProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionEntryMetaSchema: Aglyn.ComponentSchema<CollectionEntryMetaProps>;
+export { CollectionEntryMeta };