@henryx/pagely 0.1.0

package/dist/types/menuCommands.d.ts

@@ -0,0 +1,42 @@
+import { ChainedCommands } from '@tiptap/core';
+import { EmbedViewAttrs } from '../extensions/EmbedView';
+export type MenuChain = ChainedCommands & {
+    toggleOrderedList: () => MenuChain;
+    toggleBulletList: () => MenuChain;
+    toggleTaskList: () => MenuChain;
+    liftListItem: (typeOrName: string) => MenuChain;
+    setCodeBlock: () => MenuChain;
+    unsetCodeBlock: () => MenuChain;
+    toggleBlockquote: () => MenuChain;
+    setHorizontalRule: () => MenuChain;
+    insertInlineMath: (options: {
+        latex: string;
+        pos?: number;
+    }) => MenuChain;
+    updateInlineMath: (options: {
+        latex: string;
+        pos?: number;
+    }) => MenuChain;
+    insertBlockMath: (options: {
+        latex: string;
+        pos?: number;
+    }) => MenuChain;
+    updateBlockMath: (options: {
+        latex: string;
+        pos?: number;
+    }) => MenuChain;
+    insertImage: (options: {
+        src: string;
+        alt?: string | null;
+        title?: string | null;
+        width?: number | null;
+    }) => MenuChain;
+    insertEmbedView: (options: EmbedViewAttrs) => MenuChain;
+    insertDotFlowPadBlock: () => MenuChain;
+    insertMermaidBlock: () => MenuChain;
+    insertTable: (options: {
+        rows: number;
+        cols: number;
+        withHeaderRow?: boolean;
+    }) => MenuChain;
+};

package/dist/utils/attachmentUpload.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Attachment upload — generic file-attachment helpers for the editor.
+ *
+ * pagely accepts any file as an attachment and embeds it via EmbedView. The
+ * default handler produces a local blob URL (good for demos); production hosts
+ * should pass their own `FileUploadHandler` that uploads to a CDN/store and
+ * returns a stable `href` + display `label`.
+ */
+export declare const DEFAULT_ATTACHMENT_ACCEPT = "*/*";
+export interface FileUploadResult {
+    href: string;
+    label: string;
+}
+export type FileUploadHandler = (file: File) => Promise<FileUploadResult | null>;
+export declare function defaultAttachmentUpload(file: File): Promise<FileUploadResult | null>;

package/dist/utils/commentIds.d.ts

@@ -0,0 +1 @@
+export declare function parseCommentIds(raw: unknown): string[];

package/dist/utils/embedView/attrs.d.ts

@@ -0,0 +1,19 @@
+import { EmbedViewMode } from './detect';
+export interface EmbedViewAttrs {
+    href: string;
+    label: string;
+    view: EmbedViewMode;
+}
+export interface CreateEmbedAttrsInput {
+    href: string;
+    label?: string;
+    /** Optional user-supplied view; ignored if illegal or not previewable. */
+    preferredView?: unknown;
+}
+/**
+ * Produce validated `EmbedViewAttrs`, or `null` if the href is unsafe.
+ *
+ * Trims href/label, fills the label from the URL when empty, normalises the
+ * view through `pickView`.
+ */
+export declare function createEmbedAttrs(input: CreateEmbedAttrsInput): EmbedViewAttrs | null;

package/dist/utils/embedView/detect.d.ts

@@ -0,0 +1,14 @@
+export type EmbedViewMode = 'link' | 'card' | 'preview';
+export type EmbedFileType = 'pdf' | 'md' | 'url';
+export { extractDomain, extractFileName } from './url';
+export declare function detectFileType(href: string): EmbedFileType;
+/**
+ * Detect file type from href first, falling back to the label when the href
+ * carries no extension (typical of blob: URLs from local uploads). Used by
+ * both default-view selection and runtime fetch gating (e.g. "should I fetch
+ * this as markdown text?").
+ */
+export declare function detectFileTypeWithLabel(href: string, label: string): EmbedFileType;
+export declare function getDefaultView(href: string, label?: string): EmbedViewMode;
+export declare function canPreviewEmbedView(href: string, label?: string): boolean;
+export declare function isSafeUrl(href: string): boolean;

package/dist/utils/embedView/downgrade.d.ts

@@ -0,0 +1 @@
+export declare function downgradeEmbedViewHtml(html: string): string;

package/dist/utils/embedView/markdown.d.ts

@@ -0,0 +1,6 @@
+import { default as MarkdownIt } from 'markdown-it';
+import { default as TurndownService } from 'turndown';
+export declare function embedViewCorePlugin(md: MarkdownIt): void;
+export declare const embedViewTurndownRule: {
+    name: string;
+} & TurndownService.Rule;

package/dist/utils/embedView/metadata.d.ts

@@ -0,0 +1,8 @@
+export interface UrlMetadata {
+    title: string | null;
+    favicon: string | null;
+    domain: string;
+}
+export declare function fetchUrlMetadata(href: string, signal?: AbortSignal): Promise<UrlMetadata>;
+export declare function fetchMdContent(href: string, signal?: AbortSignal): Promise<string>;
+export declare function renderMdToSafeHtml(md: string): string;

package/dist/utils/embedView/pagelyPreview.d.ts

@@ -0,0 +1 @@
+export declare function buildPagelyPreviewSrcdoc(body: string): string;

package/dist/utils/embedView/url.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Pure URL-string utilities. No business policy lives here — only mechanical
+ * parsing/decomposition of href strings. Higher-level decisions (safety,
+ * file-type semantics, default view) belong in detect.ts and attrs.ts.
+ */
+export declare function stripQueryAndHash(value: string): string;
+export declare function extractExt(value: string): string;
+export declare function isBlobUrl(href: string): boolean;
+export declare function extractDomain(href: string): string;
+export declare function extractFileName(href: string): string;

package/dist/utils/markdown-converter/shared.d.ts

@@ -0,0 +1,15 @@
+/** Shared helpers for pagely markdown conversion. */
+export declare function normalizeLanguage(lang: string): string;
+export type FencedBlockMapping = {
+    lang: string;
+    dataType: string;
+    htmlTag: 'pre' | 'div';
+    extractBody: (el: Element) => string;
+    buildHtml: (body: string, esc: (value: string) => string) => string;
+};
+export declare function fencedBlockReplacement(mapping: FencedBlockMapping, node: Node): string;
+export declare const FENCED_BLOCK_MAPPINGS: FencedBlockMapping[];
+export declare function getFencedBlockMapping(node: Node): FencedBlockMapping | null;
+export declare function escapeHtml(value: string): string;
+export declare function getInlineMathLatex(node: Node): string | null;
+export declare function getBlockMathLatex(node: Node): string | null;

package/dist/utils/markdown-converter/toHtml.d.ts

@@ -0,0 +1 @@
+export declare function markdownToHtml(markdown: string): string;

package/dist/utils/markdown-converter/toMarkdown.d.ts

@@ -0,0 +1,7 @@
+import { default as TurndownService } from 'turndown';
+type NamedRule = {
+    name: string;
+} & TurndownService.Rule;
+export declare function buildTdRules(td: TurndownService): NamedRule[];
+export declare function htmlToMarkdown(html: string): string;
+export {};

package/dist/utils/markdown-converter.d.ts

@@ -0,0 +1,4 @@
+/** Markdown <-> HTML bidirectional conversion for pagely. */
+export { normalizeLanguage } from './markdown-converter/shared';
+export { markdownToHtml } from './markdown-converter/toHtml';
+export { htmlToMarkdown } from './markdown-converter/toMarkdown';

package/dist/utils/paste/context.d.ts

@@ -0,0 +1,4 @@
+import { EditorView } from '@tiptap/pm/view';
+import { PasteContext } from './types';
+export declare function buildContext(event: ClipboardEvent, view: EditorView): PasteContext | null;
+export declare function isInlineOnlyContext(view: EditorView): boolean;

package/dist/utils/paste/escape.d.ts

@@ -0,0 +1,2 @@
+export declare function escapeText(value: string): string;
+export declare function escapeAttr(value: string): string;

package/dist/utils/paste/handlers/codeBlock.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const codeBlockHandler: PasteHandler;

package/dist/utils/paste/handlers/dotFlowPad.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const dotFlowPadHandler: PasteHandler;

package/dist/utils/paste/handlers/jsonCode.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const jsonCodeHandler: PasteHandler;

package/dist/utils/paste/handlers/latexBlock.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const latexBlockHandler: PasteHandler;

package/dist/utils/paste/handlers/markdown.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const markdownHandler: PasteHandler;

package/dist/utils/paste/handlers/mermaid.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const mermaidHandler: PasteHandler;

package/dist/utils/paste/handlers/richHtml.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const richHtmlHandler: PasteHandler;

package/dist/utils/paste/handlers/tsv.d.ts

@@ -0,0 +1,2 @@
+import { PasteHandler } from '../types';
+export declare const tsvHandler: PasteHandler;

package/dist/utils/paste/index.d.ts

@@ -0,0 +1,10 @@
+import { codeBlockHandler } from './handlers/codeBlock';
+import { dotFlowPadHandler } from './handlers/dotFlowPad';
+import { jsonCodeHandler } from './handlers/jsonCode';
+import { latexBlockHandler } from './handlers/latexBlock';
+import { markdownHandler } from './handlers/markdown';
+import { mermaidHandler } from './handlers/mermaid';
+import { richHtmlHandler } from './handlers/richHtml';
+import { tsvHandler } from './handlers/tsv';
+export { codeBlockHandler, dotFlowPadHandler, jsonCodeHandler, latexBlockHandler, markdownHandler, mermaidHandler, richHtmlHandler, tsvHandler, };
+export declare const defaultPasteHandlers: import('./types').PasteHandler[];

package/dist/utils/paste/parsers/json.d.ts

@@ -0,0 +1,5 @@
+export declare function safeParseJson(text: string): {
+    value: unknown;
+} | null;
+export declare function isArray(value: unknown): value is unknown[];
+export declare function isObject(value: unknown): value is Record<string, unknown>;

package/dist/utils/paste/parsers/tsv.d.ts

@@ -0,0 +1,5 @@
+export interface TsvParsed {
+    rows: string[][];
+    cols: number;
+}
+export declare function parseTsv(text: string): TsvParsed | null;

package/dist/utils/paste/richHtml.d.ts

@@ -0,0 +1 @@
+export declare function detectRichHtml(html: string | null): boolean;

package/dist/utils/paste/sanitize.d.ts

@@ -0,0 +1 @@
+export declare function sanitize(html: string): string;

package/dist/utils/paste/types.d.ts

@@ -0,0 +1,12 @@
+export interface PasteContext {
+    plainText: string;
+    html: string | null;
+    isRichHtml: boolean;
+    inlineOnly: boolean;
+}
+export interface PasteHandler {
+    name: string;
+    priority: number;
+    detect: (ctx: PasteContext) => boolean;
+    transform: (ctx: PasteContext) => string;
+}

package/dist/utils/tableAlign.d.ts

@@ -0,0 +1,2 @@
+export type TableAlign = 'left' | 'center' | 'right' | null;
+export declare function extractTableAlign(el: Element): TableAlign;

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "@henryx/pagely",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "A block-style rich text editor built with Vue 3 and TipTap",
+  "keywords": [
+    "vue",
+    "vue3",
+    "tiptap",
+    "block-editor",
+    "rich-text-editor"
+  ],
+  "license": "MIT",
+  "author": "",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "main": "dist/pagely.cjs",
+  "module": "dist/pagely.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/pagely.js",
+      "require": "./dist/pagely.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./style.css": "./dist/style.css"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@codemirror/autocomplete": "^6.20.1",
+    "@codemirror/commands": "^6.10.2",
+    "@codemirror/lang-cpp": "^6.0.3",
+    "@codemirror/lang-css": "^6.3.1",
+    "@codemirror/lang-html": "^6.4.11",
+    "@codemirror/lang-java": "^6.0.2",
+    "@codemirror/lang-javascript": "^6.2.5",
+    "@codemirror/lang-json": "^6.0.2",
+    "@codemirror/lang-markdown": "^6.5.0",
+    "@codemirror/lang-php": "^6.0.2",
+    "@codemirror/lang-python": "^6.2.1",
+    "@codemirror/lang-rust": "^6.0.2",
+    "@codemirror/lang-sql": "^6.10.0",
+    "@codemirror/lang-xml": "^6.1.0",
+    "@codemirror/language": "^6.12.2",
+    "@codemirror/state": "^6.5.4",
+    "@codemirror/view": "^6.39.17",
+    "@floating-ui/dom": "^1.6.0",
+    "@fontsource/jetbrains-mono": "^5.2.8",
+    "@tiptap/extension-code-block-lowlight": "^3",
+    "@tiptap/extension-color": "^3.20.2",
+    "@tiptap/extension-highlight": "^3.20.2",
+    "@tiptap/extension-link": "^3.20.1",
+    "@tiptap/extension-mathematics": "^3.23.1",
+    "@tiptap/extension-table": "^3",
+    "@tiptap/extension-task-item": "^3.20.1",
+    "@tiptap/extension-task-list": "^3.20.1",
+    "@tiptap/extension-text-align": "^3.20.2",
+    "@tiptap/starter-kit": "^3",
+    "@tiptap/vue-3": "^3",
+    "dot-flow-pad": "^0.1.2",
+    "katex": "^0.16.45",
+    "lowlight": "^3.1.0",
+    "lucide-vue-next": "^0.577.0",
+    "markdown-it": "^14.1.1",
+    "mermaid": "^11.13.0",
+    "mermaid-smart-editor": "^0.1.1",
+    "turndown": "^7.2.2",
+    "vue": "^3.4.0"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^21.1.7",
+    "@types/markdown-it": "^14.1.2",
+    "@types/turndown": "^5.0.6",
+    "@vitejs/plugin-vue": "^5.0.0",
+    "jsdom": "^24.1.3",
+    "typescript": "^5.3.0",
+    "vite": "^5.2.0",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^1.6.1",
+    "vue-tsc": "^2.0.0"
+  },
+  "peerDependencies": {
+    "vue": "^3.4.0"
+  }
+}