@seed-hypermedia/client 0.0.2 → 0.0.4

package/dist/blocks-to-markdown.d.ts

@@ -31,3 +31,30 @@ export declare function emitFrontmatter(metadata: HMMetadata): string;
  * as placeholder links (not resolved).
  */
 export declare function blocksToMarkdown(doc: HMDocument, options?: BlocksToMarkdownOptions): string;
+/**
+ * Convert a title string into a URL-safe slug.
+ *
+ * - Lowercases the string
+ * - Replaces non-alphanumeric characters with hyphens
+ * - Trims leading/trailing hyphens
+ * - Truncates to 60 characters
+ */
+export declare function slugify(title: string): string;
+/**
+ * Build a draft filename from a slug and nanoid.
+ * Format: `<slug>_<nanoid>.md` — human-readable + collision-safe.
+ * If the slug is empty, the filename is just `<nanoid>.md`.
+ */
+export declare function draftFilename(slug: string, id: string): string;
+/**
+ * Extract the draft ID (nanoid) from a draft filename.
+ *
+ * Handles both formats:
+ * - `<slug>_<nanoid>.md` → returns the nanoid part
+ * - `<nanoid>.md` → returns the nanoid (legacy/no-slug)
+ * - `<nanoid>.json` → returns the nanoid (legacy JSON)
+ */
+export declare function parseDraftFilename(filename: string): {
+    id: string;
+    ext: string;
+};

package/dist/{chunk-PPK3SKPV.mjs → chunk-YIND2WNJ.mjs}

@@ -21,7 +21,7 @@ var unpackedHmIdSchema = z.object({
   targetDocUid: z.string().nullable().optional(),
   targetDocPath: z.array(z.string()).nullable().optional()
 });
-var HMBlockChildrenTypeSchema = z.union([z.literal("Group"), z.literal("Ordered"), z.literal("Unordered"), z.literal("Blockquote")]).nullable();
+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 HMQueryStyleSchema = z.union([z.literal("Card"), z.literal("List")]);
 var baseAnnotationProperties = {
@@ -93,7 +93,8 @@ var textBlockProperties = {
   annotations: HMAnnotationsSchema
 };
 var parentBlockAttributes = {
-  childrenType: HMBlockChildrenTypeSchema.optional()
+  childrenType: HMBlockChildrenTypeSchema.optional(),
+  columnCount: z.number().optional()
 };
 var HMBlockParagraphSchema = z.object({
   type: z.literal("Paragraph"),
@@ -603,7 +604,11 @@ var HMDraftMetaBaseSchema = z.object({
   editUid: z.string().optional(),
   editPath: z.array(z.string()).optional(),
   metadata: HMDocumentMetadataSchema,
-  visibility: HMResourceVisibilitySchema.optional().default("PUBLIC")
+  visibility: HMResourceVisibilitySchema.optional().default("PUBLIC"),
+  // deps and navigation live in the index entry for .md drafts
+  // (for .json drafts they come from the content file for backwards compat)
+  deps: z.array(z.string().min(1)).default([]),
+  navigation: z.array(HMNavigationItemSchema).optional()
 });
 var draftLocationRefinement = (data) => data.editUid || data.locationUid;
 var HMDraftMetaSchema = HMDraftMetaBaseSchema.refine(draftLocationRefinement, {

package/dist/editor-types.d.ts

@@ -0,0 +1,157 @@
+import { HMBlockChildrenType } from './hm-types';
+export type EditorBlock = EditorParagraphBlock | EditorHeadingBlock | EditorCodeBlock | EditorImageBlock | EditorVideoBlock | EditorFileBlock | EditorButtonBlock | EditorEmbedBlock | EditorWebEmbedBlock | EditorMathBlock | EditorNostrBlock | EditorQueryBlock | EditorUnknownBlock;
+export type HMInlineContent = EditorText | EditorInlineEmbed | EditorLink;
+export interface EditorBaseBlock {
+    id: string;
+    props: EditorBlockProps;
+    children: Array<EditorBlock>;
+}
+export interface EditorBlockProps {
+    childrenType?: HMBlockChildrenType;
+    columnCount?: string;
+    listLevel?: string;
+    level?: number | string;
+    ref?: string;
+    revision?: string;
+}
+export interface EditorParagraphBlock extends EditorBaseBlock {
+    type: 'paragraph';
+    content: Array<HMInlineContent>;
+}
+export interface EditorHeadingBlock extends EditorBaseBlock {
+    type: 'heading';
+    content: Array<HMInlineContent>;
+}
+export interface EditorCodeBlock extends EditorBaseBlock {
+    type: 'code-block';
+    content: Array<HMInlineContent>;
+    props: EditorBlockProps & {
+        language?: string;
+    };
+}
+export interface DraftMediaRef {
+    draftId: string;
+    mediaId: string;
+    name: string;
+    mime: string;
+    size: number;
+}
+export interface MediaBlockProps extends EditorBlockProps {
+    url?: string;
+    src?: string;
+    displaySrc?: string;
+    fileBinary?: Uint8Array | number[];
+    mediaRef?: DraftMediaRef;
+    name?: string;
+    width?: string;
+    defaultOpen?: string;
+    size?: string;
+    alignment?: string;
+}
+export interface EditorImageBlock extends EditorBaseBlock {
+    type: 'image';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorVideoBlock extends EditorBaseBlock {
+    type: 'video';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorFileBlock extends EditorBaseBlock {
+    type: 'file';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorButtonBlock extends EditorBaseBlock {
+    type: 'button';
+    props: MediaBlockProps;
+    content: Array<HMInlineContent>;
+}
+export interface EditorEmbedBlock extends EditorBaseBlock {
+    type: 'embed';
+    props: EditorBlockProps & {
+        view: 'Content' | 'Card';
+        url: string;
+    };
+    content: Array<HMInlineContent>;
+}
+export interface EditorMathBlock extends EditorBaseBlock {
+    type: 'math';
+    content: Array<HMInlineContent>;
+}
+export type EditorWebEmbedBlock = EditorBaseBlock & {
+    type: 'web-embed';
+    props: EditorBlockProps & {
+        url?: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorNostrBlock = EditorBaseBlock & {
+    type: 'nostr';
+    props: EditorBlockProps & {
+        name?: string;
+        url?: string;
+        text?: string;
+        size?: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorQueryBlock = EditorBaseBlock & {
+    type: 'query';
+    props: EditorBlockProps & {
+        style: 'Card' | 'List';
+        columnCount?: '1' | '2' | '3';
+        queryLimit?: string;
+        queryIncludes?: string;
+        querySort?: string;
+        banner?: 'true' | 'false';
+    };
+    content: Array<HMInlineContent>;
+};
+export type EditorUnknownBlock = EditorBaseBlock & {
+    type: 'unknown';
+    props: EditorBlockProps & {
+        originalType: string;
+        originalData: string;
+    };
+    content: Array<HMInlineContent>;
+};
+export interface EditorText {
+    type: 'text';
+    text: string;
+    styles: EditorInlineStyles;
+}
+export interface EditorLink {
+    type: 'link';
+    href: string;
+    content: Array<HMInlineContent>;
+}
+export interface EditorInlineEmbed {
+    type: 'inline-embed';
+    link: string;
+    styles: EditorInlineStyles | {};
+}
+export interface EditorInlineStyles {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strike?: boolean;
+    code?: boolean;
+    math?: boolean;
+    range?: boolean;
+}
+export type EditorAnnotationType = 'bold' | 'italic' | 'underline' | 'strike' | 'code' | 'link' | 'inline-embed' | 'range';
+export type EditorBlockType = EditorBlock['type'];
+export type SearchResult = {
+    key: string;
+    title: string;
+    subtitle?: string;
+    icon?: string;
+    path?: string[] | null;
+    versionTime?: string;
+    searchQuery?: string;
+    onSelect?: () => void | Promise<void>;
+    onFocus: () => void;
+    onMouseEnter: () => void;
+};

package/dist/editorblock-to-hmblock.d.ts

@@ -0,0 +1,12 @@
+import { EditorBlock } from './editor-types';
+import { HMBlock, HMBlockNode } from './hm-types';
+/** Convert a single BlockNote EditorBlock into an HMBlock. */
+export declare function editorBlockToHMBlock(editorBlock: EditorBlock): HMBlock;
+/**
+ * Convert an array of BlockNote EditorBlocks into an HMBlockNode tree.
+ *
+ * This is the tree-level wrapper around `editorBlockToHMBlock` that recursively
+ * converts children. Useful when serializing editor content to the HM block format
+ * (e.g. for saving drafts as markdown or publishing documents).
+ */
+export declare function editorBlocksToHMBlockNodes(editorBlocks: EditorBlock[]): HMBlockNode[];