@replohq/sandbox-runtime 1.20.0 → 1.21.0

package/chunk-NVOBD46N.mjs

@@ -0,0 +1,541 @@
+import { exhaustiveSwitch } from './chunk-THOBCJJA.mjs';
+import * as z from 'zod';
+
+function parseJsonOrNull(json) {
+  try {
+    return JSON.parse(json);
+  } catch {
+    return null;
+  }
+}
+
+function parseSchemaOrNull(value, schema) {
+  const parseResult = schema.safeParse(value);
+  return parseResult.success ? parseResult.data : null;
+}
+var commentSourceSchema = z.enum(["ui", "agent", "mcp", "api"]).describe("CommentSource");
+var unitIntervalSchema = z.number().min(0).max(1);
+var anchorUrlSchema = z.string().max(2048);
+var anchorLocaleSchema = z.string().max(35);
+var anchorSelectorSchema = z.string().max(4e3);
+var anchorIdSchema = z.string().max(256);
+var commentAnchorContextSchema = z.object({
+  url: anchorUrlSchema,
+  locale: anchorLocaleSchema.nullish()
+}).describe("CommentAnchorContext");
+var commentAnchorNoneSchema = z.object({
+  type: z.literal("none"),
+  context: commentAnchorContextSchema.optional()
+}).describe("CommentAnchorNone");
+var commentAnchorElementSchema = z.object({
+  type: z.literal("element"),
+  semanticSelector: anchorSelectorSchema.optional(),
+  selector: anchorSelectorSchema,
+  nthOfTypePath: anchorSelectorSchema,
+  source: z.object({
+    filePath: z.string().max(1024),
+    componentChain: z.array(anchorIdSchema).max(50),
+    line: z.number().int().optional(),
+    col: z.number().int().optional()
+  }).optional(),
+  listKey: anchorIdSchema.optional(),
+  tagName: z.string().max(64),
+  textPreview: z.string().max(200),
+  quote: z.object({
+    exact: z.string().max(2e3),
+    prefix: z.string().max(80),
+    suffix: z.string().max(80)
+  }).optional(),
+  offset: z.object({ x: unitIntervalSchema, y: unitIntervalSchema }),
+  context: commentAnchorContextSchema.optional()
+}).describe("CommentAnchorElement");
+var commentAnchorCanvasSchema = z.object({
+  type: z.literal("canvas"),
+  nodeId: anchorIdSchema,
+  layerId: anchorIdSchema.optional(),
+  point: z.object({ x: z.number(), y: z.number() }),
+  world: z.object({ x: z.number(), y: z.number() }).optional().describe("Set only for free-floating pins that sit on no node.")
+}).describe("CommentAnchorCanvas");
+var commentAnchorPointSchema = z.object({
+  type: z.literal("point"),
+  page: z.number().int().min(0).optional(),
+  x: unitIntervalSchema,
+  y: unitIntervalSchema
+}).describe("CommentAnchorPoint");
+var commentAnchorSchema = z.discriminatedUnion("type", [
+  commentAnchorNoneSchema,
+  commentAnchorElementSchema,
+  commentAnchorCanvasSchema,
+  commentAnchorPointSchema
+]).describe("CommentAnchor");
+var commentTargetSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("file"),
+    fileId: z.uuid(),
+    folderId: z.uuid().optional().describe(
+      "The artifact folder the comment was left from; the file must be one of its pages."
+    )
+  }),
+  z.object({
+    kind: z.literal("sitePage"),
+    siteId: z.uuid(),
+    url: anchorUrlSchema,
+    locale: anchorLocaleSchema.nullish(),
+    routePatternHint: anchorUrlSchema.optional(),
+    via: z.object({ fileId: z.uuid(), shareId: z.string() }).optional().describe(
+      "Set when the site preview is embedded in an artifact or canvas."
+    )
+  }),
+  z.object({ kind: z.literal("order"), orderId: z.uuid() }),
+  z.object({ kind: z.literal("asset"), assetId: z.uuid() })
+]).describe("CommentTarget");
+z.enum([
+  "artifact",
+  "canvas",
+  "image",
+  "markdown",
+  "pdf",
+  "file",
+  "websiteBuilder",
+  "embeddedPreview",
+  "orders",
+  "assets"
+]).describe("CommentSurface");
+var commentAuthorSchema = z.object({
+  id: z.string(),
+  name: z.string(),
+  avatarUrl: z.string().nullable(),
+  deleted: z.boolean()
+}).describe("CommentAuthor");
+var commentSchema = z.object({
+  id: z.string(),
+  threadId: z.string(),
+  authorUserId: z.string(),
+  source: commentSourceSchema,
+  body: z.string().describe("Empty when the comment is deleted."),
+  createdAt: z.iso.datetime(),
+  editedAt: z.iso.datetime().nullable(),
+  deletedAt: z.iso.datetime().nullable()
+}).describe("Comment");
+var commentReactionSchema = z.object({
+  commentId: z.string(),
+  userId: z.string(),
+  emoji: z.string(),
+  createdAt: z.iso.datetime()
+}).describe("CommentReaction");
+var commentThreadTargetSchema = z.object({
+  fileId: z.string().optional(),
+  siteId: z.string().optional(),
+  path: z.string().optional(),
+  orderId: z.string().optional(),
+  assetId: z.string().optional()
+}).describe("CommentThreadTarget");
+var commentThreadSchema = z.object({
+  id: z.string(),
+  projectId: z.string(),
+  target: commentThreadTargetSchema,
+  viaFileId: z.string().nullable(),
+  viaFileName: z.string().nullable(),
+  anchor: commentAnchorSchema,
+  resolvedAt: z.iso.datetime().nullable(),
+  resolvedByUserId: z.string().nullable(),
+  resolvedSource: commentSourceSchema.nullable(),
+  createdAt: z.iso.datetime(),
+  updatedAt: z.iso.datetime(),
+  deletedAt: z.iso.datetime().nullable()
+}).describe("CommentThread");
+var commentViewerSchema = z.object({
+  userId: z.string().nullable().describe("The signed-in caller; null for anonymous viewers."),
+  isMember: z.boolean().describe("Holds a role on the project, so object mentions are on."),
+  canComment: z.boolean(),
+  canModerate: z.boolean().describe("A workspace admin, who can delete anyone's comment (D-10).")
+}).describe("CommentViewer");
+z.object({
+  threads: z.array(commentThreadSchema),
+  comments: z.array(commentSchema),
+  reactions: z.array(commentReactionSchema),
+  authors: z.array(commentAuthorSchema),
+  viewer: commentViewerSchema
+}).describe("CommentThreadBundle");
+z.object({
+  id: z.uuid(),
+  target: commentTargetSchema,
+  anchor: commentAnchorSchema,
+  body: z.object({ id: z.uuid(), body: z.string() })
+}).describe("CreateCommentThreadBody");
+z.object({
+  resolved: z.boolean().optional(),
+  path: z.string().optional().describe("Moves the thread to another page and resets its anchor."),
+  anchor: commentAnchorSchema.optional()
+}).refine(
+  (patch) => {
+    return patch.resolved !== void 0 || patch.path !== void 0 || patch.anchor !== void 0;
+  },
+  { message: "Pass at least one of resolved, path or anchor." }
+).refine((patch) => patch.path === void 0 || patch.anchor === void 0, {
+  message: "Move a thread or re-anchor it, not both at once."
+}).describe("UpdateCommentThreadBody");
+z.object({
+  id: z.uuid(),
+  body: z.string()
+}).describe("CreateCommentBody");
+z.object({
+  body: z.string()
+}).describe("UpdateCommentBody");
+var commentThreadStatusSchema = z.enum(["open", "resolved"]).describe("CommentThreadStatus");
+z.object({
+  fileId: z.uuid().optional(),
+  folderId: z.uuid().optional().describe("Artifact folder: every page under it."),
+  siteId: z.uuid().optional(),
+  path: z.string().optional().describe(
+    "A concrete page path or a route pattern, normalized the same way a new comment's URL is."
+  ),
+  locale: z.string().optional().describe("The locale prefixed to `path`, which is stripped first."),
+  viaFileId: z.uuid().optional(),
+  orderId: z.uuid().optional(),
+  assetId: z.uuid().optional(),
+  status: commentThreadStatusSchema.optional()
+}).refine(
+  (query) => {
+    return [
+      query.fileId,
+      query.folderId,
+      query.siteId,
+      query.orderId,
+      query.assetId
+    ].filter((value) => value !== void 0).length === 1;
+  },
+  {
+    message: "Exactly one of fileId, folderId, siteId, orderId or assetId is required."
+  }
+).refine(
+  (query) => {
+    return query.siteId !== void 0 || query.path === void 0 && query.locale === void 0 && query.viaFileId === void 0;
+  },
+  { message: "path, locale and viaFileId require siteId." }
+).describe("ListCommentThreadsQuery");
+z.object({
+  kind: z.enum(["artifact", "miniapp", "commentsScreen", "gone"]),
+  url: z.string().optional(),
+  projectId: z.string().optional().describe(
+    "The thread's project, set for miniapp and commentsScreen locations so the dashboard can build the project route."
+  ),
+  miniappId: z.string().optional(),
+  miniappRoute: z.string().optional()
+}).describe("CommentThreadLocation");
+z.object({
+  target: commentTargetSchema,
+  contentType: z.string(),
+  contentLength: z.number().int().positive()
+}).describe("PresignCommentAttachmentBody");
+z.object({
+  objectKey: z.string(),
+  presignedPutUrl: z.string(),
+  publicUrl: z.string()
+}).describe("PresignCommentAttachmentResponse");
+z.object({
+  target: commentTargetSchema,
+  objectKey: z.string()
+}).describe("CommitCommentAttachmentBody");
+z.object({
+  publicUrl: z.string()
+}).describe("CommitCommentAttachmentResponse");
+z.object({
+  column: z.enum([
+    "page",
+    "excerpt",
+    "author",
+    "created",
+    "lastActivity",
+    "replies",
+    "status",
+    "from"
+  ]),
+  direction: z.enum(["asc", "desc"])
+}).describe("CommentSiteThreadSort");
+z.object({
+  threads: z.array(commentThreadSchema),
+  comments: z.array(commentSchema),
+  reactions: z.array(commentReactionSchema),
+  authors: z.array(commentAuthorSchema),
+  orphanedPaths: z.array(z.string()).nullable().describe(
+    "Paths on this page with no current site page; null when the site's pages couldn't be read."
+  ),
+  nextCursor: z.string().nullable()
+}).describe("CommentSiteThreadPage");
+z.object({
+  id: z.string(),
+  name: z.string(),
+  avatarUrl: z.string().nullable()
+}).describe("CommentMentionPerson");
+var mentionableDisplaySchema = z.object({
+  label: z.string(),
+  imageUrl: z.string().optional()
+}).describe("MentionableDisplay");
+z.discriminatedUnion("state", [
+  z.object({ state: z.literal("ok"), display: mentionableDisplaySchema }),
+  z.object({
+    state: z.literal("forbidden"),
+    category: z.string().describe(
+      `A category label such as "File", never the object's title.`
+    )
+  })
+]).describe("MentionableResolution");
+var commentThreadTargetSummarySchema = z.object({
+  kind: z.enum(["file", "sitePage", "order", "asset"]),
+  fileId: z.string().optional(),
+  fileName: z.string().optional(),
+  filePath: z.string().optional().describe("The file's path from its project's root folder."),
+  artifactFolderId: z.string().optional().describe("Set when the file is a page of an artifact."),
+  fileDeleted: z.boolean().optional().describe("True when the commented file no longer exists."),
+  siteId: z.string().optional(),
+  path: z.string().optional().describe("The site route pattern."),
+  url: z.string().optional().describe("The concrete page URL the comment was left on."),
+  orderId: z.string().optional(),
+  assetId: z.string().optional()
+}).describe("CommentThreadTargetSummary");
+z.object({
+  thread: commentThreadSchema,
+  comments: z.array(commentSchema),
+  reactions: z.array(commentReactionSchema),
+  authors: z.array(commentAuthorSchema),
+  target: commentThreadTargetSummarySchema
+}).describe("CommentThreadDetail");
+
+var SELECT_MODE_SELECTABLE_ATTRIBUTE = "data-replo-selectable";
+var SELECT_MODE_SELECTABLE_PAYLOAD_ATTRIBUTE = "data-replo-selectable-payload";
+var displayModeSchema = z.enum(["browse", "selection", "comment"]).describe("DisplayMode");
+var selectModeInlineTextStatusSchema = z.enum(["editable", "dynamic", "translated"]).nullable().describe("SelectModeInlineTextStatus");
+var selectModeTextMetricsSchema = z.object({
+  tightWidth: z.number(),
+  lineCount: z.number(),
+  lineHeight: z.number()
+}).describe("SelectModeTextMetrics");
+var selectModeClickPositionSchema = z.object({
+  x: z.number(),
+  y: z.number()
+}).describe("SelectModeClickPosition");
+var selectModeSourceLocationSchema = z.object({
+  filePath: z.string(),
+  lineNumber: z.number(),
+  columnNumber: z.number().optional(),
+  componentName: z.string().optional()
+}).describe("SelectModeSourceLocation");
+var selectModeFiberChainEntrySchema = z.object({
+  sourceLocation: selectModeSourceLocationSchema,
+  tagName: z.string().optional(),
+  componentName: z.string().optional(),
+  props: z.record(z.string(), z.unknown()).optional()
+}).describe("SelectModeFiberChainEntry");
+var selectModeBoundingRectSchema = z.object({
+  x: z.number(),
+  y: z.number(),
+  left: z.number(),
+  top: z.number(),
+  right: z.number(),
+  bottom: z.number(),
+  width: z.number(),
+  height: z.number()
+}).describe("SelectModeBoundingRect");
+var selectModeHoverRectSchema = selectModeBoundingRectSchema.extend({ isSection: z.boolean().optional() }).describe("SelectModeHoverRect");
+var selectModeSelectionRectSchema = z.object({
+  id: z.string(),
+  rect: selectModeBoundingRectSchema
+}).describe("SelectModeSelectionRect");
+var selectModeStyleAtRuleSchema = z.object({
+  type: z.string(),
+  text: z.string()
+}).describe("SelectModeStyleAtRule");
+var selectModeStyleVariantSchema = z.object({
+  atRules: z.array(selectModeStyleAtRuleSchema),
+  pseudo: z.string().nullable()
+}).describe("SelectModeStyleVariant");
+var selectModeDefinedStyleSchema = z.object({
+  property: z.string(),
+  variant: selectModeStyleVariantSchema.nullable(),
+  className: z.string().nullable(),
+  raw: z.string(),
+  resolved: z.string()
+}).describe("SelectModeDefinedStyle");
+function transformRect({
+  rect,
+  offset,
+  scale = 1
+}) {
+  return {
+    x: rect.x * scale + offset.left,
+    y: rect.y * scale + offset.top,
+    left: rect.left * scale + offset.left,
+    right: rect.right * scale + offset.left,
+    top: rect.top * scale + offset.top,
+    bottom: rect.bottom * scale + offset.top,
+    width: rect.width * scale,
+    height: rect.height * scale
+  };
+}
+function transformPoint({
+  point,
+  offset,
+  scale = 1
+}) {
+  return {
+    x: point.x * scale + offset.left,
+    y: point.y * scale + offset.top
+  };
+}
+function getIframeOffset(iframe) {
+  if (!iframe) {
+    return { left: 0, top: 0 };
+  }
+  const iframeRect = iframe.getBoundingClientRect();
+  return { left: iframeRect.left, top: iframeRect.top };
+}
+var selectModeImageScopeSchema = z.discriminatedUnion("kind", [
+  z.object({ kind: z.literal("all") }),
+  z.object({ kind: z.literal("media"), media: z.string() })
+]).describe("SelectModeImageScope");
+var selectModeImageSourceSchema = z.object({
+  srcSet: z.string(),
+  sizes: z.string(),
+  media: z.string(),
+  type: z.string(),
+  previewUrl: z.string().nullable()
+}).describe("SelectModeImageSource");
+var selectModeImageSchema = z.object({
+  src: z.string(),
+  currentSrc: z.string(),
+  srcSet: z.string(),
+  sizes: z.string(),
+  previewUrl: z.string().nullable(),
+  sources: z.array(selectModeImageSourceSchema)
+}).describe("SelectModeImage");
+var selectModeVideoSchema = z.object({
+  src: z.string(),
+  currentSrc: z.string()
+}).describe("SelectModeVideo");
+var selectedElementSchema = z.object({
+  kind: z.literal("react-element"),
+  selector: z.string(),
+  section: z.object({ selector: z.string() }).optional(),
+  tagName: z.string(),
+  elementType: z.string(),
+  textContent: z.string().nullable(),
+  sectionLabel: z.string().optional(),
+  rect: selectModeBoundingRectSchema,
+  textMetrics: selectModeTextMetricsSchema.nullable(),
+  outerHTML: z.string(),
+  image: selectModeImageSchema.optional(),
+  video: selectModeVideoSchema.optional(),
+  definedStyles: z.array(selectModeDefinedStyleSchema).default([]),
+  authoredStyles: z.record(z.string(), z.string()).default({}).describe(
+    "Authored CSS value of the winning declaration per control property, custom properties expanded (e.g. 1.5rem for text-2xl at a wide viewport)."
+  ),
+  inheritedStyles: z.record(z.string(), z.string()).default({}),
+  clickPosition: selectModeClickPositionSchema,
+  sourceLocation: selectModeSourceLocationSchema.optional(),
+  fiberChain: z.array(selectModeFiberChainEntrySchema).default([]),
+  siblingSelectors: z.array(z.string()).default([]),
+  anchor: commentAnchorElementSchema.optional().describe(
+    "The comments capture of the same element, so a selection can become a comment anchor."
+  )
+}).describe("SelectedElement");
+var selectablePlanDataSchema = z.object({
+  kind: z.literal("plan"),
+  planId: z.string(),
+  label: z.string(),
+  rect: selectModeBoundingRectSchema
+}).describe("SelectablePlanData");
+var selectablePlanPayloadSchema = selectablePlanDataSchema.omit({ rect: true }).describe("SelectablePlanPayload");
+var selectableDataPayloadSchema = z.discriminatedUnion("kind", [selectablePlanPayloadSchema]).describe("SelectableDataPayload");
+var selectableDataSchema = z.discriminatedUnion("kind", [selectedElementSchema, selectablePlanDataSchema]).describe("SelectableData");
+function isSelectedSection(data) {
+  return data.kind === "react-element" && data.selector === data.section?.selector;
+}
+function transformSelectedElement({
+  element,
+  offset,
+  scale = 1
+}) {
+  return {
+    ...element,
+    rect: transformRect({ rect: element.rect, offset, scale }),
+    clickPosition: transformPoint({
+      point: element.clickPosition,
+      offset,
+      scale
+    })
+  };
+}
+function transformSelectableData({
+  data,
+  offset
+}) {
+  return exhaustiveSwitch(
+    data,
+    "kind"
+  )({
+    "react-element": (element) => transformSelectedElement({ element, offset }),
+    plan: (plan) => ({
+      ...plan,
+      rect: transformRect({ rect: plan.rect, offset })
+    })
+  });
+}
+function readSelectablePayload(rawPayload) {
+  if (!rawPayload) {
+    return null;
+  }
+  const parsedPayload = parseJsonOrNull(rawPayload);
+  if (!parsedPayload) {
+    return null;
+  }
+  return parseSchemaOrNull(parsedPayload, selectableDataPayloadSchema);
+}
+var selectModeOptimisticUpdatePayloadSchema = z.discriminatedUnion("kind", [
+  z.object({
+    kind: z.literal("image"),
+    image: selectModeImageSchema
+  }),
+  z.object({
+    kind: z.literal("css"),
+    fontSource: z.enum(["google", "site"]).optional(),
+    property: z.string(),
+    value: z.string().nullable()
+  }),
+  z.object({
+    kind: z.literal("content"),
+    innerHTML: z.string()
+  }),
+  z.object({
+    kind: z.literal("attribute"),
+    name: z.string(),
+    value: z.string()
+  })
+]).describe("SelectModeOptimisticUpdatePayload");
+var selectModeTiptapActiveMarksSchema = z.object({
+  bold: z.boolean(),
+  italic: z.boolean(),
+  underline: z.boolean(),
+  strike: z.boolean()
+}).describe("SelectModeTiptapActiveMarks");
+var selectModeFormatCommandSchema = z.enum(["toggleBold", "toggleItalic", "toggleUnderline", "toggleStrike"]).describe("SelectModeFormatCommand");
+var selectModeSelectionTypeSchema = z.enum(["none", "element", "area", "drag"]).describe("SelectModeSelectionType");
+var selectModeSelectionSchema = z.discriminatedUnion("type", [
+  z.object({ type: z.literal("none") }),
+  z.object({
+    type: z.literal("element"),
+    data: selectableDataSchema
+  }),
+  z.object({
+    type: z.literal("area"),
+    rect: selectModeBoundingRectSchema,
+    items: z.array(selectableDataSchema)
+  }),
+  z.object({
+    type: z.literal("drag"),
+    dragRect: selectModeBoundingRectSchema,
+    selectionRects: z.array(selectModeSelectionRectSchema)
+  })
+]).describe("SelectModeSelection");
+
+export { SELECT_MODE_SELECTABLE_ATTRIBUTE, SELECT_MODE_SELECTABLE_PAYLOAD_ATTRIBUTE, commentAnchorElementSchema, commentAnchorSchema, displayModeSchema, getIframeOffset, isSelectedSection, readSelectablePayload, selectModeBoundingRectSchema, selectModeClickPositionSchema, selectModeDefinedStyleSchema, selectModeFiberChainEntrySchema, selectModeFormatCommandSchema, selectModeHoverRectSchema, selectModeImageSchema, selectModeImageScopeSchema, selectModeImageSourceSchema, selectModeInlineTextStatusSchema, selectModeOptimisticUpdatePayloadSchema, selectModeSelectionRectSchema, selectModeSelectionSchema, selectModeSelectionTypeSchema, selectModeSourceLocationSchema, selectModeStyleAtRuleSchema, selectModeStyleVariantSchema, selectModeTextMetricsSchema, selectModeTiptapActiveMarksSchema, selectModeVideoSchema, selectableDataPayloadSchema, selectableDataSchema, selectablePlanDataSchema, selectablePlanPayloadSchema, selectedElementSchema, transformPoint, transformRect, transformSelectableData, transformSelectedElement };

package/comments-overlay/CommentsOverlayMount.d.ts

@@ -0,0 +1 @@
+export declare function CommentsOverlayMount(): null;

package/comments-overlay/CommentsOverlayMount.js

@@ -0,0 +1,44 @@
+"use client";
+if (typeof window !== "undefined") {
+  void Promise.all([
+    import("./bridge"),
+    import("../select-mode/symbolicate")
+  ]).then(([bridge, symbolication]) => {
+    const symbolicate = async (locations) => {
+      const lined = locations.flatMap((location, index) => {
+        return location.line === void 0 ? [] : [
+          {
+            index,
+            location: {
+              filePath: location.filePath,
+              lineNumber: location.line,
+              columnNumber: location.col
+            }
+          }
+        ];
+      });
+      const resolved = await symbolication.symbolicateSourceLocations(
+        lined.map((entry) => entry.location)
+      );
+      const result = [...locations];
+      for (const [position, { index }] of lined.entries()) {
+        const location = resolved[position];
+        if (location) {
+          result[index] = {
+            filePath: location.filePath,
+            line: location.lineNumber,
+            col: location.columnNumber
+          };
+        }
+      }
+      return result;
+    };
+    bridge.startCommentsOverlay({ symbolicate });
+  });
+}
+function CommentsOverlayMount() {
+  return null;
+}
+export {
+  CommentsOverlayMount
+};

package/comments-overlay/LICENSE-THIRD-PARTY.md

@@ -0,0 +1,45 @@
+# Third-party notices
+
+Files under `comments-overlay/vendor/` are ported from the projects below. Each ported file carries a header naming its source.
+
+## react-grab
+
+Source: https://github.com/aidenybai/react-grab at commit `ea4bbec` (`packages/react-grab/src`). Its selector search is modelled on `@medv/finder` (MIT).
+
+```
+MIT License
+
+Copyright (c) 2025 Aiden Bai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## bippy
+
+Source: https://github.com/aidenybai/bippy at tag `bippy@0.7.2` (the version react-grab `ea4bbec` depends on), `packages/bippy/src`.
+
+```
+Copyright 2024-present Aiden Bai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+```

package/comments-overlay/bridge.d.ts

@@ -0,0 +1,11 @@
+import type { SourceSymbolicator } from "./capture";
+/**
+ * Boots the comments overlay inside an embedded frame and connects it to the
+ * host over its own RPC channel. Inbound messages must come from the parent
+ * window on an allowed origin (C-13); outbound ones go only to that verified
+ * origin, except the payload-free `overlayReady` announcement.
+ */
+export declare function startCommentsOverlay({ symbolicate, }: {
+    /** Maps compiled source locations to original files (Next's dev endpoint). */
+    symbolicate: SourceSymbolicator;
+}): () => void;