@webmaster-droid/web 0.3.1 → 0.3.2

package/dist/index.d.ts

@@ -23,6 +23,7 @@ type EditableMetaInput = {
     kind: SelectedElementKind;
     relatedPaths?: string[];
     preview?: string;
+    componentName?: string;
 };
 declare function editableMeta(input: EditableMetaInput): Record<string, string>;
 declare function parseSelectedEditableFromTarget(target: EventTarget | null, pagePath: string): SelectedElementContext | null;

package/dist/index.js

@@ -12,6 +12,7 @@ var EDITABLE_ROOTS = ["pages.", "layout.", "seo.", "themeTokens."];
 var MAX_PATH_LENGTH = 320;
 var MAX_LABEL_LENGTH = 120;
 var MAX_PREVIEW_LENGTH = 140;
+var warnedInvalidPaths = /* @__PURE__ */ new Set();
 var RICH_TEXT_ALLOWED_TAGS = [
   "a",
   "b",
@@ -92,6 +93,26 @@ function normalizeEditablePath(value) {
   }
   return trimmed;
 }
+function warnInvalidEditablePath(componentName, propName, value) {
+  if (process.env.NODE_ENV === "production") {
+    return;
+  }
+  const rawValue = typeof value === "string" ? value : (() => {
+    try {
+      return JSON.stringify(value);
+    } catch {
+      return String(value);
+    }
+  })();
+  const key = `${componentName}:${propName}:${rawValue}`;
+  if (warnedInvalidPaths.has(key)) {
+    return;
+  }
+  warnedInvalidPaths.add(key);
+  console.warn(
+    `[webmaster-droid] ${componentName} received ${propName}="${rawValue}", but editable paths must start with one of: ${EDITABLE_ROOTS.join(", ")}. This field will stay fallback-only and will be skipped by \`webmaster-droid seed\`.`
+  );
+}
 function normalizeShortText(value, maxLength) {
   if (typeof value !== "string") {
     return null;
@@ -111,7 +132,7 @@ function normalizeKind(value) {
   }
   return null;
 }
-function normalizeRelatedPaths(value) {
+function normalizeRelatedPaths(value, componentName) {
   if (!Array.isArray(value)) {
     return [];
   }
@@ -120,6 +141,10 @@ function normalizeRelatedPaths(value) {
     const normalized = normalizeEditablePath(item);
     if (normalized) {
       out.add(normalized);
+      continue;
+    }
+    if (componentName) {
+      warnInvalidEditablePath(componentName, "relatedPaths", item);
     }
   }
   return Array.from(out);
@@ -139,6 +164,9 @@ function editableMeta(input) {
   const path = normalizeEditablePath(input.path);
   const label = normalizeShortText(input.label, MAX_LABEL_LENGTH);
   const kind = normalizeKind(input.kind);
+  if (!path && input.componentName) {
+    warnInvalidEditablePath(input.componentName, "path", input.path);
+  }
   if (!path || !label || !kind) {
     return {};
   }
@@ -147,7 +175,7 @@ function editableMeta(input) {
     "data-wmd-label": label,
     "data-wmd-kind": kind
   };
-  const relatedPaths = normalizeRelatedPaths(input.relatedPaths ?? []);
+  const relatedPaths = normalizeRelatedPaths(input.relatedPaths ?? [], input.componentName);
   if (relatedPaths.length > 0) {
     attrs["data-wmd-related-paths"] = JSON.stringify(relatedPaths);
   }
@@ -232,8 +260,16 @@ function EditableText({
   ...rest
 }) {
   const { document: document2, enabled } = useEditableDocument();
-  const value = pickStringValue(document2, path, fallback, "EditableText", "fallback", "empty");
+  const value = pickStringValue(
+    document2,
+    path,
+    fallback,
+    "EditableText",
+    "fallback",
+    "empty"
+  );
   const attrs = enabled ? editableMeta({
+    componentName: "EditableText",
     path,
     label: label ?? path,
     kind: "text",
@@ -260,6 +296,7 @@ function EditableRichText({
   );
   const sanitizedHtml = sanitizeRichTextHtml(value);
   const attrs = enabled ? editableMeta({
+    componentName: "EditableRichText",
     path,
     label: label ?? path,
     kind: "section",
@@ -297,6 +334,7 @@ function EditableImage({
     "empty"
   ) : fallbackAlt ?? "";
   const attrs = enabled ? editableMeta({
+    componentName: "EditableImage",
     path,
     label: label ?? path,
     kind: "image",
@@ -331,6 +369,7 @@ function EditableLink({
     "empty"
   );
   const attrs = enabled ? editableMeta({
+    componentName: "EditableLink",
     path: labelPath,
     label: label ?? labelPath,
     kind: "link",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webmaster-droid/web",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",