siteplane 0.1.48 → 0.1.49

package/README.md

@@ -43,6 +43,10 @@ For a direct field ID, put `siteplane.attrs(fieldId, { routeKey })` on the visib
 element using the same canonical route pattern as its value call. The value call
 does not attach DOM metadata. Missing or mismatched DOM routes block apply and
 the Next build; dynamic pages use their pattern, such as `/services/[slug]`.
+Direct attrs defaults to `fieldType: "text"`; for longText, link and image,
+pass the matching `fieldType` explicitly. The value call does not infer it for attrs.
+`setup apply` reports `field_scan.attrs_field_type_mismatch` before any contract write.
+This type diagnostic remains a scanner warning for normal website builds.
 
 ```bash
 siteplane setup apply --definition editor-definition.json --selection-summary-file selection.txt

package/dist/bin/siteplane.js

@@ -4337,6 +4337,14 @@ function scanSourceFacts(files) {
   }
   for (const attr of directAttrs) {
     const field = fields.find((candidate) => candidate.fieldId === attr.fieldId);
+    if (field && attr.fieldType !== field.fieldType) {
+      warnings.push({
+        code: "field_scan.attrs_field_type_mismatch",
+        message: `DOM attrs for ${attr.fieldId} declare ${attr.fieldType}, but its value call returns ${field.fieldType}. Pass fieldType: "${field.fieldType}" with the matching routeKey to siteplane.attrs on the visible element. This affects editor preview, not the website build.`,
+        fieldId: attr.fieldId,
+        filePath: attr.filePath
+      });
+    }
     const expectedRoute = field?.technicalRouteKey ?? field?.routeHint;
     if (!attr.routeKey || expectedRoute && attr.routeKey !== expectedRoute) {
       hardErrors.push({
@@ -4618,6 +4626,7 @@ function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs,
     directAttrs.push({
       fieldId: directFieldId,
       routeKey: secondArg && typeof secondArg === "object" && "routeKey" in secondArg ? stringValue2(secondArg.routeKey) : void 0,
+      fieldType: secondArg && typeof secondArg === "object" && "fieldType" in secondArg ? stringValue2(secondArg.fieldType) ?? "text" : "text",
       filePath: file.filePath
     });
     if (hasEventPreviewStrategy(secondArg)) {
@@ -4979,6 +4988,14 @@ async function siteSetupApplyCommand(input) {
     sourceText: await readSourceFile(filePath)
   })));
   const scan = scanSourceFiles(files, { projectRoot: input.projectDir });
+  const invalidDomTypes = scan.warnings.filter((issue) => issue.code === "field_scan.attrs_field_type_mismatch");
+  if (invalidDomTypes.length > 0) {
+    return {
+      status: "action_required",
+      code: "field_scan.attrs_field_type_mismatch",
+      message: invalidDomTypes.map((issue) => issue.message).join("\n")
+    };
+  }
   if (scan.hardErrors.length > 0) {
     return {
       status: "action_required",

package/dist/next.js

@@ -3082,6 +3082,14 @@ function scanSourceFacts(files) {
   }
   for (const attr of directAttrs) {
     const field = fields.find((candidate) => candidate.fieldId === attr.fieldId);
+    if (field && attr.fieldType !== field.fieldType) {
+      warnings.push({
+        code: "field_scan.attrs_field_type_mismatch",
+        message: `DOM attrs for ${attr.fieldId} declare ${attr.fieldType}, but its value call returns ${field.fieldType}. Pass fieldType: "${field.fieldType}" with the matching routeKey to siteplane.attrs on the visible element. This affects editor preview, not the website build.`,
+        fieldId: attr.fieldId,
+        filePath: attr.filePath
+      });
+    }
     const expectedRoute = field?.technicalRouteKey ?? field?.routeHint;
     if (!attr.routeKey || expectedRoute && attr.routeKey !== expectedRoute) {
       hardErrors.push({
@@ -3363,6 +3371,7 @@ function collectAttrsCall(node, attrFieldIds, attrRouteRefs, eventPreviewAttrs,
     directAttrs.push({
       fieldId: directFieldId,
       routeKey: secondArg && typeof secondArg === "object" && "routeKey" in secondArg ? stringValue(secondArg.routeKey) : void 0,
+      fieldType: secondArg && typeof secondArg === "object" && "fieldType" in secondArg ? stringValue(secondArg.fieldType) ?? "text" : "text",
       filePath: file.filePath
     });
     if (hasEventPreviewStrategy(secondArg)) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "siteplane",
   "private": false,
-  "version": "0.1.48",
+  "version": "0.1.49",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
   "publishConfig": {