octane 0.1.37 → 0.1.38

package/dist/cjs/form-diagnostics.cjs

@@ -0,0 +1,120 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var form_diagnostics_exports = {};
+__export(form_diagnostics_exports, {
+  formAuthoringDiagnostics: () => formAuthoringDiagnostics
+});
+module.exports = __toCommonJS(form_diagnostics_exports);
+function formAuthoringDiagnostics(tag, props, children) {
+  const diagnostics = [];
+  if (tag === "input" || tag === "textarea" || tag === "select") {
+    if (props.value !== void 0 && props.defaultValue !== void 0) {
+      diagnostics.push({
+        kind: "value-default",
+        message: `A <${tag}> has both \`value\` and \`defaultValue\` props. A form field must be either controlled or uncontrolled; remove one of these props.`
+      });
+    }
+    if (tag === "input" && props.checked !== void 0 && props.defaultChecked !== void 0) {
+      diagnostics.push({
+        kind: "checked-default",
+        message: "A <input> has both `checked` and `defaultChecked` props. A form field must be either controlled or uncontrolled; remove one of these props."
+      });
+    }
+  }
+  if (tag === "textarea" && children != null && props.value == null) {
+    diagnostics.push({
+      kind: "textarea-children",
+      message: "Use `defaultValue` or `value` instead of children on <textarea>."
+    });
+  }
+  if (tag === "option") {
+    if (props.selected != null) {
+      diagnostics.push({
+        kind: "option-selected",
+        message: "Use `value` or `defaultValue` on <select> instead of `selected` on <option>."
+      });
+    }
+    if (props.value == null && children !== void 0 && typeof children === "object" && children !== null) {
+      diagnostics.push({
+        kind: "option-children",
+        message: "Cannot infer an <option> value from complex children. Pass an explicit `value` prop or use plain text children."
+      });
+    }
+  }
+  const action = tag === "form" ? props.action : props.formAction ?? props.formaction;
+  if (action == null) return diagnostics;
+  if (tag === "input") {
+    if (props.type !== "submit" && props.type !== "image") {
+      diagnostics.push({
+        kind: "action-type",
+        message: 'A <input> can only specify `formAction` with type="submit" or type="image".'
+      });
+      return diagnostics;
+    }
+  } else if (tag === "button") {
+    if (props.type != null && props.type !== "submit") {
+      diagnostics.push({
+        kind: "action-type",
+        message: 'A <button> can only specify `formAction` with type="submit" or no type.'
+      });
+      return diagnostics;
+    }
+  } else if (tag !== "form") {
+    return diagnostics;
+  }
+  if (typeof action !== "function") return diagnostics;
+  if (tag === "form") {
+    if (props.method != null || props.encType != null || props.enctype != null) {
+      diagnostics.push({
+        kind: "action-method",
+        message: "A function form action cannot specify `method` or `encType`; Octane controls the submission transport."
+      });
+    }
+    if (props.target != null) {
+      diagnostics.push({
+        kind: "action-target",
+        message: "A function form action cannot specify `target`; the action always executes in the current window."
+      });
+    }
+    return diagnostics;
+  }
+  if (props.name != null) {
+    diagnostics.push({
+      kind: "action-name",
+      message: "A function `formAction` cannot specify `name`; the submitter identity is controlled by the action."
+    });
+  }
+  if (props.formMethod != null || props.formmethod != null || props.formEncType != null || props.formenctype != null) {
+    diagnostics.push({
+      kind: "action-method",
+      message: "A function `formAction` cannot specify `formMethod` or `formEncType`; Octane controls the submission transport."
+    });
+  }
+  if (props.formTarget != null || props.formtarget != null) {
+    diagnostics.push({
+      kind: "action-target",
+      message: "A function `formAction` cannot specify `formTarget`; the action always executes in the current window."
+    });
+  }
+  return diagnostics;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formAuthoringDiagnostics
+});

package/dist/cjs/host-property-diagnostics.cjs

@@ -0,0 +1,197 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var host_property_diagnostics_exports = {};
+__export(host_property_diagnostics_exports, {
+  booleanAttributeStringWarning: () => booleanAttributeStringWarning,
+  emptyResourceUrlWarning: () => emptyResourceUrlWarning,
+  hostPropertyWarning: () => hostPropertyWarning,
+  invalidHostPropertiesWarning: () => invalidHostPropertiesWarning,
+  unsupportedAttributeCoercionWarning: () => unsupportedAttributeCoercionWarning
+});
+module.exports = __toCommonJS(host_property_diagnostics_exports);
+var import_constants = require("./constants.cjs");
+const KNOWN_CAMELCASE_PROPERTIES = /* @__PURE__ */ new Set([
+  "autoCapitalize",
+  "autoComplete",
+  "autoCorrect",
+  "autoFocus",
+  "autoPlay",
+  "allowFullScreen",
+  "charSet",
+  "className",
+  "contentEditable",
+  "dangerouslySetInnerHTML",
+  "defaultChecked",
+  "defaultValue",
+  "disablePictureInPicture",
+  "disableRemotePlayback",
+  "encType",
+  "fetchPriority",
+  "formAction",
+  "formEncType",
+  "formMethod",
+  "formNoValidate",
+  "formTarget",
+  "imageSizes",
+  "imageSrcSet",
+  "inputMode",
+  "itemID",
+  "itemProp",
+  "itemRef",
+  "itemScope",
+  "itemType",
+  "maxLength",
+  "noModule",
+  "noValidate",
+  "playsInline",
+  "readOnly",
+  "referrerPolicy",
+  "spellCheck",
+  "srcDoc",
+  "srcLang",
+  "srcSet",
+  "suppressContentEditableWarning",
+  "suppressHydrationWarning",
+  "suppressNativeChangeWarning",
+  "tabIndex",
+  "viewBox"
+]);
+const KNOWN_PROPERTY_SPELLINGS = /* @__PURE__ */ new Map();
+for (const name of KNOWN_CAMELCASE_PROPERTIES)
+  KNOWN_PROPERTY_SPELLINGS.set(name.toLowerCase(), name);
+for (const [name, alias] of import_constants.ATTRIBUTE_ALIASES) {
+  KNOWN_PROPERTY_SPELLINGS.set(name.toLowerCase(), name);
+  KNOWN_PROPERTY_SPELLINGS.set(alias.toLowerCase(), name);
+}
+const KNOWN_SVG_PROPERTY_SPELLINGS = /* @__PURE__ */ new Map();
+for (const name of [
+  "allowReorder",
+  "attributeName",
+  "attributeType",
+  "autoReverse",
+  "baseFrequency",
+  "baseProfile",
+  "calcMode",
+  "clipPathUnits",
+  "contentScriptType",
+  "contentStyleType",
+  "diffuseConstant",
+  "edgeMode",
+  "externalResourcesRequired",
+  "filterRes",
+  "filterUnits",
+  "glyphRef",
+  "gradientTransform",
+  "gradientUnits",
+  "kernelMatrix",
+  "kernelUnitLength",
+  "keyPoints",
+  "keySplines",
+  "keyTimes",
+  "lengthAdjust",
+  "limitingConeAngle",
+  "markerHeight",
+  "markerUnits",
+  "markerWidth",
+  "maskContentUnits",
+  "maskUnits",
+  "numOctaves",
+  "pathLength",
+  "patternContentUnits",
+  "patternTransform",
+  "patternUnits",
+  "pointsAtX",
+  "pointsAtY",
+  "pointsAtZ",
+  "preserveAlpha",
+  "preserveAspectRatio",
+  "primitiveUnits",
+  "refX",
+  "refY",
+  "repeatCount",
+  "repeatDur",
+  "requiredExtensions",
+  "requiredFeatures",
+  "specularConstant",
+  "specularExponent",
+  "spreadMethod",
+  "startOffset",
+  "stdDeviation",
+  "stitchTiles",
+  "surfaceScale",
+  "systemLanguage",
+  "tableValues",
+  "targetX",
+  "targetY",
+  "textLength",
+  "viewTarget",
+  "xChannelSelector",
+  "yChannelSelector",
+  "zoomAndPan"
+]) {
+  KNOWN_SVG_PROPERTY_SPELLINGS.set(name.toLowerCase(), name);
+}
+function hostPropertyWarning(name, value, tag, isSvg = false) {
+  const lower = name.toLowerCase();
+  if (name === "for" && tag === "label") return null;
+  if (lower === "innerhtml") {
+    return "Directly setting property `innerHTML` is not permitted. Use `dangerouslySetInnerHTML={{ __html: value }}` instead.";
+  }
+  if (lower === "is" && value != null && typeof value !== "string") {
+    return `Received a \`${typeof value}\` for a string attribute \`is\`. If this is expected, cast the value to a string.`;
+  }
+  if (name.length > 2 && name[0] === "o" && name[1] === "n" && typeof value === "string") {
+    return `Unknown event handler property \`${name}\`. It will be ignored.`;
+  }
+  if (name.startsWith("aria-") || /^aria[A-Z]/.test(name) || name.startsWith("data-")) return null;
+  const known = KNOWN_PROPERTY_SPELLINGS.get(lower) ?? (isSvg ? KNOWN_SVG_PROPERTY_SPELLINGS.get(lower) : void 0);
+  if (known !== void 0) {
+    if (isSvg && import_constants.ATTRIBUTE_ALIASES.get(known) === name) return null;
+    return name !== known ? `Invalid DOM property \`${name}\`. Did you mean \`${known}\`?` : null;
+  }
+  if (name !== lower && !name.includes(":")) {
+    return `Octane does not recognize the \`${name}\` prop on a DOM element. If you intentionally want it to appear in the DOM as a custom attribute, spell it as lowercase \`${lower}\` instead. If you accidentally passed it from a parent component, remove it from the DOM element.`;
+  }
+  return null;
+}
+function booleanAttributeStringWarning(name, value) {
+  if (value !== "false" && value !== "true" || !import_constants.BOOLEAN_ATTR_PROPS.has(name.toLowerCase())) {
+    return null;
+  }
+  return `Received the string \`${value}\` for the boolean attribute \`${name}\`. ` + (value === "false" ? "The browser will interpret it as a truthy value. " : 'Although this works, it will not work as expected if you pass the string "false". ') + `Did you mean ${name}={${value}}?`;
+}
+function invalidHostPropertiesWarning(names, tag) {
+  const quoted = names.map((name) => `\`${name}\``).join(", ");
+  return names.length === 1 ? `Invalid value for prop ${quoted} on <${tag}> tag. Either remove it from the element, or pass a string or number value to keep it in the DOM.` : `Invalid values for props ${quoted} on <${tag}> tag. Either remove them from the element, or pass a string or number value to keep them in the DOM.`;
+}
+function emptyResourceUrlWarning(name) {
+  return `An empty string was passed to the \`${name}\` attribute. This may cause the browser to download the whole page again. Pass null instead of an empty string.`;
+}
+function unsupportedAttributeCoercionWarning(name, value) {
+  const type = typeof value === "symbol" ? "Symbol" : value.constructor?.name || typeof value;
+  return `The provided \`${name}\` attribute is an unsupported type ${type}. Coerce it to a string before passing it to a DOM element.`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  booleanAttributeStringWarning,
+  emptyResourceUrlWarning,
+  hostPropertyWarning,
+  invalidHostPropertiesWarning,
+  unsupportedAttributeCoercionWarning
+});

package/dist/cjs/html-tree-validation.cjs

@@ -19,11 +19,35 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var html_tree_validation_exports = {};
 __export(html_tree_validation_exports, {
   invalidHtmlNestingWithAncestor: () => invalidHtmlNestingWithAncestor,
-  invalidHtmlNestingWithParent: () => invalidHtmlNestingWithParent
+  invalidHtmlNestingWithParent: () => invalidHtmlNestingWithParent,
+  invalidHtmlTextNesting: () => invalidHtmlTextNesting
 });
 module.exports = __toCommonJS(html_tree_validation_exports);
 const autoclosingChildren = {
-  li: { direct: ["li"] },
+  li: {
+    descendant: ["li"],
+    resetBy: [
+      "article",
+      "aside",
+      "blockquote",
+      "details",
+      "dl",
+      "fieldset",
+      "figcaption",
+      "figure",
+      "footer",
+      "form",
+      "header",
+      "main",
+      "menu",
+      "nav",
+      "object",
+      "ol",
+      "section",
+      "table",
+      "ul"
+    ]
+  },
   dt: { descendant: ["dt", "dd"], resetBy: ["dl"] },
   dd: { descendant: ["dt", "dd"], resetBy: ["dl"] },
   p: {
@@ -55,7 +79,8 @@ const autoclosingChildren = {
       "section",
       "table",
       "ul"
-    ]
+    ],
+    resetBy: ["button", "object", "table", "td", "th", "template"]
   },
   rt: { descendant: ["rt", "rp"] },
   rp: { descendant: ["rt", "rp"] },
@@ -71,8 +96,8 @@ const autoclosingChildren = {
 const disallowedChildren = {
   ...autoclosingChildren,
   form: { descendant: ["form"] },
-  a: { descendant: ["a"] },
-  button: { descendant: ["button"] },
+  a: { descendant: ["a"], resetBy: ["object", "table", "td", "th", "template"] },
+  button: { descendant: ["button"], resetBy: ["object", "table", "td", "th", "template"] },
   h1: { descendant: ["h1", "h2", "h3", "h4", "h5", "h6"] },
   h2: { descendant: ["h1", "h2", "h3", "h4", "h5", "h6"] },
   h3: { descendant: ["h1", "h2", "h3", "h4", "h5", "h6"] },
@@ -80,6 +105,9 @@ const disallowedChildren = {
   h5: { descendant: ["h1", "h2", "h3", "h4", "h5", "h6"] },
   h6: { descendant: ["h1", "h2", "h3", "h4", "h5", "h6"] },
   tr: { only: ["th", "td", "style", "script", "template"] },
+  select: { only: ["hr", "option", "optgroup", "script", "template"] },
+  optgroup: { only: ["option"] },
+  option: { only: [] },
   tbody: { only: ["tr", "style", "script", "template"] },
   thead: { only: ["tr", "style", "script", "template"] },
   tfoot: { only: ["tr", "style", "script", "template"] },
@@ -141,7 +169,14 @@ function invalidHtmlNestingWithParent(childTag, parentTag, childLocation, parent
     }
     if ("only" in disallowed && !disallowed.only.includes(childTag)) {
       const allowed = disallowed.only.map((tag) => `\`<${tag}>\``).join(", ");
-      return `${child} cannot be a child of ${parent}. \`<${parentTag}>\` only allows these children: ${allowed}`;
+      let message = `${child} cannot be a child of ${parent}`;
+      if (allowed !== "") {
+        message += `. \`<${parentTag}>\` only allows these children: ${allowed}`;
+      }
+      if (parentTag === "table" && childTag === "tr") {
+        message += ". Add a `<tbody>`, `<thead>`, or `<tfoot>` to match the DOM tree generated by the browser";
+      }
+      return message;
     }
     if ("only" in disallowed) return null;
   }
@@ -168,8 +203,17 @@ function invalidHtmlNestingWithParent(childTag, parentTag, childLocation, parent
       return null;
   }
 }
+function invalidHtmlTextNesting(text, parentTag, parentLocation) {
+  if (text === "") return null;
+  if (parentTag !== "table" && parentTag !== "tbody" && parentTag !== "thead" && parentTag !== "tfoot" && parentTag !== "tr" && parentTag !== "colgroup" && parentTag !== "head" && parentTag !== "html") {
+    return null;
+  }
+  const whitespace = !/\S/.test(text);
+  return (whitespace ? "whitespace text nodes" : "text nodes") + " cannot be a child of " + elementLabel(parentTag, parentLocation) + (whitespace ? ". Make sure you do not have any extra whitespace between tags" : "");
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   invalidHtmlNestingWithAncestor,
-  invalidHtmlNestingWithParent
+  invalidHtmlNestingWithParent,
+  invalidHtmlTextNesting
 });

package/dist/cjs/index.cjs

@@ -87,6 +87,7 @@ __export(index_exports, {
   delegateEvents: () => import_runtime.delegateEvents,
   descriptorChildren: () => import_runtime.descriptorChildren,
   devEventListener: () => import_runtime.devEventListener,
+  devHtmlNesting: () => import_runtime.devHtmlNesting,
   drainFrag: () => import_runtime.drainFrag,
   drainPassiveEffects: () => import_runtime.drainPassiveEffects,
   errorBlock: () => import_runtime.errorBlock,
@@ -145,6 +146,7 @@ __export(index_exports, {
   puTake2: () => import_runtime.puTake2,
   puTake3: () => import_runtime.puTake3,
   puTake4: () => import_runtime.puTake4,
+  queueFormAuthoringDiagnostic: () => import_runtime.queueFormAuthoringDiagnostic,
   queueNativeChangeDiagnostic: () => import_runtime.queueNativeChangeDiagnostic,
   queueOwnRefDetach: () => import_runtime.queueOwnRefDetach,
   queueRefAttach: () => import_runtime.queueRefAttach,
@@ -300,6 +302,7 @@ var import_method_dep = require("./method-dep.cjs");
   delegateEvents,
   descriptorChildren,
   devEventListener,
+  devHtmlNesting,
   drainFrag,
   drainPassiveEffects,
   errorBlock,
@@ -358,6 +361,7 @@ var import_method_dep = require("./method-dep.cjs");
   puTake2,
   puTake3,
   puTake4,
+  queueFormAuthoringDiagnostic,
   queueNativeChangeDiagnostic,
   queueOwnRefDetach,
   queueRefAttach,

package/dist/cjs/resource-hint-diagnostics.cjs

@@ -0,0 +1,91 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var resource_hint_diagnostics_exports = {};
+__export(resource_hint_diagnostics_exports, {
+  resourceHintWarning: () => resourceHintWarning
+});
+module.exports = __toCommonJS(resource_hint_diagnostics_exports);
+function describeHintValue(value) {
+  if (value === null) return "`null`";
+  if (value === void 0) return "`undefined`";
+  if (value === "") return "an empty string";
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number") return "`" + value + "`";
+  return 'a value of type "' + typeof value + '"';
+}
+function resourceHintWarning(name, href, options, hasOptions = false) {
+  const invalidHref = typeof href !== "string" || href === "";
+  const invalidOptions = options === null || typeof options !== "object";
+  if (name === "preload") {
+    let encountered = "";
+    if (invalidHref) encountered += " The `href` argument was " + describeHintValue(href) + ".";
+    if (invalidOptions) {
+      encountered += " The `options` argument was " + describeHintValue(options) + ".";
+    } else {
+      const destination = options.as;
+      if (typeof destination !== "string" || destination === "") {
+        encountered += " The `as` option was " + describeHintValue(destination) + ".";
+      }
+    }
+    return encountered === "" ? null : "preload(): Expected a non-empty `href` string and an `options` object with a valid `as` destination." + encountered;
+  }
+  if (name === "preloadModule" || name === "preinitModule") {
+    let encountered = "";
+    if (invalidHref) encountered += " The `href` argument was " + describeHintValue(href) + ".";
+    if (options != null && invalidOptions) {
+      encountered += " The `options` argument was " + describeHintValue(options) + ".";
+    } else if (options !== null && typeof options === "object" && "as" in options) {
+      const destination = options.as;
+      if (name === "preloadModule" && typeof destination !== "string" || name === "preinitModule" && destination !== "script") {
+        encountered += " The `as` option was " + describeHintValue(destination) + ".";
+      }
+    }
+    if (encountered === "") return null;
+    return name + "(): Expected a non-empty `href` string and optional object-shaped `options`" + (name === "preinitModule" ? ' with `as: "script"`.' : " with a string `as` destination.") + encountered;
+  }
+  if (invalidHref) {
+    return name + "(): Expected a non-empty string `href`; received " + describeHintValue(href) + ".";
+  }
+  if (name === "preinit") {
+    if (invalidOptions) {
+      return 'preinit(): Expected the `options` argument to be an object with `as: "style"` or `as: "script"`; received ' + describeHintValue(options) + ".";
+    }
+    const destination = options.as;
+    return destination === "style" || destination === "script" ? null : 'preinit(): The `as` option must be "style" or "script"; received ' + describeHintValue(destination) + ". Use preload() for other resource destinations.";
+  }
+  if (name === "preconnect") {
+    if (options != null && typeof options !== "object") {
+      return "preconnect(): Expected the optional `options` argument to be an object; received " + describeHintValue(options) + ".";
+    }
+    if (options !== null && typeof options === "object") {
+      const crossOrigin2 = options.crossOrigin;
+      if (typeof crossOrigin2 !== "string") {
+        return "preconnect(): The `crossOrigin` option must be a string; received " + describeHintValue(crossOrigin2) + ". Remove the option or provide a string value.";
+      }
+    }
+    return null;
+  }
+  if (!hasOptions) return null;
+  const crossOrigin = options !== null && typeof options === "object" && "crossOrigin" in options ? " Browsers never use `crossOrigin` for DNS queries." : "";
+  return "prefetchDNS(): Expected only one `href` argument; the second `options` argument is unsupported." + crossOrigin;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  resourceHintWarning
+});