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

package/src/lib/components/collection-search-box.d.ts

@@ -0,0 +1,92 @@
+/**
+ * @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 { Fuse } from '@aglyn/shared-util-vendor/fuse';
+/** What a built index can be searched by — Fuse over the stamped rows. */
+type EntryFuse = InstanceType<typeof Fuse<Aglyn.CollectionEntrySearchItem>>;
+/**
+ * The fuzzy matcher, fetched the first time a reader types into a collection
+ * search box (AGL-3401) — one fetch per visit, however many boxes ask.
+ *
+ * It was a static import, and `fuse.js` is 26 KB of the 68 KB this module
+ * weighed: every page that placed ANY collection element downloaded and
+ * parsed it, including the many whose entries block has no search at all and
+ * the rest, where most visitors never type. The box itself still renders on
+ * the server; only the matcher waits for a query.
+ *
+ * A failed fetch (offline, a deploy mid-visit) is forgotten rather than
+ * cached, so the next keystroke tries again instead of the box going dead.
+ */
+export declare const loadCollectionFuse: () => Promise<typeof Fuse>;
+/**
+ * The Fuse index over `items`, and the call that asks for the matcher.
+ *
+ * `fuzzy` is null until the first `requestFuzzy()` has resolved — a box
+ * nobody typed into never builds an index. A box mounted after another one
+ * loaded the matcher starts with it, so a second search on the page answers
+ * its first keystroke synchronously.
+ */
+export declare const useEntryFuse: (items: readonly Aglyn.CollectionEntrySearchItem[] | undefined) => {
+    fuzzy: EntryFuse | null;
+    requestFuzzy: () => void;
+};
+/**
+ * The frame's search input (Figma 494:1220) — the magnify glyph and a bare
+ * `InputBase` on the quiet surface token.
+ *
+ * Presentational and stateless, so the entries block's in-place filter and
+ * the standalone toolbar box (AGL-1516) are the SAME field rather than two
+ * that merely look alike. `inert` is the editing-surface rendering: read-only
+ * and handler-free, so a click or stray keystroke in the besigner never edits
+ * state the canvas cannot use — how Category Pills go inert there too.
+ */
+export declare const SearchField: ({ value, placeholder, inert, landmark, onQuery, onEscape, }: {
+    value: string;
+    placeholder?: string;
+    inert?: boolean;
+    /**
+     * Put `role="search"` on the FIELD. False when a wrapping form carries it
+     * instead — one search landmark per box, or a screen reader announces the
+     * same field twice.
+     */
+    landmark?: boolean;
+    onQuery?: (next: string) => void;
+    onEscape?: () => void;
+}) => import("react").JSX.Element;
+/**
+ * Field plus dropdown, in a REAL form (AGL-1525) — so Enter reaches the
+ * results page and the box still works with the panel's JS doing nothing at
+ * all. The panel is an enhancement over a working search box, not the search
+ * box.
+ *
+ * Owns the query, because nothing outside it needs one: `suggest` never
+ * touches the cards underneath. That is what lets the standalone toolbar
+ * block exist at all (AGL-1516) — a box with no clones to hide is a complete
+ * feature, not a crippled one.
+ */
+export declare const SuggestSearchBox: ({ fuzzy, requestFuzzy, items, placeholder, inert, emptyText, }: {
+    /** Null until the matcher has loaded; see {@link useEntryFuse}. */
+    fuzzy: EntryFuse | null;
+    /** Asks for the matcher; called on every query, a no-op once it is here. */
+    requestFuzzy: () => void;
+    items?: readonly Aglyn.CollectionEntrySearchItem[];
+    placeholder?: string;
+    inert?: boolean;
+    /** The honest miss for the set THIS box searched. */
+    emptyText: (query: string) => string;
+}) => import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,334 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+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 { mdiMagnify } from "@aglyn/shared-data-mdi";
+import { AppLink, MdiIcon } from "@aglyn/shared-ui-jsx";
+import Box from "@mui/material/Box";
+import Chip from "@mui/material/Chip";
+import InputBase from "@mui/material/InputBase";
+import MuiStack from "@mui/material/Stack";
+import Typography from "@mui/material/Typography";
+import { useMemo, useState } from "react";
+/**
+ * The search box the Collection Entries block and the standalone Collection
+ * Search block both draw (AGL-1516/AGL-1525), and the fuzzy matcher behind
+ * it. Its own module so the other collection elements carry neither the MUI
+ * input nor the panel (AGL-3401); the matcher itself is fetched only when a
+ * reader types.
+ */ /** The toolbar search field, from the frame (Figma 494:1220). */ const SEARCH_FIELD_WIDTH = 240;
+/** Suggestion panel (Figma 496:1218). */ const SUGGESTION_PANEL_WIDTH = 420;
+/**
+ * Rows in the panel before it stops. The frame shows five; the sixth row is
+ * always the "View all results" link, which is the honest overflow answer —
+ * a scrolling suggestion panel is a worse results page.
+ */ const SUGGESTION_LIMIT = 5;
+/** Where "View all results" goes — the reserved site-search route (AGL-88). */ const searchResultsHref = (query)=>`/search?q=${encodeURIComponent(query)}`;
+/**
+ * The frame's compact filled field: magnify glyph + hint on the quiet
+ * surface token, right-aligned so it sits where the toolbar row puts it.
+ * Palette tokens only, so it follows the site theme in both modes.
+ */ const searchFieldSx = {
+    alignSelf: 'flex-end',
+    display: 'flex',
+    alignItems: 'center',
+    gap: 1,
+    px: 1.5,
+    py: 0.75,
+    borderRadius: 2,
+    bgcolor: 'action.hover',
+    color: 'text.secondary',
+    width: SEARCH_FIELD_WIDTH,
+    maxWidth: '100%'
+};
+/**
+ * The positioned parent of the suggestion panel (AGL-1525). It takes over
+ * `alignSelf` from the field so the toolbar row is unchanged — the panel
+ * hangs off the field, it does not move it.
+ */ const suggestionAnchorSx = {
+    alignSelf: 'flex-end',
+    position: 'relative',
+    width: SEARCH_FIELD_WIDTH,
+    maxWidth: '100%'
+};
+/**
+ * The floating panel itself. Right-aligned to the field it drops from, and
+ * wider than it, as the frame draws it — a suggestion row carries a title, a
+ * chip, a date and a line of excerpt, none of which fit in 240px.
+ *
+ * Palette and shadow tokens only, so it follows the site theme in both
+ * modes rather than pinning a light-mode card onto a dark page.
+ */ const suggestionPanelSx = {
+    position: 'absolute',
+    top: 'calc(100% + 8px)',
+    right: 0,
+    zIndex: 10,
+    width: SUGGESTION_PANEL_WIDTH,
+    // Never wider than the viewport on a phone, where the anchor is narrow
+    // and `right: 0` would otherwise hang the panel off the left edge.
+    maxWidth: 'calc(100vw - 32px)',
+    bgcolor: 'background.paper',
+    color: 'text.primary',
+    border: 1,
+    borderColor: 'divider',
+    borderRadius: 2,
+    boxShadow: 6,
+    overflow: 'hidden',
+    textAlign: 'left'
+};
+const suggestionRowLinkSx = {
+    display: 'block',
+    color: 'inherit',
+    '&:hover': {
+        bgcolor: 'action.hover'
+    }
+};
+const suggestionFooterSx = {
+    display: 'block',
+    px: 2,
+    py: 1.25,
+    borderTop: 1,
+    borderColor: 'divider',
+    bgcolor: 'action.hover',
+    fontSize: 14,
+    fontWeight: 500
+};
+/** The matcher's constructor, once something has asked for it. */ let loadedFuse;
+let fuseLoad;
+/**
+ * The fuzzy matcher, fetched the first time a reader types into a collection
+ * search box (AGL-3401) — one fetch per visit, however many boxes ask.
+ *
+ * It was a static import, and `fuse.js` is 26 KB of the 68 KB this module
+ * weighed: every page that placed ANY collection element downloaded and
+ * parsed it, including the many whose entries block has no search at all and
+ * the rest, where most visitors never type. The box itself still renders on
+ * the server; only the matcher waits for a query.
+ *
+ * A failed fetch (offline, a deploy mid-visit) is forgotten rather than
+ * cached, so the next keystroke tries again instead of the box going dead.
+ */ export const loadCollectionFuse = ()=>fuseLoad != null ? fuseLoad : fuseLoad = import("./collection-search-fuse.js").then((module)=>loadedFuse = module.Fuse, (error)=>{
+        fuseLoad = undefined;
+        throw error;
+    });
+/**
+ * The Fuse index over `items`, and the call that asks for the matcher.
+ *
+ * `fuzzy` is null until the first `requestFuzzy()` has resolved — a box
+ * nobody typed into never builds an index. A box mounted after another one
+ * loaded the matcher starts with it, so a second search on the page answers
+ * its first keystroke synchronously.
+ */ export const useEntryFuse = (items)=>{
+    const [FuseConstructor, setFuseConstructor] = useState(()=>loadedFuse);
+    const fuzzy = useMemo(()=>FuseConstructor && (items == null ? void 0 : items.length) ? // results page the suggestion panel links to — a query the panel
+        // forgave must not come back empty from "View all results".
+        new FuseConstructor(items, _extends({}, Aglyn.COLLECTION_SEARCH_FUSE_OPTIONS)) : null, [
+        FuseConstructor,
+        items
+    ]);
+    const requestFuzzy = ()=>{
+        if (FuseConstructor) return;
+        loadCollectionFuse().then((loaded)=>setFuseConstructor(()=>loaded), // The box keeps working as a form that submits to `/search`; the next
+        // keystroke asks again.
+        ()=>undefined);
+    };
+    return {
+        fuzzy,
+        requestFuzzy
+    };
+};
+/**
+ * The frame's search input (Figma 494:1220) — the magnify glyph and a bare
+ * `InputBase` on the quiet surface token.
+ *
+ * Presentational and stateless, so the entries block's in-place filter and
+ * the standalone toolbar box (AGL-1516) are the SAME field rather than two
+ * that merely look alike. `inert` is the editing-surface rendering: read-only
+ * and handler-free, so a click or stray keystroke in the besigner never edits
+ * state the canvas cannot use — how Category Pills go inert there too.
+ */ export const SearchField = ({ value, placeholder, inert, landmark, onQuery, onEscape })=>/*#__PURE__*/ _jsxs(Box, _extends({}, landmark ? {
+        role: 'search'
+    } : {}, {
+        sx: searchFieldSx,
+        children: [
+            /*#__PURE__*/ _jsx(MdiIcon, {
+                path: mdiMagnify.path
+            }),
+            /*#__PURE__*/ _jsx(InputBase, _extends({
+                value: value,
+                name: "q",
+                placeholder: (placeholder != null ? placeholder : '').trim() || 'Search posts…',
+                inputProps: {
+                    'aria-label': 'Search entries'
+                },
+                sx: {
+                    flex: 1,
+                    fontSize: 14,
+                    color: 'text.primary'
+                }
+            }, inert ? {
+                readOnly: true
+            } : {
+                onChange: (event)=>onQuery == null ? void 0 : onQuery(event.target.value),
+                onKeyDown: (event)=>{
+                    if (event.key === 'Escape') onEscape == null ? void 0 : onEscape();
+                }
+            }))
+        ]
+    }));
+/**
+ * The floating suggestion panel (AGL-1525, Figma 496:1218) — rows straight
+ * off the server-stamped index, and a "View all results" link that is there
+ * hits or no hits.
+ *
+ * `emptyText` is the caller's, not this component's, and that is the whole
+ * point of it being a parameter: a page-windowed entries block and a
+ * whole-collection toolbar box searched different sets, and a miss has to say
+ * WHICH set came back empty. A shared "No matches." would let one of them
+ * claim a reach it never had.
+ */ const SuggestionPanel = ({ suggestions, trimmed, emptyText })=>/*#__PURE__*/ _jsxs(Box, {
+        sx: suggestionPanelSx,
+        children: [
+            suggestions.length ? suggestions.map((item, index)=>{
+                const row = /*#__PURE__*/ _jsxs(MuiStack, {
+                    spacing: 0.5,
+                    sx: {
+                        px: 2,
+                        py: 1.25
+                    },
+                    children: [
+                        /*#__PURE__*/ _jsxs(MuiStack, {
+                            direction: "row",
+                            spacing: 1,
+                            sx: {
+                                alignItems: 'center'
+                            },
+                            children: [
+                                /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "subtitle2",
+                                    sx: {
+                                        color: 'text.primary'
+                                    },
+                                    children: item.title
+                                }),
+                                item.category ? /*#__PURE__*/ _jsx(Chip, {
+                                    label: item.category,
+                                    size: "small"
+                                }) : null,
+                                item.date ? /*#__PURE__*/ _jsx(Typography, {
+                                    variant: "caption",
+                                    sx: {
+                                        color: 'text.secondary'
+                                    },
+                                    children: item.date
+                                }) : null
+                            ]
+                        }),
+                        item.excerpt ? /*#__PURE__*/ _jsx(Typography, {
+                            variant: "body2",
+                            sx: {
+                                color: 'text.secondary',
+                                // One line of excerpt, as the frame draws it. A row that
+                                // grows with the prose turns the panel into a page.
+                                overflow: 'hidden',
+                                textOverflow: 'ellipsis',
+                                whiteSpace: 'nowrap'
+                            },
+                            children: item.excerpt
+                        }) : null
+                    ]
+                });
+                // A row without a `url` is a page cached before AGL-1525 stamped one,
+                // or a slugless entry. It renders as TEXT rather than as a link to
+                // nowhere: a suggestion that navigates to the wrong page is worse
+                // than one the reader has to read.
+                return item.url ? /*#__PURE__*/ _jsx(AppLink, {
+                    href: item.url,
+                    sx: suggestionRowLinkSx,
+                    underline: "none",
+                    children: row
+                }, index) : /*#__PURE__*/ _jsx(Box, {
+                    children: row
+                }, index);
+            }) : /*#__PURE__*/ _jsx(Typography, {
+                variant: "body2",
+                sx: {
+                    color: 'text.secondary',
+                    px: 2,
+                    py: 1.25
+                },
+                children: emptyText
+            }),
+            /*#__PURE__*/ _jsx(AppLink, {
+                href: searchResultsHref(trimmed),
+                sx: suggestionFooterSx,
+                underline: "none",
+                children: `View all results for “${trimmed}” →`
+            })
+        ]
+    });
+/**
+ * Field plus dropdown, in a REAL form (AGL-1525) — so Enter reaches the
+ * results page and the box still works with the panel's JS doing nothing at
+ * all. The panel is an enhancement over a working search box, not the search
+ * box.
+ *
+ * Owns the query, because nothing outside it needs one: `suggest` never
+ * touches the cards underneath. That is what lets the standalone toolbar
+ * block exist at all (AGL-1516) — a box with no clones to hide is a complete
+ * feature, not a crippled one.
+ */ export const SuggestSearchBox = ({ fuzzy, requestFuzzy, items, placeholder, inert, emptyText })=>{
+    const [query, setQuery] = useState('');
+    /** Escape dismissed THIS answer (AGL-1525); typing brings it back. */ const [closed, setClosed] = useState(false);
+    const trimmed = query.trim();
+    const suggestions = !inert && trimmed && fuzzy && items ? fuzzy.search(trimmed).slice(0, SUGGESTION_LIMIT).map((result)=>items[result.refIndex]).filter(Boolean) : [];
+    const field = /*#__PURE__*/ _jsx(SearchField, _extends({
+        value: query
+    }, placeholder === undefined ? {} : {
+        placeholder
+    }, inert ? {
+        inert: true,
+        landmark: true
+    } : {}, {
+        onQuery: (next)=>{
+            requestFuzzy();
+            setQuery(next);
+            // A new query reopens a panel the reader dismissed — Escape closes
+            // THIS answer, it does not turn the feature off for the visit.
+            setClosed(false);
+        },
+        onEscape: ()=>setClosed(true)
+    }));
+    if (inert) return field;
+    return /*#__PURE__*/ _jsxs(Box, {
+        component: "form",
+        role: "search",
+        action: "/search",
+        method: "get",
+        sx: suggestionAnchorSx,
+        children: [
+            field,
+            trimmed && !closed && fuzzy ? /*#__PURE__*/ _jsx(SuggestionPanel, {
+                suggestions: suggestions,
+                trimmed: trimmed,
+                emptyText: emptyText(trimmed)
+            }) : null
+        ]
+    });
+};
+
+//# sourceMappingURL=collection-search-box.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-search-box.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 { AppLink, MdiIcon } from '@aglyn/shared-ui-jsx'\n// The icon picker's fuzzy matcher (use-mdi-icons-fuzzy), not a re-implementation\n// (AGL-1516): search here has to feel like search does everywhere else in the\n// product, and two matchers is how they drift. A TYPE here: the matcher itself\n// is fetched on a reader's first keystroke — see `loadCollectionFuse`.\nimport type { Fuse } from '@aglyn/shared-util-vendor/fuse'\nimport Box from '@mui/material/Box'\nimport Chip from '@mui/material/Chip'\nimport InputBase from '@mui/material/InputBase'\nimport MuiStack from '@mui/material/Stack'\nimport Typography from '@mui/material/Typography'\nimport { useMemo, useState } from 'react'\n\n/**\n * The search box the Collection Entries block and the standalone Collection\n * Search block both draw (AGL-1516/AGL-1525), and the fuzzy matcher behind\n * it. Its own module so the other collection elements carry neither the MUI\n * input nor the panel (AGL-3401); the matcher itself is fetched only when a\n * reader types.\n */\n\n/** The toolbar search field, from the frame (Figma 494:1220). */\nconst SEARCH_FIELD_WIDTH = 240\n\n/** Suggestion panel (Figma 496:1218). */\nconst SUGGESTION_PANEL_WIDTH = 420\n\n/**\n * Rows in the panel before it stops. The frame shows five; the sixth row is\n * always the \"View all results\" link, which is the honest overflow answer —\n * a scrolling suggestion panel is a worse results page.\n */\nconst SUGGESTION_LIMIT = 5\n\n/** Where \"View all results\" goes — the reserved site-search route (AGL-88). */\nconst searchResultsHref = (query: string) =>\n  `/search?q=${encodeURIComponent(query)}`\n\n/**\n * The frame's compact filled field: magnify glyph + hint on the quiet\n * surface token, right-aligned so it sits where the toolbar row puts it.\n * Palette tokens only, so it follows the site theme in both modes.\n */\nconst searchFieldSx = {\n  alignSelf: 'flex-end',\n  display: 'flex',\n  alignItems: 'center',\n  gap: 1,\n  px: 1.5,\n  py: 0.75,\n  borderRadius: 2,\n  bgcolor: 'action.hover',\n  color: 'text.secondary',\n  width: SEARCH_FIELD_WIDTH,\n  maxWidth: '100%',\n}\n\n/**\n * The positioned parent of the suggestion panel (AGL-1525). It takes over\n * `alignSelf` from the field so the toolbar row is unchanged — the panel\n * hangs off the field, it does not move it.\n */\nconst suggestionAnchorSx = {\n  alignSelf: 'flex-end',\n  position: 'relative',\n  width: SEARCH_FIELD_WIDTH,\n  maxWidth: '100%',\n}\n\n/**\n * The floating panel itself. Right-aligned to the field it drops from, and\n * wider than it, as the frame draws it — a suggestion row carries a title, a\n * chip, a date and a line of excerpt, none of which fit in 240px.\n *\n * Palette and shadow tokens only, so it follows the site theme in both\n * modes rather than pinning a light-mode card onto a dark page.\n */\nconst suggestionPanelSx = {\n  position: 'absolute',\n  top: 'calc(100% + 8px)',\n  right: 0,\n  zIndex: 10,\n  width: SUGGESTION_PANEL_WIDTH,\n  // Never wider than the viewport on a phone, where the anchor is narrow\n  // and `right: 0` would otherwise hang the panel off the left edge.\n  maxWidth: 'calc(100vw - 32px)',\n  bgcolor: 'background.paper',\n  color: 'text.primary',\n  border: 1,\n  borderColor: 'divider',\n  borderRadius: 2,\n  boxShadow: 6,\n  overflow: 'hidden',\n  textAlign: 'left',\n}\n\nconst suggestionRowLinkSx = {\n  display: 'block',\n  color: 'inherit',\n  '&:hover': { bgcolor: 'action.hover' },\n}\n\nconst suggestionFooterSx = {\n  display: 'block',\n  px: 2,\n  py: 1.25,\n  borderTop: 1,\n  borderColor: 'divider',\n  bgcolor: 'action.hover',\n  fontSize: 14,\n  fontWeight: 500,\n}\n\n/** What a built index can be searched by — Fuse over the stamped rows. */\ntype EntryFuse = InstanceType<typeof Fuse<Aglyn.CollectionEntrySearchItem>>\n\n/** The matcher's constructor, once something has asked for it. */\nlet loadedFuse: typeof Fuse | undefined\nlet fuseLoad: Promise<typeof Fuse> | undefined\n\n/**\n * The fuzzy matcher, fetched the first time a reader types into a collection\n * search box (AGL-3401) — one fetch per visit, however many boxes ask.\n *\n * It was a static import, and `fuse.js` is 26 KB of the 68 KB this module\n * weighed: every page that placed ANY collection element downloaded and\n * parsed it, including the many whose entries block has no search at all and\n * the rest, where most visitors never type. The box itself still renders on\n * the server; only the matcher waits for a query.\n *\n * A failed fetch (offline, a deploy mid-visit) is forgotten rather than\n * cached, so the next keystroke tries again instead of the box going dead.\n */\nexport const loadCollectionFuse = (): Promise<typeof Fuse> =>\n  (fuseLoad ??= import('./collection-search-fuse').then(\n    (module) => (loadedFuse = module.Fuse),\n    (error: unknown) => {\n      fuseLoad = undefined\n      throw error\n    },\n  ))\n\n/**\n * The Fuse index over `items`, and the call that asks for the matcher.\n *\n * `fuzzy` is null until the first `requestFuzzy()` has resolved — a box\n * nobody typed into never builds an index. A box mounted after another one\n * loaded the matcher starts with it, so a second search on the page answers\n * its first keystroke synchronously.\n */\nexport const useEntryFuse = (\n  items: readonly Aglyn.CollectionEntrySearchItem[] | undefined,\n): { fuzzy: EntryFuse | null; requestFuzzy: () => void } => {\n  const [FuseConstructor, setFuseConstructor] = useState<\n    typeof Fuse | undefined\n  >(() => loadedFuse)\n  const fuzzy = useMemo(\n    () =>\n      FuseConstructor && items?.length\n        ? // The ONE matcher config (AGL-1525), shared with the site-wide\n          // results page the suggestion panel links to — a query the panel\n          // forgave must not come back empty from \"View all results\".\n          new FuseConstructor(items, { ...Aglyn.COLLECTION_SEARCH_FUSE_OPTIONS })\n        : null,\n    [FuseConstructor, items],\n  )\n  const requestFuzzy = () => {\n    if (FuseConstructor) return\n    loadCollectionFuse().then(\n      (loaded) => setFuseConstructor(() => loaded),\n      // The box keeps working as a form that submits to `/search`; the next\n      // keystroke asks again.\n      () => undefined,\n    )\n  }\n  return { fuzzy, requestFuzzy }\n}\n\n/**\n * The frame's search input (Figma 494:1220) — the magnify glyph and a bare\n * `InputBase` on the quiet surface token.\n *\n * Presentational and stateless, so the entries block's in-place filter and\n * the standalone toolbar box (AGL-1516) are the SAME field rather than two\n * that merely look alike. `inert` is the editing-surface rendering: read-only\n * and handler-free, so a click or stray keystroke in the besigner never edits\n * state the canvas cannot use — how Category Pills go inert there too.\n */\nexport const SearchField = ({\n  value,\n  placeholder,\n  inert,\n  landmark,\n  onQuery,\n  onEscape,\n}: {\n  value: string\n  placeholder?: string\n  inert?: boolean\n  /**\n   * Put `role=\"search\"` on the FIELD. False when a wrapping form carries it\n   * instead — one search landmark per box, or a screen reader announces the\n   * same field twice.\n   */\n  landmark?: boolean\n  onQuery?: (next: string) => void\n  onEscape?: () => void\n}) => (\n  <Box {...(landmark ? { role: 'search' } : {})} sx={searchFieldSx}>\n    <MdiIcon path={mdiMagnify.path} />\n    <InputBase\n      value={value}\n      name=\"q\"\n      placeholder={(placeholder ?? '').trim() || 'Search posts…'}\n      inputProps={{ 'aria-label': 'Search entries' }}\n      sx={{ flex: 1, fontSize: 14, color: 'text.primary' }}\n      {...(inert\n        ? { readOnly: true }\n        : {\n            onChange: (event) => onQuery?.(event.target.value),\n            onKeyDown: (event) => {\n              if (event.key === 'Escape') onEscape?.()\n            },\n          })}\n    />\n  </Box>\n)\n\n/**\n * The floating suggestion panel (AGL-1525, Figma 496:1218) — rows straight\n * off the server-stamped index, and a \"View all results\" link that is there\n * hits or no hits.\n *\n * `emptyText` is the caller's, not this component's, and that is the whole\n * point of it being a parameter: a page-windowed entries block and a\n * whole-collection toolbar box searched different sets, and a miss has to say\n * WHICH set came back empty. A shared \"No matches.\" would let one of them\n * claim a reach it never had.\n */\nconst SuggestionPanel = ({\n  suggestions,\n  trimmed,\n  emptyText,\n}: {\n  suggestions: readonly Aglyn.CollectionEntrySearchItem[]\n  trimmed: string\n  emptyText: string\n}) => (\n  <Box sx={suggestionPanelSx}>\n    {suggestions.length ? (\n      suggestions.map((item, index) => {\n        const row = (\n          <MuiStack spacing={0.5} sx={{ px: 2, py: 1.25 }}>\n            <MuiStack direction=\"row\" spacing={1} sx={{ alignItems: 'center' }}>\n              <Typography variant=\"subtitle2\" sx={{ color: 'text.primary' }}>\n                {item.title}\n              </Typography>\n              {item.category ? (\n                <Chip label={item.category} size=\"small\" />\n              ) : null}\n              {item.date ? (\n                <Typography variant=\"caption\" sx={{ color: 'text.secondary' }}>\n                  {item.date}\n                </Typography>\n              ) : null}\n            </MuiStack>\n            {item.excerpt ? (\n              <Typography\n                variant=\"body2\"\n                sx={{\n                  color: 'text.secondary',\n                  // One line of excerpt, as the frame draws it. A row that\n                  // grows with the prose turns the panel into a page.\n                  overflow: 'hidden',\n                  textOverflow: 'ellipsis',\n                  whiteSpace: 'nowrap',\n                }}\n              >\n                {item.excerpt}\n              </Typography>\n            ) : null}\n          </MuiStack>\n        )\n        // A row without a `url` is a page cached before AGL-1525 stamped one,\n        // or a slugless entry. It renders as TEXT rather than as a link to\n        // nowhere: a suggestion that navigates to the wrong page is worse\n        // than one the reader has to read.\n        return item.url ? (\n          <AppLink\n            key={index}\n            href={item.url}\n            sx={suggestionRowLinkSx}\n            underline=\"none\"\n          >\n            {row}\n          </AppLink>\n        ) : (\n          <Box key={index}>{row}</Box>\n        )\n      })\n    ) : (\n      <Typography\n        variant=\"body2\"\n        sx={{ color: 'text.secondary', px: 2, py: 1.25 }}\n      >\n        {emptyText}\n      </Typography>\n    )}\n    {/*\n      Always present, hits or no hits (Figma 496:1218). A box that searches\n      one page, or one bounded read of a collection, cannot answer \"then\n      where is it?\" on its own — the site-wide results page is the only\n      honest answer, and it matters most in exactly the case where the panel\n      came back empty.\n    */}\n    <AppLink\n      href={searchResultsHref(trimmed)}\n      sx={suggestionFooterSx}\n      underline=\"none\"\n    >\n      {`View all results for “${trimmed}” →`}\n    </AppLink>\n  </Box>\n)\n\n/**\n * Field plus dropdown, in a REAL form (AGL-1525) — so Enter reaches the\n * results page and the box still works with the panel's JS doing nothing at\n * all. The panel is an enhancement over a working search box, not the search\n * box.\n *\n * Owns the query, because nothing outside it needs one: `suggest` never\n * touches the cards underneath. That is what lets the standalone toolbar\n * block exist at all (AGL-1516) — a box with no clones to hide is a complete\n * feature, not a crippled one.\n */\nexport const SuggestSearchBox = ({\n  fuzzy,\n  requestFuzzy,\n  items,\n  placeholder,\n  inert,\n  emptyText,\n}: {\n  /** Null until the matcher has loaded; see {@link useEntryFuse}. */\n  fuzzy: EntryFuse | null\n  /** Asks for the matcher; called on every query, a no-op once it is here. */\n  requestFuzzy: () => void\n  items?: readonly Aglyn.CollectionEntrySearchItem[]\n  placeholder?: string\n  inert?: boolean\n  /** The honest miss for the set THIS box searched. */\n  emptyText: (query: string) => string\n}) => {\n  const [query, setQuery] = useState('')\n  /** Escape dismissed THIS answer (AGL-1525); typing brings it back. */\n  const [closed, setClosed] = useState(false)\n  const trimmed = query.trim()\n  const suggestions =\n    !inert && trimmed && fuzzy && items\n      ? fuzzy\n          .search(trimmed)\n          .slice(0, SUGGESTION_LIMIT)\n          .map((result) => items[result.refIndex])\n          .filter(Boolean)\n      : []\n  const field = (\n    <SearchField\n      value={query}\n      {...(placeholder === undefined ? {} : { placeholder })}\n      // No form wraps the inert field, so the landmark belongs on it.\n      {...(inert ? { inert: true, landmark: true } : {})}\n      onQuery={(next) => {\n        requestFuzzy()\n        setQuery(next)\n        // A new query reopens a panel the reader dismissed — Escape closes\n        // THIS answer, it does not turn the feature off for the visit.\n        setClosed(false)\n      }}\n      onEscape={() => setClosed(true)}\n    />\n  )\n  if (inert) return field\n  return (\n    <Box\n      component=\"form\"\n      role=\"search\"\n      action=\"/search\"\n      method=\"get\"\n      sx={suggestionAnchorSx}\n    >\n      {field}\n      {/*\n        Not until the matcher is here: a panel drawn in the moment it takes\n        to arrive would say \"No matches\" about a query nothing has searched.\n      */}\n      {trimmed && !closed && fuzzy ? (\n        <SuggestionPanel\n          suggestions={suggestions}\n          trimmed={trimmed}\n          emptyText={emptyText(trimmed)}\n        />\n      ) : null}\n    </Box>\n  )\n}\n"],"names":["Aglyn","mdiMagnify","AppLink","MdiIcon","Box","Chip","InputBase","MuiStack","Typography","useMemo","useState","SEARCH_FIELD_WIDTH","SUGGESTION_PANEL_WIDTH","SUGGESTION_LIMIT","searchResultsHref","query","encodeURIComponent","searchFieldSx","alignSelf","display","alignItems","gap","px","py","borderRadius","bgcolor","color","width","maxWidth","suggestionAnchorSx","position","suggestionPanelSx","top","right","zIndex","border","borderColor","boxShadow","overflow","textAlign","suggestionRowLinkSx","suggestionFooterSx","borderTop","fontSize","fontWeight","loadedFuse","fuseLoad","loadCollectionFuse","then","module","Fuse","error","undefined","useEntryFuse","items","FuseConstructor","setFuseConstructor","fuzzy","length","COLLECTION_SEARCH_FUSE_OPTIONS","requestFuzzy","loaded","SearchField","value","placeholder","inert","landmark","onQuery","onEscape","role","sx","path","name","trim","inputProps","flex","readOnly","onChange","event","target","onKeyDown","key","SuggestionPanel","suggestions","trimmed","emptyText","map","item","index","row","spacing","direction","variant","title","category","label","size","date","excerpt","textOverflow","whiteSpace","url","href","underline","SuggestSearchBox","setQuery","closed","setClosed","search","slice","result","refIndex","filter","Boolean","field","next","component","action","method"],"mappings":"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"}

package/src/lib/components/collection-search-fuse.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @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.
+ */
+/**
+ * The fuzzy matcher a collection search box fetches on its first keystroke
+ * (AGL-3401), behind a module of this package's own.
+ *
+ * `collection-search-box` `import()`s THIS file rather than the vendor
+ * package itself. The chunk is the same either way, but a dynamic import of
+ * another project is a lazy edge in the Nx graph, and because the apps load
+ * this plugin lazily too, every static import of `@aglyn/shared-util-vendor`
+ * in the console and the tenant became "a static import of a lazy-loaded
+ * library" — a lint error in files that never touch Fuse.
+ */
+export { Fuse } from '@aglyn/shared-util-vendor/fuse';

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

@@ -0,0 +1,28 @@
+/**
+ * @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.
+ */ /**
+ * The fuzzy matcher a collection search box fetches on its first keystroke
+ * (AGL-3401), behind a module of this package's own.
+ *
+ * `collection-search-box` `import()`s THIS file rather than the vendor
+ * package itself. The chunk is the same either way, but a dynamic import of
+ * another project is a lazy edge in the Nx graph, and because the apps load
+ * this plugin lazily too, every static import of `@aglyn/shared-util-vendor`
+ * in the console and the tenant became "a static import of a lazy-loaded
+ * library" — a lint error in files that never touch Fuse.
+ */ export { Fuse } from "@aglyn/shared-util-vendor/fuse";
+
+//# sourceMappingURL=collection-search-fuse.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../../libs/plugins/mui/src/lib/components/collection-search-fuse.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 * The fuzzy matcher a collection search box fetches on its first keystroke\n * (AGL-3401), behind a module of this package's own.\n *\n * `collection-search-box` `import()`s THIS file rather than the vendor\n * package itself. The chunk is the same either way, but a dynamic import of\n * another project is a lazy edge in the Nx graph, and because the apps load\n * this plugin lazily too, every static import of `@aglyn/shared-util-vendor`\n * in the console and the tenant became \"a static import of a lazy-loaded\n * library\" — a lint error in files that never touch Fuse.\n */\nexport { Fuse } from '@aglyn/shared-util-vendor/fuse'\n"],"names":["Fuse"],"mappings":"AAAA;;;;;;;;;;;;;;;CAeC,GAED;;;;;;;;;;CAUC,GACD,SAASA,IAAI,QAAQ,iCAAgC"}

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

@@ -0,0 +1,62 @@
+/**
+ * @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 SEARCH_ID: Aglyn.ComponentId;
+export interface CollectionSearchProps extends StackProps {
+    /**
+     * Collection whose entries this box searches (compose-time). Blank = the
+     * collection routed by the current URL on list-template screens.
+     */
+    collectionSlug?: string;
+    /** Hint text inside the box (blank = "Search posts…"). */
+    searchPlaceholder?: string;
+    /**
+     * Server-stamped matchable text per entry (`expandCollectionSearch`);
+     * never set by hand.
+     */
+    searchIndex?: Aglyn.CollectionEntrySearchItem[];
+    /** How many entries the index was drawn from; never set by hand. */
+    searchTotal?: number;
+    /** Whether that read reached its bound; never set by hand. */
+    searchCapped?: boolean;
+}
+/**
+ * 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.
+ */
+declare const CollectionSearch: import("react").ForwardRefExoticComponent<Omit<CollectionSearchProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export declare const collectionSearchSchema: Aglyn.ComponentSchema<CollectionSearchProps>;
+export { CollectionSearch };