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

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

@@ -0,0 +1,140 @@
+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 { mdiMagnify } from "@aglyn/shared-data-mdi";
+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";
+import { SuggestSearchBox, useEntryFuse } from "./collection-search-box.js";
+// Persisted component id (AGL-551/582); the compose pipeline references it
+// through the @aglyn/aglyn constant. Never rename.
+export const SEARCH_ID = Aglyn.COLLECTION_SEARCH_COMPONENT_ID;
+/**
+ * A search box for a collection that lives where the author puts it
+ * (AGL-1516, Figma 494:1220).
+ *
+ * The entries block has had a search box since AGL-1516's first half, and it
+ * renders inside that block — first child of its own stack. The frame puts
+ * the field in the listing's TOOLBAR: category pills on the left, search and
+ * RSS on the right, one row. That was unbuildable, and unbuildable in both
+ * directions — a block's own child cannot be lifted out of it, and the pills
+ * cannot be moved in, because every child of an entries block is cloned once
+ * per entry. Three passes of authoring hit the same wall.
+ *
+ * So the field became its own block. It searches the collection the listing
+ * beside it is drawn from, and answers with the suggestion panel (496:1218)
+ * — the only behaviour a standalone box can honestly have, since it owns no
+ * cards to hide. Enter submits to the site-wide results page, so the box
+ * works with no JavaScript at all.
+ *
+ * Inert on editing surfaces, like Category Pills: the besigner has no index
+ * to search, and a field that answered there would be answering about
+ * nothing.
+ */ const CollectionSearch = /*#__PURE__*/ forwardRef((props, ref)=>{
+    // Compose-time and search-only attributes: strip so they never hit the
+    // DOM.
+    const { collectionSlug, searchPlaceholder, searchIndex, searchTotal, searchCapped } = props, rest = _object_without_properties_loose(props, [
+        "collectionSlug",
+        "searchPlaceholder",
+        "searchIndex",
+        "searchTotal",
+        "searchCapped"
+    ]);
+    // 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);
+    const { fuzzy, requestFuzzy } = useEntryFuse(searchIndex);
+    if (!suppressNavigation && !(searchIndex == null ? void 0 : searchIndex.length)) {
+        // Nothing stamped on a live surface: an unknown collection, an empty
+        // one, or a page composed before this block existed. Renders NOTHING
+        // rather than a field that can only ever answer "no matches" — that
+        // answer would read as a fact about the reader's query instead of
+        // about the absent index behind it.
+        return /*#__PURE__*/ _jsx(Box, _extends({
+            ref: ref
+        }, rest));
+    }
+    return /*#__PURE__*/ _jsx(MuiStack, _extends({
+        ref: ref
+    }, rest, {
+        sx: [
+            {
+                alignItems: 'flex-end'
+            },
+            ...nodeSx
+        ],
+        children: /*#__PURE__*/ _jsx(SuggestSearchBox, _extends({
+            fuzzy: fuzzy,
+            requestFuzzy: requestFuzzy
+        }, searchIndex ? {
+            items: searchIndex
+        } : {}, searchPlaceholder === undefined ? {} : {
+            placeholder: searchPlaceholder
+        }, suppressNavigation ? {
+            inert: true
+        } : {}, {
+            // The honest miss for THIS box. It searched one bounded read of the
+            // collection — never "the collection", and on a category route not
+            // even the whole of it, because the source arrives filtered. So it
+            // reports the number it actually looked through, and says plainly
+            // when that number was a ceiling rather than a total.
+            emptyText: (text)=>{
+                var _ref, _ref1;
+                return searchCapped ? `No matches for “${text}” in the ${(_ref = searchIndex == null ? void 0 : searchIndex.length) != null ? _ref : 0} ` + 'entries searched here — the collection holds more, which ' + 'this box has not read.' : `No matches for “${text}” in the ${(_ref1 = searchIndex == null ? void 0 : searchIndex.length) != null ? _ref1 : 0} ` + 'entries searched here.';
+            }
+        }))
+    }));
+});
+CollectionSearch.displayName = 'AglynCollectionSearch';
+export const collectionSearchSchema = {
+    $id: SEARCH_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Collection Search',
+    description: 'A search box for a content collection, with a suggestions dropdown.',
+    category: Aglyn.ComponentCategory.NAVIGATION,
+    icon: {
+        path: mdiMagnify.path,
+        sx: {
+            color: 'secondary.main'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'collectionSlug',
+            label: 'Collection slug',
+            description: 'Content collection this box searches (e.g. "blog"). Leave blank ' + 'on a list-template screen to use the collection from the URL.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        },
+        {
+            name: 'searchPlaceholder',
+            label: 'Search placeholder',
+            description: 'Hint text inside this box. Blank shows "Search posts…", which is ' + 'worth changing when the collection is not posts.',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        }
+    ]
+};
+export { CollectionSearch };
+
+//# sourceMappingURL=collection-search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-search.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 { mdiMagnify } from '@aglyn/shared-data-mdi'\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'\nimport { SuggestSearchBox, useEntryFuse } from './collection-search-box'\n\n// Persisted component id (AGL-551/582); the compose pipeline references it\n// through the @aglyn/aglyn constant. Never rename.\nexport const SEARCH_ID: Aglyn.ComponentId = Aglyn.COLLECTION_SEARCH_COMPONENT_ID\n\nexport interface CollectionSearchProps extends StackProps {\n  /**\n   * Collection whose entries this box searches (compose-time). Blank = the\n   * collection routed by the current URL on list-template screens.\n   */\n  collectionSlug?: string\n  /** Hint text inside the box (blank = \"Search posts…\"). */\n  searchPlaceholder?: string\n  /**\n   * Server-stamped matchable text per entry (`expandCollectionSearch`);\n   * never set by hand.\n   */\n  searchIndex?: Aglyn.CollectionEntrySearchItem[]\n  /** How many entries the index was drawn from; never set by hand. */\n  searchTotal?: number\n  /** Whether that read reached its bound; never set by hand. */\n  searchCapped?: boolean\n}\n\n/**\n * A search box for a collection that lives where the author puts it\n * (AGL-1516, Figma 494:1220).\n *\n * The entries block has had a search box since AGL-1516's first half, and it\n * renders inside that block — first child of its own stack. The frame puts\n * the field in the listing's TOOLBAR: category pills on the left, search and\n * RSS on the right, one row. That was unbuildable, and unbuildable in both\n * directions — a block's own child cannot be lifted out of it, and the pills\n * cannot be moved in, because every child of an entries block is cloned once\n * per entry. Three passes of authoring hit the same wall.\n *\n * So the field became its own block. It searches the collection the listing\n * beside it is drawn from, and answers with the suggestion panel (496:1218)\n * — the only behaviour a standalone box can honestly have, since it owns no\n * cards to hide. Enter submits to the site-wide results page, so the box\n * works with no JavaScript at all.\n *\n * Inert on editing surfaces, like Category Pills: the besigner has no index\n * to search, and a field that answered there would be answering about\n * nothing.\n */\nconst CollectionSearch = forwardRef<HTMLDivElement, CollectionSearchProps>(\n  (props, ref) => {\n    // Compose-time and search-only attributes: strip so they never hit the\n    // DOM.\n    const {\n      collectionSlug,\n      searchPlaceholder,\n      searchIndex,\n      searchTotal,\n      searchCapped,\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    const { fuzzy, requestFuzzy } = useEntryFuse(searchIndex)\n    if (!suppressNavigation && !searchIndex?.length) {\n      // Nothing stamped on a live surface: an unknown collection, an empty\n      // one, or a page composed before this block existed. Renders NOTHING\n      // rather than a field that can only ever answer \"no matches\" — that\n      // answer would read as a fact about the reader's query instead of\n      // about the absent index behind it.\n      return <Box ref={ref} {...rest} />\n    }\n    return (\n      <MuiStack ref={ref} {...rest} sx={[{ alignItems: 'flex-end' }, ...nodeSx]}>\n        <SuggestSearchBox\n          fuzzy={fuzzy}\n          requestFuzzy={requestFuzzy}\n          {...(searchIndex ? { items: searchIndex } : {})}\n          {...(searchPlaceholder === undefined\n            ? {}\n            : { placeholder: searchPlaceholder })}\n          {...(suppressNavigation ? { inert: true } : {})}\n          // The honest miss for THIS box. It searched one bounded read of the\n          // collection — never \"the collection\", and on a category route not\n          // even the whole of it, because the source arrives filtered. So it\n          // reports the number it actually looked through, and says plainly\n          // when that number was a ceiling rather than a total.\n          emptyText={(text) =>\n            searchCapped\n              ? `No matches for “${text}” in the ${searchIndex?.length ?? 0} ` +\n                'entries searched here — the collection holds more, which ' +\n                'this box has not read.'\n              : `No matches for “${text}” in the ${searchIndex?.length ?? 0} ` +\n                'entries searched here.'\n          }\n        />\n      </MuiStack>\n    )\n  },\n)\nCollectionSearch.displayName = 'AglynCollectionSearch'\n\nexport const collectionSearchSchema: Aglyn.ComponentSchema<CollectionSearchProps> =\n  {\n    $id: SEARCH_ID,\n    pluginId: BUNDLE_ID,\n    displayName: 'Collection Search',\n    description:\n      'A search box for a content collection, with a suggestions dropdown.',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiMagnify.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 this box searches (e.g. \"blog\"). Leave blank ' +\n          'on a list-template screen to use the collection from the URL.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      {\n        name: 'searchPlaceholder',\n        label: 'Search placeholder',\n        description:\n          'Hint text inside this box. Blank shows \"Search posts…\", which is ' +\n          'worth changing when the collection is not posts.',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n      // `searchIndex`, `searchTotal` and `searchCapped` are deliberately NOT\n      // attributes: all three are server-stamped facts about a read, and an\n      // author who could edit them could make the box lie about its own\n      // reach.\n    ],\n  }\n\nexport { CollectionSearch }\n"],"names":["Aglyn","mdiMagnify","Box","MuiStack","forwardRef","useContext","BUNDLE_ID","SuggestSearchBox","useEntryFuse","SEARCH_ID","COLLECTION_SEARCH_COMPONENT_ID","CollectionSearch","props","ref","collectionSlug","searchPlaceholder","searchIndex","searchTotal","searchCapped","rest","nodeSx","Array","isArray","suppressNavigation","ScreenLinkContext","fuzzy","requestFuzzy","length","sx","alignItems","items","undefined","placeholder","inert","emptyText","text","displayName","collectionSearchSchema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","path","color","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","label","component","FieldComponentType","TEXT_FIELD"],"mappings":";;;AAAA;;;;;;;;;;;;;;;CAeC,GAED,YAAYA,WAAW,eAAc;AACrC,SAASC,UAAU,QAAQ,yBAAwB;AACnD,OAAOC,SAAS,oBAAmB;AACnC,OAAOC,cAAmC,sBAAqB;AAC/D,SAASC,UAAU,EAAEC,UAAU,QAAQ,QAAO;AAC9C,SAASC,SAAS,QAAQ,gCAA4B;AACtD,SAASC,gBAAgB,EAAEC,YAAY,QAAQ,6BAAyB;AAExE,2EAA2E;AAC3E,mDAAmD;AACnD,OAAO,MAAMC,YAA+BT,MAAMU,8BAA8B,CAAA;AAqBhF;;;;;;;;;;;;;;;;;;;;;CAqBC,GACD,MAAMC,iCAAmBP,WACvB,CAACQ,OAAOC;IACN,uEAAuE;IACvE,OAAO;IACP,MAAM,EACJC,cAAc,EACdC,iBAAiB,EACjBC,WAAW,EACXC,WAAW,EACXC,YAAY,EAEb,GAAGN,OADCO,wCACDP;;;;;;;IACJ,yEAAyE;IACzE,MAAMQ,SAASC,MAAMC,OAAO,CAACV,KAAK,CAAC,KAAK,IAAIA,KAAK,CAAC,KAAK,GAAG;QAACA,KAAK,CAAC,KAAK;KAAC;IACvE,MAAM,EAAEW,kBAAkB,EAAE,GAAGlB,WAAWL,MAAMwB,iBAAiB;IACjE,MAAM,EAAEC,KAAK,EAAEC,YAAY,EAAE,GAAGlB,aAAaQ;IAC7C,IAAI,CAACO,sBAAsB,EAACP,+BAAAA,YAAaW,MAAM,GAAE;QAC/C,qEAAqE;QACrE,qEAAqE;QACrE,oEAAoE;QACpE,kEAAkE;QAClE,oCAAoC;QACpC,qBAAO,KAACzB;YAAIW,KAAKA;WAASM;IAC5B;IACA,qBACE,KAAChB;QAASU,KAAKA;OAASM;QAAMS,IAAI;YAAC;gBAAEC,YAAY;YAAW;eAAMT;SAAO;kBACvE,cAAA,KAACb;YACCkB,OAAOA;YACPC,cAAcA;WACTV,cAAc;YAAEc,OAAOd;QAAY,IAAI,CAAC,GACxCD,sBAAsBgB,YACvB,CAAC,IACD;YAAEC,aAAajB;QAAkB,GAChCQ,qBAAqB;YAAEU,OAAO;QAAK,IAAI,CAAC;YAC7C,oEAAoE;YACpE,mEAAmE;YACnE,mEAAmE;YACnE,kEAAkE;YAClE,sDAAsD;YACtDC,WAAW,CAACC;;uBACVjB,eACI,CAAC,gBAAgB,EAAEiB,KAAK,SAAS,UAAEnB,+BAAAA,YAAaW,MAAM,mBAAI,EAAE,CAAC,CAAC,GAC9D,8DACA,2BACA,CAAC,gBAAgB,EAAEQ,KAAK,SAAS,WAAEnB,+BAAAA,YAAaW,MAAM,oBAAI,EAAE,CAAC,CAAC,GAC9D;;;;AAKd;AAEFhB,iBAAiByB,WAAW,GAAG;AAE/B,OAAO,MAAMC,yBACX;IACEC,KAAK7B;IACL8B,UAAUjC;IACV8B,aAAa;IACbI,aACE;IACFC,UAAUzC,MAAM0C,iBAAiB,CAACC,UAAU;IAC5CC,MAAM;QAAEC,MAAM5C,WAAW4C,IAAI;QAAEjB,IAAI;YAAEkB,OAAO;QAAiB;IAAE;IAC/DC,OAAO;QAAEC,aAAahD,MAAMiD,YAAY,CAACC,OAAO;IAAC;IACjDC,YAAY;QACV;YACEC,MAAM;YACNC,OAAO;YACPb,aACE,qEACA;YACFc,WAAWtD,MAAMuD,kBAAkB,CAACC,UAAU;QAChD;QACA;YACEJ,MAAM;YACNC,OAAO;YACPb,aACE,sEACA;YACFc,WAAWtD,MAAMuD,kBAAkB,CAACC,UAAU;QAChD;KAKD;AACH,EAAC;AAEH,SAAS7C,gBAAgB,GAAE"}

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

@@ -0,0 +1,31 @@
+/**
+ * @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 SHARE_ID: Aglyn.ComponentId;
+export interface CollectionShareProps extends StackProps {
+    /** Heading before the buttons; empty string hides it. */
+    heading?: string;
+}
+/**
+ * Share buttons for the CURRENT page URL (AGL-582): X, LinkedIn, Facebook,
+ * and copy-link. Pure client behavior — the URL is read at click time so
+ * SSR and besigner renders stay markup-identical; editing surfaces no-op.
+ */
+declare const CollectionShare: import("react").ForwardRefExoticComponent<Omit<CollectionShareProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionShareSchema: Aglyn.ComponentSchema<CollectionShareProps>;
+export { CollectionShare };

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

@@ -0,0 +1,154 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * @license
+ * Copyright 2026 Aglyn LLC
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */ import * as Aglyn from "@aglyn/aglyn";
+import { mdiContentCopy, mdiFacebook, mdiLinkedin, mdiShareVariant, mdiTwitter } from "@aglyn/shared-data-mdi";
+import { MdiIcon } from "@aglyn/shared-ui-jsx";
+import IconButton from "@mui/material/IconButton";
+import MuiStack from "@mui/material/Stack";
+import Typography from "@mui/material/Typography";
+import { forwardRef, useContext, useState } 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 SHARE_ID = Aglyn.COLLECTION_SHARE_COMPONENT_ID;
+const SHARE_TARGETS = [
+    {
+        label: 'Share on X',
+        path: mdiTwitter.path,
+        href: (url)=>`https://twitter.com/intent/tweet?url=${encodeURIComponent(url)}`
+    },
+    {
+        label: 'Share on LinkedIn',
+        path: mdiLinkedin.path,
+        href: (url)=>'https://www.linkedin.com/sharing/share-offsite/?url=' + encodeURIComponent(url)
+    },
+    {
+        label: 'Share on Facebook',
+        path: mdiFacebook.path,
+        href: (url)=>`https://www.facebook.com/sharer/sharer.php?u=${encodeURIComponent(url)}`
+    }
+];
+/**
+ * Share buttons for the CURRENT page URL (AGL-582): X, LinkedIn, Facebook,
+ * and copy-link. Pure client behavior — the URL is read at click time so
+ * SSR and besigner renders stay markup-identical; editing surfaces no-op.
+ */ const CollectionShare = /*#__PURE__*/ forwardRef((props, ref)=>{
+    const { heading } = props, rest = _object_without_properties_loose(props, [
+        "heading"
+    ]);
+    // 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);
+    const [copied, setCopied] = useState(false);
+    const title = heading != null ? heading : 'Share';
+    const open = (buildHref)=>()=>{
+            if (suppressNavigation || typeof window === 'undefined') return;
+            window.open(buildHref(window.location.href), '_blank', 'noopener,noreferrer');
+        };
+    const copy = async ()=>{
+        if (suppressNavigation || typeof window === 'undefined') return;
+        try {
+            await navigator.clipboard.writeText(window.location.href);
+            setCopied(true);
+            setTimeout(()=>setCopied(false), 2000);
+        } catch (unused) {
+        // Clipboard unavailable (permissions, http) — silently skip.
+        }
+    };
+    return /*#__PURE__*/ _jsxs(MuiStack, _extends({
+        ref: ref,
+        direction: "row",
+        spacing: 0.5
+    }, rest, {
+        // MERGE, never replace (AGL-1450) — see collection-entry-meta.tsx.
+        sx: [
+            {
+                alignItems: 'center'
+            },
+            ...nodeSx
+        ],
+        children: [
+            title ? // `component="p"` because this labels a row of buttons; it is not a
+            // section heading (AGL-2486). MUI's `defaultVariantMapping` sends
+            // `subtitle2` to `<h6>`, so without this the Share Bar puts a level-6
+            // heading into the document outline of every page carrying it. On a
+            // blog post the nearest preceding heading is an `h2`, which makes it
+            // a skipped level and a `heading-order` failure.
+            //
+            // Said here rather than as a theme-wide `variantMapping` override: a
+            // default would silently change the element under every `subtitle2`
+            // in the codebase, including surfaces where an `h6` is correct.
+            /*#__PURE__*/ _jsx(Typography, {
+                component: "p",
+                variant: "subtitle2",
+                sx: {
+                    mr: 1
+                },
+                children: title
+            }) : null,
+            SHARE_TARGETS.map((target)=>/*#__PURE__*/ _jsx(IconButton, {
+                    "aria-label": target.label,
+                    size: "small",
+                    onClick: open(target.href),
+                    children: /*#__PURE__*/ _jsx(MdiIcon, {
+                        path: target.path
+                    })
+                }, target.label)),
+            /*#__PURE__*/ _jsx(IconButton, {
+                "aria-label": copied ? 'Link copied' : 'Copy link',
+                size: "small",
+                color: copied ? 'success' : 'default',
+                onClick: copy,
+                children: /*#__PURE__*/ _jsx(MdiIcon, {
+                    path: mdiContentCopy.path
+                })
+            })
+        ]
+    }));
+});
+CollectionShare.displayName = 'AglynCollectionShare';
+export const collectionShareSchema = {
+    $id: SHARE_ID,
+    pluginId: BUNDLE_ID,
+    displayName: 'Share Bar',
+    description: 'Share buttons for the current page, plus a copy link.',
+    category: Aglyn.ComponentCategory.NAVIGATION,
+    icon: {
+        path: mdiShareVariant.path,
+        sx: {
+            color: 'secondary.main'
+        }
+    },
+    flags: {
+        selfClosing: Aglyn.FEATURE_FLAG.ENABLED
+    },
+    attributes: [
+        {
+            name: 'heading',
+            label: 'Heading',
+            description: 'Text before the buttons (blank hides it).',
+            component: Aglyn.FieldComponentType.TEXT_FIELD
+        }
+    ]
+};
+export { CollectionShare };
+
+//# sourceMappingURL=collection-share.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-share.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 {\n  mdiContentCopy,\n  mdiFacebook,\n  mdiLinkedin,\n  mdiShareVariant,\n  mdiTwitter,\n} from '@aglyn/shared-data-mdi'\nimport { MdiIcon } from '@aglyn/shared-ui-jsx'\nimport IconButton from '@mui/material/IconButton'\nimport MuiStack, { type StackProps } from '@mui/material/Stack'\nimport Typography from '@mui/material/Typography'\nimport { forwardRef, useContext, useState } 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 SHARE_ID: Aglyn.ComponentId = Aglyn.COLLECTION_SHARE_COMPONENT_ID\n\nexport interface CollectionShareProps extends StackProps {\n  /** Heading before the buttons; empty string hides it. */\n  heading?: string\n}\n\nconst SHARE_TARGETS = [\n  {\n    label: 'Share on X',\n    path: mdiTwitter.path,\n    href: (url: string) =>\n      `https://twitter.com/intent/tweet?url=${encodeURIComponent(url)}`,\n  },\n  {\n    label: 'Share on LinkedIn',\n    path: mdiLinkedin.path,\n    href: (url: string) =>\n      'https://www.linkedin.com/sharing/share-offsite/?url=' +\n      encodeURIComponent(url),\n  },\n  {\n    label: 'Share on Facebook',\n    path: mdiFacebook.path,\n    href: (url: string) =>\n      `https://www.facebook.com/sharer/sharer.php?u=${encodeURIComponent(url)}`,\n  },\n]\n\n/**\n * Share buttons for the CURRENT page URL (AGL-582): X, LinkedIn, Facebook,\n * and copy-link. Pure client behavior — the URL is read at click time so\n * SSR and besigner renders stay markup-identical; editing surfaces no-op.\n */\nconst CollectionShare = forwardRef<HTMLDivElement, CollectionShareProps>(\n  (props, ref) => {\n    const { heading, ...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    const [copied, setCopied] = useState(false)\n    const title = heading ?? 'Share'\n    const open = (buildHref: (url: string) => string) => () => {\n      if (suppressNavigation || typeof window === 'undefined') return\n      window.open(\n        buildHref(window.location.href),\n        '_blank',\n        'noopener,noreferrer',\n      )\n    }\n    const copy = async () => {\n      if (suppressNavigation || typeof window === 'undefined') return\n      try {\n        await navigator.clipboard.writeText(window.location.href)\n        setCopied(true)\n        setTimeout(() => setCopied(false), 2000)\n      } catch {\n        // Clipboard unavailable (permissions, http) — silently skip.\n      }\n    }\n    return (\n      <MuiStack\n        ref={ref}\n        direction=\"row\"\n        spacing={0.5}\n        {...rest}\n        // MERGE, never replace (AGL-1450) — see collection-entry-meta.tsx.\n        sx={[{ alignItems: 'center' }, ...nodeSx]}\n      >\n        {title ? (\n          // `component=\"p\"` because this labels a row of buttons; it is not a\n          // section heading (AGL-2486). MUI's `defaultVariantMapping` sends\n          // `subtitle2` to `<h6>`, so without this the Share Bar puts a level-6\n          // heading into the document outline of every page carrying it. On a\n          // blog post the nearest preceding heading is an `h2`, which makes it\n          // a skipped level and a `heading-order` failure.\n          //\n          // Said here rather than as a theme-wide `variantMapping` override: a\n          // default would silently change the element under every `subtitle2`\n          // in the codebase, including surfaces where an `h6` is correct.\n          <Typography component=\"p\" variant=\"subtitle2\" sx={{ mr: 1 }}>\n            {title}\n          </Typography>\n        ) : null}\n        {SHARE_TARGETS.map((target) => (\n          <IconButton\n            key={target.label}\n            aria-label={target.label}\n            size=\"small\"\n            onClick={open(target.href)}\n          >\n            <MdiIcon path={target.path} />\n          </IconButton>\n        ))}\n        <IconButton\n          aria-label={copied ? 'Link copied' : 'Copy link'}\n          size=\"small\"\n          color={copied ? 'success' : 'default'}\n          onClick={copy}\n        >\n          <MdiIcon path={mdiContentCopy.path} />\n        </IconButton>\n      </MuiStack>\n    )\n  },\n)\nCollectionShare.displayName = 'AglynCollectionShare'\n\nexport const collectionShareSchema: Aglyn.ComponentSchema<CollectionShareProps> =\n  {\n    $id: SHARE_ID,\n    pluginId: BUNDLE_ID,\n    displayName: 'Share Bar',\n    description: 'Share buttons for the current page, plus a copy link.',\n    category: Aglyn.ComponentCategory.NAVIGATION,\n    icon: { path: mdiShareVariant.path, sx: { color: 'secondary.main' } },\n    flags: { selfClosing: Aglyn.FEATURE_FLAG.ENABLED },\n    attributes: [\n      {\n        name: 'heading',\n        label: 'Heading',\n        description: 'Text before the buttons (blank hides it).',\n        component: Aglyn.FieldComponentType.TEXT_FIELD,\n      },\n    ],\n  }\n\nexport { CollectionShare }\n"],"names":["Aglyn","mdiContentCopy","mdiFacebook","mdiLinkedin","mdiShareVariant","mdiTwitter","MdiIcon","IconButton","MuiStack","Typography","forwardRef","useContext","useState","BUNDLE_ID","SHARE_ID","COLLECTION_SHARE_COMPONENT_ID","SHARE_TARGETS","label","path","href","url","encodeURIComponent","CollectionShare","props","ref","heading","rest","nodeSx","Array","isArray","suppressNavigation","ScreenLinkContext","copied","setCopied","title","open","buildHref","window","location","copy","navigator","clipboard","writeText","setTimeout","direction","spacing","sx","alignItems","component","variant","mr","map","target","aria-label","size","onClick","color","displayName","collectionShareSchema","$id","pluginId","description","category","ComponentCategory","NAVIGATION","icon","flags","selfClosing","FEATURE_FLAG","ENABLED","attributes","name","FieldComponentType","TEXT_FIELD"],"mappings":"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"}