@vectoriox/iox-ui 5.43.0 → 5.44.0

package/design-core/index.d.ts

@@ -1173,6 +1173,170 @@ declare const SPEC_AXES: {
             };
         };
     };
+    readonly scrolls: {
+        readonly normal: {
+            readonly label: "Normal";
+            readonly he: "רגילה";
+            readonly hint: "The browser's own scrolling.";
+            readonly lenis: null;
+        };
+        readonly smooth: {
+            readonly label: "Smooth";
+            readonly he: "חלקה";
+            readonly hint: "A short glide after each wheel turn — what every IOX site does today.";
+            readonly lenis: {
+                readonly duration: 1.2;
+                readonly easing: "expo-out";
+                readonly wheelMultiplier: 1;
+                readonly syncTouch: false;
+            };
+        };
+        readonly extra: {
+            readonly label: "Extra smooth";
+            readonly he: "חלקה מאוד";
+            readonly hint: "A longer, softer glide; each wheel turn moves a little less.";
+            readonly lenis: {
+                readonly duration: 1.8;
+                readonly easing: "expo-out";
+                readonly wheelMultiplier: 0.9;
+                readonly syncTouch: false;
+            };
+        };
+    };
+    readonly animations: {
+        readonly still: {
+            readonly label: "Still";
+            readonly he: "ללא";
+            readonly hint: "Nothing moves in as you scroll. Buttons and cards still respond to the pointer (Speed).";
+            readonly parts: {};
+        };
+        readonly subtle: {
+            readonly label: "Subtle";
+            readonly he: "עדינה";
+            readonly hint: "Each section's content fades in once, together.";
+            readonly parts: {
+                readonly content: {
+                    readonly type: "fadeIn";
+                    readonly duration: 500;
+                };
+            };
+        };
+        readonly standard: {
+            readonly label: "Standard";
+            readonly he: "רגילה";
+            readonly hint: "Headings rise in; cards, prices and steps follow one after another.";
+            readonly parts: {
+                readonly heading: {
+                    readonly type: "moveUp";
+                    readonly distance: 16;
+                    readonly duration: 500;
+                };
+                readonly items: {
+                    readonly type: "moveUp";
+                    readonly distance: 16;
+                    readonly duration: 450;
+                    readonly stagger: 80;
+                    readonly cap: 6;
+                };
+                readonly media: {
+                    readonly type: "fadeIn";
+                    readonly duration: 600;
+                };
+            };
+        };
+        readonly lively: {
+            readonly label: "Lively";
+            readonly he: "תוססת";
+            readonly hint: "Bigger, longer entrances; side-by-side rows slide in from their side; the hero's words fade in.";
+            readonly parts: {
+                readonly heroText: {
+                    readonly type: "fadeIn";
+                    readonly duration: 400;
+                };
+                readonly heading: {
+                    readonly type: "moveUp";
+                    readonly distance: 24;
+                    readonly duration: 600;
+                };
+                readonly items: {
+                    readonly type: "moveUp";
+                    readonly distance: 24;
+                    readonly duration: 600;
+                    readonly stagger: 100;
+                    readonly cap: 8;
+                };
+                readonly media: {
+                    readonly type: "fadeIn";
+                    readonly duration: 700;
+                };
+                readonly rowMedia: {
+                    readonly type: "moveLeft";
+                    readonly mirror: "moveRight";
+                    readonly distance: 24;
+                    readonly duration: 600;
+                };
+            };
+        };
+    };
+    readonly animationFamilies: {
+        readonly nav: readonly [];
+        readonly footer: readonly [];
+        readonly hero: readonly ["heroText"];
+        readonly header: readonly ["heading"];
+        readonly detail: readonly ["heading", "media"];
+        readonly proof: readonly ["content", "heading", "items"];
+        readonly feature: readonly ["content", "heading", "items", "media", "rowMedia"];
+        readonly collection: readonly ["content", "heading", "items"];
+        readonly story: readonly ["content", "heading", "media"];
+        readonly cta: readonly ["content", "heading"];
+        readonly contact: readonly ["content", "heading"];
+        readonly faq: readonly ["content", "heading"];
+        readonly pricing: readonly ["content", "heading", "items"];
+    };
+    readonly betweens: {
+        readonly none: {
+            readonly label: "None";
+            readonly he: "ללא";
+            readonly hint: "The next page simply appears.";
+            readonly transition: "none";
+        };
+        readonly fade: {
+            readonly label: "Fade";
+            readonly he: "דהייה";
+            readonly hint: "The page fades into the next.";
+            readonly transition: "fade";
+            readonly feel: "snappy";
+        };
+        readonly slide: {
+            readonly label: "Slide";
+            readonly he: "החלקה";
+            readonly hint: "The next page pushes this one aside (from the left on a Hebrew site). On phones: Fade.";
+            readonly transition: "move-left";
+            readonly rtl: "move-right";
+            readonly feel: "smooth";
+            readonly phone: "fade";
+        };
+        readonly cinematic: {
+            readonly label: "Cinematic";
+            readonly he: "קולנועית";
+            readonly hint: "This page sinks back while the next rises over it. On phones: Fade.";
+            readonly transition: "parallax-up";
+            readonly feel: "cinematic";
+            readonly phone: "fade";
+        };
+    };
+    readonly motionChoices: {
+        readonly pre: {
+            readonly scroll: "smooth";
+            readonly animate: "still";
+            readonly between: "cinematic";
+        };
+        readonly reduced: {
+            readonly scroll: "normal";
+            readonly animate: "still";
+            readonly between: "none";
+        };
+    };
 };
 declare const SPEC_SPRINGS: {
     readonly lively: {
@@ -11992,6 +12156,25 @@ type TintId = keyof typeof SPEC_AXES.tints;
 declare const TINT_IDS: ReadonlyArray<TintId>;
 /** What a studio that stored its look BEFORE the tint existed wears: exactly the look's own palette. */
 declare const PRE_TINT_DEFAULT: TintId;
+/** How the site scrolls (AI plan rev 3.1 §3p): Normal (the browser's own) · Smooth · Extra smooth. */
+type ScrollId = keyof typeof SPEC_AXES.scrolls;
+/** How much the sections move in as they scroll into view: Still · Subtle · Standard · Lively. */
+type AnimateId = keyof typeof SPEC_AXES.animations;
+/** What plays between pages: None · Fade · Slide · Cinematic. */
+type BetweenId = keyof typeof SPEC_AXES.betweens;
+declare const SCROLL_IDS: ReadonlyArray<ScrollId>;
+declare const ANIMATE_IDS: ReadonlyArray<AnimateId>;
+declare const BETWEEN_IDS: ReadonlyArray<BetweenId>;
+/** The look's motion — the three choices the runtime and the composer read from `settings.design`. */
+interface DesignMotion {
+    scroll: ScrollId;
+    animate: AnimateId;
+    between: BetweenId;
+}
+/** What a look stored BEFORE rev 3.1 wears: exactly what every live site did (Smooth · Still · Cinematic). */
+declare const PRE_MOTION: Readonly<DesignMotion>;
+/** What a visitor who asks for reduced motion always gets, whatever the look chose. */
+declare const REDUCED_DESIGN_MOTION: Readonly<DesignMotion>;
 type SchemeId = keyof typeof SPEC_SCHEMES;
 type FontRoleToken = (typeof SPEC_FONT_ROLES)[number]['token'];
 /** Everything a studio chose about its look — the `settings.design` row, typed. */
@@ -12008,6 +12191,10 @@ interface DesignChoices {
      *  `neutral` — the palette it was applied with. */
     tint?: TintId;
     fonts?: Partial<Record<FontRoleToken, string>>;
+    /** Absent = `PRE_MOTION` (a row stored before rev 3.1 reads what its site already did). */
+    scroll?: ScrollId;
+    animate?: AnimateId;
+    between?: BetweenId;
 }
 interface FlavorSpecToken {
     readonly name: string;
@@ -13293,6 +13480,9 @@ declare enum DesignConfigKey {
     Mode = "mode",
     Tint = "tint",
     Fonts = "fonts",
+    Scroll = "scroll",
+    Animate = "animate",
+    Between = "between",
     Revert = "revert"
 }
 /** A stored design, resolved: `choices` is ALWAYS complete and valid (pack defaults fill the gaps). */
@@ -13316,12 +13506,15 @@ declare function isRetiredFlavorId(id: string | null | undefined): boolean;
  * the pack's own default (an unknown pair → the pack's first, a bad seed → the pack's seed).
  */
 declare function resolveDesignChoices(partial: Partial<DesignChoices> | null | undefined): DesignChoices;
+/** The look's motion, completed: an absent or unknown choice reads `PRE_MOTION` — what the site already does. */
+declare function resolveDesignMotion(partial: Readonly<Partial<Record<keyof DesignMotion, unknown>>> | null | undefined): DesignMotion;
 /** The pack's own defaults for `flavorId` — what picking a card means before anything is tuned. */
 declare function packDesignChoices(flavorId: string): DesignChoices;
 /**
  * What picking a pack card means, given the design the studio wears: the applied pack → the applied
  * choices; another pack → that pack's defaults, CARRYING the author's chosen fonts (§5b — a font the
- * author chose survives a pack switch unless the author changes it). Both picker homes call this.
+ * author chose survives a pack switch unless the author changes it) and the site's motion (rev 3.1 MO-D3 —
+ * how it scrolls and changes page is not a pack's, so a Look pick never resets it). Both picker homes call this.
  */
 declare function choicesForPack(flavorId: string, applied: DesignChoices | null | undefined): DesignChoices;
 /**
@@ -13332,6 +13525,8 @@ declare function choicesForPack(flavorId: string, applied: DesignChoices | null
 declare function readDesignConfig(config: ReadonlyArray<DesignConfigEntry> | null | undefined, hasRow?: boolean): StoredDesign;
 /** The colour mode a stored config compiles in — what the public page read hands the engine. */
 declare function designModeOf(config: ReadonlyArray<DesignConfigEntry> | null | undefined): DesignMode;
+/** The look's motion of a stored config — what the public page read hands the engine (`designMotion`). */
+declare function designMotionOf(config: ReadonlyArray<DesignConfigEntry> | null | undefined): DesignMotion;
 /** Resolved choices (+ the revert snapshot) → the config array a settings row stores. */
 declare function designConfigEntries(choices: DesignChoices, flavorVersion: string | number, revert?: FlavorRevertSnapshot | null): DesignConfigEntry[];
 /** Two choice sets describe the same look (fonts compared by role). */
@@ -13456,5 +13651,5 @@ interface FontFamilyRemoval {
  */
 declare function planFontFamilyRemoval(existing: ReadonlyArray<StoredDesignTokenRow>, previous: StoredDesign, family: string): FontFamilyRemoval;
 
-export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BAR_RESERVE_BREAKPOINTS, BAR_RESERVE_CLASS, BOTTOM_BAR_STYLE, BUTTON_VARIANT_TO_STYLE, CANVAS_LINK_ATTRIBUTE, CARD_LINK_CLASS, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, INHERITED_TEXT, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_TINT_DEFAULT, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SCHEME_INK, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SCHEME_INK, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, barReserveClass, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designApplySnapshot, designBaseline, designConfigEntries, designModeOf, designRevertConfig, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, headingHref, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, releaseElementStyle, resolveDesignChoices, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, roleClass, sameDesignChoices, setColorScheme, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, withSchemeInk, writeOwnedTrait };
-export type { AccentBackgrounds, AccentGround, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, ApplyElementStyleResult, ButtonBlockLinkProps, ColourCheck, ColourFlavor, ContrastFinding, DensityId, DesignApplyOptions, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignRevertSnapshot, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorColours, FlavorPack, FlavorPackV2, FlavorPalette, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedOptions, FlavorSeedPlan, FlavorSpecToken, FlavorTintConfig, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, NodeLinkProps, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, Rgba, SchemeId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TintId, TintLevel, TokenCssBlocks, TokenCssOptions };
+export { ACCENT_TOKEN_NAMES, ANIMATE_IDS, AdoptOutcome, AdoptSkipReason, BAR_RESERVE_BREAKPOINTS, BAR_RESERVE_CLASS, BETWEEN_IDS, BOTTOM_BAR_STYLE, BUTTON_VARIANT_TO_STYLE, CANVAS_LINK_ATTRIBUTE, CARD_LINK_CLASS, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, INHERITED_TEXT, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_MOTION, PRE_TINT_DEFAULT, REDUCED_DESIGN_MOTION, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SCHEME_INK, SCROLL_IDS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SCHEME_INK, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, barReserveClass, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designApplySnapshot, designBaseline, designConfigEntries, designModeOf, designMotionOf, designRevertConfig, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, headingHref, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, releaseElementStyle, resolveDesignChoices, resolveDesignMotion, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, roleClass, sameDesignChoices, setColorScheme, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, withSchemeInk, writeOwnedTrait };
+export type { AccentBackgrounds, AccentGround, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, AnimateId, ApplyElementStyleResult, BetweenId, ButtonBlockLinkProps, ColourCheck, ColourFlavor, ContrastFinding, DensityId, DesignApplyOptions, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignMotion, DesignRevertSnapshot, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorColours, FlavorPack, FlavorPackV2, FlavorPalette, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedOptions, FlavorSeedPlan, FlavorSpecToken, FlavorTintConfig, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, NodeLinkProps, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, Rgba, SchemeId, ScrollId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TintId, TintLevel, TokenCssBlocks, TokenCssOptions };

package/fesm2022/vectoriox-iox-ui-design-core.mjs

@@ -1425,6 +1425,208 @@ const SPEC_AXES = {
                 "inverse-line": 0.03
             }
         }
+    },
+    "scrolls": {
+        "normal": {
+            "label": "Normal",
+            "he": "רגילה",
+            "hint": "The browser's own scrolling.",
+            "lenis": null
+        },
+        "smooth": {
+            "label": "Smooth",
+            "he": "חלקה",
+            "hint": "A short glide after each wheel turn — what every IOX site does today.",
+            "lenis": {
+                "duration": 1.2,
+                "easing": "expo-out",
+                "wheelMultiplier": 1,
+                "syncTouch": false
+            }
+        },
+        "extra": {
+            "label": "Extra smooth",
+            "he": "חלקה מאוד",
+            "hint": "A longer, softer glide; each wheel turn moves a little less.",
+            "lenis": {
+                "duration": 1.8,
+                "easing": "expo-out",
+                "wheelMultiplier": 0.9,
+                "syncTouch": false
+            }
+        }
+    },
+    "animations": {
+        "still": {
+            "label": "Still",
+            "he": "ללא",
+            "hint": "Nothing moves in as you scroll. Buttons and cards still respond to the pointer (Speed).",
+            "parts": {}
+        },
+        "subtle": {
+            "label": "Subtle",
+            "he": "עדינה",
+            "hint": "Each section's content fades in once, together.",
+            "parts": {
+                "content": {
+                    "type": "fadeIn",
+                    "duration": 500
+                }
+            }
+        },
+        "standard": {
+            "label": "Standard",
+            "he": "רגילה",
+            "hint": "Headings rise in; cards, prices and steps follow one after another.",
+            "parts": {
+                "heading": {
+                    "type": "moveUp",
+                    "distance": 16,
+                    "duration": 500
+                },
+                "items": {
+                    "type": "moveUp",
+                    "distance": 16,
+                    "duration": 450,
+                    "stagger": 80,
+                    "cap": 6
+                },
+                "media": {
+                    "type": "fadeIn",
+                    "duration": 600
+                }
+            }
+        },
+        "lively": {
+            "label": "Lively",
+            "he": "תוססת",
+            "hint": "Bigger, longer entrances; side-by-side rows slide in from their side; the hero's words fade in.",
+            "parts": {
+                "heroText": {
+                    "type": "fadeIn",
+                    "duration": 400
+                },
+                "heading": {
+                    "type": "moveUp",
+                    "distance": 24,
+                    "duration": 600
+                },
+                "items": {
+                    "type": "moveUp",
+                    "distance": 24,
+                    "duration": 600,
+                    "stagger": 100,
+                    "cap": 8
+                },
+                "media": {
+                    "type": "fadeIn",
+                    "duration": 700
+                },
+                "rowMedia": {
+                    "type": "moveLeft",
+                    "mirror": "moveRight",
+                    "distance": 24,
+                    "duration": 600
+                }
+            }
+        }
+    },
+    "animationFamilies": {
+        "nav": [],
+        "footer": [],
+        "hero": [
+            "heroText"
+        ],
+        "header": [
+            "heading"
+        ],
+        "detail": [
+            "heading",
+            "media"
+        ],
+        "proof": [
+            "content",
+            "heading",
+            "items"
+        ],
+        "feature": [
+            "content",
+            "heading",
+            "items",
+            "media",
+            "rowMedia"
+        ],
+        "collection": [
+            "content",
+            "heading",
+            "items"
+        ],
+        "story": [
+            "content",
+            "heading",
+            "media"
+        ],
+        "cta": [
+            "content",
+            "heading"
+        ],
+        "contact": [
+            "content",
+            "heading"
+        ],
+        "faq": [
+            "content",
+            "heading"
+        ],
+        "pricing": [
+            "content",
+            "heading",
+            "items"
+        ]
+    },
+    "betweens": {
+        "none": {
+            "label": "None",
+            "he": "ללא",
+            "hint": "The next page simply appears.",
+            "transition": "none"
+        },
+        "fade": {
+            "label": "Fade",
+            "he": "דהייה",
+            "hint": "The page fades into the next.",
+            "transition": "fade",
+            "feel": "snappy"
+        },
+        "slide": {
+            "label": "Slide",
+            "he": "החלקה",
+            "hint": "The next page pushes this one aside (from the left on a Hebrew site). On phones: Fade.",
+            "transition": "move-left",
+            "rtl": "move-right",
+            "feel": "smooth",
+            "phone": "fade"
+        },
+        "cinematic": {
+            "label": "Cinematic",
+            "he": "קולנועית",
+            "hint": "This page sinks back while the next rises over it. On phones: Fade.",
+            "transition": "parallax-up",
+            "feel": "cinematic",
+            "phone": "fade"
+        }
+    },
+    "motionChoices": {
+        "pre": {
+            "scroll": "smooth",
+            "animate": "still",
+            "between": "cinematic"
+        },
+        "reduced": {
+            "scroll": "normal",
+            "animate": "still",
+            "between": "none"
+        }
     }
 };
 const SPEC_SPRINGS = {
@@ -14016,6 +14218,13 @@ const DESIGN_TOKEN_GROUPS = ['colour', 'type', 'shape', 'depth', 'space', 'motio
 const TINT_IDS = Object.keys(SPEC_AXES.tints);
 /** What a studio that stored its look BEFORE the tint existed wears: exactly the look's own palette. */
 const PRE_TINT_DEFAULT = 'neutral';
+const SCROLL_IDS = Object.keys(SPEC_AXES.scrolls);
+const ANIMATE_IDS = Object.keys(SPEC_AXES.animations);
+const BETWEEN_IDS = Object.keys(SPEC_AXES.betweens);
+/** What a look stored BEFORE rev 3.1 wears: exactly what every live site did (Smooth · Still · Cinematic). */
+const PRE_MOTION = SPEC_AXES.motionChoices.pre;
+/** What a visitor who asks for reduced motion always gets, whatever the look chose. */
+const REDUCED_DESIGN_MOTION = SPEC_AXES.motionChoices.reduced;
 /** The spec's flavors, typed. Assignment here is the compile-time proof that the generated
  *  data fits `FlavorPackV2`. */
 const SPEC_FLAVORS = SPEC_FLAVOR_PACKS;
@@ -16503,6 +16712,7 @@ function defaultDesignChoices(pack) {
         seed: pack.seed,
         pairId: pack.pairs[0]?.id ?? '',
         ...pack.defaults,
+        ...PRE_MOTION,
     };
 }
 /**
@@ -16830,6 +17040,9 @@ var DesignConfigKey;
     DesignConfigKey["Mode"] = "mode";
     DesignConfigKey["Tint"] = "tint";
     DesignConfigKey["Fonts"] = "fonts";
+    DesignConfigKey["Scroll"] = "scroll";
+    DesignConfigKey["Animate"] = "animate";
+    DesignConfigKey["Between"] = "between";
     DesignConfigKey["Revert"] = "revert";
 })(DesignConfigKey || (DesignConfigKey = {}));
 const MODES = SPEC_AXES.modes;
@@ -16907,6 +17120,15 @@ function resolveDesignChoices(partial) {
         mode: (MODES.includes(asString(partial?.mode) ?? '') ? asString(partial?.mode) : pack.defaults.mode),
         tint: keyOf(SPEC_AXES.tints, asString(partial?.tint)) ?? pack.defaults.tint,
         ...(fonts ? { fonts } : {}),
+        ...resolveDesignMotion(partial),
+    };
+}
+/** The look's motion, completed: an absent or unknown choice reads `PRE_MOTION` — what the site already does. */
+function resolveDesignMotion(partial) {
+    return {
+        scroll: keyOf(SPEC_AXES.scrolls, asString(partial?.scroll)) ?? PRE_MOTION.scroll,
+        animate: keyOf(SPEC_AXES.animations, asString(partial?.animate)) ?? PRE_MOTION.animate,
+        between: keyOf(SPEC_AXES.betweens, asString(partial?.between)) ?? PRE_MOTION.between,
     };
 }
 /** The pack's own defaults for `flavorId` — what picking a card means before anything is tuned. */
@@ -16916,13 +17138,14 @@ function packDesignChoices(flavorId) {
 /**
  * What picking a pack card means, given the design the studio wears: the applied pack → the applied
  * choices; another pack → that pack's defaults, CARRYING the author's chosen fonts (§5b — a font the
- * author chose survives a pack switch unless the author changes it). Both picker homes call this.
+ * author chose survives a pack switch unless the author changes it) and the site's motion (rev 3.1 MO-D3 —
+ * how it scrolls and changes page is not a pack's, so a Look pick never resets it). Both picker homes call this.
  */
 function choicesForPack(flavorId, applied) {
     const pack = flavorPackById(flavorId) ?? defaultPack();
     if (applied && resolveDesignChoices(applied).flavorId === pack.id)
         return resolveDesignChoices(applied);
-    return resolveDesignChoices({ flavorId: pack.id, fonts: applied?.fonts });
+    return resolveDesignChoices({ flavorId: pack.id, fonts: applied?.fonts, ...resolveDesignMotion(applied) });
 }
 /**
  * A stored `settings.design` config → the resolved design. No row (or no config) → Crisp's defaults. A
@@ -16945,6 +17168,9 @@ function readDesignConfig(config, hasRow = !!config) {
         mode: map.get(DesignConfigKey.Mode),
         tint: (storedTint ?? undefined),
         fonts: map.get(DesignConfigKey.Fonts),
+        scroll: map.get(DesignConfigKey.Scroll),
+        animate: map.get(DesignConfigKey.Animate),
+        between: map.get(DesignConfigKey.Between),
     });
     return {
         choices,
@@ -16959,6 +17185,10 @@ function readDesignConfig(config, hasRow = !!config) {
 function designModeOf(config) {
     return readDesignConfig(config).choices.mode;
 }
+/** The look's motion of a stored config — what the public page read hands the engine (`designMotion`). */
+function designMotionOf(config) {
+    return resolveDesignMotion(readDesignConfig(config).choices);
+}
 /** Resolved choices (+ the revert snapshot) → the config array a settings row stores. */
 function designConfigEntries(choices, flavorVersion, revert) {
     const c = resolveDesignChoices(choices);
@@ -16973,6 +17203,9 @@ function designConfigEntries(choices, flavorVersion, revert) {
         { key: DesignConfigKey.PillButtons, value: String(c.pillButtons) },
         { key: DesignConfigKey.Mode, value: c.mode },
         { key: DesignConfigKey.Tint, value: c.tint },
+        { key: DesignConfigKey.Scroll, value: c.scroll },
+        { key: DesignConfigKey.Animate, value: c.animate },
+        { key: DesignConfigKey.Between, value: c.between },
         ...(c.fonts ? [{ key: DesignConfigKey.Fonts, value: JSON.stringify(c.fonts) }] : []),
         ...(revert ? [{ key: DesignConfigKey.Revert, value: JSON.stringify(revert) }] : []),
     ];
@@ -16984,6 +17217,7 @@ function sameDesignChoices(a, b) {
     return x.flavorId === y.flavorId && x.seed.toLowerCase() === y.seed.toLowerCase() && x.pairId === y.pairId
         && x.shape === y.shape && x.density === y.density && x.motion === y.motion
         && x.pillButtons === y.pillButtons && x.mode === y.mode && x.tint === y.tint
+        && x.scroll === y.scroll && x.animate === y.animate && x.between === y.between
         && JSON.stringify(x.fonts ?? {}) === JSON.stringify(y.fonts ?? {});
 }
 
@@ -17256,5 +17490,5 @@ function planFontFamilyRemoval(existing, previous, family) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BAR_RESERVE_BREAKPOINTS, BAR_RESERVE_CLASS, BOTTOM_BAR_STYLE, BUTTON_VARIANT_TO_STYLE, CANVAS_LINK_ATTRIBUTE, CARD_LINK_CLASS, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, INHERITED_TEXT, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_TINT_DEFAULT, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SCHEME_INK, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SCHEME_INK, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, barReserveClass, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designApplySnapshot, designBaseline, designConfigEntries, designModeOf, designRevertConfig, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, headingHref, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, releaseElementStyle, resolveDesignChoices, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, roleClass, sameDesignChoices, setColorScheme, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, withSchemeInk, writeOwnedTrait };
+export { ACCENT_TOKEN_NAMES, ANIMATE_IDS, AdoptOutcome, AdoptSkipReason, BAR_RESERVE_BREAKPOINTS, BAR_RESERVE_CLASS, BETWEEN_IDS, BOTTOM_BAR_STYLE, BUTTON_VARIANT_TO_STYLE, CANVAS_LINK_ATTRIBUTE, CARD_LINK_CLASS, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, ColourCheckId, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, HELD_CONTRAST, INHERITED_TEXT, LinkType, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, PRE_MOTION, PRE_TINT_DEFAULT, REDUCED_DESIGN_MOTION, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SCHEME_INK, SCROLL_IDS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_CONTRAST_AUDIT, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_INK_SCOPES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SCHEME_INK, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, TINT_FULL_CHROMA, TINT_IDS, TINT_LEVELS, TINT_OWN_HUE_CHROMA, TINT_TURN_CHROMA, USER_TOKEN_SOURCE, WCAG_AA_TEXT, WCAG_AA_UI, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, atLightness, atLightnessMaxChroma, auditDesignContrast, barReserveClass, buildFlavorTokens, buildFontFaceCss, buttonBlockHref, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, colourTabChecks, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, compositeOver, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designApplySnapshot, designBaseline, designConfigEntries, designModeOf, designMotionOf, designRevertConfig, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, ensureAlpha, ensureContrast, flavorColours, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, headingHref, inSrgbGamut, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyDesignTokenRows, legacyFlavorTokens, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, paintColours, parseCssColour, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, preTintAccentGrounds, previewElementStyleAdoption, previewFontWeight, quantizeRgb, readDesignConfig, readOwnedTrait, relativeLuminance, releaseElementStyle, resolveDesignChoices, resolveDesignMotion, resolveSchemeTokenValues, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, ringColour, roleClass, sameDesignChoices, setColorScheme, specTokenNames, splitTopLevel, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, withSchemeInk, writeOwnedTrait };
 //# sourceMappingURL=vectoriox-iox-ui-design-core.mjs.map