@vectoriox/iox-ui 5.48.0 → 5.49.0

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
@@ -2494,5 +2513,5 @@ 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, 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, MotionInput, MotionStart, NeedDef, NeedId, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, SiteAnalysis, SiteNeed, StructureId, StyleHints, StyleRead, UserAvoidId };
+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/package.json

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

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;
+}

package/src/harness-core/motion.ts

@@ -15,9 +15,22 @@ export interface MotionInput {
     avoid?: ReadonlyArray<string>;
 }
 
+/** Where the start came from, structured (the screen words it in its own language). */
+export 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;
+}
+
 export 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`). */
@@ -53,9 +66,11 @@ export function motionFor(
     const wanted = ref ?? base.animate;
     let out: DesignMotion = { scroll: base.scroll, animate: calmerChoice('animate', wanted, preset.moves.animate), between: base.between };
     const why = [type ? `${type.label}: ${triple(base)}` : `${preset.name}: the style's own`];
-    if (out.animate !== wanted) why.push(`${preset.name} moves less (${label('animate', preset.moves.animate)})`);
-    if (ref && type) why.push(`your references: ${label('animate', ref)}`);
+    const basis: MotionBasis = { type: type?.id ?? null, calmerStyle: out.animate !== wanted, references: !!(ref && type), littleMovement: false };
+    if (basis.calmerStyle) why.push(`${preset.name} moves less (${label('animate', preset.moves.animate)})`);
+    if (basis.references) why.push(`your references: ${label('animate', ref!)}`);
     if ((input.avoid ?? []).includes(LITTLE_MOVEMENT_AVOID)) {
+        basis.littleMovement = true;
         out = {
             scroll: calmerChoice('scroll', out.scroll, LITTLE_MOVEMENT_CAP.scroll),
             animate: calmerChoice('animate', out.animate, LITTLE_MOVEMENT_CAP.animate),
@@ -63,5 +78,5 @@ export function motionFor(
         };
         why.push('you asked for little movement');
     }
-    return { ...out, why };
+    return { ...out, why, basis };
 }