@vectoriox/iox-ui 5.77.0 → 5.79.0

package/generation-core/index.d.ts

@@ -1,3 +1,4 @@
+import { FrameSequence } from '@vectoriox/iox-ui/media-core';
 import { AnimateId, DesignChoices, DesignTokenLike } from '@vectoriox/iox-ui/design-core';
 import { SeoRawDoc } from '@vectoriox/iox-ui/seo-core';
 import { ContentFieldLike } from '@vectoriox/iox-ui/composite-core';
@@ -13,6 +14,10 @@ declare const SPEC_SITE_PLAN_SHAPE: {
         readonly dataSources: "(cmsDataSource | relativeDataSource)[] — merged by alias into the org library";
         readonly pages: "page[]";
         readonly globals: "globals";
+        readonly "film?": "film — the owner's film as pictures (SC6b), set by the build and placed by placeFilm; never a model's";
+    };
+    readonly film: {
+        readonly sequence: "object — a media-core FrameSequence: where the numbered pictures live, how many, their size";
     };
     readonly sourceTemplate: {
         readonly kind: "'template'";
@@ -297,6 +302,456 @@ declare const SPEC_SITE_ARCHETYPES: {
     };
 };
 declare const SPEC_SITE_PATTERNS: {
+    readonly "hero.scene-depth": {
+        readonly family: "hero";
+        readonly scene: true;
+        readonly label: "Hero — a picture that opens as you scroll";
+        readonly intent: "One strong picture of the work that opens and settles while the page holds still — a first screen that moves, for a studio with a picture worth it.";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "inverse";
+            readonly role: "scene";
+            readonly lay: {
+                readonly position: "relative";
+                readonly display: "block";
+                readonly width: "100%";
+                readonly height: "300vh";
+                readonly padding: "0px";
+            };
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly role: "scene.stage";
+                readonly lay: {
+                    readonly position: "sticky";
+                    readonly top: "0px";
+                    readonly display: "block";
+                    readonly width: "100%";
+                    readonly height: "100svh";
+                    readonly overflow: "hidden";
+                    readonly padding: "0px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Image";
+                    readonly es: "media";
+                    readonly ph: "image";
+                    readonly lay: {
+                        readonly position: "absolute";
+                        readonly top: "0px";
+                        readonly left: "0px";
+                        readonly width: "100%";
+                        readonly height: "100%";
+                        readonly aspectRatio: "auto";
+                        readonly borderRadius: "0px";
+                        readonly objectFit: "cover";
+                    };
+                    readonly tracks: readonly [{
+                        readonly prop: "scale";
+                        readonly keys: readonly [readonly [0, 1.3], readonly [1, 1]];
+                    }, {
+                        readonly prop: "clip";
+                        readonly from: "bottom";
+                        readonly keys: readonly [readonly [0, 38], readonly [0.42, 100]];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "media-scrim";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "14px";
+                        readonly position: "absolute";
+                        readonly left: "0px";
+                        readonly bottom: "0px";
+                        readonly width: "100%";
+                        readonly padding: "48px 32px 56px 32px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "display";
+                        readonly level: "h1";
+                        readonly slot: "headline";
+                        readonly max: 56;
+                        readonly fromBusiness: "name";
+                        readonly tracks: readonly [{
+                            readonly prop: "y";
+                            readonly keys: readonly [readonly [0, 0], readonly [1, -6]];
+                        }];
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "lead";
+                        readonly slot: "lead";
+                        readonly max: 180;
+                        readonly fromBusiness: "tagline";
+                        readonly ph: "copy";
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.45, 0], readonly [0.6, 1]];
+                        }];
+                    }, {
+                        readonly t: "ButtonBlock";
+                        readonly es: "button-primary";
+                        readonly href: "/contact";
+                        readonly slot: "cta";
+                        readonly max: 24;
+                        readonly text: "Get in touch";
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.5, 0], readonly [0.65, 1]];
+                        }];
+                    }];
+                }];
+            }];
+        };
+    };
+    readonly "hero.scene-object": {
+        readonly family: "hero";
+        readonly scene: true;
+        readonly film: true;
+        readonly label: "Hero — your film plays as you scroll";
+        readonly intent: "The studio's own film plays forward and back with the scroll behind the headline while the page holds still.";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "inverse";
+            readonly role: "scene";
+            readonly lay: {
+                readonly position: "relative";
+                readonly display: "block";
+                readonly width: "100%";
+                readonly height: "300vh";
+                readonly padding: "0px";
+            };
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly role: "scene.stage";
+                readonly lay: {
+                    readonly position: "sticky";
+                    readonly top: "0px";
+                    readonly display: "block";
+                    readonly width: "100%";
+                    readonly height: "100svh";
+                    readonly overflow: "hidden";
+                    readonly padding: "0px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Video";
+                    readonly es: "media";
+                    readonly film: true;
+                    readonly lay: {
+                        readonly position: "absolute";
+                        readonly top: "0px";
+                        readonly left: "0px";
+                        readonly width: "100%";
+                        readonly height: "100%";
+                        readonly aspectRatio: "auto";
+                        readonly borderRadius: "0px";
+                    };
+                    readonly tracks: readonly [{
+                        readonly prop: "play";
+                        readonly keys: readonly [readonly [0, 0], readonly [1, 100]];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "media-scrim";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "14px";
+                        readonly position: "absolute";
+                        readonly left: "0px";
+                        readonly bottom: "0px";
+                        readonly width: "100%";
+                        readonly padding: "48px 32px 56px 32px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Heading";
+                        readonly es: "display";
+                        readonly level: "h1";
+                        readonly slot: "headline";
+                        readonly max: 56;
+                        readonly fromBusiness: "name";
+                        readonly tracks: readonly [{
+                            readonly prop: "y";
+                            readonly keys: readonly [readonly [0, 0], readonly [1, -6]];
+                        }];
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "lead";
+                        readonly slot: "lead";
+                        readonly max: 180;
+                        readonly fromBusiness: "tagline";
+                        readonly ph: "copy";
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.3, 0], readonly [0.45, 1]];
+                        }];
+                    }, {
+                        readonly t: "ButtonBlock";
+                        readonly es: "button-primary";
+                        readonly href: "/contact";
+                        readonly slot: "cta";
+                        readonly max: 24;
+                        readonly text: "Get in touch";
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.35, 0], readonly [0.5, 1]];
+                        }];
+                    }];
+                }];
+            }];
+        };
+    };
+    readonly "story.scene-chapters": {
+        readonly family: "story";
+        readonly scene: true;
+        readonly label: "Story — three chapters on one held stage";
+        readonly intent: "How you work in three short chapters that take turns over one picture while the page holds still — a process worth slowing down for.";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly scheme: "inverse";
+            readonly role: "scene";
+            readonly lay: {
+                readonly position: "relative";
+                readonly display: "block";
+                readonly width: "100%";
+                readonly height: "400vh";
+                readonly padding: "0px";
+            };
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly role: "scene.stage";
+                readonly lay: {
+                    readonly position: "sticky";
+                    readonly top: "0px";
+                    readonly display: "block";
+                    readonly width: "100%";
+                    readonly height: "100svh";
+                    readonly overflow: "hidden";
+                    readonly padding: "0px";
+                };
+                readonly c: readonly [{
+                    readonly t: "Image";
+                    readonly es: "media";
+                    readonly ph: "image";
+                    readonly lay: {
+                        readonly position: "absolute";
+                        readonly top: "0px";
+                        readonly left: "0px";
+                        readonly width: "100%";
+                        readonly height: "100%";
+                        readonly aspectRatio: "auto";
+                        readonly borderRadius: "0px";
+                        readonly objectFit: "cover";
+                    };
+                    readonly tracks: readonly [{
+                        readonly prop: "scale";
+                        readonly keys: readonly [readonly [0, 1.12], readonly [1, 1]];
+                    }];
+                }, {
+                    readonly t: "Container";
+                    readonly es: "media-scrim";
+                    readonly lay: {
+                        readonly position: "absolute";
+                        readonly left: "0px";
+                        readonly bottom: "0px";
+                        readonly width: "100%";
+                        readonly height: "62%";
+                        readonly padding: "0px";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "12px";
+                            readonly position: "absolute";
+                            readonly left: "32px";
+                            readonly right: "32px";
+                            readonly bottom: "56px";
+                            readonly maxWidth: "640px";
+                        };
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0, 1], readonly [0.26, 1], readonly [0.33, 0]];
+                        }, {
+                            readonly prop: "y";
+                            readonly keys: readonly [readonly [0.26, 0], readonly [0.33, -6]];
+                        }];
+                        readonly c: readonly [{
+                            readonly t: "Text";
+                            readonly es: "eyebrow";
+                            readonly slot: "eyebrow";
+                            readonly max: 32;
+                            readonly ph: "copy";
+                            readonly text: "How we work";
+                        }, {
+                            readonly t: "Heading";
+                            readonly es: "h2";
+                            readonly level: "h2";
+                            readonly slot: "title";
+                            readonly max: 52;
+                            readonly ph: "copy";
+                            readonly text: "It starts with a conversation";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "lead";
+                            readonly slot: "text";
+                            readonly max: 180;
+                            readonly ph: "copy";
+                            readonly text: "What the first step is, in a sentence or two.";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "12px";
+                            readonly position: "absolute";
+                            readonly left: "32px";
+                            readonly right: "32px";
+                            readonly bottom: "56px";
+                            readonly maxWidth: "640px";
+                        };
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.33, 0], readonly [0.4, 1], readonly [0.6, 1], readonly [0.67, 0]];
+                        }, {
+                            readonly prop: "y";
+                            readonly keys: readonly [readonly [0.33, 6], readonly [0.4, 0], readonly [0.6, 0], readonly [0.67, -6]];
+                        }];
+                        readonly c: readonly [{
+                            readonly t: "Heading";
+                            readonly es: "h2";
+                            readonly level: "h2";
+                            readonly slot: "title2";
+                            readonly max: 52;
+                            readonly ph: "copy";
+                            readonly text: "Then we make it";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "lead";
+                            readonly slot: "text2";
+                            readonly max: 180;
+                            readonly ph: "copy";
+                            readonly text: "What the middle of the work is, in a sentence or two.";
+                        }];
+                    }, {
+                        readonly t: "Container";
+                        readonly es: "box";
+                        readonly lay: {
+                            readonly display: "flex";
+                            readonly flexDirection: "column";
+                            readonly gap: "12px";
+                            readonly position: "absolute";
+                            readonly left: "32px";
+                            readonly right: "32px";
+                            readonly bottom: "56px";
+                            readonly maxWidth: "640px";
+                        };
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.67, 0], readonly [0.74, 1], readonly [1, 1]];
+                        }, {
+                            readonly prop: "y";
+                            readonly keys: readonly [readonly [0.67, 6], readonly [0.74, 0]];
+                        }];
+                        readonly c: readonly [{
+                            readonly t: "Heading";
+                            readonly es: "h2";
+                            readonly level: "h2";
+                            readonly slot: "title3";
+                            readonly max: 52;
+                            readonly ph: "copy";
+                            readonly text: "And it is yours";
+                        }, {
+                            readonly t: "Text";
+                            readonly es: "lead";
+                            readonly slot: "text3";
+                            readonly max: 180;
+                            readonly ph: "copy";
+                            readonly text: "What the client leaves with, in a sentence or two.";
+                        }];
+                    }];
+                }];
+            }];
+        };
+    };
+    readonly "proof.scene-words": {
+        readonly family: "proof";
+        readonly scene: true;
+        readonly label: "A testimonial that lights word by word";
+        readonly intent: "One client's words, lit one word at a time while the page holds still — only once the studio has a real quote worth slowing down for.";
+        readonly node: {
+            readonly t: "Section";
+            readonly es: "section";
+            readonly role: "scene";
+            readonly lay: {
+                readonly position: "relative";
+                readonly display: "block";
+                readonly width: "100%";
+                readonly height: "250vh";
+                readonly padding: "0px";
+            };
+            readonly c: readonly [{
+                readonly t: "Container";
+                readonly role: "scene.stage";
+                readonly lay: {
+                    readonly position: "sticky";
+                    readonly top: "0px";
+                    readonly display: "flex";
+                    readonly width: "100%";
+                    readonly height: "100svh";
+                    readonly overflow: "hidden";
+                    readonly padding: "32px 32px 32px 32px";
+                    readonly alignItems: "center";
+                    readonly justifyContent: "center";
+                };
+                readonly c: readonly [{
+                    readonly t: "Container";
+                    readonly es: "box";
+                    readonly lay: {
+                        readonly display: "flex";
+                        readonly flexDirection: "column";
+                        readonly gap: "20px";
+                        readonly maxWidth: "900px";
+                        readonly width: "100%";
+                        readonly margin: "0px auto 0px auto";
+                    };
+                    readonly c: readonly [{
+                        readonly t: "Text";
+                        readonly es: "eyebrow";
+                        readonly slot: "eyebrow";
+                        readonly max: 32;
+                        readonly ph: "copy";
+                        readonly text: "What clients say";
+                    }, {
+                        readonly t: "Heading";
+                        readonly es: "h2";
+                        readonly level: "h2";
+                        readonly ph: "copy";
+                        readonly text: "A sentence a client actually said, in their own words.";
+                        readonly tracks: readonly [{
+                            readonly prop: "words";
+                            readonly keys: readonly [readonly [0.08, 0], readonly [0.7, 100]];
+                        }];
+                    }, {
+                        readonly t: "Text";
+                        readonly es: "small";
+                        readonly ph: "copy";
+                        readonly text: "[Client name] · [Project, city]";
+                        readonly tracks: readonly [{
+                            readonly prop: "opacity";
+                            readonly keys: readonly [readonly [0.7, 0], readonly [0.82, 1]];
+                        }];
+                    }];
+                }];
+            }];
+        };
+    };
     readonly "nav.inline-cta": {
         readonly family: "nav";
         readonly label: "Navigation bar";
@@ -4167,6 +4622,14 @@ declare const SPEC_SITE_LIBRARY: readonly [{
     readonly id: "hero.stacked-editorial";
     readonly family: "hero";
     readonly composed: true;
+}, {
+    readonly id: "hero.scene-depth";
+    readonly family: "hero";
+    readonly composed: true;
+}, {
+    readonly id: "hero.scene-object";
+    readonly family: "hero";
+    readonly composed: true;
 }, {
     readonly id: "proof.logo-strip";
     readonly family: "proof";
@@ -4183,6 +4646,10 @@ declare const SPEC_SITE_LIBRARY: readonly [{
     readonly id: "proof.testimonial-carousel";
     readonly family: "proof";
     readonly composed: true;
+}, {
+    readonly id: "proof.scene-words";
+    readonly family: "proof";
+    readonly composed: true;
 }, {
     readonly id: "feature.triad";
     readonly family: "feature";
@@ -4227,6 +4694,10 @@ declare const SPEC_SITE_LIBRARY: readonly [{
     readonly id: "story.quote-break";
     readonly family: "story";
     readonly composed: true;
+}, {
+    readonly id: "story.scene-chapters";
+    readonly family: "story";
+    readonly composed: true;
 }, {
     readonly id: "cta.banner";
     readonly family: "cta";
@@ -4523,6 +4994,12 @@ interface SitePlan {
     readonly dataSources: ReadonlyArray<DataSourcePlan>;
     readonly pages: ReadonlyArray<PagePlan>;
     readonly globals: Readonly<Record<`${GlobalSlot}`, string>>;
+    /** SC6b: the owner's film as pictures, set by the build and placed by `placeFilm` — never a model's. */
+    readonly film?: PlanFilm;
+}
+/** SC6b: the owner's film — the numbered pictures the wizard's browser made of their video (media-core). */
+interface PlanFilm {
+    readonly sequence: FrameSequence;
 }
 
 /**
@@ -4731,6 +5208,20 @@ 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.
+ */
+interface PatternTrack {
+    readonly prop: string;
+    readonly keys: ReadonlyArray<readonly [number, number | string]>;
+    readonly from?: string;
 }
 /** The composite-core recipes a pattern may stamp (`recipe`). */
 declare enum PatternRecipe {
@@ -4770,6 +5261,11 @@ 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;
 }
 declare const SITE_PATTERNS: Readonly<Record<string, SitePattern>>;
@@ -4849,7 +5345,11 @@ declare function slotBudget(pattern: SitePattern, slot: string, density?: string
 declare function patternLinkSlots(pattern: SitePattern): string[];
 /** True when the pattern holds a Form a section's `form` may give another preset. */
 declare function patternHasForm(pattern: SitePattern): boolean;
-/** 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). */
+declare const SCENE_LEVEL = "expressive";
+/** SC6: Scenes on the home page and at most this many other pages, one per page (`validateSitePlan`). */
+declare const SCENE_OTHER_PAGES = 1;
+/** The library's sections (contract `site.library`), each with whether it is composed. */
 declare const SITE_LIBRARY: ReadonlyArray<{
     readonly id: string;
     readonly family: string;
@@ -4873,9 +5373,18 @@ 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;
+}
+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). */
-declare function patternManifest(density?: string | null): PatternManifestEntry[];
+/**
+ * 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.
+ */
+declare function patternManifest(density?: string | null, options?: PatternManifestOptions): PatternManifestEntry[];
 /** The bind scopes a pattern reads (`route`, `next`, …) — what its page must provide. */
 declare function patternScopes(pattern: SitePattern): Set<string>;
 
@@ -4941,6 +5450,9 @@ interface SerializedNode {
     itemKey?: string;
     /** A targeted state's driving node (CC2: an icon's `trigger-on` → its item). */
     stateTriggers?: Partial<Record<string, string>>;
+    /** SC6: a Scene layer's tracks (scene-core `SceneTrack`), and its phone's own. Additive. */
+    sceneTracks?: unknown[];
+    scenePhoneTracks?: unknown[];
     bindings: SerializedBinding[];
     interactions: unknown[];
     isGlobal?: boolean;
@@ -5115,7 +5627,13 @@ declare enum SitePlanIssueCode {
     /** A page names a need the harness does not have. */
     UnknownNeed = "unknown-need",
     /** A page key that is a global slot's name (`header`, `footer`): its sections' ids would be the global's. */
-    ReservedPageKey = "reserved-page-key"
+    ReservedPageKey = "reserved-page-key",
+    /** SC6: a Scene below How animated Expressive, a second Scene on a page, or Scenes on more than the home page and
+     *  one other — the pages answer by choosing another pattern. */
+    SceneBudget = "scene-budget",
+    /** SC6b: the owner's film — pictures that cannot play, too few to play smoothly, or a film's pattern on a plan with
+     *  no film (or twice). Set by the build, never by a model. */
+    Film = "film"
 }
 type SitePlanIssue = PathIssue<SitePlanIssueCode>;
 interface SitePlanValidation {
@@ -5522,7 +6040,11 @@ interface ShowcaseInput {
     business: SiteBusiness;
     design: DesignChoices;
     locale?: `${SiteLocale}`;
+    /** SC6b: the film the film's Scene plays — a render-parity run serves its own; absent, `SHOWCASE_FILM`. */
+    film?: FrameSequence;
 }
+/** SC6b: a film's description for the showcase — as many pictures as the build prepares; nothing is fetched to compose it. */
+declare const SHOWCASE_FILM: FrameSequence;
 /** The showcase's pages: Home (the heroes), one page per other family in library order, and the item page. */
 declare function showcasePages(): PagePlan[];
 /** Every header and footer pattern, in contract order. */
@@ -5530,7 +6052,13 @@ declare function showcaseGlobals(): {
     headers: string[];
     footers: string[];
 };
-/** The showcase as Site Plans — as many as it takes for every header and every footer to be composed once. */
+/** SC6: the Scene patterns — each shown alone on the home page of its own plan, as a site may hold one (validateScenes). */
+declare function showcaseScenes(): string[];
+/**
+ * The showcase as Site Plans — as many as it takes for every header and every footer to be composed once, then one per
+ * Scene pattern (SC6): its home page holds that Scene and nothing else, at How animated Expressive, the only level a
+ * Scene is composed at; the film's Scene with a film (SC6b).
+ */
 declare function showcasePlans(input: ShowcaseInput): SitePlan[];
 
 /**
@@ -5822,7 +6350,7 @@ declare function planPartOfPath(path: string): PlanPart;
 declare function planWireGaps(): string[];
 declare class PlanWireShapeError extends Error {
 }
-/** The patterns a page section may use (every non-global one), in library order. */
+/** The patterns a page section may use (every non-global one but a film's, which `placeFilm` places), in library order. */
 declare function sectionPatternIds(): string[];
 declare function wireFieldJsonSchema(): JsonSchema;
 /** What an object of the wire travels without when its children are written as their own entries (a plan edit's). */
@@ -6773,5 +7301,54 @@ declare function stockCreditNode(index: number, credit: StockLink): SerializedNo
 /** Append the credit lines to the footer root (once each). Returns how many it added. */
 declare function addStockCredits(footer: SerializedNode, credits: ReadonlyArray<StockLink>): number;
 
-export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_PART_TOKENS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiFeature, AiGenerationStage, AiKeyMode, AiLimit, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CONTENT_ROLE_MEANINGS, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentFieldControl, ContentFieldType, ContentRole, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, DEFAULT_SITE_LOCALE, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, EntranceSide, FACT_KEYS, FIELD_TYPE_OF_CONTROL, FINAL_GENERATION_STAGES, FINDING_SEVERITY, GRAMMAR_TOO_LARGE_MESSAGE, GlobalSlot, HEBREW_PREFIXES, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PAGE_ARCHETYPES, PLAN_EDITS_ANSWER_SHAPES, PLAN_EDITS_PART_SCHEMA_NAMES, PLAN_EDIT_OP_PART, PLAN_EDIT_SHAPE, PLAN_EDIT_WIRE_KEYS, PLAN_PARTS, PLAN_PART_KEYS, PLAN_WIRE_DERIVED, PLAN_WIRE_PART_SCHEMA_NAMES, PLAN_WIRE_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanPart, PlanWireEntry, PlanWireShapeError, PlanWordIssueCode, PreflightRefusalCode, PublishRefusalCode, REQUIRED_CONTENT_ROLES, RelativeOp, SAMPLE_IMAGE_REF, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_LIBRARY, SITE_LOCALES, SITE_NEED_IDS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_ARCHETYPES, SPEC_SITE_COPY_LENGTHS, SPEC_SITE_DENSITY_COPY, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_LOCALES, SPEC_SITE_NEED_IDS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_REQUIRED_ROLES, SPEC_SITE_ROLES, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STOCK_FAMILY_INTENTS, STOCK_INTENT_ORDER, STOCK_INTENT_SUBJECTS, STOCK_ITEM_ASPECT, STOCK_MIN_KEPT, STOCK_PROVIDER_TERMS, STOCK_SUBJECT_WORDS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockIntent, StockOrientation, StockProviderId, StockReviewFlag, StockReviewVerdict, StockSlotKind, StockSubject, addBarItem, addStockCredits, aiStepParts, applyOwnPhotoGalleries, applyPlanEdits, applyStockItemPhotos, applyStockPhotos, archetypeIssues, aspectRatioOf, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypePreviewFields, contentTypeToWire, copyLengthOf, costUsd, createSerializedNode, creditsOfUsd, dataSourceToWire, derivedDataSources, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, expandPlanWire, expandWireContentType, expandWireDataSource, expandWireEdit, expandWireField, expandWirePage, expandWireSection, failedBuildStep, fieldToWire, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, isRtlLocale, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, orientationOfRatio, pageToWire, parsePatternPath, parseSampleImageRef, pathAt, patternById, patternHasForm, patternLinkSlots, patternListGap, patternManifest, patternNeedsBinding, patternNodes, patternOptionalParts, patternRoleNeeds, patternScopes, patternSlotBudgets, patternSlots, patternTakesBinding, phoneMenuPages, planEditOps, planEditToWire, planEditWireGaps, planEditWireKeys, planEditWireOps, planEditWireShape, planEditsFromWire, planEditsJsonSchema, planEditsToWire, planEntrances, planFromTemplate, planNavShape, planOwnPhotos, planPartOfPath, planPartToWire, planStockPhotos, planToWire, planWireGaps, planWirePartJsonSchema, planWirePartShape, planWordIssues, publishRefusal, publishVerdict, recipeListBinds, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, roleField, routeMatches, routeParams, sampleImageRef, scoreStockPhoto, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockFits, stockGroupOf, stockItemSlots, stockKept, stockPhotoRatio, stockPhotoSubject, stockPhotoUsable, stockPhotoWords, stockSlots, stockWord, stockWords, strictSchemaComplexity, strictSchemaRefusal, typicalStepTokens, validatePlanEdits, validateSitePlan, walkSerialized, wireContentTypeJsonSchema, wireDataSourceJsonSchema, wireFieldJsonSchema, wirePageJsonSchema, wireSectionJsonSchema, withDerivedSources, wordPattern, writtenTexts };
-export type { AddBarItemResult, AiEntitlementsView, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AuditPage, AuditPlaceholder, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentRoles, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceActionOptions, EntranceInteraction, EntranceMark, EntranceSpec, EntranceStamp, FactKey, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, OwnPhotoPlacement, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternNode, PatternPath, PatternRoleNeed, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanWireContext, PlanWireParts, PlanWordContext, PlanWordIssue, PreflightRefusal, PublishRefusal, RecipeListBinds, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, ShowcaseInput, SiteAudit, SiteAuditOptions, SiteAuditSnapshot, SiteBuildRun, SiteBusiness, SiteCheck, SiteFinding, SiteNeedId, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, StockCredit, StockItemSlot, StockLink, StockNeed, StockPhoto, StockPhotoTraits, StockPlacement, StockPlanOptions, StockProviderTerms, StockReview, StockSlot, StockTarget, StrictSchemaComplexity, StrictSchemaRefusal, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WireOptions, WrittenText };
+/**
+ * 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. */
+declare const FILM_PATTERN: string;
+/** Why a film stays off the site. Each is said to the owner on the Plan step. */
+declare 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. */
+interface FilmTarget {
+    readonly page: number;
+    readonly section: number;
+}
+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). */
+declare function filmPlacement(plan: Pick<SitePlan, 'design' | 'pages'>): FilmPlacement;
+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.
+ */
+declare function placeFilm(plan: SitePlan, sequence: unknown): PlacedFilm;
+/** The film's pictures as the composer stamps them, and the height its Scene holds the page for. */
+declare function filmOfPlan(plan: Pick<SitePlan, 'film'>): {
+    sequence: FrameSequence;
+    heightVh: number;
+} | null;
+
+export { ACTIVE_BUILD_STATUSES, AI_REFUSAL_NEXT, AI_REFUSAL_STATUS, AI_STEPS, AI_STEP_LABELS, AI_STEP_NEEDS, AI_STEP_PART_TOKENS, AI_STEP_TYPICAL_TOKENS, AiCallStatus, AiCapability, AiFeature, AiGenerationStage, AiKeyMode, AiLimit, AiNextKind, AiProviderId, AiRefusalCode, AiStep, BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BUILD_STEPS, BaselineRole, BindScope, BuildNoticeCode, BuildStep, CONTENT_ROLE_MEANINGS, CREDITS_PER_USD, CardBindTarget, CheckSeverity, ComposeError, ComposeIssueCode, ContentFieldControl, ContentFieldType, ContentRole, ContentTypeAction, CreatedKind, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, DEFAULT_SITE_LOCALE, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, EntranceSide, FACT_KEYS, FIELD_TYPE_OF_CONTROL, FILM_PATTERN, FINAL_GENERATION_STAGES, FINDING_SEVERITY, FilmUnplaced, GRAMMAR_TOO_LARGE_MESSAGE, GlobalSlot, HEBREW_PREFIXES, JSON_SCHEMA_BANNED_KEYWORDS, JsonSchemaShapeError, KeptReason, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NO_TOKENS, NavPagesSource, NavRole, NavShape, NavShapeError, PAGE_ARCHETYPES, PLAN_EDITS_ANSWER_SHAPES, PLAN_EDITS_PART_SCHEMA_NAMES, PLAN_EDIT_OP_PART, PLAN_EDIT_SHAPE, PLAN_EDIT_WIRE_KEYS, PLAN_PARTS, PLAN_PART_KEYS, PLAN_WIRE_DERIVED, PLAN_WIRE_PART_SCHEMA_NAMES, PLAN_WIRE_SHAPE, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanChangeAction, PlanChangeKind, PlanDataSourceMode, PlanDataSourceType, PlanEditIssueCode, PlanEditOp, PlanEditsOutcome, PlanPart, PlanWireEntry, PlanWireShapeError, PlanWordIssueCode, PreflightRefusalCode, PublishRefusalCode, REQUIRED_CONTENT_ROLES, RelativeOp, SAMPLE_IMAGE_REF, SCENE_LEVEL, SCENE_OTHER_PAGES, SHOWCASE_FILM, SITE_CHECKS, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_LIBRARY, SITE_LOCALES, SITE_NEED_IDS, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_ARCHETYPES, SPEC_SITE_COPY_LENGTHS, SPEC_SITE_DENSITY_COPY, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_LOCALES, SPEC_SITE_NEED_IDS, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_REQUIRED_ROLES, SPEC_SITE_ROLES, SPEC_SITE_TEMPLATES, STOCK_FAMILIES, STOCK_FAMILY_INTENTS, STOCK_INTENT_ORDER, STOCK_INTENT_SUBJECTS, STOCK_ITEM_ASPECT, STOCK_MIN_KEPT, STOCK_PROVIDER_TERMS, STOCK_SUBJECT_WORDS, STRICT_SCHEMA_BUDGET, STRICT_SCHEMA_LIMITS, STUDIO_TEMPLATE, SiteBuildKind, SiteBuildStatus, SiteCheckId, SiteFindingCode, SiteLocale, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, StepState, StockIntent, StockOrientation, StockProviderId, StockReviewFlag, StockReviewVerdict, StockSlotKind, StockSubject, addBarItem, addStockCredits, aiStepParts, applyOwnPhotoGalleries, applyPlanEdits, applyStockItemPhotos, applyStockPhotos, archetypeIssues, aspectRatioOf, assertStyleSlots, assertValidSitePlan, auditSite, barIconForRoute, blocksPublish, buildKeys, buildStepFacts, builtHomePageId, composeNavHeader, composeSection, composeSite, contentTypePreviewFields, contentTypeToWire, copyLengthOf, costUsd, createSerializedNode, creditsOfUsd, dataSourceToWire, derivedDataSources, describePlanData, describeShapeKey, entranceAction, entranceInteraction, estimateStepCredits, expandPlanWire, expandWireContentType, expandWireDataSource, expandWireEdit, expandWireField, expandWirePage, expandWireSection, failedBuildStep, fieldToWire, filmOfPlan, filmPlacement, findNavRoot, isActiveBuild, isNonEmptyString, isPlainObject, isRtlLocale, jsonAnyOf, jsonBoolean, jsonClosedObject, jsonInteger, jsonListOf, jsonOneOf, jsonSchemaKeywords, jsonSchemaObjects, jsonShapedObject, jsonText, modelCanDo, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, orientationOfRatio, pageToWire, parsePatternPath, parseSampleImageRef, pathAt, patternById, patternHasForm, patternLinkSlots, patternListGap, patternManifest, patternNeedsBinding, patternNodes, patternOptionalParts, patternRoleNeeds, patternScopes, patternSlotBudgets, patternSlots, patternTakesBinding, phoneMenuPages, placeFilm, planEditOps, planEditToWire, planEditWireGaps, planEditWireKeys, planEditWireOps, planEditWireShape, planEditsFromWire, planEditsJsonSchema, planEditsToWire, planEntrances, planFromTemplate, planNavShape, planOwnPhotos, planPartOfPath, planPartToWire, planStockPhotos, planToWire, planWireGaps, planWirePartJsonSchema, planWirePartShape, planWordIssues, publishRefusal, publishVerdict, recipeListBinds, releasedLayoutDefaults, removeBarItem, requiredAcknowledgements, requiredShapeKeys, roleField, routeMatches, routeParams, sampleImageRef, scoreStockPhoto, sectionEntrances, sectionPatternIds, sectionToWire, setStyleProps, shapeKeys, showcaseGlobals, showcasePages, showcasePlans, showcaseScenes, siteNavPages, slotBudget, stockCopyKey, stockCreditLine, stockCreditLines, stockCreditNode, stockCreditNodeId, stockFits, stockGroupOf, stockItemSlots, stockKept, stockPhotoRatio, stockPhotoSubject, stockPhotoUsable, stockPhotoWords, stockSlots, stockWord, stockWords, strictSchemaComplexity, strictSchemaRefusal, typicalStepTokens, validatePlanEdits, validateSitePlan, walkSerialized, wireContentTypeJsonSchema, wireDataSourceJsonSchema, wireFieldJsonSchema, wirePageJsonSchema, wireSectionJsonSchema, withDerivedSources, wordPattern, writtenTexts };
+export type { AddBarItemResult, AiEntitlementsView, AiMeter, AiModelEntry, AiRefusal, AiTokenCounts, AiTokenPrice, AuditPage, AuditPlaceholder, BarItemsEditResult, BuildNotice, BuildStepError, BuildStepFacts, BuildStepRecord, CmsDataSourcePlan, ComposeContext, ComposeIssue, ComposedDataSource, ComposedItem, ComposedNavHeader, ComposedPage, ComposedPlaceholder, ComposedRoute, ComposedSection, ComposedSite, ContentFieldPlan, ContentRoles, ContentSeedPlan, ContentTypePlan, CreateNodeOptions, CreatedRecord, DataSourcePlan, DynamicKeysAsList, EntranceAction, EntranceActionOptions, EntranceInteraction, EntranceMark, EntranceSpec, EntranceStamp, FactKey, FilmPlacement, FilmTarget, JsonSchema, NavHeaderInput, NavHeaderOptions, NavPage, NavShapeOptions, NavShapeResult, NodeBaseline, OwnPhotoPlacement, PageArchetype, PageArchetypeId, PageArchetypeSlot, PageData, PageDataLine, PagePlan, PageSectionPlan, PageSeoPlan, PathIssue, PatternManifestEntry, PatternManifestOptions, PatternNode, PatternPath, PatternRoleNeed, PatternTrack, PlacedFilm, PlainObject, PlanChange, PlanEdit, PlanEditIssue, PlanEditResult, PlanEditsAnswer, PlanEntrancesInput, PlanFilm, PlanWireContext, PlanWireParts, PlanWordContext, PlanWordIssue, PreflightRefusal, PublishRefusal, RecipeListBinds, RelativeDataSourcePlan, SectionEntrances, SectionInput, SectionOptions, SerializedBinding, SerializedNode, SerializedResponsive, ShapeEntry, ShapeIssueCodes, ShowcaseInput, SiteAudit, SiteAuditOptions, SiteAuditSnapshot, SiteBuildRun, SiteBusiness, SiteCheck, SiteFinding, SiteNeedId, SitePageRef, SitePattern, SitePlan, SitePlanIssue, SitePlanSource, SitePlanValidation, SiteTemplate, StockCredit, StockItemSlot, StockLink, StockNeed, StockPhoto, StockPhotoTraits, StockPlacement, StockPlanOptions, StockProviderTerms, StockReview, StockSlot, StockTarget, StrictSchemaComplexity, StrictSchemaRefusal, TemplatePlanInput, UndoKept, UndoPreview, UndoRecord, WireOptions, WrittenText };