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

package/src/lib/components/collection-presets.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";
+/**
+ * @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 { mdiAccountCircleOutline, mdiMagnify, mdiNewspaperVariantOutline, mdiPostOutline, mdiShareVariant, mdiTagMultipleOutline, mdiTagOutline, mdiTextLong } from "@aglyn/shared-data-mdi";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+import { generatePresetId } from "../utils/generate-preset-id.js";
+// Every collection element's id, read from @aglyn/aglyn rather than imported
+// from the element modules: importing them would put all nine elements into
+// the chunk of the one element these presets register with.
+const ENTRIES_ID = Aglyn.COLLECTION_ENTRIES_COMPONENT_ID;
+const ENTRY_BODY_ID = Aglyn.COLLECTION_ENTRY_BODY_COMPONENT_ID;
+const RELATED_ID = Aglyn.COLLECTION_RELATED_COMPONENT_ID;
+const SHARE_ID = Aglyn.COLLECTION_SHARE_COMPONENT_ID;
+const ENTRY_META_ID = Aglyn.COLLECTION_ENTRY_META_COMPONENT_ID;
+const ENTRY_AUTHOR_ID = Aglyn.COLLECTION_ENTRY_AUTHOR_COMPONENT_ID;
+const CATEGORIES_ID = Aglyn.COLLECTION_CATEGORIES_COMPONENT_ID;
+const SEARCH_ID = Aglyn.COLLECTION_SEARCH_COMPONENT_ID;
+const AUTHOR_PROFILE_ID = Aglyn.CONTENT_AUTHOR_PROFILE_COMPONENT_ID;
+/**
+ * The collection family's palette presets. Registered with Collection
+ * Entries (`presets: 'collectionPresets'` in plugin.ts), which re-exports
+ * them; they name every collection element by id only, so none of those
+ * elements' code comes with them.
+ */ /**
+ * Styling rides the node's own `sx`, never `props.sx` (AGL-1346): both
+ * render, but only `node.sx` is the record the Styles panel can edit or
+ * clear. `Leaf` composes `node.sx` last, so this is the same result.
+ */ const entryText = (variant, children, extra)=>{
+    const _ref = extra != null ? extra : {}, { sx } = _ref, props = _object_without_properties_loose(_ref, [
+        "sx"
+    ]);
+    return _extends({
+        $id: null,
+        componentId: 'muiTypography',
+        pluginId: BUNDLE_ID,
+        props: _extends({
+            variant,
+            children
+        }, props)
+    }, sx ? {
+        sx
+    } : {});
+};
+export const collectionPresets = [
+    {
+        $id: generatePresetId(ENTRIES_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Collection Entries',
+        pluginId: BUNDLE_ID,
+        description: 'Repeats a card (title, date, excerpt, Read more) per published ' + 'entry of a content collection',
+        category: Aglyn.ComponentCategory.BLOCKS,
+        icon: {
+            path: mdiPostOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: ENTRIES_ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                spacing: 4
+            },
+            nodes: [
+                {
+                    $id: null,
+                    componentId: 'muiStack',
+                    pluginId: BUNDLE_ID,
+                    props: {
+                        spacing: 0.5
+                    },
+                    nodes: [
+                        entryText('h5', '{{entry.title}}', {
+                            component: 'h2'
+                        }),
+                        entryText('caption', '{{entry.date}}', {
+                            sx: {
+                                color: 'text.secondary'
+                            }
+                        }),
+                        entryText('body1', '{{entry.excerpt}}'),
+                        {
+                            $id: null,
+                            componentId: 'muiScreenLink',
+                            pluginId: BUNDLE_ID,
+                            props: {
+                                children: 'Read more',
+                                href: '{{entry.url}}',
+                                size: 'small'
+                            },
+                            sx: {
+                                alignSelf: 'flex-start'
+                            }
+                        }
+                    ]
+                }
+            ]
+        }
+    },
+    {
+        $id: generatePresetId(ENTRY_BODY_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Entry Body',
+        pluginId: BUNDLE_ID,
+        description: "Renders the current entry's markdown body, themed",
+        category: Aglyn.ComponentCategory.TEXT,
+        icon: {
+            path: mdiTextLong.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: ENTRY_BODY_ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                markdown: '{{entry.body}}'
+            }
+        }
+    },
+    {
+        $id: generatePresetId(RELATED_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Related Posts',
+        pluginId: BUNDLE_ID,
+        description: "Other entries sharing the current entry's category or tags",
+        category: Aglyn.ComponentCategory.DATA_DISPLAY,
+        icon: {
+            path: mdiNewspaperVariantOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: RELATED_ID,
+            pluginId: BUNDLE_ID,
+            // `layout`, the two type steps and `dateFormat` are seeded rather than
+            // left to the runtime fallback so each dropdown opens on the value the
+            // block is actually rendering, and an author who tries another has a
+            // named route back (AGL-1457/AGL-1459). The `show*` switches are
+            // deliberately absent: their unset state IS the shipped behaviour.
+            props: {
+                heading: 'Related articles',
+                limit: 3,
+                layout: 'list',
+                headingVariant: 'h5',
+                titleVariant: 'subtitle1',
+                dateFormat: Aglyn.COLLECTION_ENTRY_DATE_FORMAT_DEFAULT
+            }
+        }
+    },
+    {
+        $id: generatePresetId(SHARE_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Share Bar',
+        pluginId: BUNDLE_ID,
+        description: 'X, LinkedIn, Facebook, and copy-link buttons for the page',
+        category: Aglyn.ComponentCategory.NAVIGATION,
+        icon: {
+            path: mdiShareVariant.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: SHARE_ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                heading: 'Share'
+            }
+        }
+    },
+    {
+        $id: generatePresetId(CATEGORIES_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Category Pills',
+        pluginId: BUNDLE_ID,
+        description: "Links to each of the collection's categories, filtering the listing",
+        category: Aglyn.ComponentCategory.NAVIGATION,
+        icon: {
+            path: mdiTagMultipleOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: CATEGORIES_ID,
+            pluginId: BUNDLE_ID,
+            // Seeded, not left to the runtime default: an explicit initial value
+            // is what lets the attributes form substitute the cleared sentinel
+            // when the author empties the box (AGL-1336).
+            props: {
+                allLabel: Aglyn.COLLECTION_ALL_PILL_DEFAULT
+            }
+        }
+    },
+    {
+        // Every author-placeable component needs a preset: the element drawer is
+        // built from PRESETS alone (`ComponentManager.schemasByCategory` iterates
+        // `this.presets`), so a component with only a schema renders correctly
+        // once a node exists but can never be put on a canvas by clicking.
+        //
+        // This one earns its place in the drawer because the entries block's own
+        // search field cannot leave that block, and the toolbar row wants the
+        // search beside the category pills rather than above the entries.
+        $id: generatePresetId(SEARCH_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Collection Search',
+        pluginId: BUNDLE_ID,
+        description: 'Search box for a collection, with a dropdown of matching entries',
+        category: Aglyn.ComponentCategory.NAVIGATION,
+        icon: {
+            path: mdiMagnify.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: SEARCH_ID,
+            pluginId: BUNDLE_ID,
+            // Deliberately no seeded props. Both attributes read blank as a real
+            // choice — `collectionSlug` blank means "take the collection from the
+            // URL", which is correct on the list templates this block is for, and
+            // `searchPlaceholder` blank means the designed "Search posts…".
+            props: {}
+        }
+    },
+    {
+        $id: generatePresetId(ENTRY_META_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Entry Meta',
+        pluginId: BUNDLE_ID,
+        description: 'Author · date · category line with tag chips for the entry',
+        category: Aglyn.ComponentCategory.TEXT,
+        icon: {
+            path: mdiTagOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: ENTRY_META_ID,
+            pluginId: BUNDLE_ID,
+            props: {
+                date: '{{entry.date}}',
+                // Named rather than left to the runtime fallback (AGL-1459): the
+                // dropdown opens on the value the block is actually rendering, and
+                // an author who tries a format has a named route back. `default` is
+                // also the fallback, so naming it is the same choice, not a second.
+                dateFormat: Aglyn.COLLECTION_ENTRY_DATE_FORMAT_DEFAULT,
+                author: '{{entry.author}}',
+                category: '{{entry.category}}',
+                tags: '{{entry.tags}}'
+            }
+        }
+    },
+    {
+        $id: generatePresetId(ENTRY_AUTHOR_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Entry Author',
+        pluginId: BUNDLE_ID,
+        description: 'Portrait, byline and bio card for the entry’s author',
+        category: Aglyn.ComponentCategory.TEXT,
+        icon: {
+            path: mdiAccountCircleOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: ENTRY_AUTHOR_ID,
+            pluginId: BUNDLE_ID,
+            // Seeded EMPTY, unlike Entry Meta's preset. Those bindings predate the
+            // server fill and stay for compatibility; here the fill is the only
+            // mechanism, and a seeded `{{entry.authorImage}}` would render a broken
+            // portrait on every surface that is not an entry template.
+            props: {}
+        }
+    },
+    {
+        $id: generatePresetId(AUTHOR_PROFILE_ID),
+        type: Aglyn.NodeType.PRESET,
+        displayName: 'Author Profile',
+        pluginId: BUNDLE_ID,
+        description: 'Portrait, name, role, bio and links for an author page',
+        category: Aglyn.ComponentCategory.TEXT,
+        icon: {
+            path: mdiAccountCircleOutline.path,
+            sx: {
+                color: 'secondary.main'
+            }
+        },
+        data: {
+            $id: null,
+            componentId: AUTHOR_PROFILE_ID,
+            pluginId: BUNDLE_ID,
+            // Seeded EMPTY, for the reason the card above it is: the server fill is
+            // the only mechanism here, and a seeded `{{author.image}}` would render
+            // a broken portrait on every surface that is not an author page.
+            props: {}
+        }
+    }
+];
+
+//# sourceMappingURL=collection-presets.js.map

package/src/lib/components/collection-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-presets.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  mdiAccountCircleOutline,\n  mdiMagnify,\n  mdiNewspaperVariantOutline,\n  mdiPostOutline,\n  mdiShareVariant,\n  mdiTagMultipleOutline,\n  mdiTagOutline,\n  mdiTextLong,\n} from '@aglyn/shared-data-mdi'\nimport { BUNDLE_ID } from '../constants/bundle-common'\nimport { generatePresetId } from '../utils/generate-preset-id'\n\n// Every collection element's id, read from @aglyn/aglyn rather than imported\n// from the element modules: importing them would put all nine elements into\n// the chunk of the one element these presets register with.\nconst ENTRIES_ID = Aglyn.COLLECTION_ENTRIES_COMPONENT_ID\nconst ENTRY_BODY_ID = Aglyn.COLLECTION_ENTRY_BODY_COMPONENT_ID\nconst RELATED_ID = Aglyn.COLLECTION_RELATED_COMPONENT_ID\nconst SHARE_ID = Aglyn.COLLECTION_SHARE_COMPONENT_ID\nconst ENTRY_META_ID = Aglyn.COLLECTION_ENTRY_META_COMPONENT_ID\nconst ENTRY_AUTHOR_ID = Aglyn.COLLECTION_ENTRY_AUTHOR_COMPONENT_ID\nconst CATEGORIES_ID = Aglyn.COLLECTION_CATEGORIES_COMPONENT_ID\nconst SEARCH_ID = Aglyn.COLLECTION_SEARCH_COMPONENT_ID\nconst AUTHOR_PROFILE_ID = Aglyn.CONTENT_AUTHOR_PROFILE_COMPONENT_ID\n\n/**\n * The collection family's palette presets. Registered with Collection\n * Entries (`presets: 'collectionPresets'` in plugin.ts), which re-exports\n * them; they name every collection element by id only, so none of those\n * elements' code comes with them.\n */\n\n/**\n * Styling rides the node's own `sx`, never `props.sx` (AGL-1346): both\n * render, but only `node.sx` is the record the Styles panel can edit or\n * clear. `Leaf` composes `node.sx` last, so this is the same result.\n */\nconst entryText = (variant: string, children: string, extra?: object) => {\n  const { sx, ...props } = (extra ?? {}) as Record<string, unknown>\n  return {\n    $id: null,\n    componentId: 'muiTypography',\n    pluginId: BUNDLE_ID,\n    props: { variant, children, ...props },\n    ...(sx ? { sx } : {}),\n  }\n}\n\nexport const collectionPresets: Aglyn.PresetSchema[] = [\n  {\n    $id: generatePresetId(ENTRIES_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Collection Entries',\n    pluginId: BUNDLE_ID,\n    description:\n      'Repeats a card (title, date, excerpt, Read more) per published ' +\n      'entry of a content collection',\n    category: Aglyn.ComponentCategory.BLOCKS,\n    icon: { path: mdiPostOutline.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: ENTRIES_ID,\n      pluginId: BUNDLE_ID,\n      props: { spacing: 4 },\n      nodes: [\n        {\n          $id: null,\n          componentId: 'muiStack',\n          pluginId: BUNDLE_ID,\n          props: { spacing: 0.5 },\n          nodes: [\n            entryText('h5', '{{entry.title}}', { component: 'h2' }),\n            entryText('caption', '{{entry.date}}', {\n              sx: { color: 'text.secondary' },\n            }),\n            entryText('body1', '{{entry.excerpt}}'),\n            {\n              $id: null,\n              componentId: 'muiScreenLink',\n              pluginId: BUNDLE_ID,\n              props: {\n                children: 'Read more',\n                href: '{{entry.url}}',\n                size: 'small',\n              },\n              sx: { alignSelf: 'flex-start' },\n            },\n          ],\n        },\n      ],\n    },\n  },\n  {\n    $id: generatePresetId(ENTRY_BODY_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Entry Body',\n    pluginId: BUNDLE_ID,\n    description: \"Renders the current entry's markdown body, themed\",\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: { path: mdiTextLong.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: ENTRY_BODY_ID,\n      pluginId: BUNDLE_ID,\n      props: { markdown: '{{entry.body}}' },\n    },\n  },\n  {\n    $id: generatePresetId(RELATED_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Related Posts',\n    pluginId: BUNDLE_ID,\n    description:\n      \"Other entries sharing the current entry's category or tags\",\n    category: Aglyn.ComponentCategory.DATA_DISPLAY,\n    icon: { path: mdiNewspaperVariantOutline.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: RELATED_ID,\n      pluginId: BUNDLE_ID,\n      // `layout`, the two type steps and `dateFormat` are seeded rather than\n      // left to the runtime fallback so each dropdown opens on the value the\n      // block is actually rendering, and an author who tries another has a\n      // named route back (AGL-1457/AGL-1459). The `show*` switches are\n      // deliberately absent: their unset state IS the shipped behaviour.\n      props: {\n        heading: 'Related articles',\n        limit: 3,\n        layout: 'list',\n        headingVariant: 'h5',\n        titleVariant: 'subtitle1',\n        dateFormat: Aglyn.COLLECTION_ENTRY_DATE_FORMAT_DEFAULT,\n      },\n    },\n  },\n  {\n    $id: generatePresetId(SHARE_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Share Bar',\n    pluginId: BUNDLE_ID,\n    description: 'X, LinkedIn, Facebook, and copy-link buttons for the page',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiShareVariant.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: SHARE_ID,\n      pluginId: BUNDLE_ID,\n      props: { heading: 'Share' },\n    },\n  },\n  {\n    $id: generatePresetId(CATEGORIES_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Category Pills',\n    pluginId: BUNDLE_ID,\n    description:\n      \"Links to each of the collection's categories, filtering the listing\",\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiTagMultipleOutline.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: CATEGORIES_ID,\n      pluginId: BUNDLE_ID,\n      // Seeded, not left to the runtime default: an explicit initial value\n      // is what lets the attributes form substitute the cleared sentinel\n      // when the author empties the box (AGL-1336).\n      props: { allLabel: Aglyn.COLLECTION_ALL_PILL_DEFAULT },\n    },\n  },\n  {\n    // Every author-placeable component needs a preset: the element drawer is\n    // built from PRESETS alone (`ComponentManager.schemasByCategory` iterates\n    // `this.presets`), so a component with only a schema renders correctly\n    // once a node exists but can never be put on a canvas by clicking.\n    //\n    // This one earns its place in the drawer because the entries block's own\n    // search field cannot leave that block, and the toolbar row wants the\n    // search beside the category pills rather than above the entries.\n    $id: generatePresetId(SEARCH_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Collection Search',\n    pluginId: BUNDLE_ID,\n    description:\n      'Search box for a collection, with a dropdown of matching entries',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiMagnify.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: SEARCH_ID,\n      pluginId: BUNDLE_ID,\n      // Deliberately no seeded props. Both attributes read blank as a real\n      // choice — `collectionSlug` blank means \"take the collection from the\n      // URL\", which is correct on the list templates this block is for, and\n      // `searchPlaceholder` blank means the designed \"Search posts…\".\n      props: {},\n    },\n  },\n  {\n    $id: generatePresetId(ENTRY_META_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Entry Meta',\n    pluginId: BUNDLE_ID,\n    description: 'Author · date · category line with tag chips for the entry',\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: { path: mdiTagOutline.path, sx: { color: 'secondary.main' } },\n    data: {\n      $id: null,\n      componentId: ENTRY_META_ID,\n      pluginId: BUNDLE_ID,\n      props: {\n        date: '{{entry.date}}',\n        // Named rather than left to the runtime fallback (AGL-1459): the\n        // dropdown opens on the value the block is actually rendering, and\n        // an author who tries a format has a named route back. `default` is\n        // also the fallback, so naming it is the same choice, not a second.\n        dateFormat: Aglyn.COLLECTION_ENTRY_DATE_FORMAT_DEFAULT,\n        author: '{{entry.author}}',\n        category: '{{entry.category}}',\n        tags: '{{entry.tags}}',\n      },\n    },\n  },\n  {\n    $id: generatePresetId(ENTRY_AUTHOR_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Entry Author',\n    pluginId: BUNDLE_ID,\n    description: 'Portrait, byline and bio card for the entry’s author',\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: {\n      path: mdiAccountCircleOutline.path,\n      sx: { color: 'secondary.main' },\n    },\n    data: {\n      $id: null,\n      componentId: ENTRY_AUTHOR_ID,\n      pluginId: BUNDLE_ID,\n      // Seeded EMPTY, unlike Entry Meta's preset. Those bindings predate the\n      // server fill and stay for compatibility; here the fill is the only\n      // mechanism, and a seeded `{{entry.authorImage}}` would render a broken\n      // portrait on every surface that is not an entry template.\n      props: {},\n    },\n  },\n  {\n    $id: generatePresetId(AUTHOR_PROFILE_ID),\n    type: Aglyn.NodeType.PRESET,\n    displayName: 'Author Profile',\n    pluginId: BUNDLE_ID,\n    description: 'Portrait, name, role, bio and links for an author page',\n    category: Aglyn.ComponentCategory.TEXT,\n    icon: {\n      path: mdiAccountCircleOutline.path,\n      sx: { color: 'secondary.main' },\n    },\n    data: {\n      $id: null,\n      componentId: AUTHOR_PROFILE_ID,\n      pluginId: BUNDLE_ID,\n      // Seeded EMPTY, for the reason the card above it is: the server fill is\n      // the only mechanism here, and a seeded `{{author.image}}` would render\n      // a broken portrait on every surface that is not an author page.\n      props: {},\n    },\n  },\n]\n"],"names":["Aglyn","mdiAccountCircleOutline","mdiMagnify","mdiNewspaperVariantOutline","mdiPostOutline","mdiShareVariant","mdiTagMultipleOutline","mdiTagOutline","mdiTextLong","BUNDLE_ID","generatePresetId","ENTRIES_ID","COLLECTION_ENTRIES_COMPONENT_ID","ENTRY_BODY_ID","COLLECTION_ENTRY_BODY_COMPONENT_ID","RELATED_ID","COLLECTION_RELATED_COMPONENT_ID","SHARE_ID","COLLECTION_SHARE_COMPONENT_ID","ENTRY_META_ID","COLLECTION_ENTRY_META_COMPONENT_ID","ENTRY_AUTHOR_ID","COLLECTION_ENTRY_AUTHOR_COMPONENT_ID","CATEGORIES_ID","COLLECTION_CATEGORIES_COMPONENT_ID","SEARCH_ID","COLLECTION_SEARCH_COMPONENT_ID","AUTHOR_PROFILE_ID","CONTENT_AUTHOR_PROFILE_COMPONENT_ID","entryText","variant","children","extra","sx","props","$id","componentId","pluginId","collectionPresets","type","NodeType","PRESET","displayName","description","category","ComponentCategory","BLOCKS","icon","path","color","data","spacing","nodes","component","href","size","alignSelf","TEXT","markdown","DATA_DISPLAY","heading","limit","layout","headingVariant","titleVariant","dateFormat","COLLECTION_ENTRY_DATE_FORMAT_DEFAULT","NAVIGATION","allLabel","COLLECTION_ALL_PILL_DEFAULT","date","author","tags"],"mappings":"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"}

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

@@ -0,0 +1,101 @@
+/**
+ * @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 RELATED_ID: Aglyn.ComponentId;
+/** How the related posts are laid out (AGL-1457). */
+export type CollectionRelatedLayout = 'list' | 'cards';
+/** One related post as stamped by the compose pipeline (AGL-582). */
+export interface CollectionRelatedProps extends StackProps {
+    /** Section heading; empty string hides it. */
+    heading?: string;
+    /** Compose-time: most related posts listed (default 3). */
+    limit?: number | string;
+    /**
+     * Emit each entry's cover image (AGL-1457). OFF is the default and the
+     * shipped behaviour — the block is live on every blog entry, so turning
+     * covers on by default would restyle published pages nobody asked about.
+     */
+    showCover?: boolean;
+    /**
+     * `list` (default) is the plain-link list that has always shipped; `cards`
+     * is the article frame's grid of cover + category chip + title.
+     */
+    layout?: CollectionRelatedLayout;
+    /** Columns in the `cards` grid (default 3, the frame's 3-up). */
+    columns?: number | string;
+    /**
+     * Type step the section heading reads at (default `h5`). One of the
+     * theme's own rungs, shared with the Typography element — a heading sized
+     * by hand in the Styles panel is the pixel-typing the tokens exist to stop.
+     */
+    headingVariant?: string;
+    /**
+     * Type step each card title reads at (default `subtitle1`, what the block
+     * has always emitted). The title is the block's own markup, so the Styles
+     * panel — which edits the node's root — cannot reach it; this is the only
+     * handle on it.
+     */
+    titleVariant?: string;
+    /** Show each post's published date. On is the shipped behaviour. */
+    showDate?: boolean;
+    /**
+     * How each card's published date reads (AGL-1459) — a COMPOSE-TIME prop
+     * like {@link limit}: it is answered in `expandCollectionRelated`, where
+     * the timestamp still exists, and never reaches the DOM. Blank, or
+     * `default`, is the locale date the block has always emitted.
+     *
+     * Read here too, but only to date the SAMPLE cards: an editing surface has
+     * no routed entry and therefore no server fill, so the picker would
+     * otherwise preview nothing.
+     */
+    dateFormat?: Aglyn.CollectionEntryDateFormat;
+    /** Show each post's category. On is the shipped behaviour. */
+    showCategory?: boolean;
+    /**
+     * Show each post's excerpt. OFF is the default and the shipped behaviour:
+     * the excerpt has been stamped onto every related item since AGL-582 and
+     * rendered by nothing, so turning it on by default would add a paragraph
+     * to every published entry nobody asked about.
+     */
+    showExcerpt?: boolean;
+    /**
+     * Server-stamped related posts (`expandCollectionRelated`); never set by
+     * hand — the tenant computes it from the current entry's category/tags.
+     */
+    entries?: Aglyn.CollectionRelatedItem[];
+}
+/**
+ * Lists other entries of the same collection sharing the current entry's
+ * category or a tag (AGL-582). The tenant stamps `entries` at compose time
+ * on entry renders; without them the published site renders nothing and an
+ * editing surface renders sample cards (AGL-2486).
+ *
+ * Two layouts (AGL-1457). `list` is the plain-link list that has always
+ * shipped and stays the default — the block is live on every blog entry, so
+ * a new default would restyle published pages nobody asked about. `cards` is
+ * the article frame's grid: cover, category chip, title, at an author-set
+ * column count.
+ *
+ * The block owns its markup, so nothing inside a card is a node the Styles
+ * panel can select. Every part it renders therefore needs an attribute, or
+ * it is unauthorable by construction — which is what the type steps and the
+ * `show*` switches are (AGL-2486).
+ */
+declare const CollectionRelated: import("react").ForwardRefExoticComponent<Omit<CollectionRelatedProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionRelatedSchema: Aglyn.ComponentSchema<CollectionRelatedProps>;
+export { CollectionRelated };