@vectoriox/iox-ui 5.77.0 → 5.79.0

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

@@ -196,6 +196,8 @@ export const PLAN_WIRE_DERIVED: Readonly<Record<string, string>> = {
     sourceTemplate: 'the AI never writes a template plan',
     sourceAi: 'this run (the context)',
     design: "the owner's pick (the context)",
+    'plan.film': "the owner's film, set by the build (SC6b)",
+    film: "the owner's film, set by the build (SC6b)",
 };
 
 const wireText = (spec: WireKey): string => {
@@ -252,9 +254,9 @@ const orNone = (values: ReadonlyArray<string>): JsonSchema => jsonOneOf([NONE, .
 const closedOrText = (values: ReadonlyArray<string>): JsonSchema => (values.length ? jsonOneOf(values) : jsonText());
 const shaped = (entry: `${PlanWireEntry}`, properties: Record<string, JsonSchema>) => jsonShapedObject(PLAN_WIRE_SHAPE[entry], properties, `wire ${entry}`);
 
-/** 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. */
 export function sectionPatternIds(): string[] {
-    return Object.entries(SITE_PATTERNS).filter(([, p]) => !p.global).map(([id]) => id);
+    return Object.entries(SITE_PATTERNS).filter(([, p]) => !p.global && !p.film).map(([id]) => id);
 }
 
 const sectionPatterns = () => sectionPatternIds().map(id => SITE_PATTERNS[id]);

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

@@ -36,3 +36,4 @@ export * from './plan-words';
 export * from './audit-site';
 export * from './stock-match';
 export * from './stock-photos';
+export * from './film';

package/src/generation-core/serialized-node.ts

@@ -34,6 +34,9 @@ export 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;

package/src/generation-core/showcase.ts

@@ -1,6 +1,7 @@
 import type { DesignChoices } from '@vectoriox/iox-ui/design-core';
+import { FILM_PREPARED_PICTURES, FrameExtension, FrameSequence } from '@vectoriox/iox-ui/media-core';
 
-import { BindScope, patternNeedsBinding, PatternGlobalPosition, patternScopes, SITE_PATTERNS } from './patterns';
+import { BindScope, patternNeedsBinding, PatternGlobalPosition, patternScopes, SCENE_LEVEL, SITE_PATTERNS } from './patterns';
 import { GlobalSlot, PagePlan, PageSectionPlan, SiteBusiness, SiteLocale, SitePlan, SitePlanSourceKind, SITE_PLAN_VERSION } from './site-plan.model';
 import { STUDIO_TEMPLATE } from './templates';
 
@@ -15,8 +16,17 @@ export 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. */
+export const SHOWCASE_FILM: FrameSequence = {
+    base: 'https://showcase.iox.invalid/film', ext: FrameExtension.Webp,
+    wide: { count: FILM_PREPARED_PICTURES, width: 1600, height: 900 },
+    phone: { count: FILM_PREPARED_PICTURES, width: 1100, height: 619 },
+};
+
 const ITEM_ROUTE = '/work/:slug';
 const LIST_SOURCE = 'projects';
 
@@ -39,7 +49,7 @@ export function showcasePages(): PagePlan[] {
     const byFamily = new Map<string, string[]>();
     const onItemPage: string[] = [];
     for (const [id, p] of Object.entries(SITE_PATTERNS)) {
-        if (p.global) continue;
+        if (p.global || p.scene) continue;
         if (readsRouteItem(id)) { onItemPage.push(id); continue; }
         byFamily.set(p.family, [...(byFamily.get(p.family) ?? []), id]);
     }
@@ -62,20 +72,35 @@ export function showcaseGlobals(): { headers: string[]; footers: string[] } {
     return { headers: of(PatternGlobalPosition.Before), footers: of(PatternGlobalPosition.After) };
 }
 
-/** 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). */
+export function showcaseScenes(): string[] {
+    return Object.entries(SITE_PATTERNS).filter(([, p]) => p.scene && !p.global).map(([id]) => id);
+}
+
+/**
+ * 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).
+ */
 export function showcasePlans(input: ShowcaseInput): SitePlan[] {
     const { headers, footers } = showcaseGlobals();
     const count = Math.max(headers.length, footers.length, 1);
     const pages = showcasePages();
-    return Array.from({ length: count }, (_, i): SitePlan => ({
+    const plan = (i: number, planPages: PagePlan[], design: DesignChoices): SitePlan => ({
         version: SITE_PLAN_VERSION,
         source: { kind: SitePlanSourceKind.Template, templateId: 'showcase', templateVersion: 1 },
         business: JSON.parse(JSON.stringify(input.business)),
         ...(input.locale ? { locale: input.locale } : {}),
-        design: JSON.parse(JSON.stringify(input.design)),
+        design: JSON.parse(JSON.stringify(design)),
         contentTypes: JSON.parse(JSON.stringify(STUDIO_TEMPLATE.contentTypes)),
         dataSources: JSON.parse(JSON.stringify(STUDIO_TEMPLATE.dataSources)),
-        pages: JSON.parse(JSON.stringify(pages)),
+        pages: JSON.parse(JSON.stringify(planPages)),
         globals: { [GlobalSlot.Header]: headers[i % headers.length], [GlobalSlot.Footer]: footers[i % footers.length] } as SitePlan['globals'],
-    }));
+    });
+    const scenes = showcaseScenes().map((id, i) => {
+        const scene = plan(i, [{ key: 'home', name: 'Home', route: '/', isHome: true, inNav: false, sections: [sectionFor(id)] }], { ...input.design, animate: SCENE_LEVEL });
+        // A film's Scene plays a film (SC6b): the plan carries one, as the build's would.
+        return SITE_PATTERNS[id].film ? { ...scene, film: { sequence: JSON.parse(JSON.stringify(input.film ?? SHOWCASE_FILM)) } } : scene;
+    });
+    return [...Array.from({ length: count }, (_, i) => plan(i, pages, input.design)), ...scenes];
 }

package/src/generation-core/site-plan.model.ts

@@ -1,3 +1,4 @@
+import type { FrameSequence } from '@vectoriox/iox-ui/media-core';
 import type { AnimateId, DesignChoices } from '@vectoriox/iox-ui/design-core';
 
 import { SPEC_SITE_ARCHETYPES, SPEC_SITE_FACTS, SPEC_SITE_LOCALES, SPEC_SITE_NEED_IDS, SPEC_SITE_REQUIRED_ROLES, SPEC_SITE_ROLES } from './site-spec.generated';
@@ -246,4 +247,11 @@ export 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). */
+export interface PlanFilm {
+    readonly sequence: FrameSequence;
 }