@aglyn/aglyn 1.0.0-beta.258 → 1.0.0-beta.260

package/src/lib/app-utils/element-motion.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @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 { type AnimationEase, type AnimationPreset } from './element-animation';
+/**
+ * Entrance motion for a whole page (AGL-3838): the pass that writes the
+ * existing animation props (`element-animation.ts`) onto a page built by
+ * code — a starter, a new site's home, a page the AI composed — so it moves
+ * the way an author would have set it up by hand in the attributes panel.
+ *
+ * Nothing new is rendered or shipped: the pass only writes the reserved
+ * `aglynAnimation*` props the renderer and the tenant's stylesheet already
+ * read, with values from their own vocabulary. A page that moves pays the
+ * stylesheet and the scroll observer it always paid; a page this pass leaves
+ * alone pays nothing.
+ *
+ * ## The rules
+ *
+ *  - The FIRST section's secondary content — its eyebrow, its lede, its
+ *    buttons, a small picture — plays on `load`, as a short ladder: each
+ *    block starts {@link ElementMotionCharacter.heroStepMs} after the one
+ *    before. Its main heading and its largest picture, the candidates for the
+ *    page's Largest Contentful Paint, never move: they are painted where
+ *    they stand from the first frame. Its band — a background color or a
+ *    cover photo — never moves either.
+ *  - Every later section's content slides in on `scroll`.
+ *  - A group of like items — a grid of cards, a list, the questions of an
+ *    FAQ, a dataset repeated over one card — STAGGERS its items, one after
+ *    another, rather than arriving as one block.
+ *  - A picture, and a group whose items each lead with one, takes the
+ *    character's media preset.
+ *  - Never touched: forms and their fields, navigation and the site's frame,
+ *    anything out of the flow (`position: fixed | sticky | absolute` — a
+ *    cover photo's backdrop is its band's), anything hidden, and
+ *    anything that already carries an animation prop — an author's choice,
+ *    `none` included, is never overwritten. A block that HOLDS one of those
+ *    is not animated as a whole either; its other children are animated one
+ *    by one instead, so a form never slides in with its section.
+ *  - Never nested: once a block animates, nothing inside it does. Two
+ *    entrances on the same pixels multiply their fades and add their
+ *    offsets, which reads as a stutter, not as motion.
+ *
+ * Pure and idempotent: a page it already moved comes back as the same
+ * object, which is what lets a caller compare by identity to skip a write.
+ *
+ * Leaf imports only, the same as `starter-template-nodes.ts`: the starter
+ * kit reads this from the console's client gallery and its seed route alike.
+ */
+/** A page's motion: the presets, curve and timing every entrance on it shares. */
+export interface ElementMotionCharacter {
+    /** Words and blocks: a section's content, a group of cards. */
+    preset: AnimationPreset;
+    /** A picture, or a group whose every item leads with one. */
+    mediaPreset: AnimationPreset;
+    ease: AnimationEase;
+    durationMs: number;
+    /** Gap between the items of a staggered group. */
+    staggerStepMs: number;
+    /** Gap between the rungs of the first section's load ladder. */
+    heroStepMs: number;
+}
+/** The motion a page gets when nothing says otherwise: a soft rise, as the attributes panel defaults to. */
+export declare const ELEMENT_MOTION_DEFAULT: ElementMotionCharacter;
+/** The most rungs the first section's ladder climbs; later blocks share the last. */
+export declare const ELEMENT_MOTION_HERO_RUNGS = 6;
+/**
+ * Elements that are never animated, nor animated as part of a block that
+ * holds them: forms and every field of one, and the site's navigation and
+ * frame. A field that slides in under a visitor's cursor is a field they
+ * miss, and a header that moves is a site that looks broken.
+ */
+export declare const ELEMENT_MOTION_NEVER: ReadonlySet<string>;
+export interface ElementMotionOptions {
+    /** The page's root; the canvas root when absent. */
+    rootId?: string;
+    /** The page's sections in order; the root's own children when absent. */
+    sectionIds?: readonly string[];
+    character?: ElementMotionCharacter;
+}
+/**
+ * Writes entrance motion onto a page's nodes by the rules above, and returns
+ * the new node map — or `nodes` itself, unchanged, when there was nothing to
+ * move.
+ */
+export declare function applyElementMotion<T extends Record<string, any>>(nodes: T, options?: ElementMotionOptions): T;

package/src/lib/app-utils/element-motion.js

@@ -0,0 +1,341 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+/**
+ * @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 { CANVAS_ROOT_ELEMENT_ID } from "../foundation/constants/canvas.js";
+import { ANIMATION_MAX_DELAY_MS, ANIMATION_MAX_DURATION_MS, ANIMATION_MAX_STAGGER_STEP_MS, NODE_ANIMATION_DELAY_PROP, NODE_ANIMATION_DURATION_PROP, NODE_ANIMATION_EASE_PROP, NODE_ANIMATION_PROPS, NODE_ANIMATION_PROP, NODE_ANIMATION_STAGGER_PROP, NODE_ANIMATION_STAGGER_STEP_PROP, NODE_ANIMATION_TRIGGER_PROP } from "./element-animation.js";
+/** The motion a page gets when nothing says otherwise: a soft rise, as the attributes panel defaults to. */ export const ELEMENT_MOTION_DEFAULT = {
+    preset: 'slide-up',
+    mediaPreset: 'fade',
+    ease: 'smooth',
+    durationMs: 600,
+    staggerStepMs: 90,
+    heroStepMs: 120
+};
+/** The most rungs the first section's ladder climbs; later blocks share the last. */ export const ELEMENT_MOTION_HERO_RUNGS = 6;
+/**
+ * Elements that are never animated, nor animated as part of a block that
+ * holds them: forms and every field of one, and the site's navigation and
+ * frame. A field that slides in under a visitor's cursor is a field they
+ * miss, and a header that moves is a site that looks broken.
+ */ export const ELEMENT_MOTION_NEVER = new Set([
+    // Forms and their fields.
+    'form',
+    'formField',
+    'muiFormControl',
+    'muiFormLabel',
+    'muiFormControlLabel',
+    'muiFormHelperText',
+    'muiInput',
+    'muiSelect',
+    'muiSelectOption',
+    'muiRadioGroup',
+    'muiRadio',
+    'muiCheckbox',
+    'muiRating',
+    'muiDatePicker',
+    'muiTimePicker',
+    'newsletter-signup',
+    'member-signin',
+    'member-signup',
+    'member-recovery',
+    'booking',
+    'reservation-widget',
+    'customer-account',
+    'return-request',
+    'order-status',
+    'searchBox',
+    'collectionSearch',
+    // Navigation and the site's frame.
+    'layoutSlot',
+    'muiAppBar',
+    'muiToolbar',
+    'muiDrawer',
+    'muiDrawerToggle',
+    'muiNavMenu',
+    'muiMegaMenu',
+    'muiBreadcrumbs',
+    'muiTabs',
+    'languageSwitcher',
+    'themeModeSwitcher',
+    'cart'
+]);
+/** Pictures: what the media preset is for. */ const MEDIA = new Set([
+    'image',
+    'video',
+    'videoEmbed',
+    'gated-video'
+]);
+/** Components that list like items whatever their children are. */ const LISTS = new Set([
+    'muiList',
+    'muiImageList',
+    'collectionEntries'
+]);
+/**
+ * What a group's items are made of when they are alike: cards, cells,
+ * panels, pictures. Words and buttons never count, however alike — a row of
+ * two buttons is a call to action, not a group of cards.
+ */ const ITEMS = new Set([
+    'muiCard',
+    'muiPaper',
+    'muiGrid',
+    'muiStack',
+    'muiBox',
+    'muiLinkBox',
+    'muiListItem',
+    'muiImageListItem',
+    'muiAccordion',
+    'reusableInstance',
+    'div',
+    'image',
+    'video'
+]);
+const clamp = (value, max)=>Math.min(Math.max(Math.round(value), 0), max);
+/**
+ * Whether a style value — plain or one per breakpoint — takes the element out
+ * of the flow: pinned to the screen, or laid over its band, as a cover
+ * photo's backdrop and its scrim are. Either is part of the band, not of what
+ * the band holds.
+ */ function pins(value) {
+    if (value === 'fixed' || value === 'sticky' || value === 'absolute') return true;
+    return typeof value === 'object' && value !== null && Object.values(value).some(pins);
+}
+/**
+ * Writes entrance motion onto a page's nodes by the rules above, and returns
+ * the new node map — or `nodes` itself, unchanged, when there was nothing to
+ * move.
+ */ export function applyElementMotion(nodes, options = {}) {
+    var _options_character, _options_rootId, _options_sectionIds;
+    if (!nodes) return nodes;
+    const character = (_options_character = options.character) != null ? _options_character : ELEMENT_MOTION_DEFAULT;
+    const rootId = (_options_rootId = options.rootId) != null ? _options_rootId : CANVAS_ROOT_ELEMENT_ID;
+    const node = (id)=>nodes[id];
+    const children = (id)=>{
+        var _ref;
+        var _node;
+        return ((_ref = (_node = node(id)) == null ? void 0 : _node.nodes) != null ? _ref : []).filter((child)=>typeof child === 'string' && !!node(child));
+    };
+    const patches = new Map();
+    /** The first section's Largest Contentful Paint candidates, painted where they stand. */ const still = new Set();
+    /** Left alone, and so is everything inside it. */ const closed = (id)=>{
+        var _at_componentId;
+        var _at_sx;
+        const at = node(id);
+        if (!at) return true;
+        if (at.hidden || still.has(id)) return true;
+        if (ELEMENT_MOTION_NEVER.has(String((_at_componentId = at.componentId) != null ? _at_componentId : ''))) return true;
+        if (at.props && NODE_ANIMATION_PROPS.some((prop)=>{
+            var _at_props;
+            return ((_at_props = at.props) == null ? void 0 : _at_props[prop]) !== undefined;
+        })) return true;
+        return pins((_at_sx = at.sx) == null ? void 0 : _at_sx['position']);
+    };
+    const holdsClosed = new Map();
+    /** The element, or one inside it, is left alone: it cannot move as one block. */ const holds = (id)=>{
+        const known = holdsClosed.get(id);
+        if (known !== undefined) return known;
+        holdsClosed.set(id, false);
+        const result = closed(id) || children(id).some(holds);
+        holdsClosed.set(id, result);
+        return result;
+    };
+    const groupMemo = new Map();
+    const belowMemo = new Map();
+    /**
+   * A group of like items, whose items stagger. A grid or a row of panels
+   * that holds a group of its own is the LAYOUT around it — a heading beside
+   * its cards — so it is opened up and the group inside staggers instead.
+   */ const isGroup = (id)=>{
+        var _at_componentId;
+        var _at_props;
+        const known = groupMemo.get(id);
+        if (known !== undefined) return known;
+        const at = node(id);
+        const componentId = String((_at_componentId = at.componentId) != null ? _at_componentId : '');
+        const kids = children(id);
+        let result;
+        // A dataset repeated over one card renders one child per record.
+        if ((((_at_props = at.props) == null ? void 0 : _at_props['repeatDataset']) || LISTS.has(componentId)) && kids.length) result = true;
+        else if (kids.length < 2) result = false;
+        else {
+            var _ref;
+            var _node, _at_props1;
+            const first = String((_ref = (_node = node(kids[0])) == null ? void 0 : _node.componentId) != null ? _ref : '');
+            const alike = componentId === 'muiGrid' && !!((_at_props1 = at.props) == null ? void 0 : _at_props1['container']) || ITEMS.has(first) && kids.every((child)=>{
+                var _node;
+                return ((_node = node(child)) == null ? void 0 : _node.componentId) === first;
+            });
+            result = alike && !holdsGroup(id);
+        }
+        groupMemo.set(id, result);
+        return result;
+    };
+    /** A group sits somewhere inside the element. */ const holdsGroup = (id)=>{
+        const known = belowMemo.get(id);
+        if (known !== undefined) return known;
+        const result = children(id).some((child)=>isGroup(child) || holdsGroup(child));
+        belowMemo.set(id, result);
+        return result;
+    };
+    /** Leads with a picture: its first leaf, down its first children, is one. */ const leadsWithMedia = (id)=>{
+        let at = id;
+        for(let depth = 0; depth < 12; depth += 1){
+            var _ref;
+            var _node;
+            if (MEDIA.has(String((_ref = (_node = node(at)) == null ? void 0 : _node.componentId) != null ? _ref : ''))) return true;
+            const kids = children(at);
+            if (!kids.length) return false;
+            at = kids[0];
+        }
+        return false;
+    };
+    const presetOf = (id, group)=>{
+        const media = group ? children(id).every(leadsWithMedia) : leadsWithMedia(id);
+        return media ? character.mediaPreset : character.preset;
+    };
+    const animate = (id, trigger, delayMs)=>{
+        const group = isGroup(id);
+        patches.set(id, _extends({
+            [NODE_ANIMATION_PROP]: presetOf(id, group),
+            [NODE_ANIMATION_TRIGGER_PROP]: trigger,
+            [NODE_ANIMATION_DURATION_PROP]: clamp(character.durationMs, ANIMATION_MAX_DURATION_MS)
+        }, delayMs > 0 ? {
+            [NODE_ANIMATION_DELAY_PROP]: clamp(delayMs, ANIMATION_MAX_DELAY_MS)
+        } : {}, {
+            [NODE_ANIMATION_EASE_PROP]: character.ease
+        }, group ? {
+            [NODE_ANIMATION_STAGGER_PROP]: true,
+            [NODE_ANIMATION_STAGGER_STEP_PROP]: clamp(character.staggerStepMs, ANIMATION_MAX_STAGGER_STEP_MS)
+        } : {}));
+    };
+    /** Down through wrappers of one child, to where a section's content starts. */ const contentOf = (id)=>{
+        let at = id;
+        while(!closed(at) && !isGroup(at)){
+            const kids = children(at);
+            if (kids.length !== 1) break;
+            at = kids[0];
+        }
+        return at;
+    };
+    /** A later section's content: on scroll, groups staggered, nothing nested. */ const place = (id)=>{
+        if (closed(id)) return;
+        if (holds(id) || !isGroup(id) && holdsGroup(id)) {
+            for (const child of children(id))place(child);
+            return;
+        }
+        animate(id, 'scroll', 0);
+    };
+    /** Down through wrappers of one child that are free to move. */ const descend = (id)=>{
+        let at = id;
+        for(let kids = children(at); kids.length === 1 && !closed(kids[0]); kids = children(at))at = kids[0];
+        return at;
+    };
+    /**
+   * The first section's content: on load, one rung per block, around the
+   * blocks that stay still. A rung that holds one is opened up, down to the
+   * parts beside it, so the eyebrow, the lede and the buttons still climb.
+   */ const ladder = (id)=>{
+        if (closed(id)) return;
+        // A repeat's one child is the card every record is drawn with: the
+        // repeat staggers its records rather than each record playing at once.
+        if (isGroup(id) && children(id).length < 2) return animate(id, 'load', 0);
+        const around = (at)=>children(at).flatMap((child)=>closed(child) ? [] : holds(child) ? around(child) : [
+                    child
+                ]);
+        const base = children(id).length ? around(id) : [
+            id
+        ];
+        // A column of words beside a picture is opened up, so its lines climb one
+        // after another before the picture lands.
+        const rungs = [];
+        base.forEach((rung, index)=>{
+            const inner = descend(rung);
+            const kids = children(inner);
+            const opens = kids.length >= 2 && !isGroup(inner) && !leadsWithMedia(inner) && rungs.length + kids.length + (base.length - index - 1) <= ELEMENT_MOTION_HERO_RUNGS;
+            rungs.push(...opens ? kids : [
+                rung
+            ]);
+        });
+        // A rung left alone takes no step of the ladder: the first block that moves starts at once.
+        rungs.filter((rung)=>!closed(rung)).forEach((rung, index)=>animate(rung, 'load', Math.min(index, ELEMENT_MOTION_HERO_RUNGS - 1) * character.heroStepMs));
+    };
+    /**
+   * What the first section paints first, and so what Lighthouse times as its
+   * Largest Contentful Paint (AGL-3581): its main heading — the h1, else its
+   * first heading — and its largest picture. Neither ever starts at opacity 0,
+   * which would hold the paint back by the length of the entrance.
+   */ const markStill = (sectionId)=>{
+        var _order_find;
+        const order = [];
+        const walk = (id)=>{
+            order.push(id);
+            for (const child of children(id))walk(child);
+        };
+        walk(sectionId);
+        const typeOf = (id)=>{
+            var _ref;
+            var _at_props;
+            const at = node(id);
+            return (at == null ? void 0 : at.componentId) === 'muiTypography' ? String((_ref = (_at_props = at.props) == null ? void 0 : _at_props['variant']) != null ? _ref : '') : null;
+        };
+        const main = (id)=>{
+            var _typeOf;
+            var _node_props, _node;
+            return /^(h1|display)/i.test((_typeOf = typeOf(id)) != null ? _typeOf : '') || typeOf(id) !== null && ((_node = node(id)) == null ? void 0 : (_node_props = _node.props) == null ? void 0 : _node_props['component']) === 'h1';
+        };
+        const heading = (_order_find = order.find(main)) != null ? _order_find : order.find((id)=>{
+            var _typeOf;
+            return /^(h[1-6]|display)/i.test((_typeOf = typeOf(id)) != null ? _typeOf : '');
+        });
+        if (heading) still.add(heading);
+        const size = (id)=>{
+            var _at_props, _at_props1, _at_sx, _at_sx1;
+            const at = node(id);
+            const read = (value)=>typeof value === 'number' ? value : parseFloat(String(value != null ? value : '')) || 0;
+            return Math.max(read(at == null ? void 0 : (_at_props = at.props) == null ? void 0 : _at_props['height']), read(at == null ? void 0 : (_at_props1 = at.props) == null ? void 0 : _at_props1['width']), read(at == null ? void 0 : (_at_sx = at.sx) == null ? void 0 : _at_sx['height']), read(at == null ? void 0 : (_at_sx1 = at.sx) == null ? void 0 : _at_sx1['width']));
+        };
+        let picture;
+        for (const id of order){
+            var _ref;
+            var _node;
+            if (MEDIA.has(String((_ref = (_node = node(id)) == null ? void 0 : _node.componentId) != null ? _ref : '')) && (picture === undefined || size(id) > size(picture))) picture = id;
+        }
+        if (picture) still.add(picture);
+    };
+    const sections = ((_options_sectionIds = options.sectionIds) != null ? _options_sectionIds : children(rootId)).filter((id)=>!!node(id));
+    if (sections[0]) markStill(sections[0]);
+    sections.forEach((id, index)=>{
+        if (closed(id)) return;
+        const content = contentOf(id);
+        // The band itself never moves — only what it holds — so a section that
+        // is nothing but its band has nothing to move.
+        if (content === id && !children(id).length) return;
+        if (index === 0) ladder(content);
+        else if (content === id && !isGroup(id)) for (const child of children(id))place(child);
+        else place(content);
+    });
+    if (!patches.size) return nodes;
+    const next = _extends({}, nodes);
+    for (const [id, props] of patches){
+        var _ref;
+        var _nodes_id;
+        next[id] = _extends({}, nodes[id], {
+            props: _extends({}, (_ref = (_nodes_id = nodes[id]) == null ? void 0 : _nodes_id.props) != null ? _ref : {}, props)
+        });
+    }
+    return next;
+}
+
+//# sourceMappingURL=element-motion.js.map

package/src/lib/app-utils/element-motion.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../libs/aglyn/src/lib/app-utils/element-motion.ts"],"sourcesContent":["/**\n * @license\n * Copyright 2026 Aglyn LLC\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *   http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { CANVAS_ROOT_ELEMENT_ID } from '../foundation/constants/canvas'\nimport {\n  ANIMATION_MAX_DELAY_MS,\n  ANIMATION_MAX_DURATION_MS,\n  ANIMATION_MAX_STAGGER_STEP_MS,\n  NODE_ANIMATION_DELAY_PROP,\n  NODE_ANIMATION_DURATION_PROP,\n  NODE_ANIMATION_EASE_PROP,\n  NODE_ANIMATION_PROPS,\n  NODE_ANIMATION_PROP,\n  NODE_ANIMATION_STAGGER_PROP,\n  NODE_ANIMATION_STAGGER_STEP_PROP,\n  NODE_ANIMATION_TRIGGER_PROP,\n  type AnimationEase,\n  type AnimationPreset,\n  type AnimationTrigger,\n} from './element-animation'\n\n/**\n * Entrance motion for a whole page (AGL-3838): the pass that writes the\n * existing animation props (`element-animation.ts`) onto a page built by\n * code — a starter, a new site's home, a page the AI composed — so it moves\n * the way an author would have set it up by hand in the attributes panel.\n *\n * Nothing new is rendered or shipped: the pass only writes the reserved\n * `aglynAnimation*` props the renderer and the tenant's stylesheet already\n * read, with values from their own vocabulary. A page that moves pays the\n * stylesheet and the scroll observer it always paid; a page this pass leaves\n * alone pays nothing.\n *\n * ## The rules\n *\n *  - The FIRST section's secondary content — its eyebrow, its lede, its\n *    buttons, a small picture — plays on `load`, as a short ladder: each\n *    block starts {@link ElementMotionCharacter.heroStepMs} after the one\n *    before. Its main heading and its largest picture, the candidates for the\n *    page's Largest Contentful Paint, never move: they are painted where\n *    they stand from the first frame. Its band — a background color or a\n *    cover photo — never moves either.\n *  - Every later section's content slides in on `scroll`.\n *  - A group of like items — a grid of cards, a list, the questions of an\n *    FAQ, a dataset repeated over one card — STAGGERS its items, one after\n *    another, rather than arriving as one block.\n *  - A picture, and a group whose items each lead with one, takes the\n *    character's media preset.\n *  - Never touched: forms and their fields, navigation and the site's frame,\n *    anything out of the flow (`position: fixed | sticky | absolute` — a\n *    cover photo's backdrop is its band's), anything hidden, and\n *    anything that already carries an animation prop — an author's choice,\n *    `none` included, is never overwritten. A block that HOLDS one of those\n *    is not animated as a whole either; its other children are animated one\n *    by one instead, so a form never slides in with its section.\n *  - Never nested: once a block animates, nothing inside it does. Two\n *    entrances on the same pixels multiply their fades and add their\n *    offsets, which reads as a stutter, not as motion.\n *\n * Pure and idempotent: a page it already moved comes back as the same\n * object, which is what lets a caller compare by identity to skip a write.\n *\n * Leaf imports only, the same as `starter-template-nodes.ts`: the starter\n * kit reads this from the console's client gallery and its seed route alike.\n */\n\n/** A page's motion: the presets, curve and timing every entrance on it shares. */\nexport interface ElementMotionCharacter {\n  /** Words and blocks: a section's content, a group of cards. */\n  preset: AnimationPreset\n  /** A picture, or a group whose every item leads with one. */\n  mediaPreset: AnimationPreset\n  ease: AnimationEase\n  durationMs: number\n  /** Gap between the items of a staggered group. */\n  staggerStepMs: number\n  /** Gap between the rungs of the first section's load ladder. */\n  heroStepMs: number\n}\n\n/** The motion a page gets when nothing says otherwise: a soft rise, as the attributes panel defaults to. */\nexport const ELEMENT_MOTION_DEFAULT: ElementMotionCharacter = {\n  preset: 'slide-up',\n  mediaPreset: 'fade',\n  ease: 'smooth',\n  durationMs: 600,\n  staggerStepMs: 90,\n  heroStepMs: 120,\n}\n\n/** The most rungs the first section's ladder climbs; later blocks share the last. */\nexport const ELEMENT_MOTION_HERO_RUNGS = 6\n\n/**\n * Elements that are never animated, nor animated as part of a block that\n * holds them: forms and every field of one, and the site's navigation and\n * frame. A field that slides in under a visitor's cursor is a field they\n * miss, and a header that moves is a site that looks broken.\n */\nexport const ELEMENT_MOTION_NEVER: ReadonlySet<string> = new Set([\n  // Forms and their fields.\n  'form',\n  'formField',\n  'muiFormControl',\n  'muiFormLabel',\n  'muiFormControlLabel',\n  'muiFormHelperText',\n  'muiInput',\n  'muiSelect',\n  'muiSelectOption',\n  'muiRadioGroup',\n  'muiRadio',\n  'muiCheckbox',\n  'muiRating',\n  'muiDatePicker',\n  'muiTimePicker',\n  'newsletter-signup',\n  'member-signin',\n  'member-signup',\n  'member-recovery',\n  'booking',\n  'reservation-widget',\n  'customer-account',\n  'return-request',\n  'order-status',\n  'searchBox',\n  'collectionSearch',\n  // Navigation and the site's frame.\n  'layoutSlot',\n  'muiAppBar',\n  'muiToolbar',\n  'muiDrawer',\n  'muiDrawerToggle',\n  'muiNavMenu',\n  'muiMegaMenu',\n  'muiBreadcrumbs',\n  'muiTabs',\n  'languageSwitcher',\n  'themeModeSwitcher',\n  'cart',\n])\n\n/** Pictures: what the media preset is for. */\nconst MEDIA: ReadonlySet<string> = new Set(['image', 'video', 'videoEmbed', 'gated-video'])\n\n/** Components that list like items whatever their children are. */\nconst LISTS: ReadonlySet<string> = new Set(['muiList', 'muiImageList', 'collectionEntries'])\n\n/**\n * What a group's items are made of when they are alike: cards, cells,\n * panels, pictures. Words and buttons never count, however alike — a row of\n * two buttons is a call to action, not a group of cards.\n */\nconst ITEMS: ReadonlySet<string> = new Set([\n  'muiCard',\n  'muiPaper',\n  'muiGrid',\n  'muiStack',\n  'muiBox',\n  'muiLinkBox',\n  'muiListItem',\n  'muiImageListItem',\n  'muiAccordion',\n  'reusableInstance',\n  'div',\n  'image',\n  'video',\n])\n\ninterface MotionNode {\n  componentId?: string\n  props?: Record<string, unknown>\n  sx?: Record<string, unknown>\n  nodes?: string[]\n  hidden?: boolean\n}\n\nexport interface ElementMotionOptions {\n  /** The page's root; the canvas root when absent. */\n  rootId?: string\n  /** The page's sections in order; the root's own children when absent. */\n  sectionIds?: readonly string[]\n  character?: ElementMotionCharacter\n}\n\nconst clamp = (value: number, max: number): number => Math.min(Math.max(Math.round(value), 0), max)\n\n/**\n * Whether a style value — plain or one per breakpoint — takes the element out\n * of the flow: pinned to the screen, or laid over its band, as a cover\n * photo's backdrop and its scrim are. Either is part of the band, not of what\n * the band holds.\n */\nfunction pins(value: unknown): boolean {\n  if (value === 'fixed' || value === 'sticky' || value === 'absolute') return true\n  return typeof value === 'object' && value !== null && Object.values(value).some(pins)\n}\n\n/**\n * Writes entrance motion onto a page's nodes by the rules above, and returns\n * the new node map — or `nodes` itself, unchanged, when there was nothing to\n * move.\n */\nexport function applyElementMotion<T extends Record<string, any>>(nodes: T, options: ElementMotionOptions = {}): T {\n  if (!nodes) return nodes\n  const character = options.character ?? ELEMENT_MOTION_DEFAULT\n  const rootId = options.rootId ?? CANVAS_ROOT_ELEMENT_ID\n  const node = (id: string): MotionNode | undefined => nodes[id] as MotionNode | undefined\n  const children = (id: string): string[] => (node(id)?.nodes ?? []).filter((child) => typeof child === 'string' && !!node(child))\n  const patches = new Map<string, Record<string, unknown>>()\n\n  /** The first section's Largest Contentful Paint candidates, painted where they stand. */\n  const still = new Set<string>()\n  /** Left alone, and so is everything inside it. */\n  const closed = (id: string): boolean => {\n    const at = node(id)\n    if (!at) return true\n    if (at.hidden || still.has(id)) return true\n    if (ELEMENT_MOTION_NEVER.has(String(at.componentId ?? ''))) return true\n    if (at.props && NODE_ANIMATION_PROPS.some((prop) => at.props?.[prop] !== undefined)) return true\n    return pins(at.sx?.['position'])\n  }\n  const holdsClosed = new Map<string, boolean>()\n  /** The element, or one inside it, is left alone: it cannot move as one block. */\n  const holds = (id: string): boolean => {\n    const known = holdsClosed.get(id)\n    if (known !== undefined) return known\n    holdsClosed.set(id, false)\n    const result = closed(id) || children(id).some(holds)\n    holdsClosed.set(id, result)\n    return result\n  }\n  const groupMemo = new Map<string, boolean>()\n  const belowMemo = new Map<string, boolean>()\n  /**\n   * A group of like items, whose items stagger. A grid or a row of panels\n   * that holds a group of its own is the LAYOUT around it — a heading beside\n   * its cards — so it is opened up and the group inside staggers instead.\n   */\n  const isGroup = (id: string): boolean => {\n    const known = groupMemo.get(id)\n    if (known !== undefined) return known\n    const at = node(id) as MotionNode\n    const componentId = String(at.componentId ?? '')\n    const kids = children(id)\n    let result: boolean\n    // A dataset repeated over one card renders one child per record.\n    if ((at.props?.['repeatDataset'] || LISTS.has(componentId)) && kids.length) result = true\n    else if (kids.length < 2) result = false\n    else {\n      const first = String(node(kids[0])?.componentId ?? '')\n      const alike =\n        (componentId === 'muiGrid' && !!at.props?.['container']) ||\n        (ITEMS.has(first) && kids.every((child) => node(child)?.componentId === first))\n      result = alike && !holdsGroup(id)\n    }\n    groupMemo.set(id, result)\n    return result\n  }\n  /** A group sits somewhere inside the element. */\n  const holdsGroup = (id: string): boolean => {\n    const known = belowMemo.get(id)\n    if (known !== undefined) return known\n    const result = children(id).some((child) => isGroup(child) || holdsGroup(child))\n    belowMemo.set(id, result)\n    return result\n  }\n  /** Leads with a picture: its first leaf, down its first children, is one. */\n  const leadsWithMedia = (id: string): boolean => {\n    let at = id\n    for (let depth = 0; depth < 12; depth += 1) {\n      if (MEDIA.has(String(node(at)?.componentId ?? ''))) return true\n      const kids = children(at)\n      if (!kids.length) return false\n      at = kids[0]\n    }\n    return false\n  }\n  const presetOf = (id: string, group: boolean): AnimationPreset => {\n    const media = group ? children(id).every(leadsWithMedia) : leadsWithMedia(id)\n    return media ? character.mediaPreset : character.preset\n  }\n\n  const animate = (id: string, trigger: AnimationTrigger, delayMs: number): void => {\n    const group = isGroup(id)\n    patches.set(id, {\n      [NODE_ANIMATION_PROP]: presetOf(id, group),\n      [NODE_ANIMATION_TRIGGER_PROP]: trigger,\n      [NODE_ANIMATION_DURATION_PROP]: clamp(character.durationMs, ANIMATION_MAX_DURATION_MS),\n      ...(delayMs > 0 ? { [NODE_ANIMATION_DELAY_PROP]: clamp(delayMs, ANIMATION_MAX_DELAY_MS) } : {}),\n      [NODE_ANIMATION_EASE_PROP]: character.ease,\n      ...(group\n        ? {\n            [NODE_ANIMATION_STAGGER_PROP]: true,\n            [NODE_ANIMATION_STAGGER_STEP_PROP]: clamp(character.staggerStepMs, ANIMATION_MAX_STAGGER_STEP_MS),\n          }\n        : {}),\n    })\n  }\n\n  /** Down through wrappers of one child, to where a section's content starts. */\n  const contentOf = (id: string): string => {\n    let at = id\n    while (!closed(at) && !isGroup(at)) {\n      const kids = children(at)\n      if (kids.length !== 1) break\n      at = kids[0]\n    }\n    return at\n  }\n\n  /** A later section's content: on scroll, groups staggered, nothing nested. */\n  const place = (id: string): void => {\n    if (closed(id)) return\n    if (holds(id) || (!isGroup(id) && holdsGroup(id))) {\n      for (const child of children(id)) place(child)\n      return\n    }\n    animate(id, 'scroll', 0)\n  }\n\n  /** Down through wrappers of one child that are free to move. */\n  const descend = (id: string): string => {\n    let at = id\n    for (let kids = children(at); kids.length === 1 && !closed(kids[0]); kids = children(at)) at = kids[0]\n    return at\n  }\n\n  /**\n   * The first section's content: on load, one rung per block, around the\n   * blocks that stay still. A rung that holds one is opened up, down to the\n   * parts beside it, so the eyebrow, the lede and the buttons still climb.\n   */\n  const ladder = (id: string): void => {\n    if (closed(id)) return\n    // A repeat's one child is the card every record is drawn with: the\n    // repeat staggers its records rather than each record playing at once.\n    if (isGroup(id) && children(id).length < 2) return animate(id, 'load', 0)\n    const around = (at: string): string[] =>\n      children(at).flatMap((child) => (closed(child) ? [] : holds(child) ? around(child) : [child]))\n    const base = children(id).length ? around(id) : [id]\n    // A column of words beside a picture is opened up, so its lines climb one\n    // after another before the picture lands.\n    const rungs: string[] = []\n    base.forEach((rung, index) => {\n      const inner = descend(rung)\n      const kids = children(inner)\n      const opens =\n        kids.length >= 2 &&\n        !isGroup(inner) &&\n        !leadsWithMedia(inner) &&\n        rungs.length + kids.length + (base.length - index - 1) <= ELEMENT_MOTION_HERO_RUNGS\n      rungs.push(...(opens ? kids : [rung]))\n    })\n    // A rung left alone takes no step of the ladder: the first block that moves starts at once.\n    rungs\n      .filter((rung) => !closed(rung))\n      .forEach((rung, index) => animate(rung, 'load', Math.min(index, ELEMENT_MOTION_HERO_RUNGS - 1) * character.heroStepMs))\n  }\n\n  /**\n   * What the first section paints first, and so what Lighthouse times as its\n   * Largest Contentful Paint (AGL-3581): its main heading — the h1, else its\n   * first heading — and its largest picture. Neither ever starts at opacity 0,\n   * which would hold the paint back by the length of the entrance.\n   */\n  const markStill = (sectionId: string): void => {\n    const order: string[] = []\n    const walk = (id: string): void => {\n      order.push(id)\n      for (const child of children(id)) walk(child)\n    }\n    walk(sectionId)\n    const typeOf = (id: string) => {\n      const at = node(id)\n      return at?.componentId === 'muiTypography' ? String(at.props?.['variant'] ?? '') : null\n    }\n    const main = (id: string) => /^(h1|display)/i.test(typeOf(id) ?? '') || (typeOf(id) !== null && node(id)?.props?.['component'] === 'h1')\n    const heading = order.find(main) ?? order.find((id) => /^(h[1-6]|display)/i.test(typeOf(id) ?? ''))\n    if (heading) still.add(heading)\n    const size = (id: string): number => {\n      const at = node(id)\n      const read = (value: unknown) => (typeof value === 'number' ? value : parseFloat(String(value ?? '')) || 0)\n      return Math.max(read(at?.props?.['height']), read(at?.props?.['width']), read(at?.sx?.['height']), read(at?.sx?.['width']))\n    }\n    let picture: string | undefined\n    for (const id of order) {\n      if (MEDIA.has(String(node(id)?.componentId ?? '')) && (picture === undefined || size(id) > size(picture))) picture = id\n    }\n    if (picture) still.add(picture)\n  }\n\n  const sections = (options.sectionIds ?? children(rootId)).filter((id) => !!node(id))\n  if (sections[0]) markStill(sections[0])\n  sections.forEach((id, index) => {\n    if (closed(id)) return\n    const content = contentOf(id)\n    // The band itself never moves — only what it holds — so a section that\n    // is nothing but its band has nothing to move.\n    if (content === id && !children(id).length) return\n    if (index === 0) ladder(content)\n    else if (content === id && !isGroup(id)) for (const child of children(id)) place(child)\n    else place(content)\n  })\n\n  if (!patches.size) return nodes\n  const next: Record<string, any> = { ...nodes }\n  for (const [id, props] of patches) {\n    next[id] = { ...nodes[id], props: { ...(nodes[id]?.props ?? {}), ...props } }\n  }\n  return next as T\n}\n"],"names":["CANVAS_ROOT_ELEMENT_ID","ANIMATION_MAX_DELAY_MS","ANIMATION_MAX_DURATION_MS","ANIMATION_MAX_STAGGER_STEP_MS","NODE_ANIMATION_DELAY_PROP","NODE_ANIMATION_DURATION_PROP","NODE_ANIMATION_EASE_PROP","NODE_ANIMATION_PROPS","NODE_ANIMATION_PROP","NODE_ANIMATION_STAGGER_PROP","NODE_ANIMATION_STAGGER_STEP_PROP","NODE_ANIMATION_TRIGGER_PROP","ELEMENT_MOTION_DEFAULT","preset","mediaPreset","ease","durationMs","staggerStepMs","heroStepMs","ELEMENT_MOTION_HERO_RUNGS","ELEMENT_MOTION_NEVER","Set","MEDIA","LISTS","ITEMS","clamp","value","max","Math","min","round","pins","Object","values","some","applyElementMotion","nodes","options","character","rootId","node","id","children","filter","child","patches","Map","still","closed","at","hidden","has","String","componentId","props","prop","undefined","sx","holdsClosed","holds","known","get","set","result","groupMemo","belowMemo","isGroup","kids","length","first","alike","every","holdsGroup","leadsWithMedia","depth","presetOf","group","media","animate","trigger","delayMs","contentOf","place","descend","ladder","around","flatMap","base","rungs","forEach","rung","index","inner","opens","push","markStill","sectionId","order","walk","typeOf","main","test","heading","find","add","size","read","parseFloat","picture","sections","sectionIds","content","next"],"mappings":"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"}

package/src/lib/app-utils/health-report.d.ts

@@ -1852,16 +1852,27 @@ export declare const APP_CHECK_MIN_REQUESTS = 20;
 /**
  * The floor the allow rate must clear.
  *
- * 0.90, against a measured 0.997. The gap is deliberate: a handful of genuine
- * denials is ordinary — a stale tab, a bot, a browser that failed its
+ * 0.75, against real traffic that never read below 0.976 in any six-hour
+ * window over the 30 days to 2026-10-16. The gap is deliberate: a handful of
+ * genuine denials is ordinary — a stale tab, a bot, a browser that failed its
  * reCAPTCHA — and a floor set near the observed rate would page on those.
  *
+ * ⛔ Our own native test runs are the largest source of denials, and they
+ * cannot be made to attest. A Simulator or emulator build has no App Attest
+ * or Play Integrity, and debug tokens are banned outright (AGL-2402), so every
+ * sign-in such a build tries is an INVALID denial on this service, often in
+ * retry bursts. One evening of native sign-in testing put 60 of them into a
+ * quiet window and read 0.891, which paged as an outage under the old 0.90
+ * floor while every real visitor was attesting. 0.75 needs roughly three
+ * times that before it reds.
+ *
  * What this is built to catch is not a drift of a few percent; it is the
  * documented failure mode of `recaptcha-allowlist.ts`, where an origin that is
  * attached and routed but not allowlisted renders a console that can never
- * sign anyone in. That reads as ~0%, not 85%.
+ * sign anyone in. That reads as ~0%, and a breakage confined to one browser
+ * family still lands well under 0.75.
  */
-export declare const APP_CHECK_MIN_ALLOW_RATE = 0.9;
+export declare const APP_CHECK_MIN_ALLOW_RATE = 0.75;
 /**
  * Grade attestation for real visitors.
  *

package/src/lib/app-utils/health-report.js

@@ -2209,15 +2209,26 @@ export async function writeCronBeat(store, jobId, now = Date.now()) {
 /**
  * The floor the allow rate must clear.
  *
- * 0.90, against a measured 0.997. The gap is deliberate: a handful of genuine
- * denials is ordinary — a stale tab, a bot, a browser that failed its
+ * 0.75, against real traffic that never read below 0.976 in any six-hour
+ * window over the 30 days to 2026-10-16. The gap is deliberate: a handful of
+ * genuine denials is ordinary — a stale tab, a bot, a browser that failed its
  * reCAPTCHA — and a floor set near the observed rate would page on those.
  *
+ * ⛔ Our own native test runs are the largest source of denials, and they
+ * cannot be made to attest. A Simulator or emulator build has no App Attest
+ * or Play Integrity, and debug tokens are banned outright (AGL-2402), so every
+ * sign-in such a build tries is an INVALID denial on this service, often in
+ * retry bursts. One evening of native sign-in testing put 60 of them into a
+ * quiet window and read 0.891, which paged as an outage under the old 0.90
+ * floor while every real visitor was attesting. 0.75 needs roughly three
+ * times that before it reds.
+ *
  * What this is built to catch is not a drift of a few percent; it is the
  * documented failure mode of `recaptcha-allowlist.ts`, where an origin that is
  * attached and routed but not allowlisted renders a console that can never
- * sign anyone in. That reads as ~0%, not 85%.
- */ export const APP_CHECK_MIN_ALLOW_RATE = 0.9;
+ * sign anyone in. That reads as ~0%, and a breakage confined to one browser
+ * family still lands well under 0.75.
+ */ export const APP_CHECK_MIN_ALLOW_RATE = 0.75;
 /**
  * Grade attestation for real visitors.
  *