@activecollab/components 2.0.414 → 2.0.416

package/dist/index.js

@@ -25321,16 +25321,204 @@
   })(["margin:0;border:none;border-top:1px solid var(--border-primary);"]);
   StyledDivider.displayName = "StyledDivider";
 
-  /** The default `list` block; rendered as ul or ol through the `as` prop. */
+  /**
+   * The default `list` block; rendered as ul or ol through the `as` prop, and
+   * tagged `data-portable-list` so the depth rules below scope to design-system
+   * lists — a stray `<ul>`/`<ol>` from an injected renderer is left untouched.
+   *
+   * Nesting works structurally: each level is its own StyledList inside a parent
+   * `<li>`, so it re-applies its own `padding-left` (indentation compounds) and,
+   * for ordered levels, restarts numbering. A nested list carries no vertical
+   * margin, so it hugs the item it belongs to.
+   *
+   * Both bullet and numbered levels change their marker by nesting depth, so
+   * levels stay distinct even where the two interleave:
+   *   bullets   disc → circle → square → (disc)
+   *   numbers   decimal → lower-alpha → lower-roman → (upper-alpha)
+   * Depth is counted from the list ancestors themselves (not per-tag), so an
+   * intervening `<ol>` never throws off a `<ul>`'s depth and vice-versa. The
+   * rules are ordered shallow-to-deep; a deeper rule is more specific, so it
+   * wins the cascade for the levels it applies to.
+   */
   var StyledList$1 = styled__default["default"].ul.withConfig({
     displayName: "Styles__StyledList",
     componentId: "sc-1fss4z4-5"
-  })(["margin:0;padding-left:", ";list-style:", " outside;li + li{margin-top:", ";}"], "1.25rem", function (_ref) {
+  })(["margin:0;padding-left:", ";list-style:", " outside;li + li{margin-top:", ";}& ul[data-portable-list]{list-style-type:circle;}& ol[data-portable-list]{list-style-type:lower-alpha;}& [data-portable-list] ul[data-portable-list]{list-style-type:square;}& [data-portable-list] ol[data-portable-list]{list-style-type:lower-roman;}& [data-portable-list] [data-portable-list] ul[data-portable-list]{list-style-type:disc;}& [data-portable-list] [data-portable-list] ol[data-portable-list]{list-style-type:upper-alpha;}"], "1.25rem", function (_ref) {
     var $ordered = _ref.$ordered;
     return $ordered ? "decimal" : "disc";
   }, SPACE.xs);
   StyledList$1.displayName = "StyledList";
 
+  /**
+   * Portable Text envelope — the general content contract for structured,
+   * renderer-independent content (in-app messages, help, changelogs).
+   *
+   * The design system owns this envelope and the universal default set below.
+   * It never hardcodes a product element: concrete elements (callout,
+   * button-reference, doc-link, …) are defined in the application catalog and
+   * injected into the Portable Text engine through {@link PortableTextComponents}.
+   * See README.md next to this file for the full contract.
+   */
+
+  /* ---- Spans and marks ------------------------------------------------- */
+
+  /**
+   * A mark with data. Parameterless marks travel as plain strings ("strong");
+   * marks that need data travel as objects discriminated by `type`.
+   */
+
+  /** The one default mark that carries data. */
+
+  /** The leaf of every text run: a piece of text plus the marks wrapping it. */
+
+  /** Marks every client understands without injection. */
+  var PORTABLE_TEXT_DEFAULT_MARKS = ["strong", "em", "code", "link"];
+
+  /* ---- Blocks ----------------------------------------------------------- */
+
+  /** 1 maps to Title1, 2 to Title2, 3 to Header2 typography. */
+
+  /**
+   * A list item's children are its own spans first, then any nested `list`
+   * block(s) — the shape that carries multi-level lists. A spans-only item (no
+   * nested list) is the common, flat case and stays valid unchanged.
+   */
+
+  /** Screenshots render framed (border, no shadow); illustrations render flat. */
+
+  /**
+   * Video variants name the hosting service; `src` is the canonical video URL.
+   * Their rendering carries service semantics (URL parsing, embed derivation),
+   * so it belongs to the application catalog — injected as a `media` block
+   * override — never to the default set. The default renderer degrades them.
+   */
+
+  // A Record so the compiler checks the list against the union in both
+  // directions: a missing and a stray key each fail to build.
+  var MEDIA_IMAGE_VARIANTS = {
+    screenshot: true,
+    illustration: true
+  };
+  var isPortableTextMediaImageVariant = function isPortableTextMediaImageVariant(value) {
+    return typeof value === "string" && value in MEDIA_IMAGE_VARIANTS;
+  };
+
+  /** A table cell is a span array, so inline marks work inside cells. */
+
+  /** A themed horizontal rule between sections. Carries no data. */
+
+  /**
+   * Derived from the union's discriminators, so adding a block to the union
+   * without a renderer entry is a compile error, never silent drift.
+   */
+
+  // A Record so the compiler checks the list against the union in both
+  // directions: a missing and a stray key each fail to build.
+  var DEFAULT_BLOCK_TYPES = {
+    paragraph: true,
+    heading: true,
+    list: true,
+    "list-item": true,
+    media: true,
+    "titled-text": true,
+    "code-block": true,
+    table: true,
+    divider: true
+  };
+
+  /** Blocks every client understands without injection. */
+  var PORTABLE_TEXT_DEFAULT_BLOCKS = Object.keys(DEFAULT_BLOCK_TYPES);
+
+  /* ---- Objects ----------------------------------------------------------- */
+
+  /**
+   * An embedded component the envelope does not interpret: `_type` names an
+   * application-catalog element, everything else is that element's data. An
+   * object whose `_type` has no injected renderer renders nothing and is logged.
+   */
+
+  /** The root of a message body: what an API returns under `content`. */
+
+  /* ---- Injection contract ------------------------------------------------ */
+
+  /**
+   * Called once per unknown type instead of rendering it, so content written
+   * for newer clients degrades silently on older ones.
+   */
+
+  /**
+   * What an application injects into the Portable Text engine: renderers for
+   * its catalog marks and objects, optional overrides for the default blocks,
+   * and the unknown-type hook.
+   */
+
+  /* ---- Runtime guards ----------------------------------------------------- */
+
+  var isRecord = function isRecord(value) {
+    return typeof value === "object" && value !== null;
+  };
+  var isPortableTextSpan = function isPortableTextSpan(value) {
+    return isRecord(value) && typeof value.text === "string";
+  };
+  var isPortableTextTableRow = function isPortableTextTableRow(value) {
+    return Array.isArray(value) && value.every(function (cell) {
+      return Array.isArray(cell) && cell.every(isPortableTextSpan);
+    });
+  };
+  var isPortableTextObjectNode = function isPortableTextObjectNode(value) {
+    return isRecord(value) && value.type === "object" && typeof value._type === "string";
+  };
+
+  /**
+   * A block is any non-object node with a string `type`. Unknown block types
+   * stay valid on purpose — they render nothing on clients that predate them.
+   * Known types are held to their shape, so a serializer bug (a paragraph
+   * without `children`, a list of non-nodes) fails here instead of at render.
+   */
+  var _isPortableTextBlock = function isPortableTextBlock(value) {
+    if (!isRecord(value) || typeof value.type !== "string" || value.type === "object") {
+      return false;
+    }
+    switch (value.type) {
+      case "paragraph":
+      case "heading":
+        return Array.isArray(value.children) && value.children.every(isPortableTextSpan);
+      case "list-item":
+        // The item's spans, plus optional nested `list` block(s). Widened only
+        // for nested lists: any other block child (a stray paragraph, an object)
+        // still fails, so a serializer bug is caught here, not at render.
+        return Array.isArray(value.children) && value.children.every(function (child) {
+          return isPortableTextSpan(child) || _isPortableTextBlock(child) && child.type === "list";
+        });
+      case "list":
+        // A list holds `list-item`s only. A sublist emitted as a sibling of the
+        // items (the classic half-implemented-nesting bug) renders invalid HTML
+        // — <ul> with a direct <ul> child — so it fails here, not at render.
+        // `list-item` is validated but sits outside the PortableTextBlock union,
+        // so the discriminator is checked before isPortableTextBlock narrows it.
+        return Array.isArray(value.children) && value.children.every(function (child) {
+          return isRecord(child) && child.type === "list-item" && _isPortableTextBlock(child);
+        });
+      case "media":
+        return typeof value.src === "string";
+      case "titled-text":
+        return typeof value.title === "string" && (value.content === undefined || isPortableTextContent(value.content));
+      case "code-block":
+        return typeof value.code === "string" && (value.language === undefined || typeof value.language === "string");
+      case "table":
+        return isPortableTextTableRow(value.header) && Array.isArray(value.rows) && value.rows.every(isPortableTextTableRow);
+      case "divider":
+        return true;
+      default:
+        return true;
+    }
+  };
+  var isPortableTextContent = function isPortableTextContent(value) {
+    return Array.isArray(value) && value.every(function (node) {
+      return _isPortableTextBlock(node) || isPortableTextObjectNode(node);
+    });
+  };
+
   var StyledMedia = styled__default["default"].div.withConfig({
     displayName: "Styles__StyledMedia",
     componentId: "sc-zjz7mh-0"
@@ -25520,10 +25708,16 @@
       var block = _ref8.block,
         children = _ref8.children;
       var ordered = block.style === "number";
-      return /*#__PURE__*/React__default["default"].createElement(StyledList$1, {
-        as: ordered ? "ol" : "ul",
-        $ordered: ordered
-      }, children);
+      return (
+        /*#__PURE__*/
+        // `data-portable-list` scopes the depth-marker rules in Styles.ts to
+        // design-system lists, and marks the ancestors those rules count.
+        React__default["default"].createElement(StyledList$1, {
+          as: ordered ? "ol" : "ul",
+          $ordered: ordered,
+          "data-portable-list": ""
+        }, children)
+      );
     },
     "list-item": function listItem(_ref9) {
       var children = _ref9.children;
@@ -25539,6 +25733,15 @@
         alt = _ref1.alt,
         variant = _ref1.variant,
         caption = _ref1.caption;
+
+      // Video (and future) variants carry service semantics, so their renderer
+      // is application-catalog territory — an injected `media` override. The
+      // universal set covers images only; anything else degrades and warns, per
+      // the contract's degradation rule.
+      if (variant !== undefined && !isPortableTextMediaImageVariant(variant)) {
+        console.warn("PortableText: no default renderer for media variant \"".concat(variant, "\"."));
+        return null;
+      }
       return /*#__PURE__*/React__default["default"].createElement(Media, {
         src: src,
         alt: alt,
@@ -25602,140 +25805,6 @@
     }
   };
 
-  /**
-   * Portable Text envelope — the general content contract for structured,
-   * renderer-independent content (in-app messages, help, changelogs).
-   *
-   * The design system owns this envelope and the universal default set below.
-   * It never hardcodes a product element: concrete elements (callout,
-   * button-reference, doc-link, …) are defined in the application catalog and
-   * injected into the Portable Text engine through {@link PortableTextComponents}.
-   * See README.md next to this file for the full contract.
-   */
-
-  /* ---- Spans and marks ------------------------------------------------- */
-
-  /**
-   * A mark with data. Parameterless marks travel as plain strings ("strong");
-   * marks that need data travel as objects discriminated by `type`.
-   */
-
-  /** The one default mark that carries data. */
-
-  /** The leaf of every text run: a piece of text plus the marks wrapping it. */
-
-  /** Marks every client understands without injection. */
-  var PORTABLE_TEXT_DEFAULT_MARKS = ["strong", "em", "code", "link"];
-
-  /* ---- Blocks ----------------------------------------------------------- */
-
-  /** 1 maps to Title1, 2 to Title2, 3 to Header2 typography. */
-
-  /** Screenshots render framed (border, no shadow); illustrations render flat. */
-
-  /** A table cell is a span array, so inline marks work inside cells. */
-
-  /** A themed horizontal rule between sections. Carries no data. */
-
-  /**
-   * Derived from the union's discriminators, so adding a block to the union
-   * without a renderer entry is a compile error, never silent drift.
-   */
-
-  // A Record so the compiler checks the list against the union in both
-  // directions: a missing and a stray key each fail to build.
-  var DEFAULT_BLOCK_TYPES = {
-    paragraph: true,
-    heading: true,
-    list: true,
-    "list-item": true,
-    media: true,
-    "titled-text": true,
-    "code-block": true,
-    table: true,
-    divider: true
-  };
-
-  /** Blocks every client understands without injection. */
-  var PORTABLE_TEXT_DEFAULT_BLOCKS = Object.keys(DEFAULT_BLOCK_TYPES);
-
-  /* ---- Objects ----------------------------------------------------------- */
-
-  /**
-   * An embedded component the envelope does not interpret: `_type` names an
-   * application-catalog element, everything else is that element's data. An
-   * object whose `_type` has no injected renderer renders nothing and is logged.
-   */
-
-  /** The root of a message body: what an API returns under `content`. */
-
-  /* ---- Injection contract ------------------------------------------------ */
-
-  /**
-   * Called once per unknown type instead of rendering it, so content written
-   * for newer clients degrades silently on older ones.
-   */
-
-  /**
-   * What an application injects into the Portable Text engine: renderers for
-   * its catalog marks and objects, optional overrides for the default blocks,
-   * and the unknown-type hook.
-   */
-
-  /* ---- Runtime guards ----------------------------------------------------- */
-
-  var isRecord = function isRecord(value) {
-    return typeof value === "object" && value !== null;
-  };
-  var isPortableTextSpan = function isPortableTextSpan(value) {
-    return isRecord(value) && typeof value.text === "string";
-  };
-  var isPortableTextTableRow = function isPortableTextTableRow(value) {
-    return Array.isArray(value) && value.every(function (cell) {
-      return Array.isArray(cell) && cell.every(isPortableTextSpan);
-    });
-  };
-  var isPortableTextObjectNode = function isPortableTextObjectNode(value) {
-    return isRecord(value) && value.type === "object" && typeof value._type === "string";
-  };
-
-  /**
-   * A block is any non-object node with a string `type`. Unknown block types
-   * stay valid on purpose — they render nothing on clients that predate them.
-   * Known types are held to their shape, so a serializer bug (a paragraph
-   * without `children`, a list of non-nodes) fails here instead of at render.
-   */
-  var _isPortableTextBlock = function isPortableTextBlock(value) {
-    if (!isRecord(value) || typeof value.type !== "string" || value.type === "object") {
-      return false;
-    }
-    switch (value.type) {
-      case "paragraph":
-      case "heading":
-      case "list-item":
-        return Array.isArray(value.children) && value.children.every(isPortableTextSpan);
-      case "list":
-        return Array.isArray(value.children) && value.children.every(_isPortableTextBlock);
-      case "media":
-        return typeof value.src === "string";
-      case "titled-text":
-        return typeof value.title === "string" && (value.content === undefined || isPortableTextContent(value.content));
-      case "code-block":
-        return typeof value.code === "string" && (value.language === undefined || typeof value.language === "string");
-      case "table":
-        return isPortableTextTableRow(value.header) && Array.isArray(value.rows) && value.rows.every(isPortableTextTableRow);
-      case "divider":
-        return true;
-      default:
-        return true;
-    }
-  };
-  var isPortableTextContent = function isPortableTextContent(value) {
-    return Array.isArray(value) && value.every(function (node) {
-      return _isPortableTextBlock(node) || isPortableTextObjectNode(node);
-    });
-  };
-
   var _excluded$o = ["content", "components", "space"];
   var defaultUnknownTypeHandler = function defaultUnknownTypeHandler(kind, type) {
     console.warn("PortableText: no renderer for ".concat(kind, " type \"").concat(type, "\"."));
@@ -30521,6 +30590,7 @@
   exports.isOptionGroup = isOptionGroup;
   exports.isPortableTextBlock = _isPortableTextBlock;
   exports.isPortableTextContent = isPortableTextContent;
+  exports.isPortableTextMediaImageVariant = isPortableTextMediaImageVariant;
   exports.isPortableTextObjectNode = isPortableTextObjectNode;
   exports.isPortableTextSpan = isPortableTextSpan;
   exports.isPortableTextTableRow = isPortableTextTableRow;