@vectoriox/iox-ui 5.68.0 → 5.69.0

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

@@ -75,6 +75,7 @@ const SPEC_SITE_PLAN_SHAPE = {
         "count": "integer ≥ 0",
         "sample": "boolean — items are flagged isSample",
         "isPublished": "boolean",
+        "perItem?": "per field, one string per sample: real content that wins over the template",
         "[field]?": "the field's value — strings are templates: {n} = the item's 1-based number, {sampleImage:n} / {sampleImage:n+k} = a bundled sample image"
     },
     "cmsDataSource": {
@@ -10887,6 +10888,7 @@ const ROLE_KEYS$1 = shapeKeys(SHAPE['roles']);
 const PAGE_SEO_KEYS = shapeKeys(SHAPE['pageSeo']);
 const ARRAY_TYPE = 'array';
 const FIELD_KEYS = shapeKeys(SHAPE['field']);
+const SLUG_FIELD = 'slug';
 const SEED_FIXED_KEYS = shapeKeys(SHAPE['seed']);
 const CMS_SOURCE_KEYS = shapeKeys(SHAPE['cmsDataSource']);
 const RELATIVE_SOURCE_KEYS = shapeKeys(SHAPE['relativeDataSource']);
@@ -11025,6 +11027,21 @@ function validateContentTypes(c, list) {
                 for (const key of ['sample', 'isPublished'])
                     if (typeof seed[key] !== 'boolean')
                         c.add(SitePlanIssueCode.Shape, `${path}.seed.${key}`, 'must be a boolean');
+                const perItem = seed['perItem'];
+                if (perItem !== undefined) {
+                    if (!isPlainObject(perItem))
+                        c.add(SitePlanIssueCode.Shape, `${path}.seed.perItem`, 'must be an object');
+                    else
+                        for (const [field, list] of Object.entries(perItem)) {
+                            const at = `${path}.seed.perItem.${field}`;
+                            if (!fieldSet.has(field))
+                                c.add(SitePlanIssueCode.UnknownField, at, `"${field}" is not a field of ${name}`);
+                            else if (!Array.isArray(list) || list.length !== seed['count'] || list.some(v => typeof v !== 'string'))
+                                c.add(SitePlanIssueCode.Shape, at, `must be ${String(seed['count'])} strings, one per sample`);
+                            else if (field === SLUG_FIELD && new Set(list).size !== list.length)
+                                c.add(SitePlanIssueCode.Shape, at, 'each sample needs its own slug');
+                        }
+                }
                 for (const key of Object.keys(seed)) {
                     if (!SEED_FIXED_KEYS.includes(key) && !fieldSet.has(key))
                         c.add(SitePlanIssueCode.UnknownField, `${path}.seed.${key}`, `"${key}" is not a field of ${name}`);
@@ -13061,7 +13078,8 @@ function composeItems(type, fillEmpty) {
         for (const field of type.fields) {
             const given = seed[field.name];
             const empty = !(field.name in seed) || given === '' || (Array.isArray(given) && !given.length);
-            const value = empty && fillEmpty ? defaultSeed(type, field) : given;
+            const own = seed.perItem?.[field.name]?.[n - 1];
+            const value = own || (empty && fillEmpty ? defaultSeed(type, field) : given);
             if (value !== undefined)
                 item[field.name] = expandSeedValue(value, n);
         }
@@ -13669,6 +13687,7 @@ const WIRE_KEYS = {
     seedValue: {
         field: { refs: ['seed.[field]'], text: 'string — a field of the type' },
         value: { refs: ['seed.[field]'], text: `string | string[] — ${describeShapeKey(PLAN_SHAPE['seed'], '[field]')} (a list for an array field)` },
+        each: { refs: ['seed.perItem'], text: 'string[] — one value per sample, in order, when each sample has its own content', none: '[]' },
     },
     dataSource: {
         alias: { refs: ['cmsDataSource.alias', 'relativeDataSource.alias'] },
@@ -13798,7 +13817,7 @@ const shapedAs = (entry, options, properties) => {
     return jsonShapedObject(wireEntryShape(entry, options), Object.fromEntries(Object.entries(properties).filter(([k]) => !left.includes(k))), `wire ${entry}`);
 };
 function wireContentTypeJsonSchema(options = {}) {
-    const value = shaped(PlanWireEntry.SeedValue, { field: jsonText(), value: jsonAnyOf([jsonText(), jsonListOf(jsonText())]) });
+    const value = shaped(PlanWireEntry.SeedValue, { field: jsonText(), value: jsonAnyOf([jsonText(), jsonListOf(jsonText())]), each: jsonListOf(jsonText()) });
     return shapedAs(PlanWireEntry.ContentType, options, {
         name: jsonText(),
         label: jsonText(),
@@ -13910,8 +13929,18 @@ function expandWireContentType(wire, options = {}) {
     const { values, ...fixed } = seed;
     if (fixed['count'] === 0 && emptyList(values))
         return out;
-    const map = listToMap(values ?? [], 'field', 'value');
-    return { ...out, seed: isPlainObject(map) ? { ...fixed, ...map } : { ...fixed, values } };
+    const perItem = {};
+    const plain = Array.isArray(values) ? values.map(row => {
+        if (!isPlainObject(row))
+            return row;
+        const { each, ...rest } = row;
+        if (Array.isArray(each) && each.length)
+            perItem[String(rest['field'])] = each;
+        return rest;
+    }) : values;
+    const map = listToMap(plain ?? [], 'field', 'value');
+    const items = Object.keys(perItem).length ? { perItem } : {};
+    return { ...out, seed: isPlainObject(map) ? { ...fixed, ...items, ...map } : { ...fixed, values } };
 }
 function expandWireDataSource(wire) {
     if (!isPlainObject(wire))
@@ -13994,10 +14023,10 @@ function fieldToWire(field) {
 function contentTypeToWire(type, options = {}) {
     const played = type.roles;
     const roles = ROLE_KEYS.filter(role => played[role]).map(role => ({ role, field: played[role] }));
-    const { count = 0, sample = false, isPublished = false, ...values } = type.seed ?? {};
+    const { count = 0, sample = false, isPublished = false, perItem = {}, ...values } = type.seed ?? {};
     return {
         name: type.name, label: type.label, roles, ...(options.children === false ? {} : { fields: type.fields.map(fieldToWire) }),
-        seed: { count, sample, isPublished, values: mapToList(values, 'field', 'value') },
+        seed: { count, sample, isPublished, values: mapToList(values, 'field', 'value').map(row => ({ ...row, each: perItem[String(row['field'])] ?? [] })) },
     };
 }
 function dataSourceToWire(source) {
@@ -14949,7 +14978,10 @@ function writtenTexts(plan) {
     });
     plan.contentTypes?.forEach((type, t) => {
         add(`contentTypes[${t}].label`, type.label);
-        for (const [field, value] of Object.entries(type.seed ?? {})) {
+        const { perItem, ...seed } = type.seed ?? {};
+        for (const [field, list] of Object.entries(perItem ?? {}))
+            list.forEach((v, k) => add(`contentTypes[${t}].seed.perItem.${field}[${k}]`, v));
+        for (const [field, value] of Object.entries(seed)) {
             const values = Array.isArray(value) ? value : [value];
             values.forEach((v, k) => add(`contentTypes[${t}].seed.${field}${Array.isArray(value) ? `[${k}]` : ''}`, v));
         }