@saastro/studio 0.3.3 → 0.4.0

package/dist/{chunk-M5BCEVWK.js → chunk-5EXFBVC2.js}

@@ -3,7 +3,7 @@ import {
   injectVersionMetaTag,
   injectVisibilityStyle,
   readVisibilityConfigSync
-} from "./chunk-NICLSTZK.js";
+} from "./chunk-IPVMSMB4.js";
 
 // src/vite/index.ts
 import { promises as fs } from "node:fs";
@@ -607,7 +607,7 @@ function injectSchema(source, schema, options = {}) {
 
 // src/vite/instrument-fields.ts
 var FRONTMATTER_RE4 = /^\s*---\s*\n[\s\S]*?\n---\s*\n/;
-function instrumentFields(source, schema, _options = {}) {
+function instrumentFields(source, schema, options = {}) {
   if (!schema.fields.length) return source;
   if (!source.includes("data-saastro=")) return source;
   const fmMatch = FRONTMATTER_RE4.exec(source);
@@ -626,19 +626,28 @@ function instrumentFields(source, schema, _options = {}) {
     head = template;
     tail = "";
   }
-  const transformed = transformTemplate(head, schema.fields);
+  const transformed = transformTemplate(
+    head,
+    schema.fields,
+    options.componentPath,
+    source
+  );
   return source.slice(0, templateStart) + transformed + tail;
 }
-function instrumentJsxFields(source, schema, _options = {}) {
+function instrumentJsxFields(source, schema, options = {}) {
   if (!schema.fields.length) return source;
   if (!/<[A-Za-z]/.test(source)) return source;
-  return transformTemplate(source, schema.fields);
+  return transformTemplate(source, schema.fields, options.componentPath, source);
 }
-function transformTemplate(template, fields) {
+function transformTemplate(template, fields, componentPath, source = template) {
   let out = template;
   for (const field of fields) {
     if (field.kind !== "array") continue;
-    out = transformArrayField(out, field);
+    const res = transformArrayField(out, field);
+    out = res.out;
+    if (!res.matched && hasMapReference(source, field.name) && !hasHandWrittenFieldMarker(template, field.name)) {
+      warnUninstrumentedArray(componentPath, field.name);
+    }
   }
   for (const field of fields) {
     if (field.kind === "array") continue;
@@ -646,6 +655,21 @@ function transformTemplate(template, fields) {
   }
   return out;
 }
+function hasHandWrittenFieldMarker(template, name) {
+  const n = escapeReg(name);
+  return new RegExp(
+    "data-saastro(?:-field)?\\s*=\\s*\\{\\s*`[^`]*\\b" + n + "[[.]"
+  ).test(template);
+}
+function warnUninstrumentedArray(componentPath, name) {
+  const where = componentPath ? ` in ${componentPath}` : "";
+  console.warn(
+    `[saastro/studio] array prop "${name}"${where} was not auto-instrumented: no \`${name}.map(...)\` found in the template (it may be iterated via a derived variable, a chained method, or a destructured param). Its items won't be editable in the Studio until you hand-write data-saastro-field markers \u2014 e.g. <img src={item.image} data-saastro-field={\`${name}[\${i}].image\`} />.`
+  );
+}
+function hasMapReference(source, name) {
+  return new RegExp("\\b" + escapeReg(name) + "\\s*\\.\\s*map\\s*\\(").test(source);
+}
 function transformArrayField(template, field) {
   const name = field.name;
   const subFields = field.items?.fields ?? [];
@@ -655,8 +679,10 @@ function transformArrayField(template, field) {
   );
   let result = "";
   let cursor = 0;
+  let matchCount = 0;
   let m;
   while ((m = re.exec(template)) !== null) {
+    matchCount++;
     const headerStart = m.index;
     const paramName = m[1];
     const existingIdx = m[2] ?? null;
@@ -683,7 +709,7 @@ function transformArrayField(template, field) {
     re.lastIndex = cursor;
   }
   result += template.slice(cursor);
-  return result;
+  return { out: result, matched: matchCount > 0 };
 }
 function readArrowBody(template, start) {
   let i = start;
@@ -1258,4 +1284,4 @@ async function loadTsx(path) {
 export {
   studioAutoWrap
 };
-//# sourceMappingURL=chunk-M5BCEVWK.js.map
+//# sourceMappingURL=chunk-5EXFBVC2.js.map