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

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

@@ -0,0 +1,331 @@
+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, Fragment as _Fragment } 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 { mdiTagOutline } from "@aglyn/shared-data-mdi";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import Box from "@mui/material/Box";
+import Chip from "@mui/material/Chip";
+import MuiStack from "@mui/material/Stack";
+import Typography from "@mui/material/Typography";
+import { forwardRef, useContext } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { UNRESOLVED_TOKEN, ENTRY_SAMPLE_PUBLISHED_AT, ENTRY_SAMPLE_AUTHOR, ENTRY_SAMPLE_CATEGORY, ENTRY_SAMPLE_TAGS, samplePortraitSx, metaValue, SAFE_AUTHOR_HREF } 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_META_ID = Aglyn.COLLECTION_ENTRY_META_COMPONENT_ID;
+/** Byline avatar, from the article frame (Figma 170:190). */ const ENTRY_AVATAR_SIZE = 36;
+/**
+ * "{{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.
+ */ const CollectionEntryMeta = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { date, // Compose-time (AGL-1459): read by `expandCollectionEntryMeta`, which has
+    // the timestamp. Destructured so it never reaches the DOM.
+    dateFormat: _dateFormat, author, authorPageUrl, linkAuthor, category, tags, avatarImage, showDate, showAuthor, showCategory, showTags, showAvatar } = props, rest = _object_without_properties_loose(props, [
+        "date",
+        "dateFormat",
+        "author",
+        "authorPageUrl",
+        "linkAuthor",
+        "category",
+        "tags",
+        "avatarImage",
+        "showDate",
+        "showAuthor",
+        "showCategory",
+        "showTags",
+        "showAvatar"
+    ]);
+    // Node styles ride the renderer-merged sx; recompose (stack.ts pattern).
+    const nodeSx = Array.isArray(props['sx']) ? props['sx'] : [
+        props['sx']
+    ];
+    const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext);
+    // The resolver every other surface shares (AGL-1215), so one media
+    // reference keeps working across sites. A hook — before any early return.
+    const { hostId } = Aglyn.useSite();
+    const dateValue = showDate !== false ? metaValue(date, suppressNavigation) : '';
+    const authorValue = showAuthor !== false ? metaValue(author, suppressNavigation) : '';
+    const categoryValue = showCategory !== false ? metaValue(category, suppressNavigation) : '';
+    const tagsValue = showTags !== false ? metaValue(tags, suppressNavigation) : '';
+    const tagList = tagsValue.split(',').map((tag)=>tag.trim()).filter(Boolean);
+    // An unresolved token empties on EVERY surface here, unlike the text
+    // fields: a literal `{{…}}` in a src is a broken image in the canvas, and a
+    // byline that renders a broken avatar on every post is worse than no
+    // avatar at all.
+    const avatarRaw = (avatarImage != null ? avatarImage : '').trim();
+    const avatarSrc = showAvatar !== false && avatarRaw && !UNRESOLVED_TOKEN.test(avatarRaw) ? Aglyn.resolveMediaSrc(avatarRaw, {
+        hostId
+    }) : '';
+    // Author leads, so the frame's "The Aglyn Team · Jul 2026" reads in that
+    // order. With no author the join is character-for-character what it was.
+    const filledLine = [
+        authorValue,
+        dateValue,
+        categoryValue
+    ].filter(Boolean).join(' · ');
+    /*
+    The rest of the line, WITHOUT the author (AGL-2519).
+
+    The row is one string everywhere else, which is what a `·`-joined byline
+    wants — but a link is an element, so the author has to come out of the
+    join to be one. Split rather than reassembled from parts, so the
+    separator, the order and the empty-field collapsing all stay in the one
+    expression above: the linked row and the plain row cannot render a
+    different sentence.
+  */ const authorHrefRaw = metaValue(authorPageUrl, suppressNavigation);
+    const authorHref = linkAuthor !== false && SAFE_AUTHOR_HREF.test(authorHrefRaw) ? authorHrefRaw : '';
+    const trailingLine = [
+        dateValue,
+        categoryValue
+    ].filter(Boolean).join(' · ');
+    // Nothing to show and nothing to route from: an editing surface previews
+    // the block's own markup at the author's own settings, and a published page
+    // renders nothing at all (AGL-2486). The switches are honoured here exactly
+    // as they are below, so a row with Show date off previews without one.
+    const sample = !filledLine && !tagList.length && !avatarSrc && suppressNavigation;
+    const line = sample ? [
+        showAuthor !== false ? ENTRY_SAMPLE_AUTHOR : '',
+        showDate !== false ? Aglyn.formatCollectionEntryDate(ENTRY_SAMPLE_PUBLISHED_AT, Aglyn.normalizeCollectionEntryDateFormat(_dateFormat)) : '',
+        showCategory !== false ? ENTRY_SAMPLE_CATEGORY : ''
+    ].filter(Boolean).join(' · ') : filledLine;
+    const chips = sample ? showTags !== false ? ENTRY_SAMPLE_TAGS.split(',').map((tag)=>tag.trim()) : [] : tagList;
+    // The portrait an entry's own author record supplies arrives at compose
+    // time, so on the canvas there is none to resolve — the slot is drawn
+    // instead, which is what a byline's spacing is actually built around.
+    const samplePortrait = sample && showAvatar !== false;
+    if (!line && !chips.length && !avatarSrc && !samplePortrait) {
+        return /*#__PURE__*/ _jsx(Box, _extends({
+            ref: ref
+        }, rest));
+    }
+    return /*#__PURE__*/ _jsxs(MuiStack, _extends({
+        ref: ref,
+        direction: "row",
+        spacing: 1
+    }, rest, {
+        // MERGE, never replace (AGL-1450, same class as AGL-1284). `rest.sx`
+        // is the ARRAY `mergeSxProps` builds in leaf.tsx, so spreading it into
+        // an object produced `{0: …, 1: …, 2: …}` — numeric keys emotion emits
+        // as invalid selectors — and discarded EVERY authored property while
+        // these two defaults still applied. The block looked deliberately
+        // styled, so nothing suggested the value had been dropped. Defaults
+        // go first; the node's slice comes after and can override them.
+        sx: [
+            {
+                alignItems: 'center',
+                flexWrap: 'wrap'
+            },
+            ...nodeSx
+        ],
+        children: [
+            avatarSrc ? /*#__PURE__*/ _jsx(Box, _extends({
+                component: "img",
+                src: avatarSrc,
+                // Decorative: the byline names the author in text right beside it,
+                // so a screen reader announcing the mark again is noise.
+                alt: "",
+                sx: {
+                    display: 'block',
+                    width: ENTRY_AVATAR_SIZE,
+                    height: ENTRY_AVATAR_SIZE,
+                    borderRadius: '50%',
+                    objectFit: 'cover'
+                }
+            }, Aglyn.DEFERRED_IMAGE_ATTRIBUTES)) : samplePortrait ? /*#__PURE__*/ _jsx(Box, {
+                "aria-hidden": true,
+                sx: samplePortraitSx(ENTRY_AVATAR_SIZE)
+            }) : null,
+            line ? /*#__PURE__*/ _jsx(Typography, {
+                variant: "caption",
+                sx: {
+                    color: 'text.secondary'
+                },
+                children: // Linked only on the real byline, never on the canvas sample: a
+                // preview whose placeholder name navigates is a trap, and the
+                // sample author has no page to go to.
+                authorHref && authorValue && !sample ? /*#__PURE__*/ _jsxs(_Fragment, {
+                    children: [
+                        /*#__PURE__*/ _jsx(AppLink, {
+                            href: authorHref,
+                            sx: {
+                                color: 'inherit'
+                            },
+                            underline: "hover",
+                            children: authorValue
+                        }),
+                        trailingLine ? ` · ${trailingLine}` : ''
+                    ]
+                }) : line
+            }) : null,
+            chips.map((tag)=>/*#__PURE__*/ _jsx(Chip, {
+                    label: tag,
+                    size: "small",
+                    variant: "outlined"
+                }, tag))
+        ]
+    }));
+});
+CollectionEntryMeta.displayName = 'AglynCollectionEntryMeta';
+export const collectionEntryMetaSchema = {
+    $id: ENTRY_META_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Entry Meta',
+    description: 'The byline row for an entry — author, date, category and tags.',
+    category: Aglyn.ComponentCategory.TEXT,
+    icon: {
+        path: mdiTagOutline.path,
+        sx: {
+            color: 'secondary.main'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'date',
+            label: 'Date',
+            description: 'Blank shows the entry’s own published date on entry templates. ' + 'Type here (or bind {{entry.date}}) only to override it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'dateFormat',
+            label: 'Date format',
+            description: 'How the published date reads. Site default is the format this ' + 'block has always used; it has no effect on a Date you typed in ' + 'yourself.',
+            component: Aglyn.FieldComponentType.SELECT,
+            // The formats the pure layer knows how to produce, so the list cannot
+            // offer a shape nothing renders. Every value is REAL — including the
+            // do-nothing one (AGL-1451/AGL-1453): `''` cannot survive a save, so
+            // an author who tried a format would have no route back.
+            options: [
+                ...Aglyn.COLLECTION_ENTRY_DATE_FORMAT_OPTIONS
+            ]
+        },
+        {
+            name: 'author',
+            label: 'Author',
+            description: 'Blank shows the entry’s own author. Type here (or bind ' + '{{entry.author}}) only to override it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'category',
+            label: 'Category',
+            description: 'Blank shows the entry’s own category. Type here (or bind ' + '{{entry.category}}) only to override it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'tags',
+            label: 'Tags',
+            description: 'Comma-separated. Blank shows the entry’s own tags; type here (or ' + 'bind {{entry.tags}}) only to override them.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'avatarImage',
+            label: 'Avatar',
+            description: 'Round image before the byline — your brand mark, or any image ' + 'from the media library. Blank shows no avatar.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'showDate',
+            label: 'Show date',
+            description: 'Off hides the published date from the line without clearing what ' + 'the Date field would have shown.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means SHOWN in the renderer above, so the switch has to
+            // OPEN in that position or it lies about the block in front of
+            // the author — and the first click, which writes the `true` that
+            // was already in effect, changes nothing and reads as a dead
+            // control (AGL-2506).
+            initialValue: true
+        },
+        {
+            name: 'showCategory',
+            label: 'Show category',
+            description: 'Off drops the category from the line. The entry keeps its ' + 'category — this is about the byline, not the taxonomy.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means SHOWN in the renderer above, so the switch has to
+            // OPEN in that position or it lies about the block in front of
+            // the author — and the first click, which writes the `true` that
+            // was already in effect, changes nothing and reads as a dead
+            // control (AGL-2506).
+            initialValue: true
+        },
+        {
+            name: 'showTags',
+            label: 'Show tags',
+            description: 'Off hides the tag chips below the line. Leave it on and the ' + 'other three off for a tags-only row.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means SHOWN in the renderer above, so the switch has to
+            // OPEN in that position or it lies about the block in front of
+            // the author — and the first click, which writes the `true` that
+            // was already in effect, changes nothing and reads as a dead
+            // control (AGL-2506).
+            initialValue: true
+        },
+        {
+            name: 'authorPageUrl',
+            label: 'Author links to',
+            description: 'Blank sends the byline to the author’s page on this site. Type ' + 'here (or bind {{entry.authorPageUrl}}) only to override it.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'linkAuthor',
+            label: 'Link author',
+            description: 'Off leaves the byline as plain text even when the author has a ' + 'page. On, the name links there and the date and category beside ' + 'it do not.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means LINKED in the renderer above, so the switch has to open
+            // in that position or it lies about the block in front of the author
+            // (AGL-2506).
+            initialValue: true
+        },
+        {
+            name: 'showAuthor',
+            label: 'Show author',
+            description: 'Off hides the byline. The avatar follows it: a block with no ' + 'author shown never fills in the author’s portrait.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means SHOWN in the renderer above, so the switch has to
+            // OPEN in that position or it lies about the block in front of
+            // the author — and the first click, which writes the `true` that
+            // was already in effect, changes nothing and reads as a dead
+            // control (AGL-2506).
+            initialValue: true
+        },
+        {
+            name: 'showAvatar',
+            label: 'Show avatar',
+            description: 'Off hides the round image in front of the byline, including an ' + 'author’s own portrait.',
+            component: Aglyn.FieldComponentType.SWITCH,
+            // Unset means SHOWN in the renderer above, so the switch has to
+            // OPEN in that position or it lies about the block in front of
+            // the author — and the first click, which writes the `true` that
+            // was already in effect, changes nothing and reads as a dead
+            // control (AGL-2506).
+            initialValue: true
+        }
+    ]
+};
+export { CollectionEntryMeta };
+
+//# sourceMappingURL=collection-entry-meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-entry-meta.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 { mdiTagOutline } from '@aglyn/shared-data-mdi'\nimport { AppLink } from '@aglyn/shared-ui-jsx'\nimport Box from '@mui/material/Box'\nimport Chip from '@mui/material/Chip'\nimport MuiStack, { type StackProps } from '@mui/material/Stack'\nimport Typography from '@mui/material/Typography'\nimport { forwardRef, useContext } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport {\n  UNRESOLVED_TOKEN,\n  ENTRY_SAMPLE_PUBLISHED_AT,\n  ENTRY_SAMPLE_AUTHOR,\n  ENTRY_SAMPLE_CATEGORY,\n  ENTRY_SAMPLE_TAGS,\n  samplePortraitSx,\n  metaValue,\n  SAFE_AUTHOR_HREF,\n} 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_META_ID: Aglyn.ComponentId =\n  Aglyn.COLLECTION_ENTRY_META_COMPONENT_ID\n\nexport interface CollectionEntryMetaProps extends StackProps {\n  /**\n   * Published date. Server-filled from the routed entry on entry templates\n   * (`expandCollectionEntryMeta`, AGL-1385); set it — or bind\n   * `{{entry.date}}` — only to override.\n   */\n  date?: string\n  /**\n   * How {@link date} reads when the server fills it in (AGL-1459) — a\n   * COMPOSE-TIME prop, like Related Posts' `limit`: it is answered where the\n   * timestamp still exists (`expandCollectionEntryMeta`) and never reaches the\n   * DOM. Blank, or `default`, is the locale date the block has always emitted.\n   */\n  dateFormat?: Aglyn.CollectionEntryDateFormat\n  /**\n   * Byline (AGL-1459). Server-filled from the entry's own author on entry\n   * templates, exactly like {@link date}; set it — or bind `{{entry.author}}`\n   * — only to override.\n   */\n  author?: string\n  /** Category; server-filled, or bind `{{entry.category}}` to override. */\n  category?: string\n  /** Comma-joined tags; server-filled, or bind `{{entry.tags}}`. */\n  tags?: string\n  /**\n   * Round avatar shown before the byline (AGL-1459) — a media-picker target,\n   * so it holds a media reference (AGL-1215) as well as any URL form.\n   *\n   * A block-level pick, deliberately, and NOT a per-author image: entries\n   * carry an author NAME (`authorName`) and no portrait field, so a per-author\n   * avatar would need a schema decision on the entry model plus an editor\n   * field to fill it. Until then this is the site's brand mark, chosen once on\n   * the template — which is what the article frame actually asks for. Left\n   * unset it renders nothing at all, never a broken image.\n   */\n  avatarImage?: string\n  showDate?: boolean\n  showAuthor?: boolean\n  /**\n   * Where the byline's NAME links — the author's page on this site\n   * (AGL-2519). Server-filled from the routed entry's author, like the\n   * avatar beside it; blank renders the name as plain text.\n   *\n   * Distinct from the author's own `url`, which the Entry Author card offers\n   * as a link row: this is \"everything they wrote here\", that is \"their\n   * site\", and a byline that conflated them would send a reader off-site from\n   * every article.\n   */\n  authorPageUrl?: string\n  /** Off leaves the byline as plain text even when the author has a page. */\n  linkAuthor?: boolean\n  showCategory?: boolean\n  showTags?: boolean\n  showAvatar?: boolean\n}\n\n/** Byline avatar, from the article frame (Figma 170:190). */\nconst ENTRY_AVATAR_SIZE = 36\n\n/**\n * \"{{entry.date}} · {{entry.category}}\" meta line plus tag chips\n * (AGL-582). Values arrive through entry tokens on entry renders; on other\n * surfaces unresolved tokens collapse to nothing instead of leaking.\n *\n * On an entry template the tenant now also FILLS the three values from the\n * routed entry when nothing is bound (`expandCollectionEntryMeta`, AGL-1385).\n * Before that, a block dragged from the palette rather than dropped as the\n * preset had no values at all — three \"Show\" switches gating nothing — and\n * rendered as the empty `<Box>` below, at height 0.\n */\nconst CollectionEntryMeta = forwardRef<\n  HTMLDivElement,\n  CollectionEntryMetaProps\n>((props, ref) => {\n  const {\n    date,\n    // Compose-time (AGL-1459): read by `expandCollectionEntryMeta`, which has\n    // the timestamp. Destructured so it never reaches the DOM.\n    dateFormat: _dateFormat,\n    author,\n    authorPageUrl,\n    linkAuthor,\n    category,\n    tags,\n    avatarImage,\n    showDate,\n    showAuthor,\n    showCategory,\n    showTags,\n    showAvatar,\n    ...rest\n  } = 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  const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext)\n  // The resolver every other surface shares (AGL-1215), so one media\n  // reference keeps working across sites. A hook — before any early return.\n  const { hostId } = Aglyn.useSite()\n  const dateValue = showDate !== false ? metaValue(date, suppressNavigation) : ''\n  const authorValue =\n    showAuthor !== false ? metaValue(author, suppressNavigation) : ''\n  const categoryValue =\n    showCategory !== false ? metaValue(category, suppressNavigation) : ''\n  const tagsValue = showTags !== false ? metaValue(tags, suppressNavigation) : ''\n  const tagList = tagsValue\n    .split(',')\n    .map((tag) => tag.trim())\n    .filter(Boolean)\n  // An unresolved token empties on EVERY surface here, unlike the text\n  // fields: a literal `{{…}}` in a src is a broken image in the canvas, and a\n  // byline that renders a broken avatar on every post is worse than no\n  // avatar at all.\n  const avatarRaw = (avatarImage ?? '').trim()\n  const avatarSrc =\n    showAvatar !== false && avatarRaw && !UNRESOLVED_TOKEN.test(avatarRaw)\n      ? Aglyn.resolveMediaSrc(avatarRaw, { hostId })\n      : ''\n  // Author leads, so the frame's \"The Aglyn Team · Jul 2026\" reads in that\n  // order. With no author the join is character-for-character what it was.\n  const filledLine = [authorValue, dateValue, categoryValue]\n    .filter(Boolean)\n    .join(' · ')\n  /*\n    The rest of the line, WITHOUT the author (AGL-2519).\n\n    The row is one string everywhere else, which is what a `·`-joined byline\n    wants — but a link is an element, so the author has to come out of the\n    join to be one. Split rather than reassembled from parts, so the\n    separator, the order and the empty-field collapsing all stay in the one\n    expression above: the linked row and the plain row cannot render a\n    different sentence.\n  */\n  const authorHrefRaw = metaValue(authorPageUrl, suppressNavigation)\n  const authorHref =\n    linkAuthor !== false && SAFE_AUTHOR_HREF.test(authorHrefRaw)\n      ? authorHrefRaw\n      : ''\n  const trailingLine = [dateValue, categoryValue].filter(Boolean).join(' · ')\n  // Nothing to show and nothing to route from: an editing surface previews\n  // the block's own markup at the author's own settings, and a published page\n  // renders nothing at all (AGL-2486). The switches are honoured here exactly\n  // as they are below, so a row with Show date off previews without one.\n  const sample = !filledLine && !tagList.length && !avatarSrc && suppressNavigation\n  const line = sample\n    ? [\n        showAuthor !== false ? ENTRY_SAMPLE_AUTHOR : '',\n        showDate !== false\n          ? Aglyn.formatCollectionEntryDate(\n              ENTRY_SAMPLE_PUBLISHED_AT,\n              Aglyn.normalizeCollectionEntryDateFormat(_dateFormat),\n            )\n          : '',\n        showCategory !== false ? ENTRY_SAMPLE_CATEGORY : '',\n      ]\n        .filter(Boolean)\n        .join(' · ')\n    : filledLine\n  const chips = sample\n    ? showTags !== false\n      ? ENTRY_SAMPLE_TAGS.split(',').map((tag) => tag.trim())\n      : []\n    : tagList\n  // The portrait an entry's own author record supplies arrives at compose\n  // time, so on the canvas there is none to resolve — the slot is drawn\n  // instead, which is what a byline's spacing is actually built around.\n  const samplePortrait = sample && showAvatar !== false\n  if (!line && !chips.length && !avatarSrc && !samplePortrait) {\n    return <Box ref={ref} {...rest} />\n  }\n  return (\n    <MuiStack\n      ref={ref}\n      direction=\"row\"\n      spacing={1}\n      {...rest}\n      // MERGE, never replace (AGL-1450, same class as AGL-1284). `rest.sx`\n      // is the ARRAY `mergeSxProps` builds in leaf.tsx, so spreading it into\n      // an object produced `{0: …, 1: …, 2: …}` — numeric keys emotion emits\n      // as invalid selectors — and discarded EVERY authored property while\n      // these two defaults still applied. The block looked deliberately\n      // styled, so nothing suggested the value had been dropped. Defaults\n      // go first; the node's slice comes after and can override them.\n      sx={[{ alignItems: 'center', flexWrap: 'wrap' }, ...nodeSx]}\n    >\n      {avatarSrc ? (\n        <Box\n          component=\"img\"\n          src={avatarSrc}\n          // Decorative: the byline names the author in text right beside it,\n          // so a screen reader announcing the mark again is noise.\n          alt=\"\"\n          sx={{\n            display: 'block',\n            width: ENTRY_AVATAR_SIZE,\n            height: ENTRY_AVATAR_SIZE,\n            borderRadius: '50%',\n            objectFit: 'cover',\n            // No background plate: a brand mark with a transparent ground\n            // would sit on a grey disc nobody asked for.\n          }}\n          // `lazy` alone, same as Related Posts' rail (AGL-2486). A\n          // byline avatar is decorative and tiny; it has no business\n          // outranking anything.\n          {...Aglyn.DEFERRED_IMAGE_ATTRIBUTES}\n        />\n      ) : samplePortrait ? (\n        <Box aria-hidden sx={samplePortraitSx(ENTRY_AVATAR_SIZE)} />\n      ) : null}\n      {line ? (\n        <Typography variant=\"caption\" sx={{ color: 'text.secondary' }}>\n          {\n            // Linked only on the real byline, never on the canvas sample: a\n            // preview whose placeholder name navigates is a trap, and the\n            // sample author has no page to go to.\n            authorHref && authorValue && !sample ? (\n              <>\n                <AppLink\n                  href={authorHref}\n                  sx={{ color: 'inherit' }}\n                  underline=\"hover\"\n                >\n                  {authorValue}\n                </AppLink>\n                {trailingLine ? ` · ${trailingLine}` : ''}\n              </>\n            ) : (\n              line\n            )\n          }\n        </Typography>\n      ) : null}\n      {chips.map((tag) => (\n        <Chip key={tag} label={tag} size=\"small\" variant=\"outlined\" />\n      ))}\n    </MuiStack>\n  )\n})\nCollectionEntryMeta.displayName = 'AglynCollectionEntryMeta'\n\nexport const collectionEntryMetaSchema: Aglyn.ComponentSchema<CollectionEntryMetaProps> =\n  {\n    $id: ENTRY_META_ID,\n    pluginId: BUNDLE_ID,\n    displayName: 'Entry Meta',\n    description:\n      'The byline row for an entry — author, date, category and tags.',\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: { path: mdiTagOutline.path, sx: { color: 'secondary.main' } },\n    flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n    attributes: [\n      {\n        name: 'date',\n        label: 'Date',\n        description:\n          'Blank shows the entry’s own published date on entry templates. ' +\n          'Type here (or bind {{entry.date}}) only to override it.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'dateFormat',\n        label: 'Date format',\n        description:\n          'How the published date reads. Site default is the format this ' +\n          'block has always used; it has no effect on a Date you typed in ' +\n          'yourself.',\n        component: Aglyn.FieldComponentType.SELECT,\n        // The formats the pure layer knows how to produce, so the list cannot\n        // offer a shape nothing renders. Every value is REAL — including the\n        // do-nothing one (AGL-1451/AGL-1453): `''` cannot survive a save, so\n        // an author who tried a format would have no route back.\n        options: [...Aglyn.COLLECTION_ENTRY_DATE_FORMAT_OPTIONS],\n      },\n      {\n        name: 'author',\n        label: 'Author',\n        description:\n          'Blank shows the entry’s own author. Type here (or bind ' +\n          '{{entry.author}}) only to override it.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'category',\n        label: 'Category',\n        description:\n          'Blank shows the entry’s own category. Type here (or bind ' +\n          '{{entry.category}}) only to override it.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'tags',\n        label: 'Tags',\n        description:\n          'Comma-separated. Blank shows the entry’s own tags; type here (or ' +\n          'bind {{entry.tags}}) only to override them.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'avatarImage',\n        label: 'Avatar',\n        description:\n          'Round image before the byline — your brand mark, or any image ' +\n          'from the media library. Blank shows no avatar.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'showDate',\n        label: 'Show date',\n        description:\n          'Off hides the published date from the line without clearing what ' +\n          'the Date field would have shown.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means SHOWN in the renderer above, so the switch has to\n        // OPEN in that position or it lies about the block in front of\n        // the author — and the first click, which writes the `true` that\n        // was already in effect, changes nothing and reads as a dead\n        // control (AGL-2506).\n        initialValue: true,\n      },\n      {\n        name: 'showCategory',\n        label: 'Show category',\n        description:\n          'Off drops the category from the line. The entry keeps its ' +\n          'category — this is about the byline, not the taxonomy.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means SHOWN in the renderer above, so the switch has to\n        // OPEN in that position or it lies about the block in front of\n        // the author — and the first click, which writes the `true` that\n        // was already in effect, changes nothing and reads as a dead\n        // control (AGL-2506).\n        initialValue: true,\n      },\n      {\n        name: 'showTags',\n        label: 'Show tags',\n        description:\n          'Off hides the tag chips below the line. Leave it on and the ' +\n          'other three off for a tags-only row.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means SHOWN in the renderer above, so the switch has to\n        // OPEN in that position or it lies about the block in front of\n        // the author — and the first click, which writes the `true` that\n        // was already in effect, changes nothing and reads as a dead\n        // control (AGL-2506).\n        initialValue: true,\n      },\n      {\n        name: 'authorPageUrl',\n        label: 'Author links to',\n        description:\n          'Blank sends the byline to the author’s page on this site. Type ' +\n          'here (or bind {{entry.authorPageUrl}}) only to override it.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'linkAuthor',\n        label: 'Link author',\n        description:\n          'Off leaves the byline as plain text even when the author has a ' +\n          'page. On, the name links there and the date and category beside ' +\n          'it do not.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means LINKED in the renderer above, so the switch has to open\n        // in that position or it lies about the block in front of the author\n        // (AGL-2506).\n        initialValue: true,\n      },\n      {\n        name: 'showAuthor',\n        label: 'Show author',\n        description:\n          'Off hides the byline. The avatar follows it: a block with no ' +\n          'author shown never fills in the author’s portrait.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means SHOWN in the renderer above, so the switch has to\n        // OPEN in that position or it lies about the block in front of\n        // the author — and the first click, which writes the `true` that\n        // was already in effect, changes nothing and reads as a dead\n        // control (AGL-2506).\n        initialValue: true,\n      },\n      {\n        name: 'showAvatar',\n        label: 'Show avatar',\n        description:\n          'Off hides the round image in front of the byline, including an ' +\n          'author’s own portrait.',\n        component: Aglyn.FieldComponentType.SWITCH,\n        // Unset means SHOWN in the renderer above, so the switch has to\n        // OPEN in that position or it lies about the block in front of\n        // the author — and the first click, which writes the `true` that\n        // was already in effect, changes nothing and reads as a dead\n        // control (AGL-2506).\n        initialValue: true,\n      },\n    ],\n  }\n\nexport { CollectionEntryMeta }\n"],"names":["Aglyn","mdiTagOutline","AppLink","Box","Chip","MuiStack","Typography","forwardRef","useContext","BUNDLE_ID","UNRESOLVED_TOKEN","ENTRY_SAMPLE_PUBLISHED_AT","ENTRY_SAMPLE_AUTHOR","ENTRY_SAMPLE_CATEGORY","ENTRY_SAMPLE_TAGS","samplePortraitSx","metaValue","SAFE_AUTHOR_HREF","ENTRY_META_ID","COLLECTION_ENTRY_META_COMPONENT_ID","ENTRY_AVATAR_SIZE","CollectionEntryMeta","props","ref","date","dateFormat","_dateFormat","author","authorPageUrl","linkAuthor","category","tags","avatarImage","showDate","showAuthor","showCategory","showTags","showAvatar","rest","nodeSx","Array","isArray","suppressNavigation","ScreenLinkContext","hostId","useSite","dateValue","authorValue","categoryValue","tagsValue","tagList","split","map","tag","trim","filter","Boolean","avatarRaw","avatarSrc","test","resolveMediaSrc","filledLine","join","authorHrefRaw","authorHref","trailingLine","sample","length","line","formatCollectionEntryDate","normalizeCollectionEntryDateFormat","chips","samplePortrait","direction","spacing","sx","alignItems","flexWrap","component","src","alt","display","width","height","borderRadius","objectFit","DEFERRED_IMAGE_ATTRIBUTES","aria-hidden","variant","color","href","underline","label","size","displayName","collectionEntryMetaSchema","$id","pluginId","description","ComponentCategory","TEXT","icon","path","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","FieldComponentType","TEXT_FIELD","SELECT","options","COLLECTION_ENTRY_DATE_FORMAT_OPTIONS","SWITCH","initialValue"],"mappings":";;;AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,aAAa,QAAQ,yBAAwB;AACtD,SAASC,OAAO,QAAQ,uBAAsB;AAC9C,OAAOC,SAAS,oBAAmB;AACnC,OAAOC,UAAU,qBAAoB;AACrC,OAAOC,cAAmC,sBAAqB;AAC/D,OAAOC,gBAAgB,2BAA0B;AACjD,SAASC,UAAU,EAAEC,UAAU,QAAQ,QAAO;AAC9C,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SACEC,gBAAgB,EAChBC,yBAAyB,EACzBC,mBAAmB,EACnBC,qBAAqB,EACrBC,iBAAiB,EACjBC,gBAAgB,EAChBC,SAAS,EACTC,gBAAgB,QACX,yBAAqB;AAE5B,2EAA2E;AAC3E,mDAAmD;AACnD,OAAO,MAAMC,gBACXlB,MAAMmB,kCAAkC,CAAA;AA0D1C,2DAA2D,GAC3D,MAAMC,oBAAoB;AAE1B;;;;;;;;;;CAUC,GACD,MAAMC,oCAAsBd,WAG1B,CAACe,OAAOC;IACR,MAAM,EACJC,IAAI,EACJ,0EAA0E;IAC1E,2DAA2D;IAC3DC,YAAYC,WAAW,EACvBC,MAAM,EACNC,aAAa,EACbC,UAAU,EACVC,QAAQ,EACRC,IAAI,EACJC,WAAW,EACXC,QAAQ,EACRC,UAAU,EACVC,YAAY,EACZC,QAAQ,EACRC,UAAU,EAEX,GAAGf,OADCgB,wCACDhB;;;;;;;;;;;;;;;IACJ,yEAAyE;IACzE,MAAMiB,SAASC,MAAMC,OAAO,CAACnB,KAAK,CAAC,KAAK,IAAIA,KAAK,CAAC,KAAK,GAAG;QAACA,KAAK,CAAC,KAAK;KAAC;IACvE,MAAM,EAAEoB,kBAAkB,EAAE,GAAGlC,WAAWR,MAAM2C,iBAAiB;IACjE,mEAAmE;IACnE,0EAA0E;IAC1E,MAAM,EAAEC,MAAM,EAAE,GAAG5C,MAAM6C,OAAO;IAChC,MAAMC,YAAYb,aAAa,QAAQjB,UAAUQ,MAAMkB,sBAAsB;IAC7E,MAAMK,cACJb,eAAe,QAAQlB,UAAUW,QAAQe,sBAAsB;IACjE,MAAMM,gBACJb,iBAAiB,QAAQnB,UAAUc,UAAUY,sBAAsB;IACrE,MAAMO,YAAYb,aAAa,QAAQpB,UAAUe,MAAMW,sBAAsB;IAC7E,MAAMQ,UAAUD,UACbE,KAAK,CAAC,KACNC,GAAG,CAAC,CAACC,MAAQA,IAAIC,IAAI,IACrBC,MAAM,CAACC;IACV,qEAAqE;IACrE,4EAA4E;IAC5E,qEAAqE;IACrE,iBAAiB;IACjB,MAAMC,YAAY,CAACzB,sBAAAA,cAAe,IAAIsB,IAAI;IAC1C,MAAMI,YACJrB,eAAe,SAASoB,aAAa,CAAC/C,iBAAiBiD,IAAI,CAACF,aACxDzD,MAAM4D,eAAe,CAACH,WAAW;QAAEb;IAAO,KAC1C;IACN,yEAAyE;IACzE,yEAAyE;IACzE,MAAMiB,aAAa;QAACd;QAAaD;QAAWE;KAAc,CACvDO,MAAM,CAACC,SACPM,IAAI,CAAC;IACR;;;;;;;;;EASA,GACA,MAAMC,gBAAgB/C,UAAUY,eAAec;IAC/C,MAAMsB,aACJnC,eAAe,SAASZ,iBAAiB0C,IAAI,CAACI,iBAC1CA,gBACA;IACN,MAAME,eAAe;QAACnB;QAAWE;KAAc,CAACO,MAAM,CAACC,SAASM,IAAI,CAAC;IACrE,yEAAyE;IACzE,4EAA4E;IAC5E,4EAA4E;IAC5E,uEAAuE;IACvE,MAAMI,SAAS,CAACL,cAAc,CAACX,QAAQiB,MAAM,IAAI,CAACT,aAAahB;IAC/D,MAAM0B,OAAOF,SACT;QACEhC,eAAe,QAAQtB,sBAAsB;QAC7CqB,aAAa,QACTjC,MAAMqE,yBAAyB,CAC7B1D,2BACAX,MAAMsE,kCAAkC,CAAC5C,gBAE3C;QACJS,iBAAiB,QAAQtB,wBAAwB;KAClD,CACE0C,MAAM,CAACC,SACPM,IAAI,CAAC,SACRD;IACJ,MAAMU,QAAQL,SACV9B,aAAa,QACXtB,kBAAkBqC,KAAK,CAAC,KAAKC,GAAG,CAAC,CAACC,MAAQA,IAAIC,IAAI,MAClD,EAAE,GACJJ;IACJ,wEAAwE;IACxE,sEAAsE;IACtE,sEAAsE;IACtE,MAAMsB,iBAAiBN,UAAU7B,eAAe;IAChD,IAAI,CAAC+B,QAAQ,CAACG,MAAMJ,MAAM,IAAI,CAACT,aAAa,CAACc,gBAAgB;QAC3D,qBAAO,KAACrE;YAAIoB,KAAKA;WAASe;IAC5B;IACA,qBACE,MAACjC;QACCkB,KAAKA;QACLkD,WAAU;QACVC,SAAS;OACLpC;QACJ,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,qEAAqE;QACrE,kEAAkE;QAClE,oEAAoE;QACpE,gEAAgE;QAChEqC,IAAI;YAAC;gBAAEC,YAAY;gBAAUC,UAAU;YAAO;eAAMtC;SAAO;;YAE1DmB,0BACC,KAACvD;gBACC2E,WAAU;gBACVC,KAAKrB;gBACL,mEAAmE;gBACnE,yDAAyD;gBACzDsB,KAAI;gBACJL,IAAI;oBACFM,SAAS;oBACTC,OAAO9D;oBACP+D,QAAQ/D;oBACRgE,cAAc;oBACdC,WAAW;gBAGb;eAIIrF,MAAMsF,yBAAyB,KAEnCd,+BACF,KAACrE;gBAAIoF,aAAW;gBAACZ,IAAI5D,iBAAiBK;iBACpC;YACHgD,qBACC,KAAC9D;gBAAWkF,SAAQ;gBAAUb,IAAI;oBAAEc,OAAO;gBAAiB;0BAKxDzB,AAHA,gEAAgE;gBAChE,8DAA8D;gBAC9D,sCAAsC;gBACtCA,cAAcjB,eAAe,CAACmB,uBAC5B;;sCACE,KAAChE;4BACCwF,MAAM1B;4BACNW,IAAI;gCAAEc,OAAO;4BAAU;4BACvBE,WAAU;sCAET5C;;wBAEFkB,eAAe,CAAC,GAAG,EAAEA,cAAc,GAAG;;qBAGzCG;iBAIJ;YACHG,MAAMnB,GAAG,CAAC,CAACC,oBACV,KAACjD;oBAAewF,OAAOvC;oBAAKwC,MAAK;oBAAQL,SAAQ;mBAAtCnC;;;AAInB;AACAhC,oBAAoByE,WAAW,GAAG;AAElC,OAAO,MAAMC,4BACX;IACEC,KAAK9E;IACL+E,UAAUxF;IACVqF,aAAa;IACbI,aACE;IACFpE,UAAU9B,MAAMmG,iBAAiB,CAACC,IAAI;IACtCC,MAAM;QAAEC,MAAMrG,cAAcqG,IAAI;QAAE3B,IAAI;YAAEc,OAAO;QAAiB;IAAE;IAClEc,OAAO;QAAEC,aAAaxG,MAAMyG,YAAY,CAACC,OAAO;IAAC;IACjDC,YAAY;QACV;YACEC,MAAM;YACNhB,OAAO;YACPM,aACE,oEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,mEACA,oEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACE,MAAM;YAC1C,sEAAsE;YACtE,qEAAqE;YACrE,qEAAqE;YACrE,yDAAyD;YACzDC,SAAS;mBAAIhH,MAAMiH,oCAAoC;aAAC;QAC1D;QACA;YACEL,MAAM;YACNhB,OAAO;YACPM,aACE,4DACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,8DACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,sEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,mEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,sEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,6DAA6D;YAC7D,sBAAsB;YACtBC,cAAc;QAChB;QACA;YACEP,MAAM;YACNhB,OAAO;YACPM,aACE,+DACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,6DAA6D;YAC7D,sBAAsB;YACtBC,cAAc;QAChB;QACA;YACEP,MAAM;YACNhB,OAAO;YACPM,aACE,iEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,6DAA6D;YAC7D,sBAAsB;YACtBC,cAAc;QAChB;QACA;YACEP,MAAM;YACNhB,OAAO;YACPM,aACE,oEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEF,MAAM;YACNhB,OAAO;YACPM,aACE,oEACA,qEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,sEAAsE;YACtE,qEAAqE;YACrE,cAAc;YACdC,cAAc;QAChB;QACA;YACEP,MAAM;YACNhB,OAAO;YACPM,aACE,kEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,6DAA6D;YAC7D,sBAAsB;YACtBC,cAAc;QAChB;QACA;YACEP,MAAM;YACNhB,OAAO;YACPM,aACE,oEACA;YACFpB,WAAW9E,MAAM6G,kBAAkB,CAACK,MAAM;YAC1C,gEAAgE;YAChE,+DAA+D;YAC/D,iEAAiE;YACjE,6DAA6D;YAC7D,sBAAsB;YACtBC,cAAc;QAChB;KACD;AACH,EAAC;AAEH,SAAS9F,mBAAmB,GAAE"}

package/src/lib/components/collection-presets.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @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';
+export declare const collectionPresets: Aglyn.PresetSchema[];