@relyio/sdk 0.12.0 → 0.14.0

package/dist/{chunk-FI5VIF4M.cjs → chunk-RSHMA4KT.cjs}

@@ -4,20 +4,252 @@ var chunkMWMSFIWN_cjs = require('./chunk-MWMSFIWN.cjs');
 
 /* RelyIO SDK - Built with ❤️ by the RelyIO Team */
 
+// src/rich-text/anchors.ts
+function richTextHeadingSlug(text) {
+  return text.trim().toLowerCase().replace(/[^\p{L}\p{M}\p{N}\s_-]/gu, "").replace(/\s/gu, "-");
+}
+chunkMWMSFIWN_cjs.__name(richTextHeadingSlug, "richTextHeadingSlug");
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+chunkMWMSFIWN_cjs.__name(isRecord, "isRecord");
+var BUILT_IN_CONTAINERS = /* @__PURE__ */ new Set([
+  "paragraph",
+  "heading",
+  "quote",
+  "list",
+  "listItem",
+  "codeGroup",
+  "table",
+  "tableRow",
+  "tableCell"
+]);
+function headingText(heading) {
+  if (!Array.isArray(heading.children)) return "";
+  let text = "";
+  for (const child of heading.children) {
+    if (!isRecord(child)) continue;
+    if (child._type === "lineBreak") text += " ";
+    else if (child._type === "text" && typeof child.text === "string") text += child.text;
+  }
+  return text;
+}
+chunkMWMSFIWN_cjs.__name(headingText, "headingText");
+function richTextHeadingAnchors(value) {
+  return anchorsAcross([value]);
+}
+chunkMWMSFIWN_cjs.__name(richTextHeadingAnchors, "richTextHeadingAnchors");
+function entryHeadingAnchors(entry) {
+  return anchorsAcross(isRecord(entry) ? Object.values(entry) : []);
+}
+chunkMWMSFIWN_cjs.__name(entryHeadingAnchors, "entryHeadingAnchors");
+function anchorsAcross(values) {
+  const anchors = /* @__PURE__ */ new Map();
+  const taken = /* @__PURE__ */ new Map();
+  const unique = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((slug) => {
+    let anchor = slug;
+    const seen = taken.get(slug);
+    if (seen !== void 0) {
+      let count = seen;
+      do {
+        count += 1;
+        anchor = `${slug}-${count}`;
+      } while (taken.has(anchor));
+      taken.set(slug, count);
+    }
+    taken.set(anchor, 0);
+    return anchor;
+  }, "unique");
+  const visit = /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((nodes) => {
+    for (const node of nodes) {
+      if (!isRecord(node) || typeof node._type !== "string") continue;
+      if (node._type === "heading") {
+        const slug = richTextHeadingSlug(headingText(node));
+        if (slug !== "") anchors.set(node, unique(slug));
+        continue;
+      }
+      if (BUILT_IN_CONTAINERS.has(node._type) && Array.isArray(node.children)) visit(node.children);
+    }
+  }, "visit");
+  for (const value of values) {
+    if (isRecord(value) && value._type === "richText" && Array.isArray(value.children)) {
+      visit(value.children);
+    }
+  }
+  return anchors;
+}
+chunkMWMSFIWN_cjs.__name(anchorsAcross, "anchorsAcross");
+
+// src/binding/key-path.ts
+var ITEM_SELECTOR = "[_key==";
+function formatKeyPath(listPath, key, field) {
+  const item = `${listPath}${ITEM_SELECTOR}${JSON.stringify(key)}]`;
+  return field === void 0 ? item : `${item}.${field}`;
+}
+chunkMWMSFIWN_cjs.__name(formatKeyPath, "formatKeyPath");
+function parseKeyPath(path) {
+  const segments = [];
+  let at = 0;
+  let expectField = true;
+  while (at < path.length) {
+    if (path.startsWith(ITEM_SELECTOR, at)) {
+      const previous = segments[segments.length - 1];
+      if (expectField || previous === void 0 || !("field" in previous)) return null;
+      const quoted = readQuoted(path, at + ITEM_SELECTOR.length);
+      if (quoted === null || path[quoted.end] !== "]") return null;
+      segments.push({ key: quoted.value });
+      at = quoted.end + 1;
+      if (at < path.length && path[at] !== "." && !path.startsWith(ITEM_SELECTOR, at)) return null;
+      if (path[at] === ".") {
+        at += 1;
+        expectField = true;
+      }
+      continue;
+    }
+    let end = at;
+    while (end < path.length && path[end] !== "." && path[end] !== "[") end += 1;
+    const field = path.slice(at, end);
+    if (field.length === 0) return null;
+    segments.push({ field });
+    expectField = false;
+    at = end;
+    if (path[at] === ".") {
+      at += 1;
+      expectField = true;
+      if (at === path.length) return null;
+    } else if (at < path.length && !path.startsWith(ITEM_SELECTOR, at)) {
+      return null;
+    }
+  }
+  return segments.length === 0 || expectField ? null : segments;
+}
+chunkMWMSFIWN_cjs.__name(parseKeyPath, "parseKeyPath");
+function readQuoted(path, start) {
+  if (path[start] !== '"') return null;
+  for (let end = start + 1; end < path.length; end += 1) {
+    if (path[end] === "\\") {
+      end += 1;
+      continue;
+    }
+    if (path[end] !== '"') continue;
+    try {
+      const value = JSON.parse(path.slice(start, end + 1));
+      return typeof value === "string" && value.length > 0 ? { value, end: end + 1 } : null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+chunkMWMSFIWN_cjs.__name(readQuoted, "readQuoted");
+
+// src/binding/relyio-field.ts
+var BINDING_VERSION = "1";
+function relyioField(subject, path) {
+  if (subject === void 0) return void 0;
+  if (isBindingShaped(subject)) return continued(subject, path);
+  const field = typeof path === "string" ? path : String(path);
+  const metadata = subject._metadata;
+  const attributes = {
+    "data-relyio-entry": requireMetadata(metadata, "id", field),
+    "data-relyio-type": requireMetadata(metadata, "type", field),
+    "data-relyio-field": field,
+    "data-relyio-locale": requireMetadata(metadata, "locale", field),
+    "data-relyio-v": BINDING_VERSION
+  };
+  requireKeyPath("entry", field, field);
+  return attributes;
+}
+chunkMWMSFIWN_cjs.__name(relyioField, "relyioField");
+function isBindingShaped(value) {
+  return "data-relyio-field" in value;
+}
+chunkMWMSFIWN_cjs.__name(isBindingShaped, "isBindingShaped");
+function continued(binding, path) {
+  const spelled = typeof path === "string" ? path : `{ _key: ${JSON.stringify(path._key)} }`;
+  const complete = binding["data-relyio-v"] === BINDING_VERSION && [
+    binding["data-relyio-entry"],
+    binding["data-relyio-type"],
+    binding["data-relyio-field"],
+    binding["data-relyio-locale"]
+  ].every((value) => typeof value === "string" && value.length > 0);
+  if (!complete) {
+    throw new TypeError(
+      `relyioField(binding, '${spelled}'): the binding is not one relyioField returned \u2014 continue the attributes relyioField(entry, field) gave, or a renderer handed you.`
+    );
+  }
+  const field = typeof path === "string" ? `${binding["data-relyio-field"]}.${path}` : formatKeyPath(binding["data-relyio-field"], path._key);
+  requireKeyPath("binding", spelled, field);
+  return {
+    "data-relyio-entry": binding["data-relyio-entry"],
+    "data-relyio-type": binding["data-relyio-type"],
+    "data-relyio-field": field,
+    "data-relyio-locale": binding["data-relyio-locale"],
+    "data-relyio-v": BINDING_VERSION
+  };
+}
+chunkMWMSFIWN_cjs.__name(continued, "continued");
+function requireKeyPath(form, given, field) {
+  if (parseKeyPath(field) !== null) return;
+  throw new TypeError(
+    `relyioField(${form}, '${given}'): '${field}' is not a field or a key path. Name a field (\`title\`), or a value inside one by its items\u2019 keys (\`sections[_key=="k1"].heading\`).`
+  );
+}
+chunkMWMSFIWN_cjs.__name(requireKeyPath, "requireKeyPath");
+function requireMetadata(metadata, key, field) {
+  const value = metadata?.[key];
+  if (typeof value !== "string" || value.length === 0) {
+    throw new TypeError(
+      `relyioField(entry, '${field}'): the entry has no _metadata.${key}, so the field cannot be bound. Pass an entry as the RelyIO API returned it.`
+    );
+  }
+  return value;
+}
+chunkMWMSFIWN_cjs.__name(requireMetadata, "requireMetadata");
+
 // src/rich-text/render.ts
 var RICH_TEXT_VOID_TAGS = /* @__PURE__ */ new Set([
   "hr",
   "br",
   "input"
 ]);
+var BUILT_IN_NODES = {
+  paragraph: true,
+  heading: true,
+  quote: true,
+  list: true,
+  listItem: true,
+  codeBlock: true,
+  codeGroup: true,
+  table: true,
+  tableRow: true,
+  tableCell: true,
+  divider: true,
+  text: true,
+  lineBreak: true
+};
+function isDeclaredRichTextNode(node) {
+  if (typeof node !== "object" || node === null) return false;
+  const type = node._type;
+  return typeof type === "string" && type !== "" && !Object.prototype.hasOwnProperty.call(BUILT_IN_NODES, type);
+}
+chunkMWMSFIWN_cjs.__name(isDeclaredRichTextNode, "isDeclaredRichTextNode");
 var PLAIN = Object.freeze({ header: false });
 var HEADER = Object.freeze({ header: true });
-function renderRichText(value, target) {
-  if (value._type !== "richText") {
-    const drawn = block(value, target);
+var headingAnchors = /* @__PURE__ */ new Map();
+function renderRichText(value, target, options = {}) {
+  const held = value;
+  if (held._type !== "richText") {
+    const drawn = block(held, target);
     return drawn === void 0 ? [] : [drawn];
   }
-  return Array.isArray(value.children) ? blocks(value.children, target) : [];
+  const outer = headingAnchors;
+  headingAnchors = options.anchors ?? richTextHeadingAnchors(held);
+  try {
+    return Array.isArray(held.children) ? blocks(held.children, target) : [];
+  } finally {
+    headingAnchors = outer;
+  }
 }
 chunkMWMSFIWN_cjs.__name(renderRichText, "renderRichText");
 function blocks(nodes, target) {
@@ -38,6 +270,9 @@ var HEADING_TAGS = {
   6: "h6"
 };
 function block(node, target) {
+  if (isDeclaredRichTextNode(node)) {
+    return target.declared(node, "block");
+  }
   switch (node._type) {
     case "paragraph": {
       return target.node(
@@ -49,10 +284,16 @@ function block(node, target) {
     }
     case "heading": {
       const tag = HEADING_TAGS[node.level] ?? "p";
+      const anchor = headingAnchors.get(node);
       return target.node(
         node,
         inline(node.children, target),
-        (contents) => target.element(tag, void 0, contents, node._key),
+        (contents) => target.element(
+          tag,
+          anchor === void 0 ? void 0 : { id: anchor },
+          contents,
+          node._key
+        ),
         PLAIN
       );
     }
@@ -255,6 +496,12 @@ function inline(nodes, target) {
     runs = [];
   }, "flush");
   for (const node of nodes) {
+    if (isDeclaredRichTextNode(node)) {
+      flush();
+      const drawn = target.declared(node, "inline");
+      if (drawn !== void 0) out.push(drawn);
+      continue;
+    }
     switch (node._type) {
       case "text": {
         runs.push({ span: node, drawn: 0 });
@@ -303,9 +550,22 @@ function nextMark(run) {
 chunkMWMSFIWN_cjs.__name(nextMark, "nextMark");
 function sameMark(a, b) {
   if (a?._type !== b._type) return false;
-  return a._type !== "link" || b._type !== "link" || a.href === b.href;
+  if (a._type === "link" && b._type === "link") return a.href === b.href;
+  if (a._type === "entryLink" && b._type === "entryLink") {
+    return linkedEntryId(a) === linkedEntryId(b) && a.anchor === b.anchor;
+  }
+  return true;
 }
 chunkMWMSFIWN_cjs.__name(sameMark, "sameMark");
+function linkedEntryId(link) {
+  const to = link.to;
+  if (typeof to === "object" && to !== null && "_metadata" in to) {
+    const metadata = to._metadata;
+    return metadata?.id ?? to;
+  }
+  return to;
+}
+chunkMWMSFIWN_cjs.__name(linkedEntryId, "linkedEntryId");
 var MARK_TAGS = {
   bold: "strong",
   italic: "em",
@@ -318,6 +578,9 @@ var MARK_TAGS = {
 };
 function applyMark(mark, inner, target) {
   switch (mark._type) {
+    case "entryLink": {
+      return [target.entryLink(mark, inner)];
+    }
     case "link": {
       const href = safeRichTextHref(mark.href);
       if (href === void 0) return inner;
@@ -391,28 +654,168 @@ function attributesOf(attributes) {
   return written;
 }
 chunkMWMSFIWN_cjs.__name(attributesOf, "attributesOf");
-var HTML_TARGET = {
-  element(tag, attributes, children) {
-    return RICH_TEXT_VOID_TAGS.has(tag) ? `<${tag}${attributesOf(attributes)}/>` : `<${tag}${attributesOf(attributes)}>${children.join("")}</${tag}>`;
-  },
-  text: escapeHtml,
-  node: /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((_node, contents, draw) => draw(contents), "node"),
-  mark: /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((_mark, contents, draw) => draw(contents), "mark")
-};
-function richTextToHtml(value) {
+var VOID_ELEMENTS = /* @__PURE__ */ new Set([
+  "area",
+  "base",
+  "br",
+  "col",
+  "embed",
+  "hr",
+  "img",
+  "input",
+  "link",
+  "meta",
+  "source",
+  "track",
+  "wbr"
+]);
+var RAW_TEXT_ELEMENTS = /* @__PURE__ */ new Set(["script", "style", "textarea", "title"]);
+var BOUND = /\sdata-relyio-entry(?:[\s=/>]|$)/i;
+function tagEnd(html, start) {
+  let quote;
+  for (let index = start + 1; index < html.length; index++) {
+    const character = html[index];
+    if (quote !== void 0) {
+      if (character === quote) quote = void 0;
+    } else if (character === '"' || character === "'") {
+      quote = character;
+    } else if (character === ">") {
+      return index + 1;
+    }
+  }
+  return -1;
+}
+chunkMWMSFIWN_cjs.__name(tagEnd, "tagEnd");
+var TAG_NAME = /^<\/?([A-Za-z][\w:-]*)/;
+function soleElementStartTag(html) {
+  const from = html.length - html.trimStart().length;
+  const to = html.trimEnd().length;
+  const root = TAG_NAME.exec(html.slice(from));
+  if (root === null || html[from + 1] === "/") return void 0;
+  let depth = 0;
+  let index = from;
+  let startTag;
+  while (index < to) {
+    if (depth === 0 && startTag !== void 0) return void 0;
+    const open = html.indexOf("<", index);
+    if (open !== index) {
+      if (depth === 0) return void 0;
+      if (open === -1 || open >= to) return void 0;
+      index = open;
+      continue;
+    }
+    if (html.startsWith("<!--", index)) {
+      if (depth === 0) return void 0;
+      const close = html.indexOf("-->", index + 4);
+      if (close === -1) return void 0;
+      index = close + 3;
+      continue;
+    }
+    const name = TAG_NAME.exec(html.slice(index));
+    if (name === null) {
+      if (depth === 0) return void 0;
+      index += 1;
+      continue;
+    }
+    const end = tagEnd(html, index);
+    if (end === -1 || end > to) return void 0;
+    const tag = (name[1] ?? "").toLowerCase();
+    if (html[index + 1] === "/") {
+      depth -= 1;
+      if (depth < 0) return void 0;
+      index = end;
+      continue;
+    }
+    const selfClosing = html[end - 2] === "/";
+    if (startTag === void 0) {
+      let insertAt = selfClosing ? end - 2 : end - 1;
+      while (insertAt > index && /\s/.test(html[insertAt - 1] ?? "")) insertAt -= 1;
+      startTag = { insertAt, tag: html.slice(index, end) };
+    }
+    if (selfClosing || VOID_ELEMENTS.has(tag)) {
+      index = end;
+      continue;
+    }
+    if (RAW_TEXT_ELEMENTS.has(tag)) {
+      const close = html.toLowerCase().indexOf(`</${tag}`, end);
+      if (close === -1) return void 0;
+      depth += 1;
+      index = close;
+      continue;
+    }
+    depth += 1;
+    index = end;
+  }
+  return depth === 0 ? startTag : void 0;
+}
+chunkMWMSFIWN_cjs.__name(soleElementStartTag, "soleElementStartTag");
+function stamped(html, binding) {
+  if (binding === void 0) return html;
+  const root = soleElementStartTag(html);
+  if (root === void 0) return html;
+  if (BOUND.test(root.tag)) return html;
+  return `${html.slice(0, root.insertAt)}${attributesOf(binding)}${html.slice(root.insertAt)}`;
+}
+chunkMWMSFIWN_cjs.__name(stamped, "stamped");
+function htmlTarget(declared2, entryLink, field) {
+  return {
+    element(tag, attributes, children) {
+      return RICH_TEXT_VOID_TAGS.has(tag) ? `<${tag}${attributesOf(attributes)}/>` : `<${tag}${attributesOf(attributes)}>${children.join("")}</${tag}>`;
+    },
+    text: escapeHtml,
+    node: /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((_node, contents, draw) => draw(contents), "node"),
+    mark: /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((_mark, contents, draw) => draw(contents), "mark"),
+    // A value built by hand holding an entry link no writer draws: its text, with no anchor
+    entryLink: /* @__PURE__ */ chunkMWMSFIWN_cjs.__name((link, contents) => entryLink === void 0 ? contents.join("") : entryLink(link, contents.join("")), "entryLink"),
+    // A declared node's writer (REL-1807), handed the node's key path below the field's binding and
+    // stamped with it (REL-2142); no binding asks the core nothing
+    declared(node) {
+      const write = Object.prototype.hasOwnProperty.call(declared2, node._type) ? declared2[node._type] : void 0;
+      if (write === void 0) return void 0;
+      const binding = field === void 0 ? void 0 : relyioField(field, node);
+      return stamped(write(node, binding), binding);
+    }
+  };
+}
+chunkMWMSFIWN_cjs.__name(htmlTarget, "htmlTarget");
+function richTextToHtml(value, ...[options]) {
   if (value === void 0) return "";
-  return renderRichText(value, HTML_TARGET).join("");
+  const declared2 = options?.declared ?? {};
+  const entryLink = options?.entryLink;
+  return renderRichText(
+    value,
+    htmlTarget(declared2, entryLink, options?.field),
+    options?.anchors === void 0 ? {} : { anchors: options.anchors }
+  ).join("");
 }
 chunkMWMSFIWN_cjs.__name(richTextToHtml, "richTextToHtml");
 
 // src/rich-text/markdown.ts
-function richTextToMarkdown(value) {
+var entryLinkWriter;
+var writers = {};
+function declared(node) {
+  const type = node._type;
+  const write = Object.prototype.hasOwnProperty.call(writers, type) ? writers[type] : void 0;
+  return write === void 0 ? void 0 : write(node);
+}
+chunkMWMSFIWN_cjs.__name(declared, "declared");
+function richTextToMarkdown(value, ...[options]) {
   if (value === void 0) return "";
-  const held = value._type === "richText" ? value.children : [value];
+  const tree = value;
+  const held = tree._type === "richText" ? tree.children : [tree];
   if (!Array.isArray(held)) return "";
-  const written = blocks2(held);
-  return written.length === 0 ? "" : `${written.join("\n\n")}
+  const outer = writers;
+  const outerLink = entryLinkWriter;
+  writers = options?.declared ?? {};
+  entryLinkWriter = options?.entryLink;
+  try {
+    const written = blocks2(held);
+    return written.length === 0 ? "" : `${written.join("\n\n")}
 `;
+  } finally {
+    writers = outer;
+    entryLinkWriter = outerLink;
+  }
 }
 chunkMWMSFIWN_cjs.__name(richTextToMarkdown, "richTextToMarkdown");
 function blocks2(nodes) {
@@ -425,6 +828,7 @@ function blocks2(nodes) {
 }
 chunkMWMSFIWN_cjs.__name(blocks2, "blocks");
 function block2(node) {
+  if (isDeclaredRichTextNode(node)) return declared(node);
   switch (node._type) {
     case "paragraph": {
       return escapeLineStarts(inline2(node.children, "\\\n"));
@@ -568,6 +972,11 @@ function inline2(nodes, lineBreak) {
     runs = [];
   }, "flush");
   for (const node of nodes) {
+    if (isDeclaredRichTextNode(node)) {
+      flush();
+      out += declared(node) ?? "";
+      continue;
+    }
     switch (node._type) {
       case "text": {
         runs.push({ span: node, drawn: 0 });
@@ -618,6 +1027,9 @@ function marked2(runs) {
 chunkMWMSFIWN_cjs.__name(marked2, "marked");
 function applyMark2(mark, inner) {
   switch (mark._type) {
+    case "entryLink": {
+      return entryLinkWriter === void 0 || inner === "" ? inner : entryLinkWriter(mark, inner);
+    }
     case "link": {
       const href = safeRichTextHref(mark.href);
       if (href === void 0 || inner === "") return inner;
@@ -678,9 +1090,17 @@ function escapeLineStarts(paragraph) {
 chunkMWMSFIWN_cjs.__name(escapeLineStarts, "escapeLineStarts");
 
 exports.RICH_TEXT_VOID_TAGS = RICH_TEXT_VOID_TAGS;
+exports.entryHeadingAnchors = entryHeadingAnchors;
+exports.escapeHtml = escapeHtml;
+exports.formatKeyPath = formatKeyPath;
+exports.isDeclaredRichTextNode = isDeclaredRichTextNode;
+exports.parseKeyPath = parseKeyPath;
+exports.relyioField = relyioField;
 exports.renderRichText = renderRichText;
+exports.richTextHeadingAnchors = richTextHeadingAnchors;
+exports.richTextHeadingSlug = richTextHeadingSlug;
 exports.richTextToHtml = richTextToHtml;
 exports.richTextToMarkdown = richTextToMarkdown;
 exports.safeRichTextHref = safeRichTextHref;
-//# sourceMappingURL=chunk-FI5VIF4M.cjs.map
-//# sourceMappingURL=chunk-FI5VIF4M.cjs.map
+//# sourceMappingURL=chunk-RSHMA4KT.cjs.map
+//# sourceMappingURL=chunk-RSHMA4KT.cjs.map