@vectoriox/iox-ui 5.65.0 → 5.66.0

package/harness-core/index.d.ts

@@ -2335,6 +2335,22 @@ declare function rankStylePresets(input: RankInput, presets?: ReadonlyArray<Styl
  * proper name); a type's or the owner's advice and the shared-moods line are English in the contract yet.
  */
 declare function presetReason(ranked: RankedPreset, preset: StylePreset | undefined, locale: string | null | undefined): string;
+/** One flavor's styles in Design ▸ Look: its presets in ranking order. */
+interface PresetFlavorGroup {
+    flavorId: string;
+    presets: RankedPreset[];
+}
+/**
+ * Design ▸ Look's grid (decided 2026-10-28, Doron: "All 24, grouped by flavor" — reverses Q7 and the wizard's best 6):
+ * every ranked style under its flavor, the flavors in catalogue order (Crisp · Linen · Midnight · Glass · Bloom · Pop),
+ * each flavor's styles best-ranked first. A ranking with no basis (no business, no moods) is catalogue order, so the
+ * groups are too. One rule for both hosts.
+ */
+declare function presetsByFlavor(ranked: ReadonlyArray<RankedPreset>, presets?: ReadonlyArray<StylePreset>, flavors?: ReadonlyArray<{
+    id: string;
+}>): PresetFlavorGroup[];
+/** The style the ranking puts first — only when it had something to rank by (a positive score); else none is "best". */
+declare function bestRankedPreset(ranked: ReadonlyArray<RankedPreset>): string | null;
 declare enum StyleReadSourceKind {
     Image = "image",
     Site = "site"
@@ -2994,5 +3010,5 @@ type SiteAuditView = SiteAudit & {
     advice: LintFinding[];
 };
 
-export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, GENERATION_LIMITS, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, MAX_PIXEL_SAMPLES, MAX_READ_PICTURES, NEEDS, NEED_IDS, NeedSource, PALETTE_SIZE, PALETTE_THRESHOLDS, PictureRole, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisFromWire, analysisPromptContext, analysisToWire, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
-export type { AiGenerationView, AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, BusinessTypeMatch, CheckRule, ColourSample, FactRead, GenerationFileView, GenerationReadersView, GenerationStartRequest, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MeasuredPicture, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PaletteColour, PaletteReading, PictureStyle, PlanRevisionView, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };
+export { ANIMATE_ADVICE_STEPS, AnalysisIssueCode, AnalysisLocale, AvoidCheck, BUSINESS_TYPES, BUSINESS_TYPE_IDS, BookingNeed, COPY_LENGTH_ORDER, CopyLength, GENERATION_LIMITS, HARNESS_SOURCE, LITTLE_MOVEMENT_AVOID, LITTLE_MOVEMENT_CAP, LintKind, MAX_ANALYSIS_MOODS, MAX_PIXEL_SAMPLES, MAX_READ_PICTURES, NEEDS, NEED_IDS, NeedSource, PALETTE_SIZE, PALETTE_THRESHOLDS, PictureRole, PlanChangeOutcome, PresetFit, RANK_WEIGHTS, READING_SHAPE, READ_ANIMATE, READ_WEIGHTS, RankReason, ReaderState, ReadingIssueCode, SITE_ANALYSIS_SCHEMA_NAME, SITE_READING_SCHEMA_NAME, SPEC_ANALYSIS_SHAPE, SPEC_BUSINESS_TYPES, SPEC_HARNESS_EXAMPLES, SPEC_HARNESS_SOURCE, SPEC_NEEDS, SPEC_STRUCTURES, SPEC_USER_AVOIDS, STRUCTURES, SiteReadRefusal, StyleReadGround, StyleReadHeadings, StyleReadMotion, StyleReadSourceKind, USER_AVOID_IDS, VoiceFormality, VoicePerson, addressesIn, analysisFromWire, analysisPromptContext, analysisToWire, bestRankedPreset, businessTypeById, calmerChoice, decodeSiteReading, inferNeeds, isLookRule, lintDesign, lookMatches, mapStyleRead, matchBusinessType, matchBusinessTypes, measurePalette, mergeStyleReads, motionAdvice, motionFor, normalizeAddress, oklchHue, paletteBrand, paletteGround, paletteSamples, pictureStyleRead, pixelSamples, presetDesign, presetHasSerifHeadings, presetLook, presetReason, presetsByFlavor, rankStylePresets, rankWithReferences, readPalette, referenceSeed, seedPassesPreset, siteAnalysisJsonSchema, siteReadingJsonSchema, startingDesign, structureFor, userAvoidRule, validateSiteAnalysis, validateSiteReading, withoutAddress };
+export type { AiGenerationView, AnalysisContext, AnalysisIssue, AnalysisValidation, AvoidRule, BusinessType, BusinessTypeMatch, CheckRule, ColourSample, FactRead, GenerationFileView, GenerationReadersView, GenerationStartRequest, GoodFit, LintFinding, LintSite, LookCondition, LookDesign, LookRule, MeasuredPicture, MotionBasis, MotionInput, MotionStart, NeedDef, NeedId, PaletteColour, PaletteReading, PictureStyle, PlanRevisionView, PresetFlavorGroup, PromptContext, PromptContextOptions, PromptSection, RankInput, RankedPreset, ReadingIssue, ReferenceSeed, SiteAnalysis, SiteAuditView, SiteNeed, SiteReaderView, SiteReading, StartingDesign, StructureChoice, StructureId, StyleHints, StyleRead, UserAvoidId };

package/package.json

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

package/src/design-core/style-presets.ts

@@ -72,3 +72,16 @@ export function presetChoices(id: string, mode?: DesignMode): DesignChoices | nu
         motion: preset.motion, pillButtons: preset.pillButtons, mode: wear, tint: preset.tint, ...preset.moves,
     });
 }
+
+/**
+ * The preset a set of choices IS (Design ▸ Look's "Current", 2026-10-28): its look — flavor, colour, tint, pairing,
+ * shape, spacing, pill buttons — in a mode it offers. Motion, speed and font overrides are the site's, not the
+ * style's, so they never unmark it; a colour or a corner changed by hand does: the look is then its flavor's, customised.
+ */
+export function stylePresetOfChoices(choices: DesignChoices | null | undefined): StylePreset | undefined {
+    if (!choices) return undefined;
+    const c = resolveDesignChoices(choices);
+    return STYLE_PRESETS.find(p => p.flavorId === c.flavorId && p.seed.toLowerCase() === c.seed.toLowerCase() && p.tint === c.tint
+        && p.pairId === c.pairId && p.shape === c.shape && p.density === c.density && p.pillButtons === c.pillButtons
+        && presetModes(p).includes(c.mode));
+}

package/src/harness-core/rank.ts

@@ -1,5 +1,5 @@
 import {
-    DensityId, flavorPackById, MOOD_LABELS, MoodId, parseFontFamilies, ShapeId, STYLE_PRESETS, StylePreset, TintId,
+    DensityId, flavorPackById, MOOD_LABELS, MoodId, parseFontFamilies, ShapeId, SPEC_FLAVORS, STYLE_PRESETS, StylePreset, TintId,
 } from '@vectoriox/iox-ui/design-core';
 import type { AnimateId } from '@vectoriox/iox-ui/design-core';
 
@@ -133,6 +133,35 @@ export function presetReason(ranked: RankedPreset, preset: StylePreset | undefin
     return (hebrew ? preset?.blurbHe : preset?.blurb) ?? '';
 }
 
+/** One flavor's styles in Design ▸ Look: its presets in ranking order. */
+export interface PresetFlavorGroup {
+    flavorId: string;
+    presets: RankedPreset[];
+}
+
+/**
+ * Design ▸ Look's grid (decided 2026-10-28, Doron: "All 24, grouped by flavor" — reverses Q7 and the wizard's best 6):
+ * every ranked style under its flavor, the flavors in catalogue order (Crisp · Linen · Midnight · Glass · Bloom · Pop),
+ * each flavor's styles best-ranked first. A ranking with no basis (no business, no moods) is catalogue order, so the
+ * groups are too. One rule for both hosts.
+ */
+export function presetsByFlavor(
+    ranked: ReadonlyArray<RankedPreset>,
+    presets: ReadonlyArray<StylePreset> = STYLE_PRESETS,
+    flavors: ReadonlyArray<{ id: string }> = SPEC_FLAVORS,
+): PresetFlavorGroup[] {
+    const flavorOf = new Map(presets.map(p => [p.id, p.flavorId]));
+    return flavors
+        .map(f => ({ flavorId: f.id, presets: ranked.filter(r => flavorOf.get(r.id) === f.id) }))
+        .filter(g => g.presets.length > 0);
+}
+
+/** The style the ranking puts first — only when it had something to rank by (a positive score); else none is "best". */
+export function bestRankedPreset(ranked: ReadonlyArray<RankedPreset>): string | null {
+    const top = ranked[0];
+    return top && top.score > 0 ? top.id : null;
+}
+
 // ── References: a reading of pictures or a site, as style (plan §3k, R4) ─────────────────────────────────
 export enum StyleReadSourceKind {
     Image = 'image',