@vectoriox/iox-ui 5.47.0 → 5.49.0

package/generation-core/index.d.ts

@@ -1,4 +1,4 @@
-import { DesignChoices } from '@vectoriox/iox-ui/design-core';
+import { DesignChoices, AnimateId } from '@vectoriox/iox-ui/design-core';
 
 declare const SPEC_SITE_PLAN_SHAPE: {
     readonly plan: {
@@ -2709,5 +2709,111 @@ declare function removeBarItem(globals: ReadonlyArray<SerializedNode>, itemId: s
 /** The bar's Items list drag-to-reorder (board 2): item `from` moves to `to`. Input not mutated. */
 declare function moveBarItem(globals: ReadonlyArray<SerializedNode>, from: number, to: number): BarItemsEditResult;
 
-export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, findNavRoot, isNonEmptyString, isPlainObject, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, siteNavPages, validateSitePlan, walkSerialized };
-export type { AddBarItemResult, BarItemsEditResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, FactKey, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PagePlan, PageSectionPlan, PathIssue, PatternNode, PlainObject, RelativeDataSourcePlan, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };
+/**
+ * How animated (AI plan rev 3.1 §3p) — the ONE reading of the contract's `axes.animations` (what each level
+ * moves, how) and `axes.animationFamilies` (which parts a section family lets move). The pieces every stamper
+ * shares: the Design step's business specimen (H4-4) today, `planEntrances` in the composer (M1-6b) next. Pure.
+ *
+ * A level with `content` moves a section's content together, once; otherwise it names parts (heading, items,
+ * media…) and each part enters on its own, items one after another. Navigation, footers and globals are a family
+ * with no parts, so nothing there ever moves.
+ */
+declare enum EntrancePart {
+    Content = "content",
+    Heading = "heading",
+    Items = "items",
+    Media = "media",
+    RowMedia = "rowMedia",
+    HeroText = "heroText"
+}
+/** What an entrance stamp is marked with — a later restamp touches only what the look made (H4-5). */
+declare const ENTRANCE_ORIGIN_LOOK = "look";
+/** The trigger every entrance plays on. */
+declare const ENTRANCE_TRIGGER = "viewportEnter";
+/** The easing every entrance plays with (only `opacity` and `transform` move). */
+declare const ENTRANCE_EASING = "ease-out";
+/** One entrance as the contract states it. */
+interface EntranceSpec {
+    readonly type: string;
+    readonly duration: number;
+    readonly distance?: number;
+    /** Items: ms added per item, up to `cap` items. */
+    readonly stagger?: number;
+    readonly cap?: number;
+    /** The type a right-to-left page plays instead (a side-by-side row slides in from ITS side). */
+    readonly mirror?: string;
+}
+/** What one section family moves at one level. `content` set = the whole content together, and no parts. */
+interface SectionEntrances {
+    readonly content: EntranceSpec | null;
+    readonly parts: Readonly<Partial<Record<EntrancePart, EntranceSpec>>>;
+}
+/** The interaction action a stamp carries — the shape both interaction runtimes play. */
+interface EntranceAction {
+    type: string;
+    target: 'self';
+    duration: number;
+    delay: number;
+    easing: typeof ENTRANCE_EASING;
+    once: true;
+    params?: {
+        distance: number;
+    };
+}
+interface EntranceInteraction {
+    id: string;
+    trigger: typeof ENTRANCE_TRIGGER;
+    actions: [EntranceAction];
+    origin: typeof ENTRANCE_ORIGIN_LOOK;
+}
+/** What a section of `family` moves at `level` — nothing for an unknown level or family. */
+declare function sectionEntrances(level: AnimateId | string | null | undefined, family: string): SectionEntrances;
+/** The literal delay of the `index`-th item: `stagger` ms each, the last `cap` waiting no longer than the one before. */
+declare function staggerDelay(spec: EntranceSpec, index?: number): number;
+/** The action a node plays: the spec's type (mirrored on a right-to-left page), its distance and its delay. */
+declare function entranceAction(spec: EntranceSpec, opts?: {
+    index?: number;
+    rtl?: boolean;
+}): EntranceAction;
+/** The stamp on a node: `viewportEnter`, once, on itself (a duplicated node needs no remap), from the look. */
+declare function entranceInteraction(nodeId: string, action: EntranceAction): EntranceInteraction;
+
+/**
+ * What each page of a plan shows and where its data comes from (AI plan rev 3 §3d, `describePlanData`) — the
+ * Plan step's data lines, in the vocabulary the builder already uses. Pure and STRUCTURED: the screen words
+ * each kind in its own language ("Lists every Project", "One Project, found by its address /work/:slug").
+ */
+declare enum PageDataKind {
+    /** A section repeats every item of a content type. */
+    List = "list",
+    /** A section repeats the newest `count` items. */
+    Latest = "latest",
+    /** A template page: one item, found by its address — one page per item. */
+    One = "one",
+    /** The next (or previous) item beside the page's own. */
+    Siblings = "siblings",
+    /** A form: what it sends, to the studio's inbox (+ an email when Email is connected). */
+    Form = "form",
+    /** Words and pictures, no data. */
+    Static = "static"
+}
+interface PageDataLine {
+    kind: PageDataKind;
+    /** The content type's label ("Projects"), for every kind that reads one. */
+    contentType?: string;
+    /** Latest: how many. */
+    count?: number;
+    /** One: the page's own address, with its parameter. */
+    route?: string;
+    /** Form: the form preset (`contact`). */
+    form?: string;
+}
+interface PageData {
+    pageKey: string;
+    lines: PageDataLine[];
+}
+/** One entry per page of the plan, in plan order. */
+declare function describePlanData(plan: SitePlan): PageData[];
+
+export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, describePlanData, entranceAction, entranceInteraction, findNavRoot, isNonEmptyString, isPlainObject, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, sectionEntrances, setStyleProps, shapeKeys, siteNavPages, staggerDelay, validateSitePlan, walkSerialized };
+export type { AddBarItemResult, BarItemsEditResult, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, DataSourcePlan, EntranceAction, EntranceInteraction, EntranceSpec, FactKey, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, PageData, PageDataLine, PagePlan, PageSectionPlan, PathIssue, PatternNode, PlainObject, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, SiteBusiness, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, TemplatePlanInput };

package/harness-core/index.d.ts

@@ -2279,9 +2279,21 @@ interface MotionInput {
     businessType?: string | null;
     avoid?: ReadonlyArray<string>;
 }
+/** Where the start came from, structured (the screen words it in its own language). */
+interface MotionBasis {
+    /** The kind of business it started from (null: no type matched, the style's own). */
+    type: string | null;
+    /** The style made How animated calmer than the business (or the references) wanted. */
+    calmerStyle: boolean;
+    /** The references set How animated. */
+    references: boolean;
+    /** The owner asked for little movement: all three were capped. */
+    littleMovement: boolean;
+}
 interface MotionStart extends DesignMotion {
     /** Why, in English — one line per step the start took. */
     why: string[];
+    basis: MotionBasis;
 }
 /** The owner asked for little movement (`USER_AVOID_IDS`). */
 declare const LITTLE_MOVEMENT_AVOID = "lots-of-motion";
@@ -2345,6 +2357,13 @@ declare function oklchHue(hex: string): {
     chroma: number;
 } | null;
 declare function lintDesign(site: LintSite, typeId: string, types?: ReadonlyArray<BusinessType>): LintFinding[];
+/**
+ * Rev 3.1: two levels above what this kind of business usually wears (Subtle → Lively) is advice, never a block.
+ * Structured, so Design ▸ Motion says it in the studio's language: `usual` = the level the type wears.
+ */
+declare function motionAdvice(typeId: string | null | undefined, animate: AnimateId | string | null | undefined, types?: ReadonlyArray<BusinessType>): {
+    usual: AnimateId;
+} | null;
 
 /**
  * What the reading of a prompt returns (AI plan rev 3 §3d): one of the 30 kinds of business (and the two
@@ -2475,5 +2494,24 @@ interface PromptContextOptions {
 }
 declare function analysisPromptContext(analysis: SiteAnalysis, opts?: PromptContextOptions): PromptContext;
 
-export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, NEEDS, NEED_IDS, NeedSource, PresetFit, RANK_WEIGHTS, READ_ANIMATE, READ_WEIGHTS, RankReason, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, analysisPromptContext, businessTypeById, calmerChoice, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, motionFor, oklchHue, presetHasSerifHeadings, presetLook, rankStylePresets, rankWithReferences, userAvoidRule, validateSiteAnalysis };
-export type { AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, CheckRule, FactRead, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MotionInput, MotionStart, NeedDef, NeedId, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, SiteAnalysis, SiteNeed, StructureId, StyleHints, StyleRead, UserAvoidId };
+interface BusinessTypeMatch {
+    id: string;
+    /** The keywords found, in the type's order. */
+    keywords: string[];
+    /** The letters matched — longer, more specific keywords weigh more ("barber" over "bar"). */
+    score: number;
+}
+/** The kind of business the words name, best first; empty when none of the keywords appears. Ties keep the board's order. */
+declare function matchBusinessTypes(text: string, types?: ReadonlyArray<BusinessType>): BusinessTypeMatch[];
+/** The single best kind of business the words name, or null. */
+declare function matchBusinessType(text: string, types?: ReadonlyArray<BusinessType>): string | null;
+/** An address as a chip shows it: no scheme, no `www.`, no trailing punctuation or slash, lower-case host. */
+declare function normalizeAddress(raw: string): string;
+/** Every website address typed or pasted in the words (an http(s) address or a bare domain), once each, in
+ *  order. An email address is not a website. */
+declare function addressesIn(text: string): string[];
+/** The words without one address (removing its chip): every spelling of it, and the space it leaves. */
+declare function withoutAddress(text: string, address: string): string;
+
+export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, NEEDS, NEED_IDS, NeedSource, PresetFit, RANK_WEIGHTS, READ_ANIMATE, READ_WEIGHTS, RankReason, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisPromptContext, businessTypeById, calmerChoice, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, motionAdvice, motionFor, normalizeAddress, oklchHue, presetHasSerifHeadings, presetLook, rankStylePresets, rankWithReferences, userAvoidRule, validateSiteAnalysis, withoutAddress };
+export type { AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, BusinessTypeMatch, CheckRule, FactRead, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, SiteAnalysis, SiteNeed, StructureId, StyleHints, StyleRead, UserAvoidId };

package/index.d.ts

@@ -113,13 +113,15 @@ interface PageScrollStart {
  * Scrolling choice (`planScroll`); `scrollTo` actions and the dialog lock go through it whether or not
  * Lenis runs. Never on the server: there is no window to scroll.
  */
-declare class PageScrollProvider {
+declare class PageScrollProvider implements OnDestroy {
     private zone;
     private lenis;
     private rafId?;
     private wrapper;
     private lockedOverflow;
     init(start: PageScrollStart): void;
+    /** Provided by a component (a page, the Design step's specimen): its Lenis and loop go with it. */
+    ngOnDestroy(): void;
     /** Stop Lenis and its loop; the page falls back to the browser's own scrolling. */
     destroy(): void;
     /** Hard-stop page scroll (dialog open, A1b): wheel/touch frozen until start(). */
@@ -3034,6 +3036,23 @@ declare function hasOwnPageTransition(anim: RouteAnimationLike | null | undefine
  */
 declare function pageTransitionOf(anim: RouteAnimationLike | null | undefined, ctx?: PageTransitionContext): PlannedPageTransition;
 
+/** The two layers a builder preview of a page change plays on, and the stage that holds them. */
+interface TransitionPreviewLayers {
+    /** Holds both layers; it carries the perspective the 3D presets need. */
+    stage: HTMLElement;
+    /** The page that leaves. */
+    out: HTMLElement | null;
+    /** The page that arrives. */
+    in: HTMLElement | null;
+}
+/**
+ * Play a resolved page change (`resolvePageTransition`) on two stacked layers — the ONE dual-layer preview the
+ * builder's Page panel and the Design step's specimen both play (rev 3.1 §3o). The live site plays the same
+ * frames through its own transition service. Resolves when the arriving layer has finished (or at once when
+ * there is no arriving layer). The layers are left at their last frame: the caller decides what to show after.
+ */
+declare function playDualLayerTransition(resolved: ResolvedPageTransition, layers: TransitionPreviewLayers): Promise<void>;
+
 /**
  * Gallery effect registry — the SHARED, effect-agnostic description of how each gallery slide looks
  * and animates in a given crossfade state. Modeled on `binding-pipes.ts` / `PAGE_TRANSITION_PRESETS`:
@@ -3156,5 +3175,5 @@ declare class GalleryLoop {
     private emit;
 }
 
-export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, NO_PAGE_TRANSITION, ON_STATE_ROLES, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PHONE_TRANSITION_QUERY, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, SCROLL_EASINGS, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, ScrollEasing, SectionComponent, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildInteractionKeyframes, buildPartSelector, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, feelFor, finalKeyframe, getSeoValue, hasHoverState, hasOwnPageTransition, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isLastEmittedStateKey, isOverriddenAt, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeGalleryImage, normalizeIconClass, orderStatesForEmit, pageTransitionOf, parentBreakpoint, parseUrlList, partClassName, planResponsiveRules, planScroll, planSwiperOptions, prefersReducedMotion, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveSeo, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, sliderControlElements, sliderInputsFromProps, sliderInputsOf, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, targetedStateSelector, viewportTransitionContext, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
-export type { A11yNodeSource, BoundValueSpec, BreakpointDef, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageScrollStart, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionContext, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, PlannedPageTransition, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteAnimationLike, ScrollPlanContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SliderBootOptions, SliderControlElements, SliderInputs, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToggleableAction, TransitionFeel, TransitionPhase, TransitionTimelineInput, TransitionViewport, ValueSource, VirtualTraitGroup };
+export { A11yAttribute, A11yTrait, ACCESSIBLE_NAME_TYPES, AOSService, ARIA_CURRENT_PAGE, BACKDROP_TWIN_KEY, BACKDROP_WHOLE_KEY, BREAKPOINTS, Breakpoint, BreakpointQueryKind, BuilderButtonComponent, BuilderDividerComponent, BuilderHeadingComponent, BuilderIconComponent, BuilderImageComponent, BuilderLinkComponent, BuilderSpacerComponent, ButtonBlockComponent, COMPONENT_STATE_SELECTOR, CONTAINER_HTML_TAGS, CONTEXT_ACTION_TYPES, CURRENT_LINK_TYPES, CardComponent, ClientGalleryComponent, ClientListComponent, ClientListItemComponent, ClientRepeaterComponent, ClientSliderContainerComponent, ClientSliderSlideComponent, ComponentInstanceRegistryService, ComponentState, ContainerComponent, ContextStore, DECORATIVE_TYPES, DEFAULT_GALLERY_SCHEDULER, DEFAULT_PAGE_TRANSITION, DEFAULT_PAGE_TRANSITION_DURATION, DEFAULT_PAGE_TRANSITION_EASING, DEFAULT_PAGE_TRANSITION_PERSPECTIVE, DEFAULT_PHOSPHOR_WEIGHT, DEFAULT_WIDTH_BY_TYPE, DIALOG_CLOSE_ABOVE_ATTRIBUTE, DIALOG_NODE_TYPE, DeclarationContext, ENTRANCE_ACTION_TYPES, EXIT_ACTION_TYPES, FormRenderState, FormRuntimeService, GALLERY_EFFECTS, GALLERY_EFFECT_DESCRIPTORS, GalleryLoop, HOVER_DEFAULT_TRANSITION, HOVER_STATES, INTERACTION_HIDDEN_ATTRIBUTE, IOX_BUILDER_EVENTS, IOX_FORM_MESSAGES, IOX_FORM_NAVIGATOR, IOX_FORM_TRANSPORT, IS_PREVIEW, IoxAnimateContainer, IoxAosDirective, IoxAosModule, IoxBuilderComponentsModule, IoxComponentRegistryService, IoxDialogComponent, IoxFieldComponent, IoxFormComponent, IoxFormErrorComponent, IoxFormSuccessComponent, IoxPageComponent, IoxPageModule, IoxSubmitButtonComponent, IoxUiModule, IoxVideoComponent, LAST_EMITTED_STATES, LEGACY_DIRECTION_KEY, LEGACY_HOVER_TRANSITION, LEGACY_SWIPER_CONTROLS, LinkedContainerComponent, MANAGED_A11Y_ATTRIBUTES, MAX_LINES_KEY, NAMED_GROUP_ROLES, NO_PAGE_TRANSITION, ON_STATE_ROLES, PAGE_STYLE_TOKENS, PAGE_TOKEN_FALLBACKS, PAGE_TRANSITION_CATEGORIES, PAGE_TRANSITION_PRESETS, PART_CLASS_NAMES, PART_PAGINATION_MODIFIER, PHONE_TRANSITION_QUERY, PIPE_DESCRIPTORS, PIPE_REGISTRY, PageScrollProvider, PageStyleField, PageStyleSource, REDUCED_MOTION_QUERY, SCROLL_EASINGS, SLIDER_INPUTS_ATTRIBUTE, SLIDER_INPUT_NAMES, STATE_PSEUDO_CLASS, SUPPRESSED_STYLE_PROPS_BY_TYPE, SWIPER_A11Y_OPTIONS, SWIPER_RESPONSIVE_TRAITS, SWIPER_TRIGGER_EVENTS, ScrollEasing, SectionComponent, SwiperModuleName, TARGETED_STATE_SUFFIX, TEXT_ALIGN_KEY, TEXT_DIRECTION_KEY, TRANSITION_FEELS, TextAlign, TextBlockComponent, VALIDATION_STATES, VALIDATION_STATE_CLASS, VIRTUAL_TRAIT_GROUPS, VIRTUAL_TRAIT_KEYS, ViewPositionDirective, ViewPositionModule, VisibilityActionType, activeActions, applyBindingPipes, applyFeel, bootSlider, breakpointDef, breakpointForWidth, breakpointQueryFor, buildInteractionKeyframes, buildPartSelector, buildSwiperBreakpoints, buildTargetedStateSelector, buildTargetedSuffixSelector, buildTransitionTimeline, cascadeChain, clearInputOverride, clearOverride, closeAboveMediaQuery, collectContextSlotKeys, compileDeclarations, compilePageStyle, componentStatesFor, composeVirtualTraits, containerHtmlTag, contextActionEffect, contextSlotKeys, countOverrides, declaredInputNames, decomposeBackdropFilter, defaultHoverTransition, defaultMessageResolver, deriveSeoFromContent, describePageStyle, describeSeoFields, dialogCloseAboveMinWidth, domHasSliderParts, effectiveActionType, effectiveTransitionId, entrancePreStateStyle, feelFor, finalKeyframe, getSeoValue, hasHoverState, hasOwnPageTransition, hasOwnTransition, initialSlotValues, isActionEnabled, isContextAction, isCurrentLink, isExternalOrFragment, isGradientPaint, isInputOverriddenAt, isLastEmittedStateKey, isOverriddenAt, isValidSlotKey, isWholeBackdropSet, keyframePropertyName, keyframeStyleEntries, legacyEnterToTransition, mediaQueryFor, mergeSwiperBreakpoints, migrateLegacyDirection, migrateLegacyTextAlign, motionAllowed, nearestCommonAncestorId, needsAccessibleName, needsGroupName, nodeA11yAttributes, nodeCssId, nodeTraitValue, nodeUsesContext, normalizeAppPath, normalizeGalleryImage, normalizeIconClass, orderStatesForEmit, pageTransitionOf, parentBreakpoint, parseUrlList, partClassName, planResponsiveRules, planScroll, planSwiperOptions, playDualLayerTransition, prefersReducedMotion, renderDefaultDeclarations, resetPageStyleField, resetSeoField, resolveBoundValue, resolveContextValue, resolveGalleryEffect, resolveGalleryUrls, resolveInputChain, resolveInputs, resolvePageTransition, resolvePath, resolveSeo, resolveStateStyles, resolveStyleProps, resolveToggleVisibility, resolveValueChain, rewriteViewportUnits, safeSetInput, serializeA11yAttributes, setInputOverride, setOverride, setSeoAuto, setSeoBinding, setSeoOverride, setSeoValue, sliderControlElements, sliderInputsFromProps, sliderInputsOf, stateNamesIn, statePseudoClass, stateSelectorSuffix, stripSuppressedProps, swiperAutoplayAllowed, swiperLoopOptions, swiperModuleNames, syncNodeA11yAttributes, targetedStateSelector, viewportTransitionContext, withContextSlots, withDefaultHoverTransition, wrapInBreakpointQuery, wrapInMediaQuery };
+export type { A11yNodeSource, BoundValueSpec, BreakpointDef, ContextActionEffect, ContextActionLike, ContextItemRef, ContextSlotDefault, ContextValueSpec, ContextWriteScope, CurrentLinkOptions, FormMessageResolver, GalleryBoundSource, GalleryDurations, GalleryEffect, GalleryEffectDescriptor, GalleryImage, GalleryLoopOptions, GalleryLoopScheduler, GalleryLoopState, GallerySlideState, IBuilderEventEmitter, InputMap, InteractionKeyframe, IoxContextSlot, IoxPipe, MatchMediaHost, NodeA11yContext, OverrideBreakpoint, PageScrollStart, PageStyleFieldState, PageStyleOptions, PageStyleSettings, PageTransitionCategory, PageTransitionCategoryMeta, PageTransitionContext, PageTransitionOptions, PageTransitionPreset, PipeArgSpec, PipeContext, PipeDescriptor, PlannedPageTransition, ResolvedPageTransition, ResponsiveLayer, ResponsiveOverrides, ResponsiveRuleSet, RouteAnimationLike, ScrollPlanContext, SeoDerivedContent, SeoFieldSource, SeoFieldState, SeoResolveContext, SetContextParams, SliderBootOptions, SliderControlElements, SliderInputs, StateStyleMap, StyleMap, StyleTreeNode, SwiperBreakpointMap, SwiperModuleFlags, SwiperPlan, SwiperPlanContext, ToggleableAction, TransitionFeel, TransitionPhase, TransitionPreviewLayers, TransitionTimelineInput, TransitionViewport, ValueSource, VirtualTraitGroup };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vectoriox/iox-ui",
-  "version": "5.47.0",
+  "version": "5.49.0",
   "peerDependencies": {
     "@angular/common": ">=20.0.0",
     "@angular/core": ">=20.0.0",

package/src/design-core/design-apply.ts

@@ -8,7 +8,7 @@ import {
 } from './flavor-seed';
 import { DesignChoices, DesignTokenRow, flavorSourceStamp, StoredDesignTokenRow } from './design-token.model';
 import { FONT_FAMILY_TOKENS, fontFamilyKey, FontFamilyToken, fontRoleReferences, parseFontFamilies, withoutScriptPartners } from './fonts';
-import { DesignConfigEntry, DesignConfigKey, designConfigEntries, flavorPackById, isRetiredFlavorId, packDesignChoices, StoredDesign } from './design-settings';
+import { DesignConfigEntry, DesignConfigKey, designConfigEntries, flavorPackById, isRetiredFlavorId, packDesignChoices, sameDesignChoices, StoredDesign } from './design-settings';
 
 /**
  * Applying a look (design-system DS4): the COMPLETE `buildFlavorTokens` set for the chosen
@@ -147,8 +147,10 @@ export interface DesignRevertSnapshot extends FlavorRevertSnapshot {
  * What an Apply of `plan` stores as its revert snapshot — the ONE rule the builder's Apply and the
  * server-side site build (W2) share: the whole pre-apply token set, what the apply writes into each row,
  * and where a revert goes back to — never a null flavor (a studio with no design row wore its design's
- * defaults, so that is what it returns to). An apply that writes nothing keeps the previous snapshot:
- * clobbering a useful one with "nothing changed" would be a lie.
+ * defaults, so that is what it returns to). An apply that changes NOTHING keeps the previous snapshot:
+ * clobbering a useful one with "nothing changed" would be a lie. A choice that lives in the config only
+ * (Scrolling · How animated · Between pages) IS a change — pass `next` so a motion-only Apply gets its own
+ * snapshot and Revert goes back to the motion worn just before it (vectoriox/iox-ui#28).
  */
 export function designApplySnapshot(
     previous: StoredDesign,
@@ -156,8 +158,10 @@ export function designApplySnapshot(
     existing: ReadonlyArray<StoredDesignTokenRow>,
     plan: FlavorSeedPlan,
     appliedAt: number,
+    next?: DesignChoices,
 ): DesignRevertSnapshot | null {
-    if (!plan.create.length && !plan.update.length) return previous.revert;
+    const wroteTokens = plan.create.length > 0 || plan.update.length > 0;
+    if (!wroteTokens && (!next || sameDesignChoices(previous.choices, next))) return previous.revert;
     const origin: Pick<DesignRevertSnapshot, 'from' | 'fromConfig'> = previous.storedFlavorId
         ? {
             from: { flavorId: previous.storedFlavorId, flavorVersion: previous.flavorVersion, brandSeed: previous.storedSeed },

package/src/generation-core/entrances.ts

@@ -0,0 +1,110 @@
+import { AnimateId, SPEC_AXES } from '@vectoriox/iox-ui/design-core';
+
+/**
+ * How animated (AI plan rev 3.1 §3p) — the ONE reading of the contract's `axes.animations` (what each level
+ * moves, how) and `axes.animationFamilies` (which parts a section family lets move). The pieces every stamper
+ * shares: the Design step's business specimen (H4-4) today, `planEntrances` in the composer (M1-6b) next. Pure.
+ *
+ * A level with `content` moves a section's content together, once; otherwise it names parts (heading, items,
+ * media…) and each part enters on its own, items one after another. Navigation, footers and globals are a family
+ * with no parts, so nothing there ever moves.
+ */
+
+export enum EntrancePart {
+    Content = 'content',
+    Heading = 'heading',
+    Items = 'items',
+    Media = 'media',
+    RowMedia = 'rowMedia',
+    HeroText = 'heroText',
+}
+
+/** What an entrance stamp is marked with — a later restamp touches only what the look made (H4-5). */
+export const ENTRANCE_ORIGIN_LOOK = 'look';
+/** The trigger every entrance plays on. */
+export const ENTRANCE_TRIGGER = 'viewportEnter';
+/** The easing every entrance plays with (only `opacity` and `transform` move). */
+export const ENTRANCE_EASING = 'ease-out';
+
+/** One entrance as the contract states it. */
+export interface EntranceSpec {
+    readonly type: string;
+    readonly duration: number;
+    readonly distance?: number;
+    /** Items: ms added per item, up to `cap` items. */
+    readonly stagger?: number;
+    readonly cap?: number;
+    /** The type a right-to-left page plays instead (a side-by-side row slides in from ITS side). */
+    readonly mirror?: string;
+}
+
+/** What one section family moves at one level. `content` set = the whole content together, and no parts. */
+export interface SectionEntrances {
+    readonly content: EntranceSpec | null;
+    readonly parts: Readonly<Partial<Record<EntrancePart, EntranceSpec>>>;
+}
+
+/** The interaction action a stamp carries — the shape both interaction runtimes play. */
+export interface EntranceAction {
+    type: string;
+    target: 'self';
+    duration: number;
+    delay: number;
+    easing: typeof ENTRANCE_EASING;
+    once: true;
+    params?: { distance: number };
+}
+
+export interface EntranceInteraction {
+    id: string;
+    trigger: typeof ENTRANCE_TRIGGER;
+    actions: [EntranceAction];
+    origin: typeof ENTRANCE_ORIGIN_LOOK;
+}
+
+type Level = Readonly<{ parts: Readonly<Partial<Record<EntrancePart, EntranceSpec>>> }>;
+const LEVELS = SPEC_AXES.animations as unknown as Readonly<Record<string, Level>>;
+const FAMILIES = SPEC_AXES.animationFamilies as unknown as Readonly<Record<string, ReadonlyArray<EntrancePart>>>;
+
+const NOTHING: SectionEntrances = { content: null, parts: {} };
+
+/** What a section of `family` moves at `level` — nothing for an unknown level or family. */
+export function sectionEntrances(level: AnimateId | string | null | undefined, family: string): SectionEntrances {
+    const lv = level ? LEVELS[level] : undefined;
+    const allow = FAMILIES[family] ?? [];
+    if (!lv || !allow.length) return NOTHING;
+    if (lv.parts.content && allow.includes(EntrancePart.Content)) return { content: lv.parts.content, parts: {} };
+    const parts: Partial<Record<EntrancePart, EntranceSpec>> = {};
+    for (const part of allow) {
+        if (part === EntrancePart.Content) continue;
+        // A level without its own side-by-side entrance gives a row's picture the plain picture one.
+        const spec = lv.parts[part] ?? (part === EntrancePart.RowMedia ? lv.parts.media : undefined);
+        if (spec) parts[part] = spec;
+    }
+    return { content: null, parts };
+}
+
+/** The literal delay of the `index`-th item: `stagger` ms each, the last `cap` waiting no longer than the one before. */
+export function staggerDelay(spec: EntranceSpec, index = 0): number {
+    if (!spec.stagger) return 0;
+    const cap = Math.max(1, spec.cap ?? 1);
+    return Math.min(Math.max(0, index), cap - 1) * spec.stagger;
+}
+
+/** The action a node plays: the spec's type (mirrored on a right-to-left page), its distance and its delay. */
+export function entranceAction(spec: EntranceSpec, opts: { index?: number; rtl?: boolean } = {}): EntranceAction {
+    return {
+        type: opts.rtl && spec.mirror ? spec.mirror : spec.type,
+        target: 'self',
+        duration: spec.duration,
+        delay: staggerDelay(spec, opts.index),
+        easing: ENTRANCE_EASING,
+        once: true,
+        ...(spec.distance ? { params: { distance: spec.distance } } : {}),
+    };
+}
+
+/** The stamp on a node: `viewportEnter`, once, on itself (a duplicated node needs no remap), from the look. */
+export function entranceInteraction(nodeId: string, action: EntranceAction): EntranceInteraction {
+    return { id: `${nodeId}-enter`, trigger: ENTRANCE_TRIGGER, actions: [action], origin: ENTRANCE_ORIGIN_LOOK };
+}

package/src/generation-core/plan-data.ts

@@ -0,0 +1,71 @@
+import { BindScope, patternById, patternNodes, patternScopes } from './patterns';
+import { CmsDataSourcePlan, DataSourcePlan, PagePlan, PlanDataSourceMode, PlanDataSourceType, SitePlan } from './site-plan.model';
+
+/**
+ * What each page of a plan shows and where its data comes from (AI plan rev 3 §3d, `describePlanData`) — the
+ * Plan step's data lines, in the vocabulary the builder already uses. Pure and STRUCTURED: the screen words
+ * each kind in its own language ("Lists every Project", "One Project, found by its address /work/:slug").
+ */
+
+export enum PageDataKind {
+    /** A section repeats every item of a content type. */
+    List = 'list',
+    /** A section repeats the newest `count` items. */
+    Latest = 'latest',
+    /** A template page: one item, found by its address — one page per item. */
+    One = 'one',
+    /** The next (or previous) item beside the page's own. */
+    Siblings = 'siblings',
+    /** A form: what it sends, to the studio's inbox (+ an email when Email is connected). */
+    Form = 'form',
+    /** Words and pictures, no data. */
+    Static = 'static',
+}
+
+export interface PageDataLine {
+    kind: PageDataKind;
+    /** The content type's label ("Projects"), for every kind that reads one. */
+    contentType?: string;
+    /** Latest: how many. */
+    count?: number;
+    /** One: the page's own address, with its parameter. */
+    route?: string;
+    /** Form: the form preset (`contact`). */
+    form?: string;
+}
+
+export interface PageData {
+    pageKey: string;
+    lines: PageDataLine[];
+}
+
+const sameLine = (a: PageDataLine, b: PageDataLine) => JSON.stringify(a) === JSON.stringify(b);
+
+function sourceLine(source: DataSourcePlan | undefined, label: (name: string) => string): PageDataLine | null {
+    if (!source || source.type !== PlanDataSourceType.Cms) return null;
+    const cms = source as CmsDataSourcePlan;
+    if (cms.mode !== PlanDataSourceMode.Query) return null;
+    return cms.limit
+        ? { kind: PageDataKind.Latest, contentType: label(cms.contentType), count: cms.limit }
+        : { kind: PageDataKind.List, contentType: label(cms.contentType) };
+}
+
+function pageLines(page: PagePlan, plan: SitePlan, label: (name: string) => string): PageDataLine[] {
+    const lines: PageDataLine[] = [];
+    const add = (line: PageDataLine | null) => { if (line && !lines.some(l => sameLine(l, line))) lines.push(line); };
+    if (page.template) add({ kind: PageDataKind.One, contentType: label(page.template), route: page.route });
+    for (const section of page.sections) {
+        const pattern = patternById(section.pattern);
+        if (!pattern) continue;
+        if (section.binding) add(sourceLine(plan.dataSources.find(d => d.alias === section.binding), label));
+        if (page.template && patternScopes(pattern).has(BindScope.Next)) add({ kind: PageDataKind.Siblings, contentType: label(page.template) });
+        for (const node of patternNodes(pattern)) if (node.preset) add({ kind: PageDataKind.Form, form: node.preset });
+    }
+    return lines.length ? lines : [{ kind: PageDataKind.Static }];
+}
+
+/** One entry per page of the plan, in plan order. */
+export function describePlanData(plan: SitePlan): PageData[] {
+    const label = (name: string) => plan.contentTypes.find(t => t.name === name)?.label ?? name;
+    return plan.pages.map(page => ({ pageKey: page.key, lines: pageLines(page, plan, label) }));
+}

package/src/generation-core/public-api.ts

@@ -21,3 +21,5 @@ export * from './shape-check';
 export * from './validate-site-plan';
 export * from './compose-site';
 export * from './nav-shape';
+export * from './entrances';
+export * from './plan-data';

package/src/harness-core/intake.ts

@@ -0,0 +1,85 @@
+import { BUSINESS_TYPES, BusinessType } from './business-types';
+
+/**
+ * What Start reads from the owner's words BEFORE any model runs (AI plan rev 3 §3d step 0, N-D3): the kind of
+ * business by the contract's own keywords (`BusinessType.match` — "the no-model fallback"), and the addresses
+ * typed into the box (each becomes a "style only" reference chip, R1). Pure; the template path uses it today and
+ * the reading stage (M1-1) checks the model against the same match.
+ */
+
+/** A single Hebrew letter that prefixes a word (the, in, to, and, from, that, as) — "בסדנאות" holds "סדנ". */
+const HEBREW_PREFIX = '[הבלומשכ]?';
+
+const escapeRe = (s: string) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+const KEYWORD_RES = new Map<string, RegExp>();
+
+/** A keyword matches at the START of a word (so a stem — "סדנ", "consult" — matches its forms). */
+function keywordRe(keyword: string): RegExp {
+    let re = KEYWORD_RES.get(keyword);
+    if (!re) {
+        re = new RegExp(`(^|[^\\p{L}\\p{N}])${HEBREW_PREFIX}${escapeRe(keyword.toLocaleLowerCase())}`, 'u');
+        KEYWORD_RES.set(keyword, re);
+    }
+    return re;
+}
+
+export interface BusinessTypeMatch {
+    id: string;
+    /** The keywords found, in the type's order. */
+    keywords: string[];
+    /** The letters matched — longer, more specific keywords weigh more ("barber" over "bar"). */
+    score: number;
+}
+
+/** The kind of business the words name, best first; empty when none of the keywords appears. Ties keep the board's order. */
+export function matchBusinessTypes(text: string, types: ReadonlyArray<BusinessType> = BUSINESS_TYPES): BusinessTypeMatch[] {
+    const words = (text ?? '').toLocaleLowerCase();
+    if (!words.trim()) return [];
+    return types
+        .map((type, order) => {
+            const keywords = type.match.filter(k => keywordRe(k).test(words));
+            return { id: type.id, keywords, score: keywords.reduce((n, k) => n + k.length, 0), order };
+        })
+        .filter(m => m.score > 0)
+        .sort((a, b) => b.score - a.score || a.order - b.order)
+        .map(({ order, ...m }) => m);
+}
+
+/** The single best kind of business the words name, or null. */
+export function matchBusinessType(text: string, types: ReadonlyArray<BusinessType> = BUSINESS_TYPES): string | null {
+    return matchBusinessTypes(text, types)[0]?.id ?? null;
+}
+
+const ADDRESS_RE = /(?:https?:\/\/)?(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z]{2,}(?:\/[^\s<>"']*)?/gi;
+const TRAILING = /[.,;:!?)\]}'"״׳]+$/;
+
+/** An address as a chip shows it: no scheme, no `www.`, no trailing punctuation or slash, lower-case host. */
+export function normalizeAddress(raw: string): string {
+    const bare = raw.replace(TRAILING, '').replace(/^https?:\/\//i, '').replace(/^www\./i, '').replace(/\/+$/, '');
+    const slash = bare.indexOf('/');
+    return slash < 0 ? bare.toLowerCase() : bare.slice(0, slash).toLowerCase() + bare.slice(slash);
+}
+
+/** Every website address typed or pasted in the words (an http(s) address or a bare domain), once each, in
+ *  order. An email address is not a website. */
+export function addressesIn(text: string): string[] {
+    const found: string[] = [];
+    for (const m of (text ?? '').matchAll(ADDRESS_RE)) {
+        const before = m.index ? text[m.index - 1] : '';
+        if (before === '@' || /[\p{L}\p{N}_-]/u.test(before)) continue;
+        const address = normalizeAddress(m[0]);
+        if (address && !found.includes(address)) found.push(address);
+    }
+    return found;
+}
+
+/** The words without one address (removing its chip): every spelling of it, and the space it leaves. */
+export function withoutAddress(text: string, address: string): string {
+    const out = (text ?? '').replace(ADDRESS_RE, (m, offset: number, whole: string) => {
+        const before = offset ? whole[offset - 1] : '';
+        if (before === '@' || /[\p{L}\p{N}_-]/u.test(before)) return m;
+        return normalizeAddress(m) === address ? '' : m;
+    });
+    return out.replace(/[ \t]{2,}/g, ' ').replace(/ +([.,;:!?])/g, '$1').trim();
+}

package/src/harness-core/lint.ts

@@ -1,4 +1,4 @@
-import { DesignChoices, DesignMotion, parseHexColor, rgbToOklab, SPEC_AXES } from '@vectoriox/iox-ui/design-core';
+import { AnimateId, DesignChoices, DesignMotion, parseHexColor, rgbToOklab, SPEC_AXES } from '@vectoriox/iox-ui/design-core';
 import type { FactKey } from '@vectoriox/iox-ui/generation-core';
 
 import { AvoidCheck, BUSINESS_TYPES, BusinessType, COPY_LENGTH_ORDER, CopyLength, isLookRule } from './business-types';
@@ -85,10 +85,22 @@ export function lintDesign(site: LintSite, typeId: string, types: ReadonlyArray<
             }
         }
     }
-    // Rev 3.1: two levels above what this kind of business usually wears (Subtle → Lively) is advice, never a block.
-    if (site.design.animate && ANIMATE_ORDER.indexOf(site.design.animate) >= ANIMATE_ORDER.indexOf(type.moves.animate) + ANIMATE_ADVICE_STEPS) {
-        const usual = (SPEC_AXES.animations as Readonly<Record<string, { label: string }>>)[type.moves.animate].label;
+    const advice = motionAdvice(type.id, site.design.animate, types);
+    if (advice) {
+        const usual = (SPEC_AXES.animations as Readonly<Record<string, { label: string }>>)[advice.usual].label;
         out.push({ kind: LintKind.Look, say: `${type.label} sites usually move less (${usual}); this much movement as people scroll can feel restless.` });
     }
     return out;
 }
+
+/**
+ * Rev 3.1: two levels above what this kind of business usually wears (Subtle → Lively) is advice, never a block.
+ * Structured, so Design ▸ Motion says it in the studio's language: `usual` = the level the type wears.
+ */
+export function motionAdvice(
+    typeId: string | null | undefined, animate: AnimateId | string | null | undefined, types: ReadonlyArray<BusinessType> = BUSINESS_TYPES,
+): { usual: AnimateId } | null {
+    const type = typeId ? types.find(t => t.id === typeId) : undefined;
+    if (!type || !animate || !ANIMATE_ORDER.includes(animate)) return null;
+    return ANIMATE_ORDER.indexOf(animate) >= ANIMATE_ORDER.indexOf(type.moves.animate) + ANIMATE_ADVICE_STEPS ? { usual: type.moves.animate } : null;
+}