@flamingo-stack/openframe-frontend-core 0.0.285 → 0.0.286-snapshot.20260618154650

package/dist/utils/index.cjs

@@ -190,6 +190,13 @@ function formatBytesShort(bytes) {
   const i = Math.floor(Math.log(bytes) / Math.log(k));
   return `${parseFloat((bytes / Math.pow(k, i)).toFixed(2))} ${sizes[i]}`;
 }
+function formatFileSize(bytes) {
+  if (bytes === 0) return "0 B";
+  const k = 1024;
+  const sizes = ["B", "KB", "MB", "GB"];
+  const i = Math.floor(Math.log(bytes) / Math.log(k));
+  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${sizes[i]}`;
+}
 function formatLargeNumber(num) {
   if (num === 0) return "0";
   const isNegative = num < 0;
@@ -3368,7 +3375,8 @@ var BUILDERS = {
   case_study: (ids, b) => `${b}/api/case-studies?ids=${ids.join(",")}&limit=${ids.length}`,
   product_release: (ids, b) => `${b}/api/releases?ids=${ids.join(",")}&limit=${ids.length}`,
   customer_interview: (ids, b) => `${b}/api/customer-interviews?ids=${ids.join(",")}&limit=${ids.length}`,
-  investor_update: (ids, b) => `${b}/api/investor-updates?ids=${ids.join(",")}&limit=${ids.length}`
+  investor_update: (ids, b) => `${b}/api/investor-updates?ids=${ids.join(",")}&limit=${ids.length}`,
+  faq: (ids, b) => `${b}/api/faqs?ids=${ids.join(",")}&limit=${ids.length}`
 };
 function buildListUrl(contentRefType, ids, base = "") {
   if (ids.length === 0) return null;
@@ -3380,6 +3388,24 @@ function buildListUrl(contentRefType, ids, base = "") {
   return fn ? fn(ids, base) : null;
 }
 
+// src/utils/faq-anchor.ts
+function faqSectionSlug(section) {
+  return "faq-" + section.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function faqItemAnchor(id) {
+  return `faq-item-${id}`;
+}
+var FAQ_ITEM_HASH_RE = /^faq-item-(\d+)$/;
+function parseFaqHash(hash) {
+  if (!hash) return null;
+  const trimmed = hash.replace(/^#/, "");
+  if (!trimmed) return null;
+  const itemMatch = FAQ_ITEM_HASH_RE.exec(trimmed);
+  if (itemMatch) return { kind: "item", rawId: itemMatch[1] };
+  if (trimmed.startsWith("faq-")) return { kind: "section", slug: trimmed };
+  return null;
+}
+
 // src/utils/content-ref-groups.ts
 var CONTENT_REF_GROUPS = {
   investor_update: { label: "Investor Updates", order: 1, layout: "grid", gridSize: "default" },
@@ -3515,6 +3541,274 @@ function evaluateHumanitySignals(body, opts) {
 }
 var splitCsvEnv = (s) => s?.split(",").map((t) => t.trim()).filter(Boolean) ?? [];
 
+// src/utils/doc-tree-nav.ts
+var DEFAULT_FOLDER_INDEX_FILE = "README.md";
+var DEFAULT_FOLDER_INDEX = DEFAULT_FOLDER_INDEX_FILE;
+function stripFolderIndexFromPath(path, folderIndexFile = DEFAULT_FOLDER_INDEX) {
+  const suffix = `/${folderIndexFile}`;
+  if (path.endsWith(suffix)) return path.slice(0, -suffix.length);
+  if (path === folderIndexFile) return "";
+  return path;
+}
+function findDocNodeByPath(path, nodes) {
+  for (const node of nodes) {
+    if (node.path === path) return node;
+    if (node.children) {
+      const found = findDocNodeByPath(path, node.children);
+      if (found) return found;
+    }
+  }
+  return null;
+}
+function getDocAncestorNodeIds(nodePath) {
+  const parts = nodePath.split("/");
+  const ids = [];
+  let current = "";
+  for (const part of parts) {
+    current = current ? `${current}-${part}` : part;
+    ids.push(current.toLowerCase());
+  }
+  return ids;
+}
+function resolveContentFetchPath(selectedPath, structure, folderIndexFile = DEFAULT_FOLDER_INDEX) {
+  if (selectedPath === "") {
+    return folderIndexFile;
+  }
+  const node = findDocNodeByPath(selectedPath, structure);
+  if (node && node.type === "folder" && !node.hasReadme) {
+    return null;
+  }
+  let pathToFetch = selectedPath;
+  if (node && node.type === "folder" && node.hasReadme) {
+    pathToFetch = `${selectedPath}/${folderIndexFile}`;
+  }
+  return pathToFetch;
+}
+function getInitialExpandedNodeIds(cleanInitialPath) {
+  if (!cleanInitialPath) return [];
+  const pathForExpansion = cleanInitialPath.includes(".") ? cleanInitialPath.substring(0, cleanInitialPath.lastIndexOf("/")) : cleanInitialPath;
+  if (!pathForExpansion) return [];
+  return getDocAncestorNodeIds(pathForExpansion);
+}
+function getDocSourceDefaultPath(structure, folderIndexFile = DEFAULT_FOLDER_INDEX) {
+  if (!structure.length) return null;
+  const hasRootIndex = structure.some(
+    (node) => node.type === "file" && node.path === folderIndexFile
+  );
+  if (hasRootIndex) return null;
+  const firstFolderWithReadme = structure.find(
+    (node) => node.type === "folder" && node.hasReadme && !!node.path
+  );
+  return firstFolderWithReadme?.path ?? null;
+}
+
+// src/utils/doc-path-utils.ts
+function toDocSlug(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, "-");
+}
+function pathToNodeId(path) {
+  return path.replace(/[\/\s]/g, "-").toLowerCase();
+}
+function normalizeDocPath(segments, folderIndexFile = DEFAULT_FOLDER_INDEX_FILE) {
+  const lowerPath = (segments?.join("/") || "").toLowerCase();
+  const lowerIndex = folderIndexFile.toLowerCase();
+  const suffix = `/${lowerIndex}`;
+  if (lowerPath.endsWith(suffix)) return lowerPath.slice(0, -suffix.length);
+  if (lowerPath === lowerIndex) return "";
+  return lowerPath;
+}
+
+// src/utils/tree-builder.ts
+function formatDocName(name) {
+  let displayName = name;
+  if (displayName.endsWith(".md")) {
+    displayName = displayName.slice(0, -3);
+  }
+  if (displayName.toLowerCase() === "readme") {
+    return "README";
+  }
+  return displayName.charAt(0).toUpperCase() + displayName.slice(1).replace(/-/g, " ");
+}
+function sortTreeChildren(nodes) {
+  nodes.sort((a, b) => {
+    const aIsReadme = a.name.toLowerCase() === "readme" || a.name.toLowerCase() === "readme.md";
+    const bIsReadme = b.name.toLowerCase() === "readme" || b.name.toLowerCase() === "readme.md";
+    if (aIsReadme && !bIsReadme) return -1;
+    if (!aIsReadme && bIsReadme) return 1;
+    if (a.type === "folder" && b.type !== "folder") return -1;
+    if (a.type !== "folder" && b.type === "folder") return 1;
+    const aOrder = a.sortOrder ?? Infinity;
+    const bOrder = b.sortOrder ?? Infinity;
+    if (aOrder !== bOrder) return aOrder - bOrder;
+    return a.name.localeCompare(b.name, void 0, { sensitivity: "base" });
+  });
+  for (const node of nodes) {
+    if (node.type === "folder" && node.children) {
+      node.children = sortTreeChildren(node.children);
+    }
+  }
+  return nodes;
+}
+function buildDocumentTree(docs, mapFn, getParentPath, getPath) {
+  const nodeMap = /* @__PURE__ */ new Map();
+  const rootNodes = [];
+  for (const doc of docs) {
+    const node = mapFn(doc);
+    nodeMap.set(getPath(doc), node);
+  }
+  for (const doc of docs) {
+    const node = nodeMap.get(getPath(doc));
+    let resolvedParentPath = getParentPath(doc);
+    if (!resolvedParentPath) {
+      const nodePath = getPath(doc);
+      const lastSlash = nodePath.lastIndexOf("/");
+      if (lastSlash > 0) {
+        resolvedParentPath = nodePath.substring(0, lastSlash);
+      }
+    }
+    if (resolvedParentPath) {
+      const parent = nodeMap.get(resolvedParentPath);
+      if (parent) {
+        if (!parent.children) parent.children = [];
+        parent.children.push(node);
+      } else {
+        rootNodes.push(node);
+      }
+    } else {
+      rootNodes.push(node);
+    }
+  }
+  return sortTreeChildren(rootNodes);
+}
+
+// src/utils/markdown-to-plain.ts
+function stripInlineMarkdown(s) {
+  return s.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/\*([^*]+)\*/g, "$1").replace(/`([^`]+)`/g, "$1");
+}
+function markdownToPlainText(markdown, options = {}) {
+  const { mode = "article", maxChars } = options;
+  let out = markdown.replace(/```[\s\S]*?```/g, "").replace(/!\[[^\]]*\]\([^)]+\)/g, "");
+  out = stripInlineMarkdown(out).replace(/^#+\s*/gm, "").replace(/^\s*[-*+]\s+/gm, "");
+  if (mode === "preview") {
+    out = out.replace(/\s+/g, " ").trim();
+  } else {
+    out = out.replace(/\n{3,}/g, "\n\n").trim();
+  }
+  if (maxChars != null && out.length > maxChars) {
+    out = out.slice(0, maxChars);
+  }
+  return out;
+}
+
+// src/utils/markdown-section-extractor.ts
+var DEFAULT_OPTIONS = {
+  maxLevel: 2,
+  removeEmojis: true,
+  handleDuplicateIds: true,
+  stripFormattingMarkers: true,
+  skipCodeAndYamlBlocks: true
+};
+function extractSections(markdown, options = {}) {
+  const opts = { ...DEFAULT_OPTIONS, ...options };
+  const sections = [];
+  const lines = markdown.split("\n");
+  const idCounts = {};
+  let inCodeBlock = false;
+  let inYamlBlock = false;
+  for (const line of lines) {
+    if (opts.skipCodeAndYamlBlocks) {
+      if (line.startsWith("```")) {
+        inCodeBlock = !inCodeBlock;
+        continue;
+      }
+      if (line === "---") {
+        inYamlBlock = !inYamlBlock;
+        continue;
+      }
+      if (inCodeBlock || inYamlBlock) continue;
+    }
+    const pattern = new RegExp(`^(#{1,${opts.maxLevel}})\\s+(.+)`);
+    const match = line.match(pattern);
+    if (!match) continue;
+    const level = match[1].length;
+    if (level > opts.maxLevel) continue;
+    let title = match[2].trim();
+    if (opts.stripFormattingMarkers) {
+      title = stripInlineMarkdown(title).trim();
+    }
+    let baseId = title;
+    if (opts.removeEmojis) {
+      baseId = baseId.replace(
+        /[\u{1F300}-\u{1F9FF}]|[\u{2600}-\u{26FF}]|[\u{2700}-\u{27BF}]/gu,
+        ""
+      ).trim();
+    }
+    baseId = baseId.toLowerCase().replace(/[^\w\s-]/g, "").replace(/\s+/g, "-").replace(/^-+|-+$/g, "");
+    const cleanId = baseId || `section-${sections.length + 1}`;
+    let id = cleanId;
+    if (opts.handleDuplicateIds) {
+      if (idCounts[cleanId]) {
+        idCounts[cleanId]++;
+        id = `${cleanId}-${idCounts[cleanId]}`;
+      } else {
+        idCounts[cleanId] = 1;
+      }
+    }
+    sections.push({ id, title, level });
+  }
+  return sections;
+}
+
+// src/utils/embed-url-converters.ts
+function toGoogleSheetsEmbedUrl(url) {
+  if (url.includes("/htmlembed")) return url;
+  const match = url.match(/\/spreadsheets\/d\/([a-zA-Z0-9-_]+)/);
+  if (!match) return url;
+  const gidMatch = url.match(/[#?&]gid=(\d+)/);
+  const gid = gidMatch ? gidMatch[1] : "0";
+  return `https://docs.google.com/spreadsheets/d/${match[1]}/htmlembed?widget=true&chrome=false&headers=false&gid=${gid}`;
+}
+function toGoogleSheetsOriginalUrl(url) {
+  const match = url.match(/\/spreadsheets\/d\/([a-zA-Z0-9-_]+)/);
+  if (!match) return url;
+  const gidMatch = url.match(/[#?&]gid=(\d+)/);
+  const gid = gidMatch ? gidMatch[1] : "0";
+  return `https://docs.google.com/spreadsheets/d/${match[1]}/edit#gid=${gid}`;
+}
+function toFigmaEmbedUrl(url, opts) {
+  if (url.includes("embed.figma.com")) return url;
+  if (url.includes("figma.com/embed")) return url;
+  const match = url.match(
+    /figma\.com\/(design|file|proto|board|slides|deck)\/([a-zA-Z0-9]+)(?:\/([^?]*))?(\?.*)?$/
+  );
+  if (match) {
+    const [, urlType, fileKey, titleSlug, queryString] = match;
+    const isSlides = urlType === "slides" || urlType === "deck";
+    const embedType = urlType === "proto" ? "proto" : isSlides ? opts?.slidesView === "browse" ? "slides" : "deck" : "design";
+    const pathSuffix = titleSlug ? `/${titleSlug}` : "";
+    const params = new URLSearchParams(queryString?.replace(/^\?/, "") || "");
+    if (!params.has("embed-host")) {
+      params.set("embed-host", "flamingo");
+    }
+    const clientId = process.env.NEXT_PUBLIC_FIGMA_CLIENT_ID;
+    if (clientId && !params.has("client-id")) {
+      params.set("client-id", clientId);
+    }
+    return `https://embed.figma.com/${embedType}/${fileKey}${pathSuffix}?${params.toString()}`;
+  }
+  return `https://www.figma.com/embed?embed-host=flamingo&url=${encodeURIComponent(url)}`;
+}
+function isFigmaSlidesUrl(url) {
+  if (!url) return false;
+  return /(?:www\.|embed\.)?figma\.com\/(?:slides|deck)\/[a-zA-Z0-9]+/.test(url);
+}
+function toFigmaOriginalUrl(url) {
+  if (url.includes("embed.figma.com")) {
+    return url.replace("embed.figma.com", "www.figma.com").replace(/\?.*$/, "");
+  }
+  return url.replace(/\?.*$/, "");
+}
+
 exports.ANTHROPIC_SUPPORTED_IMAGE_MIME = ANTHROPIC_SUPPORTED_IMAGE_MIME;
 exports.AUTO_CONTINUATION_DIRECTIVE_PREFIX = AUTO_CONTINUATION_DIRECTIVE_PREFIX;
 exports.CHAT_ATTACHMENT_MARKDOWN_PATTERN = CHAT_ATTACHMENT_MARKDOWN_PATTERN;
@@ -3524,6 +3818,7 @@ exports.CHAT_ATTACHMENT_VIEW_URL_PREFIX_REGEX_ESCAPED = CHAT_ATTACHMENT_VIEW_URL
 exports.CONTENT_REF_GROUPS = CONTENT_REF_GROUPS;
 exports.CUSTOM_ITEM_ID = CUSTOM_ITEM_ID;
 exports.DEFAULT_CONTENT_SUFFIXES = DEFAULT_CONTENT_SUFFIXES;
+exports.DEFAULT_FOLDER_INDEX_FILE = DEFAULT_FOLDER_INDEX_FILE;
 exports.DEFAULT_MIN_FILL_MS = DEFAULT_MIN_FILL_MS;
 exports.DEFAULT_OS_PLATFORM = DEFAULT_OS_PLATFORM;
 exports.DELIVERY_TASK_TYPE_OPTIONS = DELIVERY_TASK_TYPE_OPTIONS;
@@ -3549,6 +3844,7 @@ exports.buildAutoContinuationDirective = buildAutoContinuationDirective;
 exports.buildChatAttachmentViewUrl = buildChatAttachmentViewUrl;
 exports.buildDefaultHref = buildDefaultHref;
 exports.buildDiscussAddendum = buildDiscussAddendum;
+exports.buildDocumentTree = buildDocumentTree;
 exports.buildListUrl = buildListUrl;
 exports.buildSuggestionUrl = buildSuggestionUrl;
 exports.canonicalContentRefType = canonicalContentRefType;
@@ -3572,7 +3868,11 @@ exports.extractHumanitySignals = extractHumanitySignals;
 exports.extractImageEdgeColorAsync = extractImageEdgeColorAsync;
 exports.extractItemId = extractItemId;
 exports.extractItems = extractItems;
+exports.extractSections = extractSections;
+exports.faqItemAnchor = faqItemAnchor;
+exports.faqSectionSlug = faqSectionSlug;
 exports.fetchPriorityProp = fetchPriorityProp;
+exports.findDocNodeByPath = findDocNodeByPath;
 exports.flattenAssistantContent = flattenAssistantContent;
 exports.formatAbbreviatedNumber = formatAbbreviatedNumber;
 exports.formatAbsoluteDate = formatAbsoluteDate;
@@ -3590,12 +3890,14 @@ exports.formatDateSlashUTC = formatDateSlashUTC;
 exports.formatDateTime = formatDateTime;
 exports.formatDateTimeAt = formatDateTimeAt;
 exports.formatDateUTC = formatDateUTC;
+exports.formatDocName = formatDocName;
 exports.formatDuration = formatDuration;
 exports.formatDurationCompact = formatDurationCompact;
 exports.formatDurationFromMs = formatDurationFromMs;
 exports.formatDurationFromRange = formatDurationFromRange;
 exports.formatDurationMMSS = formatDurationMMSS;
 exports.formatEntryMonthUTC = formatEntryMonthUTC;
+exports.formatFileSize = formatFileSize;
 exports.formatLargeNumber = formatLargeNumber;
 exports.formatLegalDate = formatLegalDate;
 exports.formatNumber = formatNumber;
@@ -3631,10 +3933,13 @@ exports.getCurrentPlatform = getCurrentPlatform;
 exports.getDefaultColorForPlatform = getDefaultColorForPlatform;
 exports.getDefaultIconForPlatform = getDefaultIconForPlatform;
 exports.getDetailedTimeDifference = getDetailedTimeDifference;
+exports.getDocAncestorNodeIds = getDocAncestorNodeIds;
+exports.getDocSourceDefaultPath = getDocSourceDefaultPath;
 exports.getDynamicIcon = getDynamicIcon;
 exports.getEmbedProxyAuth = getEmbedProxyAuth;
 exports.getFirstLastInitials = getFirstLastInitials;
 exports.getIconComponent = getIconComponent;
+exports.getInitialExpandedNodeIds = getInitialExpandedNodeIds;
 exports.getOSIcon = getOSIcon;
 exports.getOSLabel = getOSLabel;
 exports.getOSPlatformId = getOSPlatformId;
@@ -3665,6 +3970,7 @@ exports.getTrendColors = getTrendColors;
 exports.hasGenericEmailDomain = hasGenericEmailDomain;
 exports.hexToRgb = hexToRgb;
 exports.isCrossOriginUrl = isCrossOriginUrl;
+exports.isFigmaSlidesUrl = isFigmaSlidesUrl;
 exports.isGenericDomain = isGenericDomain;
 exports.isGenericWebsiteDomain = isGenericWebsiteDomain;
 exports.isOSPlatform = isOSPlatform;
@@ -3673,15 +3979,19 @@ exports.isValidEmailDomain = isValidEmailDomain;
 exports.isValidToolType = isValidToolType;
 exports.isWithinMinutes = isWithinMinutes;
 exports.makeComposeContentUrl = makeComposeContentUrl;
+exports.markdownToPlainText = markdownToPlainText;
 exports.nameInitials = nameInitials;
+exports.normalizeDocPath = normalizeDocPath;
 exports.normalizeDomain = normalizeDomain;
 exports.normalizeIconKey = normalizeIconKey;
 exports.normalizeOSType = normalizeOSType;
 exports.normalizeToolType = normalizeToolType;
 exports.normalizeToolTypeWithFallback = normalizeToolTypeWithFallback;
 exports.orderContentRefTypes = orderContentRefTypes;
+exports.parseFaqHash = parseFaqHash;
 exports.parseScrollAnchor = parseScrollAnchor;
 exports.parseWireCommandOverride = parseWireCommandOverride;
+exports.pathToNodeId = pathToNodeId;
 exports.platformColors = platformColors;
 exports.platformDescriptions = platformDescriptions;
 exports.platformDisplayNames = platformDisplayNames;
@@ -3691,6 +4001,7 @@ exports.platformIcons = platformIcons;
 exports.platformSlogans = platformSlogans;
 exports.readLeadingDecisionFrame = readLeadingDecisionFrame;
 exports.releaseTypeToBadgeColor = releaseTypeToBadgeColor;
+exports.resolveContentFetchPath = resolveContentFetchPath;
 exports.resolveReleaseCover = resolveReleaseCover;
 exports.rgbToHex = rgbToHex;
 exports.sanitizeTitleForChat = sanitizeTitleForChat;
@@ -3699,9 +4010,17 @@ exports.serializeJsonLd = serializeJsonLd;
 exports.setEmbedAuthAdapter = setEmbedAuthAdapter;
 exports.setEmbedProxyAuth = setEmbedProxyAuth;
 exports.shouldProxyImage = shouldProxyImage;
+exports.sortTreeChildren = sortTreeChildren;
 exports.splitCsvEnv = splitCsvEnv;
 exports.stripChatAttachmentMarkdown = stripChatAttachmentMarkdown;
+exports.stripFolderIndexFromPath = stripFolderIndexFromPath;
 exports.stripHtml = stripHtml;
+exports.stripInlineMarkdown = stripInlineMarkdown;
+exports.toDocSlug = toDocSlug;
+exports.toFigmaEmbedUrl = toFigmaEmbedUrl;
+exports.toFigmaOriginalUrl = toFigmaOriginalUrl;
+exports.toGoogleSheetsEmbedUrl = toGoogleSheetsEmbedUrl;
+exports.toGoogleSheetsOriginalUrl = toGoogleSheetsOriginalUrl;
 exports.toToolLabel = toToolLabel;
 exports.transformPlatformConfigsToOptions = transformPlatformConfigsToOptions;
 exports.truncateString = truncateString;