@activecollab/components 2.0.414 → 2.0.415

package/dist/index.js

@@ -25331,6 +25331,157 @@
   }, 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. */
+
+  /** 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":
+      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 StyledMedia = styled__default["default"].div.withConfig({
     displayName: "Styles__StyledMedia",
     componentId: "sc-zjz7mh-0"
@@ -25539,6 +25690,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 +25762,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 +30547,7 @@
   exports.isOptionGroup = isOptionGroup;
   exports.isPortableTextBlock = _isPortableTextBlock;
   exports.isPortableTextContent = isPortableTextContent;
+  exports.isPortableTextMediaImageVariant = isPortableTextMediaImageVariant;
   exports.isPortableTextObjectNode = isPortableTextObjectNode;
   exports.isPortableTextSpan = isPortableTextSpan;
   exports.isPortableTextTableRow = isPortableTextTableRow;