@vectoriox/iox-ui 5.77.0 → 5.79.0

package/harness-core/index.d.ts

@@ -1,6 +1,7 @@
 import { MotionId, MoodId, TintId, DensityId, DesignMotion, DesignChoices, DesignMode, StylePreset, ShapeId, AnimateId } from '@vectoriox/iox-ui/design-core';
 import { FactKey, PathIssue, PlainObject, JsonSchema, SiteTemplate, ShapeEntry, AiGenerationStage, AiStep, SitePlan, PlanEdit, PlanChange, SiteAudit } from '@vectoriox/iox-ui/generation-core';
 export { JsonSchema } from '@vectoriox/iox-ui/generation-core';
+import { FrameSequence } from '@vectoriox/iox-ui/media-core';
 
 declare const SPEC_HARNESS_SOURCE: {
     readonly repo: "nextlevelbuilder/ui-ux-pro-max-skill";
@@ -155,6 +156,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Your own photos only, large and uncropped; never stock.";
     readonly pages: readonly ["home", "work (collection)", "project (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -217,6 +219,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Wide, bright room shots; details of materials.";
     readonly pages: readonly ["home", "projects (collection)", "project (detail)", "services", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "services", "about", "contact"];
@@ -280,6 +283,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Large project photos and drawings.";
     readonly pages: readonly ["home", "projects (collection)", "project (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -341,9 +345,10 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
     readonly motion: "standard";
     readonly moves: {
         readonly scroll: "smooth";
-        readonly animate: "lively";
+        readonly animate: "expressive";
         readonly between: "slide";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Case-study images of your own work.";
     readonly pages: readonly ["home", "work (collection)", "case study (detail)", "services", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "services", "about", "contact"];
@@ -398,6 +403,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Your pieces, photographed flat and true to colour.";
     readonly pages: readonly ["home", "works (collection)", "work (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -451,9 +457,10 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
     readonly motion: "calm";
     readonly moves: {
         readonly scroll: "normal";
-        readonly animate: "lively";
+        readonly animate: "expressive";
         readonly between: "slide";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Your pieces and hands at work; natural light.";
     readonly pages: readonly ["home", "pieces (collection)", "piece (detail)", "workshops", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -509,6 +516,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Close-ups on a plain ground.";
     readonly pages: readonly ["home", "collection", "piece (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -565,6 +573,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "slide";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Healed work, clean photos.";
     readonly pages: readonly ["home", "work (collection)", "artists", "faq", "contact"];
     readonly needs: readonly ["collection", "faq", "contact"];
@@ -620,6 +629,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "standard";
     readonly imagery: "Rooms, textures, hands; no faces needed.";
     readonly pages: readonly ["home", "treatments (services)", "prices", "about", "contact"];
     readonly needs: readonly ["services", "prices", "about", "contact"];
@@ -685,6 +695,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Your own before-and-after photos.";
     readonly pages: readonly ["home", "services", "prices", "gallery", "contact"];
     readonly needs: readonly ["services", "prices", "gallery", "contact"];
@@ -744,6 +755,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "lively";
     readonly imagery: "The room, real classes, daylight.";
     readonly pages: readonly ["home", "classes", "schedule", "teachers", "prices", "contact"];
     readonly needs: readonly ["prices", "contact"];
@@ -804,6 +816,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "lively";
         readonly between: "slide";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Real people training; movement.";
     readonly pages: readonly ["home", "classes", "prices", "coaches", "contact"];
     readonly needs: readonly ["prices", "contact"];
@@ -860,6 +873,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "none";
     };
+    readonly ceiling: "subtle";
     readonly imagery: "A calm room, daylight; your portrait.";
     readonly pages: readonly ["home", "how I work", "about", "faq", "contact"];
     readonly needs: readonly ["collection", "about", "faq", "contact"];
@@ -920,6 +934,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "subtle";
     readonly imagery: "Your team and rooms; no stock doctors.";
     readonly pages: readonly ["home", "treatments (services)", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -981,6 +996,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "subtle";
     readonly imagery: "Your clinic and team.";
     readonly pages: readonly ["home", "treatments", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -1040,6 +1056,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "standard";
     readonly imagery: "Real animals you treat (with permission).";
     readonly pages: readonly ["home", "services", "team", "faq", "contact"];
     readonly needs: readonly ["services", "team", "faq", "contact"];
@@ -1095,6 +1112,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Your own food and room photos.";
     readonly pages: readonly ["home", "menu", "about", "contact"];
     readonly needs: readonly ["menu", "about", "contact"];
@@ -1157,6 +1175,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "slide";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Your bakes and drinks, close up.";
     readonly pages: readonly ["home", "menu", "about", "contact"];
     readonly needs: readonly ["menu", "about", "contact"];
@@ -1216,6 +1235,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "The cellar, the bar, the bottle.";
     readonly pages: readonly ["home", "menu or wines", "our story", "visit", "contact"];
     readonly needs: readonly ["menu", "visit", "contact"];
@@ -1275,6 +1295,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "slide";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Product photos on plain grounds; real people wearing them.";
     readonly pages: readonly ["home", "collection", "product (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1329,6 +1350,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Your own arrangements in daylight.";
     readonly pages: readonly ["home", "flowers (collection)", "weddings and events", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -1384,6 +1406,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Pieces in real rooms and on plain grounds.";
     readonly pages: readonly ["home", "collection", "product (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1439,6 +1462,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "fade";
     };
+    readonly ceiling: "standard";
     readonly imagery: "Your portrait; diagrams over stock.";
     readonly pages: readonly ["home", "services", "case studies", "about", "contact"];
     readonly needs: readonly ["services", "about", "contact"];
@@ -1496,6 +1520,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "standard";
     readonly imagery: "Your portrait, working with people.";
     readonly pages: readonly ["home", "how it works", "programmes", "about", "contact"];
     readonly needs: readonly ["collection", "about", "contact"];
@@ -1547,6 +1572,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "still";
         readonly between: "none";
     };
+    readonly ceiling: "subtle";
     readonly imagery: "Your team; your office.";
     readonly pages: readonly ["home", "practice areas (services)", "team", "about", "contact"];
     readonly needs: readonly ["services", "team", "about", "contact"];
@@ -1609,6 +1635,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "slide";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Your own property photos; never stock.";
     readonly pages: readonly ["home", "properties (collection)", "property (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1667,6 +1694,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "fade";
     };
+    readonly ceiling: "standard";
     readonly imagery: "Real people you help (with permission).";
     readonly pages: readonly ["home", "what we do", "stories", "get involved", "contact"];
     readonly needs: readonly ["contact"];
@@ -1718,6 +1746,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "standard";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Real events at your venue.";
     readonly pages: readonly ["home", "spaces", "gallery", "faq", "contact"];
     readonly needs: readonly ["gallery", "faq", "contact"];
@@ -1776,6 +1805,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "subtle";
         readonly between: "cinematic";
     };
+    readonly ceiling: "expressive";
     readonly imagery: "Rooms, views, breakfast; your own photos.";
     readonly pages: readonly ["home", "rooms (collection)", "room (detail)", "about", "contact"];
     readonly needs: readonly ["collection", "detail", "about", "contact"];
@@ -1834,6 +1864,7 @@ declare const SPEC_BUSINESS_TYPES: readonly [{
         readonly animate: "lively";
         readonly between: "slide";
     };
+    readonly ceiling: "lively";
     readonly imagery: "Real classes (with permission).";
     readonly pages: readonly ["home", "classes", "prices", "about", "contact"];
     readonly needs: readonly ["prices", "about", "contact"];
@@ -2238,6 +2269,9 @@ interface BusinessType {
     readonly motion: MotionId;
     /** How its site usually scrolls, how animated it is and what plays between pages (rev 3.1). */
     readonly moves: Readonly<DesignMotion>;
+    /** SC6: the most How animated a GENERATED site of this type may start at (`motionFor`). A Scene needs Expressive,
+     *  so a type capped below it never gets one. Binds generated output only — the owner may choose any level. */
+    readonly ceiling: DesignMotion['animate'];
     readonly imagery: string;
     readonly pages: ReadonlyArray<string>;
     /** The needs its page set implies, in page order (derived from `pages` at contract build). */
@@ -2436,6 +2470,8 @@ interface MotionBasis {
     references: boolean;
     /** The owner asked for little movement: all three were capped. */
     littleMovement: boolean;
+    /** SC6: How animated was held at the type's ceiling (a law firm stays calm whatever the style or references). */
+    ceiling: boolean;
 }
 interface MotionStart extends DesignMotion {
     /** Why, in English — one line per step the start took. */
@@ -2913,11 +2949,13 @@ interface AiGenerationView {
     stage: `${AiGenerationStage}`;
     /** The model step the runner is working on; null = the owner's move. */
     task: `${AiStep}` | null;
+    /** `film`: the owner's film as pictures (SC6b), told by the wizard at Build — `placeFilm` places it. */
     intake: {
         prompt: string;
         files: GenerationFileView[];
         addresses: string[];
         auto: boolean;
+        film?: FrameSequence;
     };
     readers: GenerationReadersView;
     reads: {

package/media-core/index.d.ts

@@ -111,6 +111,24 @@ declare const PHONE_LONG_SIDE = 1100;
 declare function fittedFrameSize(width: number, height: number, longSide: number): FrameSizes;
 /** How many pictures a video of `seconds` becomes. */
 declare function videoFrameCount(seconds: number): number;
+/**
+ * Pictures per screen of scrolling at which a played film stays smooth as a glide slows to a stop. Measured on Doron's
+ * iPhone (2026-11-05): Studio Alma's film at about 11 a screen stepped, at about 55 it did not.
+ */
+declare const FILM_SMOOTH_PER_SCREEN = 40;
+/** The fewest and most screens a film the build places holds the page for (SC6b): long enough to feel, short enough to pass. */
+declare const FILM_MIN_SCREENS = 1;
+declare const FILM_MAX_SCREENS = 4;
+/** What the build prepares a film to: about 60 pictures a screen at the longest hold — denser than smooth, never wasted. */
+declare const FILM_PREPARED_PICTURES: number;
+/** The fewest pictures a placed film may have: smooth over the shortest hold. */
+declare const FILM_MIN_PICTURES: number;
+/**
+ * The screens a film of `count` pictures holds the page for (SC6b, the composer's density rule): the stretches between
+ * pictures are what scroll, so `(count − 1) ÷ 40`, rounded DOWN to a tenth (150 pictures over 3.75 screens measure 39.7 a
+ * screen, thin), within the hold's limits. Null: too few pictures to play smoothly over the shortest hold.
+ */
+declare function filmScreensFor(count: number): number | null;
 /** Which of `sourceCount` pictures make a set of `count`, spread evenly, first and last always in. */
 declare function sampledFrameIndexes(sourceCount: number, count: number): number[];
 /** Rendered frames in their real order: `frame2` before `frame10`. */
@@ -473,5 +491,5 @@ declare function attachVideos(container: ParentNode, options?: VideoRuntimeOptio
 /** The runtime already running at `el`, if any. */
 declare function videoRuntimeOf(el: Element | null | undefined): VideoRuntime | null;
 
-export { CONSENT_GRANT_EVENT, CONSENT_PREFERENCES_EVENT, FRAMES_PHONE_MAX_WIDTH, FRAMES_SHOWING_ATTRIBUTE, FRAMES_UNPACKED_BYTES, FRAME_BLEND_STEPS, FRAME_SEQUENCE_ID, FrameExtension, FramePlayer, FrameSet, FramesClass, MAX_FRAMES, MAX_FRAME_BYTES, PHONE_LONG_SIDE, VIDEO_EMBED_ORIGINS, VIDEO_NODE_TYPE, VIDEO_PROVIDER_COMPANY, VIDEO_PROVIDER_LABEL, VIDEO_WORDS, VideoAttribute, VideoClass, VideoIcon, VideoKind, VideoMode, VideoRuntime, VideoSource, VideoTrait, WIDE_LONG_SIDE, attachVideoAt, attachVideos, documentConsentTransport, fittedFrameSize, frameBlendAt, frameFileName, frameIndexAt, frameLoadOrder, framePosition, frameSetFor, frameSummary, frameUrl, framesToHold, isThirdPartyPoster, nearestLoadedFrame, normalizeFrameSequence, parseVideoUrl, phoneFrameSrcset, planVideo, readConsentRecord, sampledFrameIndexes, serializeVideoAttributes, sortFrameFiles, unpackedFrameCount, videoConsentCategory, videoEmbedUrl, videoFrameCount, videoInnerHtml, videoPlayLabel, videoPosterFileName, videoProp, videoRefOf, videoRootAttributes, videoRuntimeOf, videoSourceOf, videoThumbnailRequest, videoWords };
+export { CONSENT_GRANT_EVENT, CONSENT_PREFERENCES_EVENT, FILM_MAX_SCREENS, FILM_MIN_PICTURES, FILM_MIN_SCREENS, FILM_PREPARED_PICTURES, FILM_SMOOTH_PER_SCREEN, FRAMES_PHONE_MAX_WIDTH, FRAMES_SHOWING_ATTRIBUTE, FRAMES_UNPACKED_BYTES, FRAME_BLEND_STEPS, FRAME_SEQUENCE_ID, FrameExtension, FramePlayer, FrameSet, FramesClass, MAX_FRAMES, MAX_FRAME_BYTES, PHONE_LONG_SIDE, VIDEO_EMBED_ORIGINS, VIDEO_NODE_TYPE, VIDEO_PROVIDER_COMPANY, VIDEO_PROVIDER_LABEL, VIDEO_WORDS, VideoAttribute, VideoClass, VideoIcon, VideoKind, VideoMode, VideoRuntime, VideoSource, VideoTrait, WIDE_LONG_SIDE, attachVideoAt, attachVideos, documentConsentTransport, filmScreensFor, fittedFrameSize, frameBlendAt, frameFileName, frameIndexAt, frameLoadOrder, framePosition, frameSetFor, frameSummary, frameUrl, framesToHold, isThirdPartyPoster, nearestLoadedFrame, normalizeFrameSequence, parseVideoUrl, phoneFrameSrcset, planVideo, readConsentRecord, sampledFrameIndexes, serializeVideoAttributes, sortFrameFiles, unpackedFrameCount, videoConsentCategory, videoEmbedUrl, videoFrameCount, videoInnerHtml, videoPlayLabel, videoPosterFileName, videoProp, videoRefOf, videoRootAttributes, videoRuntimeOf, videoSourceOf, videoThumbnailRequest, videoWords };
 export type { ConsentGrantDetail, ConsentTransport, FrameBlend, FramePlayerOptions, FrameSequence, FrameSetInfo, FrameSizes, VideoMarkupOptions, VideoNodeLike, VideoPlan, VideoRef, VideoRuntimeOptions, VideoThumbnailRequest, VideoWords };

package/package.json

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

package/scene-core/index.d.ts

@@ -218,10 +218,7 @@ declare const SCENE_MAX_SCREENS = 20;
  */
 declare function sceneScreensOf(height: string | null | undefined): number | null;
 declare function sceneHeightForScreens(screens: number): string;
-/**
- * Pictures per screen of scrolling at which a played film stays smooth as a glide slows to a stop. Measured on Doron's
- * iPhone (2026-11-05): Studio Alma's film at about 11 a screen stepped, at about 55 it did not.
- */
+/** Pictures per screen of scrolling at which a played film stays smooth (media-core's, which the composer sizes by). */
 declare const SCENE_FILM_SMOOTH = 40;
 interface SceneFilmDensity {
     /** Pictures per screen of scrolling over most of the play: half its scroll holds at least this many. */

package/src/design-core/flavor-spec.generated.ts

@@ -1533,6 +1533,36 @@ export const SPEC_AXES = {
           "duration": 600
         }
       }
+    },
+    "expressive": {
+      "label": "Expressive",
+      "he": "נועזת",
+      "hint": "Headings rise line by line and pictures open as they arrive; one section may hold the page and move as you scroll.",
+      "parts": {
+        "heroText": {
+          "type": "fadeIn",
+          "duration": 500
+        },
+        "heading": {
+          "type": "revealText",
+          "duration": 700
+        },
+        "items": {
+          "type": "moveUp",
+          "distance": 32,
+          "duration": 700,
+          "stagger": 110,
+          "cap": 8
+        },
+        "media": {
+          "type": "clipReveal",
+          "duration": 800
+        },
+        "rowMedia": {
+          "type": "clipReveal",
+          "duration": 800
+        }
+      }
     }
   },
   "animationFamilies": {
@@ -1937,7 +1967,7 @@ export const SPEC_STYLE_PRESETS = [
     "pillButtons": false,
     "moves": {
       "scroll": "smooth",
-      "animate": "lively",
+      "animate": "expressive",
       "between": "slide"
     },
     "modes": [
@@ -2034,7 +2064,7 @@ export const SPEC_STYLE_PRESETS = [
     "pillButtons": false,
     "moves": {
       "scroll": "normal",
-      "animate": "standard",
+      "animate": "expressive",
       "between": "fade"
     },
     "modes": [
@@ -2320,7 +2350,7 @@ export const SPEC_STYLE_PRESETS = [
     "pillButtons": false,
     "moves": {
       "scroll": "normal",
-      "animate": "lively",
+      "animate": "expressive",
       "between": "slide"
     },
     "modes": [
@@ -2385,7 +2415,7 @@ export const SPEC_STYLE_PRESETS = [
     "pillButtons": false,
     "moves": {
       "scroll": "normal",
-      "animate": "standard",
+      "animate": "expressive",
       "between": "slide"
     },
     "modes": [

package/src/generation-core/compose-site.ts

@@ -10,9 +10,10 @@ import {
 } from '@vectoriox/iox-ui/composite-core';
 
 import { EntranceMark, EntrancePart, planEntrances } from './entrances';
+import { filmOfPlan } from './film';
 import { NODE_BASELINES } from './node-baselines.generated';
 import {
-    BindScope, CardBindTarget, parsePatternPath, PatternDirective, PatternNode, PatternOpens, PatternPlaceholder, PatternRecipe, SitePattern, patternById,
+    BindScope, CardBindTarget, parsePatternPath, PatternDirective, PatternNode, PatternOpens, PatternPlaceholder, PatternRecipe, PatternTrack, SitePattern, patternById,
 } from './patterns';
 import { recipeListBinds } from './recipe-fields';
 import { assertStyleSlots, ComposeError, createSerializedNode, SerializedBinding, SerializedNode, setStyleProps, walkSerialized } from './serialized-node';
@@ -206,6 +207,8 @@ const IMAGE = 'Image';
 const VIDEO = 'Video';
 /** A Video's source prop (media-core `VideoTrait.Source` — not `source`, which names a data source). */
 const VIDEO_SOURCE_PROP = 'videoSource';
+/** A Video's pictures the scroll plays (media-core `VideoTrait.Frames`). */
+const VIDEO_FRAMES_PROP = 'frames';
 const DIALOG = 'Dialog';
 const SUBMIT_BUTTON = 'SubmitButton';
 const FORM_SUCCESS = 'FormSuccess';
@@ -575,6 +578,8 @@ function composeNode(given: PatternNode, id: string, repeater: RepeaterScope | n
     // Props first: a Heading with no `es` wears its LEVEL's default style.
     const node = create(id, type, props, pn.es ?? null);
     if (pn.role) node.role = pn.role;
+    if (pn.tracks?.length) node.sceneTracks = pn.tracks.map(cloneTrack);
+    if (pn.phoneTracks?.length) node.scenePhoneTracks = pn.phoneTracks.map(cloneTrack);
     markEntrance(pn, id, repeater, ctx);
 
     // Words.
@@ -600,6 +605,13 @@ function composeNode(given: PatternNode, id: string, repeater: RepeaterScope | n
         setProp(node, VIDEO_SOURCE_PROP, 'file');
         setProp(node, 'mode', pn.video);
     }
+    // SC6b: a film pattern's Video plays the owner's pictures (the build places the pattern only with a film).
+    if (pn.film) {
+        if (type !== VIDEO) throw new ComposeError(`${id}: "film" belongs on a Video`);
+        const film = filmOfPlan(ctx.plan);
+        if (!film) throw new ComposeError(`${id}: a film's pattern on a plan with no film`);
+        setProp(node, VIDEO_FRAMES_PROP, film.sequence);
+    }
     if (pn.ph === PatternPlaceholder.Video) {
         setProp(node, 'src', '');
         ctx.placeholders.push({ nodeId: id, owner: ctx.owner, kind: PlaceholderKind.Video, text: '' });
@@ -990,6 +1002,13 @@ function wireOpeners(root: SerializedNode, openers: ReadonlyArray<string>): void
 }
 
 /** How a composed section moves in (M1-6b): the look's How animated (or the section's own) on the page's direction. */
+/** SC6: a track's own copy, so a composed page never shares an array with the contract. */
+const cloneTrack = (track: PatternTrack): Record<string, unknown> => ({
+    prop: track.prop,
+    keys: track.keys.map(([at, value]) => [at, value]),
+    ...(track.from ? { from: track.from } : {}),
+});
+
 interface SectionMotion {
     level: AnimateId | string | null;
     rtl: boolean;
@@ -1002,7 +1021,11 @@ function composePattern(pattern: SitePattern, id: string, ctx: Ctx, motion: Sect
     if (!node) throw new ComposeError(`${id}: a pattern's root cannot be optional or a link`);
     wireOpeners(node, own.openers ?? []);
     wireShownWhen(node, own.shownWhen ?? []);
-    if (motion && !pattern.global) stampEntrances(node, pattern.family, own.entrances ?? [], motion);
+    // A Scene moves by the scroll alone: the look's entrances would fade its pinned stage in on arrival (SC6).
+    if (motion && !pattern.global && !pattern.scene) stampEntrances(node, pattern.family, own.entrances ?? [], motion);
+    // SC6b, the density rule: a film's Scene holds the page as long as its pictures stay smooth, and no longer.
+    const film = pattern.film ? filmOfPlan(ctx.plan) : null;
+    if (film) setStyleProps(node, { height: `${film.heightVh}vh` });
     node.label = pattern.label;
     return node;
 }

package/src/generation-core/film.ts

@@ -0,0 +1,91 @@
+import { filmScreensFor, FrameSequence, normalizeFrameSequence } from '@vectoriox/iox-ui/media-core';
+
+import { patternById, patternLinkSlots, patternSlots, SCENE_LEVEL, SITE_PATTERNS } from './patterns';
+import { PageSectionPlan, SitePlan } from './site-plan.model';
+
+/**
+ * The owner's film on a built site (premium sites SC6b). The owner gives a video in Analysis; the wizard's browser makes
+ * it pictures (cms-client `FramesPrepareService`); the build places it. A model never picks the film's pattern — the
+ * manifest and the plan wire leave it out — so ONE pure placement decides where it goes, run by the wizard to draw the
+ * Plan and by the server to build: they cannot disagree.
+ */
+
+/** The pattern a film plays in: the one whose Video is marked `film` in the contract. */
+export const FILM_PATTERN: string = Object.entries(SITE_PATTERNS).find(([, p]) => p.film)?.[0] ?? '';
+
+/** Why a film stays off the site. Each is said to the owner on the Plan step. */
+export enum FilmUnplaced {
+    /** How animated is below Expressive: no section holds the page there. */
+    NotExpressive = 'notExpressive',
+    /** The home page does not open with a hero to play it in. */
+    NoHero = 'noHero',
+    /** The home page already holds the page elsewhere (one Scene per page). */
+    AnotherScene = 'anotherScene',
+    /** Too few pictures to play smoothly over the shortest hold (media-core `FILM_MIN_PICTURES`). */
+    TooShort = 'tooShort',
+}
+
+/** Where the film plays: the home page's first section when it is a hero. */
+export interface FilmTarget {
+    readonly page: number;
+    readonly section: number;
+}
+
+export type FilmPlacement = { readonly target: FilmTarget; readonly unplaced?: undefined } | { readonly target?: undefined; readonly unplaced: FilmUnplaced };
+
+/** Where a film WOULD play on this plan (the Plan step asks before the pictures exist). */
+export function filmPlacement(plan: Pick<SitePlan, 'design' | 'pages'>): FilmPlacement {
+    if ((plan.design as { animate?: string }).animate !== SCENE_LEVEL) return { unplaced: FilmUnplaced.NotExpressive };
+    const page = plan.pages.findIndex(p => p.isHome);
+    const sections = page >= 0 ? plan.pages[page].sections : [];
+    const first = patternById(sections[0]?.pattern);
+    if (!first || first.family !== FILM_FAMILY) return { unplaced: FilmUnplaced.NoHero };
+    if (sections.slice(1).some(s => patternById(s.pattern)?.scene)) return { unplaced: FilmUnplaced.AnotherScene };
+    return { target: { page, section: 0 } };
+}
+
+const FILM_FAMILY = SITE_PATTERNS[FILM_PATTERN]?.family ?? 'hero';
+
+export interface PlacedFilm {
+    readonly plan: SitePlan;
+    readonly unplaced?: FilmUnplaced;
+}
+
+/**
+ * The plan with the owner's film in it: `film` set, and the home page's hero becomes the film's pattern, keeping the
+ * hero's words and links that the film's pattern has. A film that cannot play (unreadable, too few pictures) or a plan
+ * with no place for it leaves the plan as it was — the hero keeps its picture, and the builder can add the film later.
+ */
+export function placeFilm(plan: SitePlan, sequence: unknown): PlacedFilm {
+    const film = normalizeFrameSequence(sequence);
+    if (!film || filmScreensFor(film.wide.count) === null) return { plan, unplaced: FilmUnplaced.TooShort };
+    const placement = filmPlacement(plan);
+    if (!placement.target) return { plan, unplaced: placement.unplaced };
+    const { page, section } = placement.target;
+    const pages = plan.pages.map((p, i) => i !== page ? p : {
+        ...p,
+        sections: p.sections.map((s, j) => (j === section ? filmSection(s) : s)),
+    });
+    return { plan: { ...plan, pages, film: { sequence: film } } };
+}
+
+function filmSection(hero: PageSectionPlan): PageSectionPlan {
+    const pattern = SITE_PATTERNS[FILM_PATTERN];
+    const slots = new Set(patternSlots(pattern));
+    const links = new Set(patternLinkSlots(pattern));
+    const keep = (values: Readonly<Record<string, string>> | undefined, allowed: Set<string>) => {
+        const kept = Object.entries(values ?? {}).filter(([key]) => allowed.has(key));
+        return kept.length ? Object.fromEntries(kept) : undefined;
+    };
+    const keptSlots = keep(hero.slots, slots);
+    const keptLinks = keep(hero.links, links);
+    return { pattern: FILM_PATTERN, ...(keptSlots ? { slots: keptSlots } : {}), ...(keptLinks ? { links: keptLinks } : {}) };
+}
+
+/** The film's pictures as the composer stamps them, and the height its Scene holds the page for. */
+export function filmOfPlan(plan: Pick<SitePlan, 'film'>): { sequence: FrameSequence; heightVh: number } | null {
+    const sequence = normalizeFrameSequence(plan.film?.sequence);
+    const screens = sequence ? filmScreensFor(sequence.wide.count) : null;
+    // A Scene's root holds the page for its height less the one screen its stage fills.
+    return sequence && screens !== null ? { sequence, heightVh: Math.round((screens + 1) * 100) } : null;
+}

package/src/generation-core/patterns.ts

@@ -90,6 +90,21 @@ export interface PatternNode {
     readonly side?: `${EntranceSide}`;
     /** L0-3: a link to the page that shows this scope's item (the plan's template page of its type). */
     readonly detail?: `${BindScope.Item}` | `${BindScope.Next}`;
+    /** SC6: a Scene layer's scene-core tracks, written to the node's `sceneTracks` (and `scenePhoneTracks`). */
+    readonly tracks?: ReadonlyArray<PatternTrack>;
+    readonly phoneTracks?: ReadonlyArray<PatternTrack>;
+    /** SC6b: the Video a film pattern plays the owner's film in (its `frames`). */
+    readonly film?: boolean;
+}
+
+/**
+ * SC6: one scene-core track as the contract writes it — `{ prop, keys: [[progress, value]], from? }`. Typed here, not
+ * imported: generation-core stamps it verbatim and scene-core reads (and normalizes) it where it plays.
+ */
+export interface PatternTrack {
+    readonly prop: string;
+    readonly keys: ReadonlyArray<readonly [number, number | string]>;
+    readonly from?: string;
 }
 
 
@@ -138,6 +153,11 @@ export interface SitePattern {
     readonly global?: `${PatternGlobalPosition}`;
     /** A navigation pattern's phone shape (CC1): `planNavShape` adds it after the pattern is stamped. */
     readonly phoneMenu?: 'drawer' | 'bar' | 'both';
+    /** SC6: a Scene section — held while the page scrolls, moved by the scroll. Only at How animated Expressive, at
+     *  most one per page and on at most two pages (`validateSitePlan`); it never takes the look's entrances. */
+    readonly scene?: boolean;
+    /** SC6b: a Scene that plays the owner's film. Placed by `placeFilm`, never chosen: no manifest or wire lists it. */
+    readonly film?: boolean;
     readonly node: PatternNode;
 }
 
@@ -295,7 +315,12 @@ export function patternHasForm(pattern: SitePattern): boolean {
     return patternNodes(pattern).some(n => !!n.preset);
 }
 
-/** The library's 31 sections (contract `site.library`), each with whether it is composed. */
+/** SC6: the level a Scene needs — the site's How animated, never a section's own `enter` (a Scene takes no entrance). */
+export const SCENE_LEVEL = 'expressive';
+/** SC6: Scenes on the home page and at most this many other pages, one per page (`validateSitePlan`). */
+export const SCENE_OTHER_PAGES = 1;
+
+/** The library's sections (contract `site.library`), each with whether it is composed. */
 export const SITE_LIBRARY: ReadonlyArray<{ readonly id: string; readonly family: string; readonly composed: boolean }> = SPEC_SITE_LIBRARY;
 
 /** One pattern as the model reads it (L0-2): what it is for, what it may write and how long, and what it binds. */
@@ -316,11 +341,22 @@ export interface PatternManifestEntry {
     roles: string[];
     optionalParts: string[];
     form: boolean;
+    /** SC6: it holds the page as it scrolls — one per page, the home page and at most one other. */
+    scene?: boolean;
 }
 
-/** The composed library as the model reads it — every pattern, its budgets under `density` (M1-3's manifest). */
-export function patternManifest(density?: string | null): PatternManifestEntry[] {
-    return Object.entries(SITE_PATTERNS).map(([id, p]) => ({
+export interface PatternManifestOptions {
+    /** The site's How animated: below `SCENE_LEVEL` the Scenes are left out — a model cannot choose what it never sees. */
+    animate?: string | null;
+}
+
+/**
+ * The composed library as the model reads it — every pattern, its budgets under `density` (M1-3's manifest). Given the
+ * site's How animated (SC6), the Scenes are listed only at `SCENE_LEVEL`, marked `scene`; without it, all of them.
+ */
+export function patternManifest(density?: string | null, options: PatternManifestOptions = {}): PatternManifestEntry[] {
+    const scenes = !('animate' in options) || options.animate === SCENE_LEVEL;
+    return Object.entries(SITE_PATTERNS).filter(([, p]) => !p.film && (scenes || !p.scene)).map(([id, p]) => ({
         id, family: p.family, label: p.label, intent: p.intent, ...(p.global ? { global: p.global } : {}),
         slots: Object.fromEntries(Object.keys(patternSlotBudgets(p)).map(slot => [slot, slotBudget(p, slot, density) as number])),
         links: patternLinkSlots(p),
@@ -328,6 +364,7 @@ export function patternManifest(density?: string | null): PatternManifestEntry[]
         roles: [...new Set(patternRoleNeeds(p).map(r => `${r.scope}.@${r.role}${r.optional ? OPTIONAL_MARK : ''}`))],
         optionalParts: patternOptionalParts(p),
         form: patternHasForm(p),
+        ...(p.scene ? { scene: true } : {}),
     }));
 }