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

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

@@ -0,0 +1,52 @@
+/**
+ * @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 CATEGORIES_ID: Aglyn.ComponentId;
+export interface CollectionCategoriesProps extends StackProps {
+    /**
+     * Collection whose taxonomy renders (compose-time). Blank = the collection
+     * routed by the current URL on list-template screens.
+     */
+    collectionSlug?: string;
+    /**
+     * Label for the unfiltered pill (default "All"). Clearing the field
+     * persists `Aglyn.COLLECTION_ALL_PILL_NONE`, which omits the pill —
+     * `''` cannot be stored at all (AGL-1336).
+     */
+    allLabel?: string;
+    /**
+     * Server-stamped pill links (`expandCollectionCategories`); never set by
+     * hand — the tenant builds them from the collection's categories and the
+     * routed category.
+     */
+    items?: Aglyn.CollectionCategoryLink[];
+}
+/**
+ * The category filter row for a collection listing (AGL-1321): "All" plus one
+ * pill per category, each a REAL anchor to `/{collection}/category/{slug}`.
+ *
+ * Anchors, not click handlers, and that is the whole design. A JS-only toggle
+ * would be invisible to crawlers, unopenable in a new tab, unlinkable, and
+ * unreachable without hydration — and it could not exist anyway, since the
+ * filter is resolved server-side before the page is composed. The pill the
+ * current URL selected carries `aria-current="page"`, stamped on the server so
+ * it is in the HTML rather than derived after hydration.
+ */
+declare const CollectionCategories: import("react").ForwardRefExoticComponent<Omit<CollectionCategoriesProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionCategoriesSchema: Aglyn.ComponentSchema<CollectionCategoriesProps>;
+export { CollectionCategories };

package/src/lib/components/collection-categories.js

@@ -0,0 +1,163 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Aglyn from "@aglyn/aglyn";
+import { mdiTagMultipleOutline } from "@aglyn/shared-data-mdi";
+import { AppLink } from "@aglyn/shared-ui-jsx";
+import Box from "@mui/material/Box";
+import MuiStack from "@mui/material/Stack";
+import { forwardRef, useContext } from "react";
+import { BUNDLE_ID } from "../constants/bundle-common.js";
+// Persisted component id (AGL-551/582); the compose pipeline references it
+// through the @aglyn/aglyn constant. Never rename.
+export const CATEGORIES_ID = Aglyn.COLLECTION_CATEGORIES_COMPONENT_ID;
+/** Pill look, in palette tokens so it follows the site theme in both modes. */ const pillSx = (active)=>({
+        px: 1.75,
+        py: 0.75,
+        borderRadius: 999,
+        border: '1px solid',
+        borderColor: active ? 'primary.main' : 'divider',
+        bgcolor: active ? 'primary.main' : 'transparent',
+        color: active ? 'primary.contrastText' : 'text.secondary',
+        fontSize: 14,
+        lineHeight: 1.2,
+        whiteSpace: 'nowrap',
+        '&:hover': {
+            borderColor: active ? 'primary.main' : 'text.primary',
+            color: active ? 'primary.contrastText' : 'text.primary'
+        }
+    });
+/**
+ * The category filter row for a collection listing (AGL-1321): "All" plus one
+ * pill per category, each a REAL anchor to `/{collection}/category/{slug}`.
+ *
+ * Anchors, not click handlers, and that is the whole design. A JS-only toggle
+ * would be invisible to crawlers, unopenable in a new tab, unlinkable, and
+ * unreachable without hydration — and it could not exist anyway, since the
+ * filter is resolved server-side before the page is composed. The pill the
+ * current URL selected carries `aria-current="page"`, stamped on the server so
+ * it is in the HTML rather than derived after hydration.
+ */ const CollectionCategories = /*#__PURE__*/ forwardRef((props, ref)=>{
+    // `collectionSlug`/`allLabel` are compose-time: the tenant resolves them
+    // while stamping `items`; strip so they never hit the DOM.
+    const { collectionSlug, allLabel, items } = props, rest = _object_without_properties_loose(props, [
+        "collectionSlug",
+        "allLabel",
+        "items"
+    ]);
+    // 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);
+    if (!(items == null ? void 0 : items.length)) {
+        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: 'Category pills — All + one pill per collection category render here'
+        }));
+    }
+    return /*#__PURE__*/ _jsx(MuiStack, _extends({
+        ref: ref,
+        direction: "row",
+        spacing: 1
+    }, rest, {
+        // MERGE, never replace (AGL-1450) — see collection-entry-meta.tsx.
+        sx: [
+            {
+                flexWrap: 'wrap',
+                rowGap: 1
+            },
+            ...nodeSx
+        ],
+        children: items.map((item)=>// Editing surfaces render the pill look without an href, so a click
+            // in the besigner never navigates the canvas away.
+            suppressNavigation ? /*#__PURE__*/ _jsx(Box, {
+                sx: pillSx(item.active),
+                children: item.label
+            }, item.href) : /*#__PURE__*/ _jsx(AppLink, {
+                href: item.href,
+                underline: "none",
+                "aria-current": item.active ? 'page' : undefined,
+                sx: pillSx(item.active),
+                children: item.label
+            }, item.href))
+    }));
+});
+CollectionCategories.displayName = 'AglynCollectionCategories';
+export const collectionCategoriesSchema = {
+    $id: CATEGORIES_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Category Pills',
+    description: 'A pill per collection category, each filtering the listing.',
+    category: Aglyn.ComponentCategory.NAVIGATION,
+    icon: {
+        path: mdiTagMultipleOutline.path,
+        sx: {
+            color: 'secondary.main'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'collectionSlug',
+            label: 'Collection slug',
+            description: 'Content collection whose categories render as pills (e.g. ' + '"blog"). Leave blank on a list-template screen to use the ' + 'collection from the URL.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'allLabel',
+            label: 'All label',
+            description: 'Label for the unfiltered pill, which links to the collection ' + 'root (default "All"). Clear the box to omit that pill — it then ' + 'reads "none", which is what makes the omission stick. Typing ' + '"none" does the same thing.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD,
+            // Without this the emptied field persists NOTHING (AGL-1336): ddf
+            // maps an emptied value to `clearedValue`, final-form's parse turns
+            // `''` into `undefined`, and the missing key takes the runtime
+            // default — so "clear it to omit that pill" was undoable by
+            // clicking. Same shape as FIELD_COLOR_ALT1's `'default'` (AGL-1191):
+            // a value that means something has to BE something.
+            //
+            // ddf only substitutes `clearedValue` when the field HAD an initial
+            // value (`enhancedOnChange`'s `typeof initial !== 'undefined'`),
+            // which is why its preset (collection-presets.ts) seeds `allLabel`
+            // and why the sentinel is a word an author can also type. A block
+            // that never carried the prop has an already-empty box and nothing
+            // to clear.
+            clearedValue: Aglyn.COLLECTION_ALL_PILL_NONE
+        }
+    ]
+};
+export { CollectionCategories };
+
+//# sourceMappingURL=collection-categories.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-categories.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 { mdiTagMultipleOutline } from '@aglyn/shared-data-mdi'\nimport { AppLink } from '@aglyn/shared-ui-jsx'\nimport Box from '@mui/material/Box'\nimport MuiStack, { type StackProps } from '@mui/material/Stack'\nimport { forwardRef, useContext } from 'react'\nimport { BUNDLE_ID } from '../constants/bundle-common'\n\n// Persisted component id (AGL-551/582); the compose pipeline references it\n// through the @aglyn/aglyn constant. Never rename.\nexport const CATEGORIES_ID: Aglyn.ComponentId =\n  Aglyn.COLLECTION_CATEGORIES_COMPONENT_ID\n\nexport interface CollectionCategoriesProps extends StackProps {\n  /**\n   * Collection whose taxonomy renders (compose-time). Blank = the collection\n   * routed by the current URL on list-template screens.\n   */\n  collectionSlug?: string\n  /**\n   * Label for the unfiltered pill (default \"All\"). Clearing the field\n   * persists `Aglyn.COLLECTION_ALL_PILL_NONE`, which omits the pill —\n   * `''` cannot be stored at all (AGL-1336).\n   */\n  allLabel?: string\n  /**\n   * Server-stamped pill links (`expandCollectionCategories`); never set by\n   * hand — the tenant builds them from the collection's categories and the\n   * routed category.\n   */\n  items?: Aglyn.CollectionCategoryLink[]\n}\n\n/** Pill look, in palette tokens so it follows the site theme in both modes. */\nconst pillSx = (active: boolean) => ({\n  px: 1.75,\n  py: 0.75,\n  borderRadius: 999,\n  border: '1px solid',\n  borderColor: active ? 'primary.main' : 'divider',\n  bgcolor: active ? 'primary.main' : 'transparent',\n  color: active ? 'primary.contrastText' : 'text.secondary',\n  fontSize: 14,\n  lineHeight: 1.2,\n  whiteSpace: 'nowrap',\n  '&:hover': {\n    borderColor: active ? 'primary.main' : 'text.primary',\n    color: active ? 'primary.contrastText' : 'text.primary',\n  },\n})\n\n/**\n * The category filter row for a collection listing (AGL-1321): \"All\" plus one\n * pill per category, each a REAL anchor to `/{collection}/category/{slug}`.\n *\n * Anchors, not click handlers, and that is the whole design. A JS-only toggle\n * would be invisible to crawlers, unopenable in a new tab, unlinkable, and\n * unreachable without hydration — and it could not exist anyway, since the\n * filter is resolved server-side before the page is composed. The pill the\n * current URL selected carries `aria-current=\"page\"`, stamped on the server so\n * it is in the HTML rather than derived after hydration.\n */\nconst CollectionCategories = forwardRef<\n  HTMLDivElement,\n  CollectionCategoriesProps\n>((props, ref) => {\n  // `collectionSlug`/`allLabel` are compose-time: the tenant resolves them\n  // while stamping `items`; strip so they never hit the DOM.\n  const { collectionSlug, allLabel, items, ...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  const { suppressNavigation } = useContext(Aglyn.ScreenLinkContext)\n  if (!items?.length) {\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        {'Category pills — All + one pill per collection category render here'}\n      </Box>\n    )\n  }\n  return (\n    <MuiStack\n      ref={ref}\n      direction=\"row\"\n      spacing={1}\n      {...rest}\n      // MERGE, never replace (AGL-1450) — see collection-entry-meta.tsx.\n      sx={[{ flexWrap: 'wrap', rowGap: 1 }, ...nodeSx]}\n    >\n      {items.map((item) =>\n        // Editing surfaces render the pill look without an href, so a click\n        // in the besigner never navigates the canvas away.\n        suppressNavigation ? (\n          <Box key={item.href} sx={pillSx(item.active)}>\n            {item.label}\n          </Box>\n        ) : (\n          <AppLink\n            key={item.href}\n            href={item.href}\n            underline=\"none\"\n            aria-current={item.active ? 'page' : undefined}\n            sx={pillSx(item.active)}\n          >\n            {item.label}\n          </AppLink>\n        ),\n      )}\n    </MuiStack>\n  )\n})\nCollectionCategories.displayName = 'AglynCollectionCategories'\n\nexport const collectionCategoriesSchema: Aglyn.ComponentSchema<CollectionCategoriesProps> =\n  {\n    $id: CATEGORIES_ID,\n    pluginId: BUNDLE_ID,\n    displayName: 'Category Pills',\n    description: 'A pill per collection category, each filtering the listing.',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiTagMultipleOutline.path, sx: { color: 'secondary.main' } },\n    flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n    attributes: [\n      {\n        name: 'collectionSlug',\n        label: 'Collection slug',\n        description:\n          'Content collection whose categories render as pills (e.g. ' +\n          '\"blog\"). Leave blank on a list-template screen to use the ' +\n          'collection from the URL.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'allLabel',\n        label: 'All label',\n        description:\n          'Label for the unfiltered pill, which links to the collection ' +\n          'root (default \"All\"). Clear the box to omit that pill — it then ' +\n          'reads \"none\", which is what makes the omission stick. Typing ' +\n          '\"none\" does the same thing.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n        // Without this the emptied field persists NOTHING (AGL-1336): ddf\n        // maps an emptied value to `clearedValue`, final-form's parse turns\n        // `''` into `undefined`, and the missing key takes the runtime\n        // default — so \"clear it to omit that pill\" was undoable by\n        // clicking. Same shape as FIELD_COLOR_ALT1's `'default'` (AGL-1191):\n        // a value that means something has to BE something.\n        //\n        // ddf only substitutes `clearedValue` when the field HAD an initial\n        // value (`enhancedOnChange`'s `typeof initial !== 'undefined'`),\n        // which is why its preset (collection-presets.ts) seeds `allLabel`\n        // and why the sentinel is a word an author can also type. A block\n        // that never carried the prop has an already-empty box and nothing\n        // to clear.\n        clearedValue: Aglyn.COLLECTION_ALL_PILL_NONE,\n      },\n    ],\n  }\n\nexport { CollectionCategories }\n"],"names":["Aglyn","mdiTagMultipleOutline","AppLink","Box","MuiStack","forwardRef","useContext","BUNDLE_ID","CATEGORIES_ID","COLLECTION_CATEGORIES_COMPONENT_ID","pillSx","active","px","py","borderRadius","border","borderColor","bgcolor","color","fontSize","lineHeight","whiteSpace","CollectionCategories","props","ref","collectionSlug","allLabel","items","rest","nodeSx","Array","isArray","suppressNavigation","ScreenLinkContext","length","sx","p","fontFamily","direction","spacing","flexWrap","rowGap","map","item","label","href","underline","aria-current","undefined","displayName","collectionCategoriesSchema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","path","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","component","FieldComponentType","TEXT_FIELD","clearedValue","COLLECTION_ALL_PILL_NONE"],"mappings":"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"}

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

@@ -0,0 +1,104 @@
+/**
+ * @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.
+ */
+/**
+ * What the collection elements share (AGL-3401): the sample values the entry
+ * blocks preview with on editing surfaces, and the guards on an author href.
+ *
+ * The nine elements were one module, and the element tier loaded all of them
+ * — 68 KB with the fuzzy matcher — for a page placing any one. Each is its
+ * own module now, so a page downloads the ones it places. What two of them
+ * need lives here, or, when it draws markup only some of them render, in
+ * `collection-search-box.tsx` (Entries, Search) and
+ * `collection-author-links.tsx` (Entry Author, Author Profile) — so that
+ * Entry Meta does not carry ten platform marks, nor Category Pills an input.
+ *
+ * Each element's persisted id is declared in its own module rather than here:
+ * this module is in every one of their chunks, and an id reads its constant
+ * from the module that defines it, so nine ids here were nine modules of
+ * `@aglyn/aglyn` in every chunk (AGL-3401).
+ */
+/** A still-unresolved `{{token}}` (no entry context on this render). */
+export declare const UNRESOLVED_TOKEN: RegExp;
+/**
+ * The instant the sample cards are dated. A FIXED one, never `Date.now()`:
+ * the canvas has to render the same bytes every time it opens, and this is
+ * the date the Date-format labels use as their worked example — so the
+ * dropdown and the cards it previews agree word for word.
+ */
+export declare const RELATED_SAMPLE_PUBLISHED_AT: {
+    seconds: number;
+};
+/** Category chip text for the sample cards; names the field, not a taxonomy. */
+export declare const RELATED_SAMPLE_CATEGORY = "Category";
+/**
+ * THE SAMPLE VALUES THE ENTRY BLOCKS PREVIEW WITH (AGL-2486).
+ *
+ * Entry Meta and Entry Author resolve FROM the routed entry, and a besigner
+ * canvas has no routed entry — so both drew a one-line dashed strip and an
+ * author styling a byline or an author card was styling something they could
+ * not see. Related Posts had the same gap and was answered the same way: the
+ * block's REAL markup, at the author's own settings, on editing surfaces
+ * only.
+ *
+ * These two need no "this is a sample" notice the way the related CARDS do.
+ * A card carries a title, a cover and a category, which is what a real post
+ * looks like; a byline reading `Sample author` says what it is in the words
+ * themselves, and a notice above a single line of caption text would be
+ * taller than the thing it labels.
+ *
+ * The date is a FIXED instant, never `Date.now()`: the canvas has to render
+ * the same bytes every time it opens, and it is the same instant the related
+ * sample uses, so two blocks on one template never disagree about what day
+ * their example is.
+ */
+export declare const ENTRY_SAMPLE_PUBLISHED_AT: {
+    seconds: number;
+};
+/** Byline name for the samples; names the field rather than a person. */
+export declare const ENTRY_SAMPLE_AUTHOR = "Sample author";
+/** Category text for the samples; names the field, not a taxonomy. */
+export declare const ENTRY_SAMPLE_CATEGORY = "Category";
+/** Two chips, so the row previews its own wrapping and gap. */
+export declare const ENTRY_SAMPLE_TAGS = "first tag, second tag";
+/** Bio line for the author-card sample; one sentence, as a real one is. */
+export declare const ENTRY_SAMPLE_BIO = "The bio from this author\u2019s record reads here, in a line or two.";
+/**
+ * The portrait STAND-IN, for a sample that has no image to resolve.
+ *
+ * A neutral plate rather than nothing, and for the reason the related sample
+ * draws its cover slot: on an entry template the portrait arrives from the
+ * author record at render, so the slot is exactly what the author is sizing
+ * and spacing. `aria-hidden` because it depicts nothing.
+ */
+export declare const samplePortraitSx: (size: number) => {
+    width: number;
+    height: number;
+    flexShrink: number;
+    borderRadius: string;
+    backgroundColor: string;
+};
+/** Unresolved tokens render empty on the site, literal in the besigner. */
+export declare const metaValue: (value: string | undefined, suppressNavigation: boolean | undefined) => string;
+/**
+ * What the byline may link to — an absolute `https:` page, or a route on this
+ * site. The Social Links block guards its hrefs the same way and for the same
+ * reason: the value comes from a stored record, so `javascript:` and friends
+ * have to be unreachable rather than merely unlikely.
+ */
+export declare const SAFE_AUTHOR_HREF: RegExp;
+/** An off-site author page opens in a new tab; a route on this site does not. */
+export declare const EXTERNAL_AUTHOR_HREF: RegExp;

package/src/lib/components/collection-common.js

@@ -0,0 +1,95 @@
+/**
+ * @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.
+ */ /**
+ * What the collection elements share (AGL-3401): the sample values the entry
+ * blocks preview with on editing surfaces, and the guards on an author href.
+ *
+ * The nine elements were one module, and the element tier loaded all of them
+ * — 68 KB with the fuzzy matcher — for a page placing any one. Each is its
+ * own module now, so a page downloads the ones it places. What two of them
+ * need lives here, or, when it draws markup only some of them render, in
+ * `collection-search-box.tsx` (Entries, Search) and
+ * `collection-author-links.tsx` (Entry Author, Author Profile) — so that
+ * Entry Meta does not carry ten platform marks, nor Category Pills an input.
+ *
+ * Each element's persisted id is declared in its own module rather than here:
+ * this module is in every one of their chunks, and an id reads its constant
+ * from the module that defines it, so nine ids here were nine modules of
+ * `@aglyn/aglyn` in every chunk (AGL-3401).
+ */ /** A still-unresolved `{{token}}` (no entry context on this render). */ export const UNRESOLVED_TOKEN = /^\{\{[^}]+\}\}$/;
+/**
+ * The instant the sample cards are dated. A FIXED one, never `Date.now()`:
+ * the canvas has to render the same bytes every time it opens, and this is
+ * the date the Date-format labels use as their worked example — so the
+ * dropdown and the cards it previews agree word for word.
+ */ export const RELATED_SAMPLE_PUBLISHED_AT = {
+    seconds: Date.UTC(2026, 7, 9) / 1000
+};
+/** Category chip text for the sample cards; names the field, not a taxonomy. */ export const RELATED_SAMPLE_CATEGORY = 'Category';
+/**
+ * THE SAMPLE VALUES THE ENTRY BLOCKS PREVIEW WITH (AGL-2486).
+ *
+ * Entry Meta and Entry Author resolve FROM the routed entry, and a besigner
+ * canvas has no routed entry — so both drew a one-line dashed strip and an
+ * author styling a byline or an author card was styling something they could
+ * not see. Related Posts had the same gap and was answered the same way: the
+ * block's REAL markup, at the author's own settings, on editing surfaces
+ * only.
+ *
+ * These two need no "this is a sample" notice the way the related CARDS do.
+ * A card carries a title, a cover and a category, which is what a real post
+ * looks like; a byline reading `Sample author` says what it is in the words
+ * themselves, and a notice above a single line of caption text would be
+ * taller than the thing it labels.
+ *
+ * The date is a FIXED instant, never `Date.now()`: the canvas has to render
+ * the same bytes every time it opens, and it is the same instant the related
+ * sample uses, so two blocks on one template never disagree about what day
+ * their example is.
+ */ export const ENTRY_SAMPLE_PUBLISHED_AT = RELATED_SAMPLE_PUBLISHED_AT;
+/** Byline name for the samples; names the field rather than a person. */ export const ENTRY_SAMPLE_AUTHOR = 'Sample author';
+/** Category text for the samples; names the field, not a taxonomy. */ export const ENTRY_SAMPLE_CATEGORY = RELATED_SAMPLE_CATEGORY;
+/** Two chips, so the row previews its own wrapping and gap. */ export const ENTRY_SAMPLE_TAGS = 'first tag, second tag';
+/** Bio line for the author-card sample; one sentence, as a real one is. */ export const ENTRY_SAMPLE_BIO = 'The bio from this author’s record reads here, in a line or two.';
+/**
+ * The portrait STAND-IN, for a sample that has no image to resolve.
+ *
+ * A neutral plate rather than nothing, and for the reason the related sample
+ * draws its cover slot: on an entry template the portrait arrives from the
+ * author record at render, so the slot is exactly what the author is sizing
+ * and spacing. `aria-hidden` because it depicts nothing.
+ */ export const samplePortraitSx = (size)=>({
+        width: size,
+        height: size,
+        flexShrink: 0,
+        borderRadius: '50%',
+        backgroundColor: 'action.hover'
+    });
+/** Unresolved tokens render empty on the site, literal in the besigner. */ export const metaValue = (value, suppressNavigation)=>{
+    const trimmed = (value != null ? value : '').trim();
+    if (!trimmed) return '';
+    if (UNRESOLVED_TOKEN.test(trimmed) && !suppressNavigation) return '';
+    return trimmed;
+};
+/**
+ * What the byline may link to — an absolute `https:` page, or a route on this
+ * site. The Social Links block guards its hrefs the same way and for the same
+ * reason: the value comes from a stored record, so `javascript:` and friends
+ * have to be unreachable rather than merely unlikely.
+ */ export const SAFE_AUTHOR_HREF = /^(https:\/\/|\/(?!\/))/i;
+/** An off-site author page opens in a new tab; a route on this site does not. */ export const EXTERNAL_AUTHOR_HREF = /^https:\/\//i;
+
+//# sourceMappingURL=collection-common.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-common.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\n/**\n * What the collection elements share (AGL-3401): the sample values the entry\n * blocks preview with on editing surfaces, and the guards on an author href.\n *\n * The nine elements were one module, and the element tier loaded all of them\n * — 68 KB with the fuzzy matcher — for a page placing any one. Each is its\n * own module now, so a page downloads the ones it places. What two of them\n * need lives here, or, when it draws markup only some of them render, in\n * `collection-search-box.tsx` (Entries, Search) and\n * `collection-author-links.tsx` (Entry Author, Author Profile) — so that\n * Entry Meta does not carry ten platform marks, nor Category Pills an input.\n *\n * Each element's persisted id is declared in its own module rather than here:\n * this module is in every one of their chunks, and an id reads its constant\n * from the module that defines it, so nine ids here were nine modules of\n * `@aglyn/aglyn` in every chunk (AGL-3401).\n */\n\n/** A still-unresolved `{{token}}` (no entry context on this render). */\nexport const UNRESOLVED_TOKEN = /^\\{\\{[^}]+\\}\\}$/\n\n/**\n * The instant the sample cards are dated. A FIXED one, never `Date.now()`:\n * the canvas has to render the same bytes every time it opens, and this is\n * the date the Date-format labels use as their worked example — so the\n * dropdown and the cards it previews agree word for word.\n */\nexport const RELATED_SAMPLE_PUBLISHED_AT = { seconds: Date.UTC(2026, 7, 9) / 1000 }\n\n/** Category chip text for the sample cards; names the field, not a taxonomy. */\nexport const RELATED_SAMPLE_CATEGORY = 'Category'\n\n/**\n * THE SAMPLE VALUES THE ENTRY BLOCKS PREVIEW WITH (AGL-2486).\n *\n * Entry Meta and Entry Author resolve FROM the routed entry, and a besigner\n * canvas has no routed entry — so both drew a one-line dashed strip and an\n * author styling a byline or an author card was styling something they could\n * not see. Related Posts had the same gap and was answered the same way: the\n * block's REAL markup, at the author's own settings, on editing surfaces\n * only.\n *\n * These two need no \"this is a sample\" notice the way the related CARDS do.\n * A card carries a title, a cover and a category, which is what a real post\n * looks like; a byline reading `Sample author` says what it is in the words\n * themselves, and a notice above a single line of caption text would be\n * taller than the thing it labels.\n *\n * The date is a FIXED instant, never `Date.now()`: the canvas has to render\n * the same bytes every time it opens, and it is the same instant the related\n * sample uses, so two blocks on one template never disagree about what day\n * their example is.\n */\nexport const ENTRY_SAMPLE_PUBLISHED_AT = RELATED_SAMPLE_PUBLISHED_AT\n\n/** Byline name for the samples; names the field rather than a person. */\nexport const ENTRY_SAMPLE_AUTHOR = 'Sample author'\n\n/** Category text for the samples; names the field, not a taxonomy. */\nexport const ENTRY_SAMPLE_CATEGORY = RELATED_SAMPLE_CATEGORY\n\n/** Two chips, so the row previews its own wrapping and gap. */\nexport const ENTRY_SAMPLE_TAGS = 'first tag, second tag'\n\n/** Bio line for the author-card sample; one sentence, as a real one is. */\nexport const ENTRY_SAMPLE_BIO =\n  'The bio from this author’s record reads here, in a line or two.'\n\n/**\n * The portrait STAND-IN, for a sample that has no image to resolve.\n *\n * A neutral plate rather than nothing, and for the reason the related sample\n * draws its cover slot: on an entry template the portrait arrives from the\n * author record at render, so the slot is exactly what the author is sizing\n * and spacing. `aria-hidden` because it depicts nothing.\n */\nexport const samplePortraitSx = (size: number) => ({\n  width: size,\n  height: size,\n  flexShrink: 0,\n  borderRadius: '50%',\n  backgroundColor: 'action.hover',\n})\n\n/** Unresolved tokens render empty on the site, literal in the besigner. */\nexport const metaValue = (\n  value: string | undefined,\n  suppressNavigation: boolean | undefined,\n): string => {\n  const trimmed = (value ?? '').trim()\n  if (!trimmed) return ''\n  if (UNRESOLVED_TOKEN.test(trimmed) && !suppressNavigation) return ''\n  return trimmed\n}\n\n/**\n * What the byline may link to — an absolute `https:` page, or a route on this\n * site. The Social Links block guards its hrefs the same way and for the same\n * reason: the value comes from a stored record, so `javascript:` and friends\n * have to be unreachable rather than merely unlikely.\n */\nexport const SAFE_AUTHOR_HREF = /^(https:\\/\\/|\\/(?!\\/))/i\n\n/** An off-site author page opens in a new tab; a route on this site does not. */\nexport const EXTERNAL_AUTHOR_HREF = /^https:\\/\\//i\n"],"names":["UNRESOLVED_TOKEN","RELATED_SAMPLE_PUBLISHED_AT","seconds","Date","UTC","RELATED_SAMPLE_CATEGORY","ENTRY_SAMPLE_PUBLISHED_AT","ENTRY_SAMPLE_AUTHOR","ENTRY_SAMPLE_CATEGORY","ENTRY_SAMPLE_TAGS","ENTRY_SAMPLE_BIO","samplePortraitSx","size","width","height","flexShrink","borderRadius","backgroundColor","metaValue","value","suppressNavigation","trimmed","trim","test","SAFE_AUTHOR_HREF","EXTERNAL_AUTHOR_HREF"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;;;;;;;CAgBC,GAED,sEAAsE,GACtE,OAAO,MAAMA,mBAAmB,kBAAiB;AAEjD;;;;;CAKC,GACD,OAAO,MAAMC,8BAA8B;IAAEC,SAASC,KAAKC,GAAG,CAAC,MAAM,GAAG,KAAK;AAAK,EAAC;AAEnF,8EAA8E,GAC9E,OAAO,MAAMC,0BAA0B,WAAU;AAEjD;;;;;;;;;;;;;;;;;;;;CAoBC,GACD,OAAO,MAAMC,4BAA4BL,4BAA2B;AAEpE,uEAAuE,GACvE,OAAO,MAAMM,sBAAsB,gBAAe;AAElD,oEAAoE,GACpE,OAAO,MAAMC,wBAAwBH,wBAAuB;AAE5D,6DAA6D,GAC7D,OAAO,MAAMI,oBAAoB,wBAAuB;AAExD,yEAAyE,GACzE,OAAO,MAAMC,mBACX,kEAAiE;AAEnE;;;;;;;CAOC,GACD,OAAO,MAAMC,mBAAmB,CAACC,OAAkB,CAAA;QACjDC,OAAOD;QACPE,QAAQF;QACRG,YAAY;QACZC,cAAc;QACdC,iBAAiB;IACnB,CAAA,EAAE;AAEF,yEAAyE,GACzE,OAAO,MAAMC,YAAY,CACvBC,OACAC;IAEA,MAAMC,UAAU,CAACF,gBAAAA,QAAS,IAAIG,IAAI;IAClC,IAAI,CAACD,SAAS,OAAO;IACrB,IAAIrB,iBAAiBuB,IAAI,CAACF,YAAY,CAACD,oBAAoB,OAAO;IAClE,OAAOC;AACT,EAAC;AAED;;;;;CAKC,GACD,OAAO,MAAMG,mBAAmB,0BAAyB;AAEzD,+EAA+E,GAC/E,OAAO,MAAMC,uBAAuB,eAAc"}

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

@@ -0,0 +1,137 @@
+/**
+ * @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 ENTRIES_ID: Aglyn.ComponentId;
+export interface CollectionEntriesProps extends StackProps {
+    /**
+     * Collection to repeat over (compose-time, AGL-551). Blank = the
+     * collection routed by the current URL on list-template screens.
+     */
+    collectionSlug?: string;
+    /** Maximum entries rendered (compose-time; blank = all, capped at 100). */
+    entriesLimit?: number | string;
+    /**
+     * Only entries in this category repeat (compose-time, AGL-582).
+     * Matches the collection's category by stable id or display name.
+     */
+    filterCategory?: string;
+    /** Only entries carrying this tag repeat (compose-time, AGL-582). */
+    filterTag?: string;
+    /**
+     * Entries per page (compose-time, AGL-620). When set, the block renders one
+     * page window instead of the top `entriesLimit`; the built-in collection
+     * list uses this with the `page` from `/{collection}/page/{n}`.
+     */
+    perPage?: number | string;
+    /** 1-based page for `perPage` (compose-time, AGL-620). */
+    page?: number | string;
+    /**
+     * Render this block only on page 1 of the routed listing (compose-time,
+     * AGL-1871). For a LEAD card — a block with no `perPage`, showing the top
+     * of the set — every `/{collection}/page/{n}` past the first otherwise
+     * repeats the identical entry above a page of different ones.
+     *
+     * Opt-in and default off: a block that legitimately belongs on every page
+     * of a listing (a "popular posts" rail) has exactly the same shape.
+     */
+    firstPageOnly?: boolean;
+    /**
+     * Show a search box that filters the RENDERED entries by title/excerpt as
+     * the reader types (AGL-1516, Figma 494:1220). Opt-in and default off, so
+     * every existing instance renders exactly as before.
+     *
+     * Client-evaluated over the entries this block already holds — the page is
+     * ISR-cached, so a keystroke never costs a Firestore read. That set is
+     * whatever the expansion left the block holding, which paging, an
+     * `entriesLimit` or the 100-entry cap can each cut down. A truncated block
+     * says so under its results either way — on a miss and on a hit
+     * (AGL-1516, AGL-2569) — rather than pretending global search.
+     */
+    search?: boolean;
+    /**
+     * What the search box DOES with a query (AGL-1525, Figma 496:1218).
+     *
+     * - `filter` (default, and the reading of an absent value) — hides the
+     *   non-matching cards in place. What AGL-1516 shipped.
+     * - `suggest` — the card grid stays exactly as it was and a floating panel
+     *   of matching entries opens under the field, ending in a link to the
+     *   site-wide results page. The frame's toolbar behaviour: a reader
+     *   skimming the list is not made to lose it to a typo.
+     */
+    searchMode?: CollectionSearchMode;
+    /** Hint text inside the search box (blank = "Search posts…"). */
+    searchPlaceholder?: string;
+    /**
+     * Server-stamped matchable text per rendered entry
+     * (`expandCollectionEntries`, AGL-1516); never set by hand.
+     */
+    searchIndex?: Aglyn.CollectionEntrySearchItem[];
+    /**
+     * How many entries `searchIndex` was drawn from — server-stamped by
+     * `expandCollectionEntries` alongside it (AGL-1516), never set by hand.
+     * `searchIndex.length < searchTotal` is the only honest test of whether
+     * this block holds the whole set; `perPage` is not, because
+     * `entriesLimit` and the 100-entry cap truncate too.
+     */
+    searchTotal?: number;
+    /**
+     * Whether the read behind `searchTotal` reached its own bound — server-
+     * stamped beside it (AGL-1516), never set by hand.
+     *
+     * `searchTotal` is a count of what the server SAW, and the collection read
+     * is limited. Without this flag a block holding 100 of 400 posts satisfies
+     * `searchIndex.length === searchTotal` and renders the one empty state that
+     * claims to have looked everywhere.
+     */
+    searchCapped?: boolean;
+}
+/** The two things the toolbar search box can do (AGL-1516/AGL-1525). */
+export type CollectionSearchMode = 'filter' | 'suggest';
+/**
+ * Author-facing choices for {@link CollectionEntriesProps.searchMode}.
+ *
+ * Both values are truthy on purpose (AGL-1453): `''` cannot survive a save,
+ * so an author who tried the other mode would have no route back. "Filter"
+ * carries the absent-value reading, which is what every block published
+ * before AGL-1525 has.
+ */
+export declare const COLLECTION_SEARCH_MODE_OPTIONS: ReadonlyArray<{
+    value: CollectionSearchMode;
+    label: string;
+}>;
+/**
+ * Repeats its children once per published entry of a content collection
+ * (AGL-551) — the collections sibling of the dataset repeatable. The tenant
+ * expands it at compose time with `{{entry.*}}` tokens; in the besigner the
+ * template renders once with literal tokens, matching the repeatable UX.
+ *
+ * Search (AGL-1516): with `search` on, a toolbar search box filters the
+ * rendered entry clones client-side against the server-stamped
+ * `searchIndex` — fuzzy, via the same Fuse the icon picker uses. The clones
+ * arrive as `children` in stamp order, one group of template roots per
+ * entry, so group N of the children IS entry N of the index. Matches keep
+ * the list's own order rather than Fuse's score order: a blog list is
+ * chronological, and search narrows it, it does not reshuffle it. In the
+ * besigner the field renders as an inert affordance (the template renders
+ * once with literal tokens and there is no index to search), matching how
+ * Category Pills go inert on editing surfaces.
+ */
+declare const CollectionEntries: import("react").ForwardRefExoticComponent<Omit<CollectionEntriesProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionEntriesSchema: Aglyn.ComponentSchema<CollectionEntriesProps>;
+export { CollectionEntries };
+export { collectionPresets } from './collection-presets';