@vectoriox/iox-ui 5.47.0 → 5.48.0

package/fesm2022/vectoriox-iox-ui-generation-core.mjs

@@ -9705,6 +9705,133 @@ function composeSection(patternId, input, options) {
     return { section, placeholders, issues };
 }
 
+/**
+ * How animated (AI plan rev 3.1 §3p) — the ONE reading of the contract's `axes.animations` (what each level
+ * moves, how) and `axes.animationFamilies` (which parts a section family lets move). The pieces every stamper
+ * shares: the Design step's business specimen (H4-4) today, `planEntrances` in the composer (M1-6b) next. Pure.
+ *
+ * A level with `content` moves a section's content together, once; otherwise it names parts (heading, items,
+ * media…) and each part enters on its own, items one after another. Navigation, footers and globals are a family
+ * with no parts, so nothing there ever moves.
+ */
+var EntrancePart;
+(function (EntrancePart) {
+    EntrancePart["Content"] = "content";
+    EntrancePart["Heading"] = "heading";
+    EntrancePart["Items"] = "items";
+    EntrancePart["Media"] = "media";
+    EntrancePart["RowMedia"] = "rowMedia";
+    EntrancePart["HeroText"] = "heroText";
+})(EntrancePart || (EntrancePart = {}));
+/** What an entrance stamp is marked with — a later restamp touches only what the look made (H4-5). */
+const ENTRANCE_ORIGIN_LOOK = 'look';
+/** The trigger every entrance plays on. */
+const ENTRANCE_TRIGGER = 'viewportEnter';
+/** The easing every entrance plays with (only `opacity` and `transform` move). */
+const ENTRANCE_EASING = 'ease-out';
+const LEVELS = SPEC_AXES.animations;
+const FAMILIES = SPEC_AXES.animationFamilies;
+const NOTHING = { content: null, parts: {} };
+/** What a section of `family` moves at `level` — nothing for an unknown level or family. */
+function sectionEntrances(level, family) {
+    const lv = level ? LEVELS[level] : undefined;
+    const allow = FAMILIES[family] ?? [];
+    if (!lv || !allow.length)
+        return NOTHING;
+    if (lv.parts.content && allow.includes(EntrancePart.Content))
+        return { content: lv.parts.content, parts: {} };
+    const parts = {};
+    for (const part of allow) {
+        if (part === EntrancePart.Content)
+            continue;
+        // A level without its own side-by-side entrance gives a row's picture the plain picture one.
+        const spec = lv.parts[part] ?? (part === EntrancePart.RowMedia ? lv.parts.media : undefined);
+        if (spec)
+            parts[part] = spec;
+    }
+    return { content: null, parts };
+}
+/** The literal delay of the `index`-th item: `stagger` ms each, the last `cap` waiting no longer than the one before. */
+function staggerDelay(spec, index = 0) {
+    if (!spec.stagger)
+        return 0;
+    const cap = Math.max(1, spec.cap ?? 1);
+    return Math.min(Math.max(0, index), cap - 1) * spec.stagger;
+}
+/** The action a node plays: the spec's type (mirrored on a right-to-left page), its distance and its delay. */
+function entranceAction(spec, opts = {}) {
+    return {
+        type: opts.rtl && spec.mirror ? spec.mirror : spec.type,
+        target: 'self',
+        duration: spec.duration,
+        delay: staggerDelay(spec, opts.index),
+        easing: ENTRANCE_EASING,
+        once: true,
+        ...(spec.distance ? { params: { distance: spec.distance } } : {}),
+    };
+}
+/** The stamp on a node: `viewportEnter`, once, on itself (a duplicated node needs no remap), from the look. */
+function entranceInteraction(nodeId, action) {
+    return { id: `${nodeId}-enter`, trigger: ENTRANCE_TRIGGER, actions: [action], origin: ENTRANCE_ORIGIN_LOOK };
+}
+
+/**
+ * What each page of a plan shows and where its data comes from (AI plan rev 3 §3d, `describePlanData`) — the
+ * Plan step's data lines, in the vocabulary the builder already uses. Pure and STRUCTURED: the screen words
+ * each kind in its own language ("Lists every Project", "One Project, found by its address /work/:slug").
+ */
+var PageDataKind;
+(function (PageDataKind) {
+    /** A section repeats every item of a content type. */
+    PageDataKind["List"] = "list";
+    /** A section repeats the newest `count` items. */
+    PageDataKind["Latest"] = "latest";
+    /** A template page: one item, found by its address — one page per item. */
+    PageDataKind["One"] = "one";
+    /** The next (or previous) item beside the page's own. */
+    PageDataKind["Siblings"] = "siblings";
+    /** A form: what it sends, to the studio's inbox (+ an email when Email is connected). */
+    PageDataKind["Form"] = "form";
+    /** Words and pictures, no data. */
+    PageDataKind["Static"] = "static";
+})(PageDataKind || (PageDataKind = {}));
+const sameLine = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function sourceLine(source, label) {
+    if (!source || source.type !== PlanDataSourceType.Cms)
+        return null;
+    const cms = source;
+    if (cms.mode !== PlanDataSourceMode.Query)
+        return null;
+    return cms.limit
+        ? { kind: PageDataKind.Latest, contentType: label(cms.contentType), count: cms.limit }
+        : { kind: PageDataKind.List, contentType: label(cms.contentType) };
+}
+function pageLines(page, plan, label) {
+    const lines = [];
+    const add = (line) => { if (line && !lines.some(l => sameLine(l, line)))
+        lines.push(line); };
+    if (page.template)
+        add({ kind: PageDataKind.One, contentType: label(page.template), route: page.route });
+    for (const section of page.sections) {
+        const pattern = patternById(section.pattern);
+        if (!pattern)
+            continue;
+        if (section.binding)
+            add(sourceLine(plan.dataSources.find(d => d.alias === section.binding), label));
+        if (page.template && patternScopes(pattern).has(BindScope.Next))
+            add({ kind: PageDataKind.Siblings, contentType: label(page.template) });
+        for (const node of patternNodes(pattern))
+            if (node.preset)
+                add({ kind: PageDataKind.Form, form: node.preset });
+    }
+    return lines.length ? lines : [{ kind: PageDataKind.Static }];
+}
+/** One entry per page of the plan, in plan order. */
+function describePlanData(plan) {
+    const label = (name) => plan.contentTypes.find(t => t.name === name)?.label ?? name;
+    return plan.pages.map(page => ({ pageKey: page.key, lines: pageLines(page, plan, label) }));
+}
+
 /**
  * @vectoriox/iox-ui/generation-core — the shared, FRAMEWORK-FREE site-plan core (design-system plan
  * §6b, W1): the Site Plan shape + its validator, the pattern library and the Studio template (both
@@ -9721,5 +9848,5 @@ function composeSection(patternId, input, options) {
  * Generated bundle index. Do not edit.
  */
 
-export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, findNavRoot, isNonEmptyString, isPlainObject, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, setStyleProps, shapeKeys, siteNavPages, validateSitePlan, walkSerialized };
+export { BAR_ITEMS_MAX, BAR_ITEMS_MIN, BASELINE_ROLES, BaselineRole, BindScope, CardBindTarget, ComposeError, ComposeIssueCode, DANGLING_LINK_CODES, DEFAULT_PHONE_MENU_BREAKPOINT, ENTRANCE_EASING, ENTRANCE_ORIGIN_LOOK, ENTRANCE_TRIGGER, EntrancePart, FACT_KEYS, GlobalSlot, NAV_PART_LABELS, NAV_SHAPE_COPY, NEUTRAL_STYLE_PROPS, NODE_BASELINES, NavPagesSource, NavRole, NavShape, NavShapeError, PRICING_PATTERN, PUBLISH_BLOCKING_PLACEHOLDERS, PageDataKind, PathIssueCollector, PatternDirective, PatternGlobalPosition, PatternOpens, PatternPlaceholder, PatternRecipe, PhoneMenuBreakpoint, PlaceholderKind, PlanDataSourceMode, PlanDataSourceType, RelativeOp, SAMPLE_IMAGE_REF, SITE_FACT_LABELS, SITE_HEADER_PATTERN, SITE_PATTERNS, SITE_PLAN_VERSION, SITE_TEMPLATES, SPEC_SITE_FACTS, SPEC_SITE_LIBRARY, SPEC_SITE_PATTERNS, SPEC_SITE_PLAN_SHAPE, SPEC_SITE_TEMPLATES, STUDIO_TEMPLATE, SitePlanError, SitePlanIssueCode, SitePlanSourceKind, SiteTemplateError, SiteTemplateId, addBarItem, altSourceScopes, assertStyleSlots, assertValidSitePlan, barIconForRoute, blocksPublish, composeNavHeader, composeSection, composeSite, createSerializedNode, describePlanData, entranceAction, entranceInteraction, findNavRoot, isNonEmptyString, isPlainObject, moveBarItem, navPages, navShapeBreakpoint, navShapeOf, nextSourceOf, nodeBindPaths, parseSampleImageRef, pathAt, patternById, patternNeedsBinding, patternNodes, patternOptionalParts, patternScopes, patternSlots, patternTakesBinding, phoneMenuPages, planFromTemplate, planNavShape, releasedLayoutDefaults, removeBarItem, requiredShapeKeys, routeParams, sampleImageRef, sectionEntrances, setStyleProps, shapeKeys, siteNavPages, staggerDelay, validateSitePlan, walkSerialized };
 //# sourceMappingURL=vectoriox-iox-ui-generation-core.mjs.map