@seed-hypermedia/client 0.0.41 → 0.0.42

package/dist/{chunk-2E3HWHST.mjs → chunk-XHVG24AF.mjs}

@@ -28,7 +28,12 @@ var unpackedHmIdSchema = z.object({
   targetDocPath: z.array(z.string()).nullable().optional()
 });
 var HMBlockChildrenTypeSchema = z.union([z.literal("Group"), z.literal("Ordered"), z.literal("Unordered"), z.literal("Blockquote"), z.literal("Grid")]).nullable();
-var HMEmbedViewSchema = z.union([z.literal("Content"), z.literal("Card"), z.literal("Comments")]);
+var HMEmbedViewSchema = z.union([
+  z.literal("Content"),
+  z.literal("Card"),
+  z.literal("Comments"),
+  z.literal("Link")
+]);
 var HMQueryStyleSchema = z.union([z.literal("Card"), z.literal("List")]);
 var baseAnnotationProperties = {
   starts: z.array(z.number()),
@@ -538,11 +543,16 @@ var HMAccountContactsRequestSchema = z.object({
   // account UID
   output: z.array(HMContactRecordSchema)
 });
+var QuotingRangeSchema = z.object({
+  start: z.number(),
+  end: z.number()
+});
 var HMCommentDraftSchema = z.object({
   blocks: z.array(HMBlockNodeSchema),
   targetDocId: z.string().optional(),
   replyCommentId: z.string().optional(),
   quotingBlockId: z.string().optional(),
+  quotingRange: QuotingRangeSchema.optional(),
   context: z.enum(["accessory", "feed", "document-content"]).optional(),
   lastUpdateTime: z.number().optional()
 });
@@ -551,6 +561,7 @@ var HMListedCommentDraftSchema = z.object({
   targetDocId: z.string(),
   replyCommentId: z.string().optional(),
   quotingBlockId: z.string().optional(),
+  quotingRange: QuotingRangeSchema.optional(),
   context: z.enum(["accessory", "feed", "document-content"]).optional(),
   lastUpdateTime: z.number()
 });
@@ -1348,6 +1359,7 @@ export {
   HMContactSubscribeSchema,
   HMContactRecordSchema,
   HMAccountContactsRequestSchema,
+  QuotingRangeSchema,
   HMCommentDraftSchema,
   HMListedCommentDraftSchema,
   HMHostConfigSchema,

package/dist/comment.d.ts

@@ -13,11 +13,26 @@ type PrepareAttachments = (binaries: Uint8Array[]) => Promise<{
     blobs: CommentAttachmentBlob[];
     resultCIDs: string[];
 }>;
+/**
+ * Target of a quoted block fragment in a comment. The optional `range`
+ * holds zero-based Unicode codepoint offsets within the block's text.
+ * When `range` is omitted, the comment quotes the whole block.
+ */
+export type QuotingTarget = {
+    blockId: string;
+    range?: {
+        start: number;
+        end: number;
+    };
+};
 type CreateCommentBaseInput = {
     docId: UnpackedHypermediaId;
     docVersion: string;
     replyCommentVersion?: string | null;
     rootReplyCommentVersion?: string | null;
+    /** Structured quote target (preferred). */
+    quoting?: QuotingTarget;
+    /** Deprecated: pass `quoting: {blockId}` instead. Still honored for back-compat. */
     quotingBlockId?: string;
     visibility?: 'Private' | '';
 };

package/dist/hm-types.d.ts

@@ -77,7 +77,7 @@ export declare const unpackedHmIdSchema: z.ZodObject<{
 export type UnpackedHypermediaId = z.infer<typeof unpackedHmIdSchema>;
 export declare const HMBlockChildrenTypeSchema: z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Group">, z.ZodLiteral<"Ordered">, z.ZodLiteral<"Unordered">, z.ZodLiteral<"Blockquote">, z.ZodLiteral<"Grid">]>>;
 export type HMBlockChildrenType = z.infer<typeof HMBlockChildrenTypeSchema>;
-export declare const HMEmbedViewSchema: z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">]>;
+export declare const HMEmbedViewSchema: z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">, z.ZodLiteral<"Link">]>;
 export type HMEmbedView = z.infer<typeof HMEmbedViewSchema>;
 export declare const HMQueryStyleSchema: z.ZodUnion<[z.ZodLiteral<"Card">, z.ZodLiteral<"List">]>;
 export type HMQueryStyle = z.infer<typeof HMQueryStyleSchema>;
@@ -2510,17 +2510,17 @@ export declare const HMBlockButtonSchema: z.ZodObject<{
 export declare const HMBlockEmbedSchema: z.ZodObject<{
     link: z.ZodString;
     attributes: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">]>>;
+        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">, z.ZodLiteral<"Link">]>>;
         childrenType: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Group">, z.ZodLiteral<"Ordered">, z.ZodLiteral<"Unordered">, z.ZodLiteral<"Blockquote">, z.ZodLiteral<"Grid">]>>>;
         columnCount: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }>>>;
     id: z.ZodString;
     revision: z.ZodOptional<z.ZodString>;
@@ -2534,7 +2534,7 @@ export declare const HMBlockEmbedSchema: z.ZodObject<{
     attributes: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     };
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -2546,7 +2546,7 @@ export declare const HMBlockEmbedSchema: z.ZodObject<{
     attributes?: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     } | undefined;
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -7403,17 +7403,17 @@ export declare const HMBlockKnownSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
 }>, z.ZodObject<{
     link: z.ZodString;
     attributes: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">]>>;
+        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">, z.ZodLiteral<"Link">]>>;
         childrenType: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Group">, z.ZodLiteral<"Ordered">, z.ZodLiteral<"Unordered">, z.ZodLiteral<"Blockquote">, z.ZodLiteral<"Grid">]>>>;
         columnCount: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }>>>;
     id: z.ZodString;
     revision: z.ZodOptional<z.ZodString>;
@@ -7427,7 +7427,7 @@ export declare const HMBlockKnownSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     attributes: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     };
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -7439,7 +7439,7 @@ export declare const HMBlockKnownSchema: z.ZodDiscriminatedUnion<"type", [z.ZodO
     attributes?: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     } | undefined;
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -9310,17 +9310,17 @@ export declare const HMBlockSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"type",
 }>, z.ZodObject<{
     link: z.ZodString;
     attributes: z.ZodDefault<z.ZodOptional<z.ZodObject<{
-        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">]>>;
+        view: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<"Content">, z.ZodLiteral<"Card">, z.ZodLiteral<"Comments">, z.ZodLiteral<"Link">]>>;
         childrenType: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodLiteral<"Group">, z.ZodLiteral<"Ordered">, z.ZodLiteral<"Unordered">, z.ZodLiteral<"Blockquote">, z.ZodLiteral<"Grid">]>>>;
         columnCount: z.ZodOptional<z.ZodNumber>;
     }, "strip", z.ZodTypeAny, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }, {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     }>>>;
     id: z.ZodString;
     revision: z.ZodOptional<z.ZodString>;
@@ -9334,7 +9334,7 @@ export declare const HMBlockSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"type",
     attributes: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     };
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -9346,7 +9346,7 @@ export declare const HMBlockSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"type",
     attributes?: {
         childrenType?: "Group" | "Ordered" | "Unordered" | "Blockquote" | "Grid" | null | undefined;
         columnCount?: number | undefined;
-        view?: "Content" | "Card" | "Comments" | undefined;
+        view?: "Content" | "Card" | "Comments" | "Link" | undefined;
     } | undefined;
     text?: "" | undefined;
     annotations?: never[] | undefined;
@@ -12868,11 +12868,32 @@ export type HMExistingDraft = {
     id: string;
     metadata?: HMMetadata;
 };
+/** Codepoint offsets within a quoted block. */
+export declare const QuotingRangeSchema: z.ZodObject<{
+    start: z.ZodNumber;
+    end: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    start: number;
+    end: number;
+}, {
+    start: number;
+    end: number;
+}>;
 export declare const HMCommentDraftSchema: z.ZodObject<{
     blocks: z.ZodArray<z.ZodType<HMBlockNode, z.ZodTypeDef, HMBlockNode>, "many">;
     targetDocId: z.ZodOptional<z.ZodString>;
     replyCommentId: z.ZodOptional<z.ZodString>;
     quotingBlockId: z.ZodOptional<z.ZodString>;
+    quotingRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>>;
     context: z.ZodOptional<z.ZodEnum<["accessory", "feed", "document-content"]>>;
     lastUpdateTime: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
@@ -12880,6 +12901,10 @@ export declare const HMCommentDraftSchema: z.ZodObject<{
     targetDocId?: string | undefined;
     replyCommentId?: string | undefined;
     quotingBlockId?: string | undefined;
+    quotingRange?: {
+        start: number;
+        end: number;
+    } | undefined;
     context?: "accessory" | "feed" | "document-content" | undefined;
     lastUpdateTime?: number | undefined;
 }, {
@@ -12887,6 +12912,10 @@ export declare const HMCommentDraftSchema: z.ZodObject<{
     targetDocId?: string | undefined;
     replyCommentId?: string | undefined;
     quotingBlockId?: string | undefined;
+    quotingRange?: {
+        start: number;
+        end: number;
+    } | undefined;
     context?: "accessory" | "feed" | "document-content" | undefined;
     lastUpdateTime?: number | undefined;
 }>;
@@ -12896,6 +12925,16 @@ export declare const HMListedCommentDraftSchema: z.ZodObject<{
     targetDocId: z.ZodString;
     replyCommentId: z.ZodOptional<z.ZodString>;
     quotingBlockId: z.ZodOptional<z.ZodString>;
+    quotingRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodNumber;
+        end: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        start: number;
+        end: number;
+    }, {
+        start: number;
+        end: number;
+    }>>;
     context: z.ZodOptional<z.ZodEnum<["accessory", "feed", "document-content"]>>;
     lastUpdateTime: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
@@ -12904,6 +12943,10 @@ export declare const HMListedCommentDraftSchema: z.ZodObject<{
     lastUpdateTime: number;
     replyCommentId?: string | undefined;
     quotingBlockId?: string | undefined;
+    quotingRange?: {
+        start: number;
+        end: number;
+    } | undefined;
     context?: "accessory" | "feed" | "document-content" | undefined;
 }, {
     id: string;
@@ -12911,6 +12954,10 @@ export declare const HMListedCommentDraftSchema: z.ZodObject<{
     lastUpdateTime: number;
     replyCommentId?: string | undefined;
     quotingBlockId?: string | undefined;
+    quotingRange?: {
+        start: number;
+        end: number;
+    } | undefined;
     context?: "accessory" | "feed" | "document-content" | undefined;
 }>;
 export type HMListedCommentDraft = z.infer<typeof HMListedCommentDraftSchema>;

package/dist/hm-types.mjs

@@ -154,6 +154,7 @@ import {
   ItalicAnnotationSchema,
   LinkAnnotationSchema,
   ParsedFragmentSchema,
+  QuotingRangeSchema,
   StrikeAnnotationSchema,
   TextColorAnnotationSchema,
   TextFamilyAnnotationSchema,
@@ -176,7 +177,7 @@ import {
   toNumber,
   unpackHmId,
   unpackedHmIdSchema
-} from "./chunk-2E3HWHST.mjs";
+} from "./chunk-XHVG24AF.mjs";
 export {
   BackgroundColorAnnotationSchema,
   BlockRangeSchema,
@@ -333,6 +334,7 @@ export {
   ItalicAnnotationSchema,
   LinkAnnotationSchema,
   ParsedFragmentSchema,
+  QuotingRangeSchema,
   StrikeAnnotationSchema,
   TextColorAnnotationSchema,
   TextFamilyAnnotationSchema,

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export type { CreateChangeOpsInput, CreateDocumentChangeFromOpsInput, CreateDocu
 export { createSeedClient } from './client';
 export type { PublishDocumentInput, SeedClient, SeedClientOptions } from './client';
 export { commentRecordIdFromBlob, createComment, deleteComment, updateComment } from './comment';
-export type { CommentAttachmentBlob, CreateCommentInput, DeleteCommentInput, UpdateCommentInput } from './comment';
+export type { CommentAttachmentBlob, CreateCommentInput, DeleteCommentInput, QuotingTarget, UpdateCommentInput, } from './comment';
 export { contactRecordIdFromBlob, createContact, deleteContact, updateContact } from './contact';
 export type { CreateContactInput, CreateContactResult, DeleteContactInput, UpdateContactInput } from './contact';
 export { SeedClientError, SeedNetworkError, SeedValidationError } from './errors';

package/dist/index.mjs

@@ -17,7 +17,7 @@ import {
   serializeBlockRange,
   toNumber,
   unpackHmId
-} from "./chunk-2E3HWHST.mjs";
+} from "./chunk-XHVG24AF.mjs";
 
 // src/capability.ts
 import { encode as cborEncode2 } from "@ipld/dag-cbor";
@@ -659,6 +659,16 @@ function isEmptyBlockNode(node) {
   if (block.type !== "Paragraph" && block.type !== "Heading") return false;
   return !block.text || block.text.trim() === "";
 }
+function resolveQuotingTarget(input) {
+  if (input.quoting) {
+    if (input.quoting.range && input.quoting.range.start === input.quoting.range.end) {
+      return { blockId: input.quoting.blockId };
+    }
+    return input.quoting;
+  }
+  if (input.quotingBlockId) return { blockId: input.quotingBlockId };
+  return void 0;
+}
 function annotationsToPublishable(annotations) {
   validateExclusiveAnnotations(annotations);
   return annotations.map((annotation) => {
@@ -892,7 +902,15 @@ function generateBlockId(length = 8) {
   return result;
 }
 function wrapQuotedContent(content, input) {
-  if (!input.quotingBlockId) return content;
+  const quoting = resolveQuotingTarget(input);
+  if (!quoting) return content;
+  const link = packHmId({
+    ...input.docId,
+    blockRef: quoting.blockId,
+    blockRange: quoting.range ?? null,
+    version: input.docVersion,
+    latest: false
+  });
   return [
     {
       block: {
@@ -904,11 +922,7 @@ function wrapQuotedContent(content, input) {
           view: "Content"
         },
         annotations: [],
-        link: packHmId({
-          ...input.docId,
-          blockRef: input.quotingBlockId,
-          version: input.docVersion
-        })
+        link
       },
       children: content
     }
@@ -3607,7 +3621,7 @@ function editorBlockToHMBlock(editorBlock) {
   const blockType = toHMBlockType(editorBlock.type);
   if (!blockType) throw new Error("Unsupported block type " + editorBlock.type);
   let block = {
-    id: editorBlock.id,
+    id: normalizeEditorBlockId(editorBlock.id),
     type: blockType,
     attributes: {},
     text: "",
@@ -3822,6 +3836,17 @@ function flattenLeaves(content) {
   }
   return result;
 }
+function normalizeEditorBlockId(id) {
+  return id && id !== "empty" ? id : generateBlockId6();
+}
+function generateBlockId6(length = 8) {
+  const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  let result = "";
+  for (let i = 0; i < length; i++) {
+    result += characters.charAt(Math.floor(Math.random() * characters.length));
+  }
+  return result;
+}
 
 // src/hmblock-to-editorblock.ts
 function toEditorBlockType(hmBlockType) {
@@ -3943,6 +3968,27 @@ function hmBlockToEditorBlock(block) {
     return out;
   }
   while (i < blockText.length) {
+    const inlineEmbed = findInlineEmbedStartingAt(pos);
+    if (inlineEmbed) {
+      if (leaf) {
+        finishLeaf(textStart, i);
+        leaf = null;
+      }
+      if (inlineBlockContent) {
+        leaves.push(inlineBlockContent);
+        inlineBlockContent = null;
+      }
+      leaves.push({
+        type: "inline-embed",
+        styles: {},
+        link: inlineEmbed.link
+      });
+      skipToCodepoint(inlineEmbed.end);
+      textStart = i;
+      leafAnnotations.clear();
+      if (i >= blockText.length) return out;
+      continue;
+    }
     let ul = 1;
     let annotationsChanged = trackPosAnnotations(pos);
     let surrogate = isSurrogate(blockText, i);
@@ -4161,6 +4207,27 @@ function hmBlockToEditorBlock(block) {
     });
     return annotationsChanged;
   }
+  function findInlineEmbedStartingAt(pos2) {
+    var _a2, _b2;
+    const blockAnnotations = block.annotations;
+    if (!blockAnnotations) return null;
+    for (const annotation of blockAnnotations) {
+      const annotationData = annotation;
+      if (annotationData.type !== "Embed") continue;
+      const spanIndex = ((_a2 = annotationData.starts) == null ? void 0 : _a2.findIndex((start) => start === pos2)) ?? -1;
+      if (spanIndex === -1) continue;
+      const end = (_b2 = annotationData.ends) == null ? void 0 : _b2[spanIndex];
+      if (typeof end !== "number" || end <= pos2) continue;
+      return { link: annotationData.link || "", end };
+    }
+    return null;
+  }
+  function skipToCodepoint(end) {
+    while (pos < end && i < blockText.length) {
+      i += isSurrogate(blockText, i) ? 2 : 1;
+      pos++;
+    }
+  }
 }
 function annotationContains(annotation, pos) {
   let low = 0;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seed-hypermedia/client",
-  "version": "0.0.41",
+  "version": "0.0.42",
   "repository": {
     "type": "git",
     "url": "https://github.com/seed-hypermedia/seed",

package/src/index.ts

@@ -19,7 +19,13 @@ export type {
 export {createSeedClient} from './client'
 export type {PublishDocumentInput, SeedClient, SeedClientOptions} from './client'
 export {commentRecordIdFromBlob, createComment, deleteComment, updateComment} from './comment'
-export type {CommentAttachmentBlob, CreateCommentInput, DeleteCommentInput, UpdateCommentInput} from './comment'
+export type {
+  CommentAttachmentBlob,
+  CreateCommentInput,
+  DeleteCommentInput,
+  QuotingTarget,
+  UpdateCommentInput,
+} from './comment'
 export {contactRecordIdFromBlob, createContact, deleteContact, updateContact} from './contact'
 export type {CreateContactInput, CreateContactResult, DeleteContactInput, UpdateContactInput} from './contact'
 export {SeedClientError, SeedNetworkError, SeedValidationError} from './errors'